BOS_集成消息中心开发指南

<集成消息中心开发指南> 修订版历史目录1. EAS消息中心主动向第三方系统推送消息 (3)1.1. 接口方法说明 (3)1.2. 配置文件说明 (3)1.3. WSMessage 字段说明 (4)1.4. 调用示例 (5)2. 第三方系统向EAS消息中心来推送消息 (6)2.1. WSWsMessageCenterFacade服务提供的接口的功能 (7)2.2. 二次开发注意事项 (8)2.3. 代码示例 (8)3. 第三方系统从EAS消息中心取消息 (9)3.1. checkMessageCount (9)3.2. clearMessageCount (9)3.3. removeMsgByID (9)3.4. getMessageList (9)3.5. 消息流 (10)4. EAS消息中心第三方系统消息节点配置方法 (10)4.1. 配置流程 (10)4.2. 相关配置文件 (12)1.EAS消息中心主动向第三方系统推送消息使用此功能需要实现一个接口MessageWebServiceDao接口全路径：com.kingdee.eas.base.message.webservice.MessageWebServiceDao 接口类所在包名：bs_message-server.jar1.1.接口方法说明✧public boolean addMessage(WSMessage message)用于在第三方系统中添加消息，其中参数message包含一些消息的信息，这个方法在消息中心获得新的消息的时候会主动调用。

✧public boolean removeMessage(String ID)用于EAS消息中心主动删除第三方系统相应的消息记录，参数ID是WSMessage中的MsgID字段的值，这个方法是在消息中心删除消息的时候会调用。

✧public boolean updateMessage(String ID)与消息中心消息状态同步接口，参数ID是WSMessage中的MsgID字段的值。

这个接口是现实的是当鼠标点击在某条消息上时改变消息状态的情况下被调用。

✧public boolean updateMessages(String IDs, MsgStatus state)与消息中心消息状态同步接口，参数IDs是多条消息的MsgID的值的集合，state是要设置消息的状态值，这个接口是在界面上按下“设置消息已读”或“未读”按钮时被调用。

1.2.配置文件说明✧eas\ server\deploy\portalconfig\easWebConfig.xml文件中有如下的配置项<configitem name="otherSystem"><!--是否启用与第三方系统消息集成--><attribute key="toSys" value="true" /><attribute key="letGet" value="true"/></configitem>配置项的value值是“true”，启用功能。

✧eas\ server\deploy\portalconfig\WSConfig.xml文件中配置信息。

<?xml version="1.0" encoding="utf-8"?><config><class>//EAS portal消息中心的url<server>http://ip:port/easportal?toPage=SYS_PC</server>//数据中心编码<dataCenter>db540</dataCenter>//实现类的包名加类名<path>com.kingdee.eas.base.message.webservice.testWebServiceImpl</p ath>//任务类型消息是否接受<task value="true">//任务类型消息节点下的工作流消息是否接受<workflow>true</workflow></task>//通知类型消息是否接受<notice value="true">//通知类型消息节点下的工作流消息是否接受<workflow>true</workflow>//通知类型消息节点下的预警消息是否接受<forwarn>true</forwarn>//通知类型消息节点下的催办消息是否接受<urgent>true</urgent></notice>//即时消息是否接受<online value="true"></online></class></config>配置文件需要注意的是每个节点都需要配置，格式要求比较严格，所以要按照示例格式配置，若有多个第三方系统集成，则配置多个class树即可。

A、<server>节点中的值是对应的EAS消息中心的URL，客户那边只能展现消息，具体的业务逻辑处理还是在EAS的消息中心，如果需要单点登陆，需要在URL串后面加上相应的单点登录信息。

B、<path>节点的值是客户实现类的“包名+类名”，EAS消息中心将用反射机制来调用这个类。

将这个类打包后放在sp目录下。

task 、notice、online等节点下的值都为true，来启用相应的任务、通知、即时消息的发送，如果为false则相应类型消息将不会被发送出去。

<dataCenter>节点值需要配置为当前使用的数据中心编码，如果不匹配也不会发送消息，修改配置文件后需要重启服务器才能起作用。

1.3.WSMessage 字段说明✧//消息IDprivate String msgID;✧//消息标题private String title;✧//消息内容private String body;✧//优先级private MsgPriority priority;✧//发送时间private Timestamp sendTime;✧//接受时间private Timestamp receiveTime;✧//源业务对象IDprivate String sourceID;✧//接收者名字private String receivers;✧//消息状态private MsgStatus state;✧//消息类型（大类）private MsgType type;✧//消息类型（小类）private MsgBizType bizType;✧//发送者名字private String sender;✧//EAS portal消息中心的urlprivate String url;✧//接收人IDprivate String recieverID;✧//组织IDprivate String OrgID;这里WSMessage消息类对消息中心中的存在的消息类新做了统一的转型处理，所以对里面的字段可用性不能保证，在实现类中接收到的WSMessage对象中获得的字段中存在是空值的情况，需要开发人员自行控制。

1.4.调用示例public class testWebServiceImpl implements MessageWebServiceDao {public boolean addMessage(WSMessage message) {if(message.getReceiveTime() == null){message.setReceiveTime(new Timestamp(System.currentTimeMillis()));}System.out.println("----------------addMessage------------");System.out.println("msgID:" + message.getMsgID());System.out.println("title:" + message.getTitle());System.out.println("body:" + message.getBody());System.out.println("priority:" + message.getPriority().getAlias());System.out.println("sendTime:" + message.getSendTime().toString());System.out.println("receiveTime:" + message.getReceiveTime().toString());System.out.println("sourceID:" + message.getSourceID());System.out.println("receivers:" + message.getReceivers());System.out.println("state" + message.getState().toString());System.out.println("type:" + message.getType().getAlias());System.out.println("bizType:" + message.getBizType().getAlias());System.out.println("sender:" + message.getSender());System.out.println("url:" + message.getUrl());System.out.println("recieverID" + message.getRecieverID());System.out.println("OrgID:" + message.getOrgID());System.out.println("----------------addMessage------------");return false;}public boolean removeMessage(String ID) {System.out.println("----------------removeMessage------------");System.out.println(ID);System.out.println("----------------removeMessage------------");return false;}public boolean updateMessage(String ID) {System.out.println("----------------updateMessage------------");System.out.println(ID);System.out.println("----------------updateMessage------------");return false;}public boolean updateMessages(String ids, MsgStatus state) {System.out.println("----------------updateMessages------------");System.out.println(ids);System.out.println("----------------updateMessages------------");return false;}}最后将写好的类编译，将编译后的class文件打成jar包，注意不要和原来EAS系统中的jar包重名。