EMP渠道配置详解_XML格式

1、 宇信易诚信贷产品部XML渠道接入 V1.0 文件修订历史记录版本修订日期修订者修改描述第1章 前言在进行服务端配置时需要确认ECLIPSE开发工具已经安装了EMP的IDE工具，并且已经为该工程添加了“为该项目添加EMP支持”，并且能够打开EMP Explore视图，才能进行后续的EMP配置操作。其他要求：² EMP IDE插件支持² 项目工程添加EMP支持第2章 XML报文服务端配置1.1. 业务逻辑1.1.1. 新建文件夹1.如上图所示，进入EMP Explore,选择工程下的：业务逻辑CMISBiz,点击右键，选择：新建新增文件夹。2.如上图所示：按照分类情况输入新增

2、的文件夹名称，此处示例文件夹名称为“demo”，点击“Finish”，完成文件夹添加。1.1.2. 新增业务逻辑构建1.如上图所示：在建立的文件夹“demo”下建立相应的业务逻辑构建，选择：demo，点击右键，选择：新建新增业务逻辑构建。2.如上图所示：根据实际情况在弹出的面板中输入业务逻辑构建ID，此处示例以“demo”为构建ID，点击“Finish”，完成新建业务逻辑构建。1.1.3. 业务逻辑构建参数设置1. 如上图所示，打开新增的业务逻辑构建“”，在基本属性tab页勾选“是一个无Session交易Context连接到：”，并且选择“Root”。2. 如上图所示，在逻辑处

3、理流程页面，选择“添加”，在弹出的面板中录入业务逻辑ID、和业务逻辑名称，点击“Finish”完成。3. 如上图所示，还需要定义“组件”，组件定义参照组件定义。请先定义组件后在继续向下操作。注意：此处最好重新打开，保证数据拿到最新值。4.如上图所示，鼠标左键单击，选择组件定义下的“交易实例”，在右侧空白面板中左键点击一下，并且用上述的红色方框标注的箭头从开始交易实例结束。然后点击保存。1.1.4. 组件定义说明：组件的定义其实可以理解为定义该交易的业务逻辑实现类，即处理交易的逻辑代码类。并且组件定义一定要求通过如下方式新建，不允许自己写java类。1. 如上图所示，选择：项目公

4、共定义组件扩展新建新增EMP Action，建立自定义组件。2. 如上图所示，依次填写“包名”、“组件ID（类名）”、“组件名称”，选择“所属分类”，点击“Finish”完成组件定义。1.2. 渠道逻辑1.2.1. 新建XML渠道接入定义1.如上图所示，在渠道逻辑上点击鼠标右键，选择“新建渠道接入定义”。2.如上图所示，在打开的面板选择“TCPIP渠道接入”，并且录入名称，此处示例使用“TCPIPServerDemo”，点击“Finish”完成新建渠道接入定义。1.2.2. 配置XML渠道接入参数1. 如上图所示，选择“TCPIP渠道接入”，在右侧的显示面板中选择“业务逻辑分组名称”的下拉框，

5、选择“CMISBiz”。2.如上图所示，选择“会话管理”，在右侧的显示面板中根据实际需求配置超时设置。此处默认。3. 如上图所示，选择“通讯设定”，在右侧的显示面板中将连接方式设置为“短连接”，双工模式设置为“true”，具体实际情况需要根据需求。4. 如上图所示，选择“监听端口”，在右侧的显示面板中将端口设置为约定的端口号（需要注意端口在5000之内的一般作为系统保留端口，不建议使用），此处以9000为例。设置持久连接为“false”，最大连接限制(根据性能设置)设置为“50”,使用线程缓冲选择为“true”，缓冲线程数依据实际情况设置。5. 如上图所示，选择“解包处理”，查看右侧的“实现类

6、”，此处实现类可依据实际需求进行调整，此处如果发现右侧面板中无法直接修改则需要通过将“TCPIPServerDemo.acc”通过文本方式打开，找到如下所示节点：<CommProcessor name="CommProcessor" label="解包处理" class="com.ecc.emp.tcpip.EMPCommProcessor"/>修改为：<CommProcessor name="CommProcessor" label="解包处理" class="co

