实现 JAX-RPC Web Service 客户机的扩展
WebSphere® Application Server 对使用 Java™ API for XML-based RPC (JAX-RPC) 编程模型的 Web Service 客户机提供扩展。
关于此任务
可以使用 JAX-RPC 客户机编程模型的以下扩展来定制 Web Service。
过程
- 在 JAX-RPC 客户机 Stub 中设置 REQUEST_SOAP_HEADERS 和 RESPONSE_SOAP_HEADERS
属性以允许 Web Service 客户机发送或检索隐式 SOAP 头。 隐式 SOAP 头是 WSDL 文件中未显式定义的 SOAP 头。隐式 SOAP 头文件符合以下描述:
- 在 WSDL 文件中声明为绑定中的 SOAP 头,但消息定义未由 portType 在 WSDL 文件中引用的消息部件。
- 未包含在 WSDL 文件中的元素。
处理程序和服务端点可以通过使用带附件的 SOAP API for Java (SAAJ) 数据模型来处理隐式或显式 SOAP 头。
要了解如何修改客户机代码以发送或检索传输头,请参阅有关使用 JAX-RPC 发送隐式 SOAP 头或使用 JAX-RPC 接收隐式 SOAP 头的信息。
- 设置 REQUEST_TRANSPORT_PROPERTIES 和 RESPONSE_TRANSPORT_PROPERTIES 属性以使 Web Service 客户机可以发送或检索传输头。
在 Stub 或 Call 对象上设置属性。
通过修改客户机代码以发送或检索传输头,您可以在服务器的出局请求或入局响应的传输头中发送或接收特定的信息。对于使用 HTTP 传输方法的请求或响应,将在 HTTP 头中发送或检索信息。类似地,对于使用 Java 消息服务 (JMS) 传输的请求或响应,将在 JMS 消息属性中发送或检索信息。
要了解如何修改客户机代码以发送或检索传输头,请参阅有关使用 JAX-RPC 发送传输头或使用 JAX-RPC 检索传输头的信息。
要了解如何使 Web Service 客户机发送或检索传输头,请参阅传输头属性最佳实践的信息。
- javax.xml.rpc.ServiceFactory.loadService() 方法的实现支持。 loadService 方法会以特定于实现的方式创建生成的服务实现类的实例。loadService 方法对于 JAX-RPC 1.1 是新方法并包括三个特征符:
- public.javax.xml.rpc.Service loadService (Class serviceInterface)
如 JAX-RPC 规范中说明的,此方法返回服务接口的已生成服务实现。请参阅 Web Service 规范和 API 文档以审阅 JAX-RPC 规范。
- public.javax.xml.rpc.Service loadService (URL wsdlDocumentLocation,
Class serviceInterface, Properties properties)此方法作用类似于 loadService (Class serviceInterface),因为以下参数被忽略:
- wsdlDocumentLocation
- properties
- public.javax.xml.rpc.Service loadService (URL wsdlDocumentLocation,
QName serviceName, Properties properties)
通过使用可选名称空间到包映射信息,此方法返回指定服务的已生成服务实现。
- wsdlDocumentLocation - 已忽略
- serviceName - 服务的 QName(名称空间,localpart)
- properties - 如果此参数非 null,那么它包含名称空间到包映射条目。每个 Property 条目键都是与名称空间相应的字符串。每个 Property 条目值都是与 Java 包名称相应的字符串。
如果此属性参数包含一个条目,而此条目带有与 QName serviceName 参数的名称空间部分匹配的键(名称空间),那么条目值 (javaPackage) 用作尝试查找服务实现时的包名称。
- public.javax.xml.rpc.Service loadService (Class serviceInterface)
- 实现 CustomBinder 接口以便为特定的 XML 模式类型提供具体的定制数据绑定程序(仅限于 JAX-RPC 应用程序)。 使用定制数据绑定程序在 XML 模式类型与 Java 对象之间进行映射。 定制数据绑定程序为当前 Java API for XML-based Remote Call Procedure (JAX-RPC) 规范不支持的 XML 模式类型提供绑定。WebSphere Application Server 为称为 CustomBinder 接口的 Web Services for Java Platform, Enterprise Edition (Java EE) 编程模型提供了扩展,该接口为特定的 XML 模式类型实现这些定制绑定。除了 deserialize 和 serialize 方法之外,CustomBinder 接口具有三个属性:
- XML 模式类型的 QName
- QName 范围
- Java 类型
定制数据绑定程序定义了一些序列化和反序列化方法,用来在 Java 对象和 SOAPElement 接口之间进行转换。定制数据绑定程序已添加至运行时系统,并使用 SOAPElement 与 Web Service 运行时交互。它们被添加至使用定制绑定提供程序的运行时。阅读有关定制数据绑定程序和定制绑定提供程序的相关信息以了解更多信息。请参阅 CustomBinder 接口文档,以了解可以如何实现此接口以便为特定的 XML 模式类型提供具体的定制数据绑定程序的更多信息。
子主题
Custom data binders for JAX-RPC applications
A custom data binder is used to map XML schema types with Java objects. Custom data binders provide bindings for XML schema types that are not supported by the current Java API for XML-based Remote Call Procedure (JAX-RPC) specification.用于 JAX-RPC 应用程序的定制绑定提供程序
定制绑定提供程序是将定制数据绑定程序类和声明式元数据文件打包的结果。定制绑定提供程序的主要用途是聚集相关定制数据绑定程序以支持特殊的用户方案。定制绑定提供程序用来将定制数据绑定程序插入发射器工具和运行时系统,以便发射器工具可以生成适当的工件,而运行时系统可以增大它的现有类型映射系统,以反映已应用的定制数据绑定程序并调用它们。JAX-RPC 应用程序的 CustomBinder 接口
WebSphere Application Server 定义了 CustomBinder 接口,可以为 Java API for XML-based Remote Call Procedure (JAX-RPC) 应用程序实现该接口,以便为特定 XML 模式类型提供具体定制数据绑定程序。部署 JAX-RPC 应用程序的定制数据绑定程序的使用模式
使用定制数据绑定程序在 XML 模式类型与 Java 对象之间进行映射。 定制数据绑定程序为当前 Java API for XML-based Remote Call Procedure (JAX-RPC) 规范不支持的 XML 模式类型提供绑定。WebSphere Application Server 为称为 CustomBinder 接口的 Web Services for Java Platform, Enterprise Edition (Java EE) 编程模型提供了扩展,该接口为特定的 XML 模式类型实现这些定制绑定。定制绑定提供程序是定制数据绑定程序的导入到运行时中的包。使用 JAX-RPC 发送隐式 SOAP 头
可以使现有的 Java API for XML-based RPC (JAX-RPC) Web Service 客户机在隐式 SOAP 头中发送值。通过修改客户机代码来发送隐式 SOAP 头,可以在出局 web service 请求中发送特定信息。使用 JAX-RPC 接收隐式 SOAP 头
可以使现有的 Java API for XML-based RPC (JAX-RPC) Web Service 客户机从隐式 SOAP 头接收值。通过修改客户机代码来接收隐式 SOAP 头,可以在入局 web service 响应中接收特定信息。使用 JAX-RPC 发送传输头
可以使现有的 Java API for XML-based RPC (JAX-RPC) Web Service 客户机通过使用传输头发送应用程序定义的信息以及 Web Service 请求。使用 JAX-RPC 检索传输头
可以使现有的 Java API for XML-based RPC (JAX-RPC) Web Service 客户机可用于从传输头中检索值。对于使用 HTTP 的请求,从 HTTP 响应消息中找到的 HTTP 头检索传输头。对于使用 Java 消息服务 (JMS) 的请求,将从 JMS 响应消息上找到的 JMS 消息属性检索传输头。


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_extendpm
文件名:twbs_extendpm.html