-- 作者:hongjunli
-- 发布时间:5/21/2008 11:31:00 AM
--
应用wscompile 和 wsdeploy 工具,开发,发布,调用Web Service: 1 wscompile可接受两种输入:WSDL和Service Endpoint Interface,输出为可移植制品和model文件. 2 wsdeploy只有一种输入:包括wscompile输入和输出再加上一个部署描述符文件,输出是可发布的特定平台上的web service. 这些工具同Java WSDP一起打包可供使用,java web服务开发包是一个免费的集成工具箱,用它构建,测试,发布XML应用,web服务以及带有最新web服务技术和标准实现的web应用. (一) wscompile工具 1 工具介绍 它生成由JAX-RPC运行时需要的各种客户端和服务端制品以供开发,部署,调用一个Web服务. 这个工具有两种使用形式:批处理和Ant构建脚本. wscompile -gen -classpath lib/foo.jar;lib/bar.jar -d generated config.xml wscompile -gen -f:infix:Name -d generated config.xml wscompile -define -f:nodatabinding -f:novalidation config.xml wscompile -import -f:explicitcontext config.xml Ant脚本,在Ant中使用这个任务前要先定义: < taskdef name="wscompile" classname="com.sun.xml.rpc.tools.ant.Wscompile"> < classpath path="${classpath}"/> 其中的类路径要指向以下档案库: jaxrpc-api.jar jaxrpc-impl.jar jaxrpc-spi.jar saaj-api.jar saaj-impl.jar jaxp-api.jar dom.jar sax.jar xalan.jar xercesImpl.jar activation.jar mail.jar jax-qname.jar namespace.jar xsdlib.jar relaxngDatatype.jar 例子: < wscompile gen="true" base="${build}" features="explicitcontext" classpath="xyz.jar" debug="true" config="config.xml"> < wscompile import="true" keep="true" sourceBase="${source.dir}" base="${build}" model="model.xml.gz" PrintStackTrace="true" config="config.xml"> < classpath refid="compile.classpath"/> < wscompile fork="true" define="true" nonClassDir="${wsdl.dir}" features="documentliteral, useonewayoperations" config="config.xml"/> 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"/> 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"/> 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}"/> 其中的类路径指向同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 fork="true" source="1.0.3" outWarFile="stock.war" inWarFile="stock-raw.war"> 2 wscompile的配置文件(部署描述符 jaxrpc-ri.xml) 它被打包在生的WAR文件中,并由wsdeploy工具使用来生成熟的WAR文件.这个描述符提供了wsdeploy工具向web容器中发布WS的信息. 该文件主要是使用endpoint和endpointMapping两个元素。
|