7、m.yucheng.cmis.pub.format.xml.OLSServerCommProcessor"/>修改后需要重新在EMP Explore中打开，修改后如下图所示：修改完成后保存。6. 如上图所示，选择“接入逻辑”，在右侧的显示面板中选择“serviceIdField”，将serviceId的值改为我们所定义的交易码字段。此处暂用“tranCode”。另，保存后需要以文本方式打开“TCPIPServerDemo.acc”，将实现类按照如下修改：<TCPIPRequestHandler appendReqHead="true" label=&q

8、uot;接入逻辑" serviceIdField="serviceId" class="com.ecc.emp.access.tcpip.EMPTCPIPRequestHandler" appendRepHead="true">修改为：<TCPIPRequestHandler appendReqHead="true" label="接入逻辑" serviceIdField="serviceId" class="com.yucheng.cmis.

9、pub.format.xml.OLSTCPIPRequestHandler" appendRepHead="true">修改后需要重新在EMP Explore中打开，修改后如下图所示：1.2.3. 渠道逻辑与业务逻辑关联1.如上图所示，右键选择“TCPIP渠道接入”，选择：新建TCPIP接入交易。2.如上图所示，选择新建的业务逻辑“”，点击“Next”，进入下一步。3. 如上图所示，选择之前所选的业务构件中的业务逻辑“TRAN001”，点击“Finish”，完成。4. 如上图所示，选择接入的业务逻辑“demo”，在右侧的面板中，将交易该接入逻

10、辑所属的交易码写入。保存。1.2.4. 类映射定义1. 如上图所示，依次将RequestHeadFormat、ResponseHeadFormat项的值修改为：com.yucheng.cmis.pub.format.xml.OLSXmlHeadFormat，将TCPIPService的值修改为：com.yucheng.cmis.pub.format.xml.OLSTCPIPRequestService。修改后的截图如下：修改完成后保存。2. 如上图所示，点击“add”，按钮，分别添加“requestDataFormat”，“responseDataFormat”，两个映射配置，将Class的值

11、设置为“com.yucheng.cmis.pub.format.xml.OLSXmlBodyFormat”。设置后截图如下所示：1.2.5. 修改web.xml文件在新建XML渠道定义时，EMP平台会同步的在系统的web.xml文件中生成一段配置信息。如上图所示，将factoryName的值修改为“CMISBiz”，将<init-param></init-param>节点删除，将启动顺序修改为“3”。修改后的结果如下所示：<servlet><servlet-name>TCPIPServerDemo</servlet-name><

12、servlet-class>com.ecc.emp.access.tcpip.EMPTCPIPServiceServlet</servlet-class><init-param><param-name>factoryName</param-name><param-value>CMISBiz</param-value></init-param><init-param><param-name>servletContextFile</param-name><param-

13、value>WEB-INF/channels/TCPIPServerDemo.xml</param-value></init-param><init-param><param-name>sessionIdField</param-name><param-value/></init-param><load-on-startup>3</load-on-startup></servlet>1.3. 模板校验配置1.3.1. perties配置在工程的cmis.

14、properties文件中添加模板文件路径，具体代码如下：#XML模版文件路径XmlFilePath=E:SRCBPOCcmisWebContentxmltemplate在上述路径下，将下述xmlFormats.xml文件存放于该路径下。模板文件配置示例：1.3.2. 添加启动加载在CMISInitializer.java类的initialize方法中添加如下代码：UnionpayXmlLoader.loadToContext(rootCtx);2. XML报文客户端配置2.1. 客户端端节点定义(services.xml)<TCPIPService id="spdTcpIpS

15、erver" implClass="com.ecc.emp.tcpip.TCPIPService" keepAlive="false" dual="true"><ConnectToHost implClass="com.ecc.emp.tcpip.ConnectToHost" port="10001" hostAddr="5"/><CommProcessor name="CommProcessor" implClass="com.yucheng.cmis.pub.format.xml.OLSClientCommProcessor"/></TCPIPService>其中，hostAddr为IP地址，prot为端口号2.2. contexts.xml文件配置<refService alias="spdTcpIpServer" type="service" refId="spdTcpIpServer"/>其中alias、refId的值与TCPIPService 节点id一致2.3.