Portal门户开发规范

1 Portlet组件开发要求

对于嵌入门户的Portlet，必须符合JSR 168标准。JSR 168本身就是一套标准API，与Sevlet相似，开发Portlet应用必须遵守这个标准。现行很多开源的MVC框架都支持此标准，如struts等。开发商可以选择适合自己的方式，遵守JSR 168标准开发Portlet应用，只有这样才能满足将应用部署到门户中的这个基本要求。

1.1 可定制显示样式

对于Portlet在门户中的展现，Portlet作为页面上的一个个小方块，它的高、宽是要自由调整的；而它的高、宽、样式等可以通过对Portlet配置参数进行设置。Portlet提供修改参数的模式机制（edit mode），在此模式下管理员权限能修改各个参数的值，从而调节展现。例如，参数如表1：

表 1 portlet参数

1.2 可定制显示模式

Portlet的作用是在门户上展现后台整合的内容。门户对信息的显示不是固定的一种方式，而是按要求提供多种显示模式供用户选择。比如，引入进来的数据是显示曲线图，可通过选择柱形模式，使Portlet显示柱形图。

这要求Portlet的开发设计是基于显示模式，而不是显示成果。通过调节显示模式，从而得到不同的显示结果，因而要求Portlet的设计是显示模式层面。

1.3 可插入处理服务接口功能

Portlet能配置引入所需的服务接口，且能插入处理服务接口的调用结果的模块。Portlet对服务调用的方式应用配置方式，具备对于处理服务的结果提供插入模块处理的能力。

以WebSphere服务接口为例，Portlet能配置访问WS接口的URL；对于调用

服务后都是得到XML，对于XML结果的处理，是一个可插入的模块，可以随时更改。

1.4 提供通信接口

Portlet提供通信的接口，供其它Portlet和自身实现通信。例如，自身能根据其它Portlet发送过来的参数，实现不同的显示功能。

1.5 命名规则

对于Portlet展现的页面的变量统一的命名方式为：开发商简称_业务系统名_模块名_方法。比如，门户中OA模块获得用户信息的方法在Portlet里的JS脚本方法就命名为：nci_portal_oa_getUserInfo，其中开发商名称、业务系统模名、模块名的大小写无要求，建议采用小写字符，方法按照JAVA中方法的命名规范进行命名。