YD_T 2145-2010基于Web Service技术的网络管理接口定义指南.pdf

ICS 33.040.01M11中华人民共和国通信行业标准YD/T 2145-2010基于 Web Service 技术的网络管理接口定义指南Guidance for defining Web service technology-based networkmanagement interface2010-12-29 发布2011-01-01 实施中华人民共和国工业和信息化部发布 YD/T 2145-2010目次前言范围·12规范性引用文件3缩略语·4　基于Web service技术的网络管理接口位置·5基于Web service技术的网络管理接口的层次结构6基本技术要求7信息模型层技术要求8MEP层技术要求9传输层的技术要求·10　安全要求附录A（资料性附录）使用JMS作为传输协议的技术要求附录B（资料性附录）使用REST技术实现网络管理接口参考文献 YD/T 2145-2010附录A（资料性附录）使用JMS作为传输协议的技术要求JMS作为J2EE架构中的一部分为多个运行在不同环境下的Java应用提供了灵活可靠的通讯机制。必威体育精装版的JMS版本是1.1版本，发布于2002年4月，相关的规范可以参考http:/products/jms/。如果网管接口A使用JMS作为通讯底层，对JMS消息的具体要求：1）头部分，JMS定义的标准头信息，JMS标准定义了很多头属性，其中很多是有JMS服务器在发送消息的时候自动填写，只有如下头信息可以通过程序设定：a）deliveryMode（xsd:int）指定传送的消息是否需要持久化；b）timeToLive（xsd:long）毫秒级别，指定消息的存活时间；c）priority（xsd:int）指定消息的优先级别；d）replyToName（xsd:string）指定一个JNDI的名字，通过这个名字可以找到一个接受响应消息的QUEUE/TOPIC。2）属性部分，有JMS指定的标准属性，应用程序也可以添加自己的属性；这些属性是可以被用来作为消息过滤；下面这些是标准属性，可以被用于过滤消息：a）targetService（xsd:string）用于指定最终处理消息的服务的名字；b）bindingVersion（xsd:string）指定传送的SOAP的消息的版本；c) soapAction (xsd:anyURI) 指定soapAction;d）isFault(xsd:boolean）指定消息体部分的SOAP消息是否是一个fault消息；e）soapMEP（xsd:string）指定消息是否需要响应（req-resp或one-way）。3）消息体部分，使用TEXT样式的消息格式。无论是响应方还是请求方在使用JMS作为通讯层的时候，都需要事先指定如下属性用于和JMS服务中事先定义好的QUEUE/TOPIC建立连接：1）destinationName（xsd:string）指定一个JNDI的名字，用于查找将被连接的TOPIC或是QUEUE；2）connectionFactoryName（xsd:string）指定一个JNDI的名字，用于查找建立连接所需要连接器工厂；3）initialContextFactory（xsd:string）指定一个上下文工厂的Java类名字，用于初始化本地JNDI上下文;4）jndiURL（xsd:anyURL）指定JNDI服务器监听连接请求的URL。当请求方通过JMS发送消息时，需要按照上述要求设置JMS消息。表A.1和A.2做了概括和总结。表 A.1请求方在构建请求消息时需要完成的工作域值JMS消息头JMSDeliveryMode持久、非持久JMSExpiration亳秒，默认为0（永久消息）JMSPriority优先级（如果不指定，将由JMS服务自行决定） JMSDestinationJNDI名字JMSReplyTo除了one-Way模式，这个属性必须指定，JNDI名字标定的QUEUE/TOPIC，用于接受响应消息8 YD/T 2145-2010表A.1 (续)域值JMS消息属性 targetService可选 soapAction可选binding Version可选soapMEP可选JMS消息体body建议是文本消息格式表 A.2响应方在构建响应消息时需要完成的工作域值JMS消息头 JMSDeliveryMode从请求消息中拷贝JMSExpiration毫秒，默认为0（永久消息)JMSPriority从请求消息中拷贝JMSDestination从请求消息中拷贝 JMSCorrelationID从请求消息中拷贝（JMS自动生成）JMS消息属性isFault指定是否是fault消息 bindingVersion从请求消息中拷贝 soapMEP从请求消息中拷贝JMS消息体