控制台socket服务开发手册精选.docVIP

中国邮政汇兑结算全国大集中系统 控制台socket服务开发手册 上海华腾软件系统有限公司 Shanghai Huateng Software System Co.,Ltd. 二零零六年十二月 1. 开发说明 1 1.1 环境准备 1 1.2 socket连接 1 2. 开发流程 1 2.1 配置 2 2.1.1 Struts Action 2 2.1.2 socket服务的配置 2 2.1.3 定义报文路径 2 2.1.4 定义报文结构 2 2.1.5 定义报文数据 3 2.1.6 定义Message 4 2.2 编码 4 2.2.1 SocketService服务 4 2.2.2 SocketCommComponent通讯组件 5 3. 文档说明 5 4. 名词解释 5 5. 附录 5 5.1 附录1 5  文档控制页 文 档 历 史 记 录 日 期 版 本 姓 名 版 本 更 新 记 录 2006/12/14 V1.0 包竹苇 初始版本 2007/01/06 V1.1 包竹苇 修订版本，重新排版，增加标记框 开发说明 环境准备 socket服务也使用控制台的服务池、事务管理等，因此需遵守控制台服务开发的相关规则。 参考：《控制台服务开发手册.doc》 socket连接 服务器端先初始化socket，然后与端口绑定(bind)，对端口进行监听(listen)，调用accept阻塞，等待客户端连接。在这时如果有客户端初始化一个socket，然后连接服务器(connect)，如果连接成功，这时客户端与服务器端的连接就建立了。客户端发送数据请求，服务器端接收请求并处理请求，然后把回应数据发送给客户端，客户端读取数据，最后关闭连接，一次交互结束。 开发流程 配置 Struts Action socket服务中Action、ActionForm与普通Struts中的Action、ActionForm有所区别，继承自控制台内部的类。 参考：《控制台Struts Action开发手册.doc》 socket服务的配置 按顺序配置服务池、服务、阶段、交易组件、通讯组件等。 参考：《控制台服务开发手册.doc》 定义报文路径 在WEB-INF目录下的TcpMeta.xml中定义socket报文路径： //请求socket报文结构路径 TitaLabel path=/WEB-INF/titatota/TitaSocketLabel.xml / //应答socket报文结构路径 TotaLabel path=/WEB-INF/titatota/TotaSocketLabel.xml / //socket报文路径 Messages message path=/WEB-INF/titatota/1000.xml id=1000 / /Messages 注记：在path属性中填写需要的文件路径。 定义报文结构 在WEB-INF/titatota目录下分别定义请求socket报文头结构和应答socket报文头结构： 请求socket报文头结构TitaSocketLabel.xml： TransMessage id=TITALABEL desc=请求报文头 Field id=ReqMsgType type=C size=1 desc=消息类型 method=fillStringRS/ Field id=ReqMsgCode type=C size=4 desc=消息代码 method=fillStringRS/ /TransMessage/TotaSocketLabel.xml： TransMessage id=TOTALABEL desc=应答报文头 Field id=RspMsgType type=C size=1 desc=消息类型 method=trimStringRE/ Field id=RspMsgCode type=C size=4 desc=消息代码 method=trimStringRE/ /TransMessageid type size desc method format C-字符型 N-数字型 H-金额型 ReqMsgType C 1 消息类型 fillStringRS 　 ReqMsgCode C 4 fillStringRS 　 id type size desc method format C-字符型 N-数字型 H-金额型 RspMsgType C 1 消息类型 fillStringRS 　 RMsgCode C 4 消息代码 fillStringRS 　 注记：method属性可填