2 wscompile的配置文件(config.XML)
这个配置文件是wscompile工具的主要信息源,这些信息同工具调用期间指定的一些开关协同工作来生成需要的制品.
有四种不同的方式向工具提供信息,每种提供信息的方式需要不同格式的配置文件,每个格式答应工具的多种模式(-import, -define, and -gen).四种方式为:
1 service,一套基于服务端点接口(SEI)的服务描述.
2 wsdl,一个要导入和处理的WSDL文档.当一个的描述被一个已经存在的WSDL文档提供或是客户端制品需要根据WSDL生成时使用这个格式. 例如:
<configuration xmlns="http://Java.sun.com/xml/ns/jax-rpc/ri/config">
<wsdl location="./StockQuoteService.wsdl"
pacakgeName="com.example"/>
</configuration>
3 modelfile,一个前面保存的model文件(在wscompile通过-model选项生成).这个文件是JAX-RPC标准实现对一个WS端点或客户端表示,由wscompile工具生成,通常用作一个.xml.gz文件.它存储了所有内部数据结构的要害信息,以容许轻易的生成实现特定的制品. 因为wsdeploy只支持有限的一套选项,很多选项都指定在wscompile阶段期间,它们保存成model的一部分.当定义一个服务时或是客户端制品需要从已存在的model文件生成时使用.例如:
<configuration xmlns="http://java.sun.com/xml/ns/jax-rpc/ri/config">
<modelfile location="./model.xml.gz"/>
</configuration>
4 j2eeMappingFile,由JSR109定义的J2EE影射信息.这个文件包括在java接口和WSDL定义之间的影射的对应信息.J2EE部署工具使用这个信息和WSDL文件一起为发布的服务和服务引用生成stubs和ties.
配置文件还有三个配置项:
1 添加类型影射,可定义自己的串行化器和反串行化器,提供对JAX-RPC运行时不支持的数据类型的支持.
2 添加处理器
3 添加namespace-to-package影射.这个功能使你指定XML命名空间到java包的影射,也可以指定java包到XML命名空间的影射.
(二) wsdeploy工具
1 工具介绍
这个工具和wscompile协同工作来生成一个能在任何servlet容器中发布的war文件，它授受一个生WAR文件，它包括一个SEI,一个SEI实现,一些值类型，一些服务特定的异常，一个model文件,一个部署描述符(jaxrpc-ri.xml), 和一些可选的其它实现特定的制品.工具处理生的war文件并生成一个实现特定的熟的war文件.这个过程包括生成串行化器，连接(TIEs),运行时描述符以及其它为了成功的发布WS需要的制品. 这个工具也有两种使用形式:批处理和Ant构建脚本.
批的例子:
wsdeploy -o target.war myapp.war
Ant脚本,在Ant中使用这个任务前要先定义：
<taskdef name="wsdeploy" classname="com.sun.xml.rpc.tools.ant.Wsdeploy">
<classpath path="${classpath}"/>
</taskdef>
其中的类路径指向同wscompile相同:
<wsdeploy classpath="xyz.jar" tmpdir="${tmp}" outWarFile="stock.war" inWarFile="stock-raw.war"/>
<wsdeploy keep="true" outWarFile="stock.war" inWarFile="stock-raw.war"><classpath refid="compile.classpath"/></wsdeploy>
<wsdeploy fork="true" source="1.0.3" outWarFile="stock.war" inWarFile="stock-raw.war"></wsdeploy>
2 wscompile的配置文件(部署描述符 jaxrpc-ri.xml)
它被打包在生的WAR文件中，并由wsdeploy工具使用来生成熟的WAR文件.这个描述符提供了wsdeploy工具向web容器中发布WS的信息.
该文件主要是使用endpoint和endpointMapping两个元素来定义端点和服务影射,把SEI及其实现聚集在一起,连同model文件提供给发布工具.
三 编写一个Hello例子
IDE环境:Eclipse,插件sysdeo,发布环境:Tomcat559.
使用类库:Sun公司的参考实现.
|
