| 组装并部署JAX-RPC Web服务
JAX-RPC Web服务应用程序能够被组装并且作为一个WAR文件部署到Sun ONE应用服务器上。WAR文件包括了压缩格式下web应用程序所需的文件。
以下步骤讲述了组装和部署Web服务应用程序到Sun ONE应用服务器的过程。
1． 创建WAR文件。为了创建一个包含服务代码的WAR文件，请创建一个build.xml文件，并为目标名称指定create-war命令。以下代码是一个创建WAR文件的示例build.xml文件。
<target name="create-war" depends="compile-server"
description="Packages the WAR file">
<echo message="Creating the WAR...."/>
<delete file="../${portable-war}" />
<delete dir="${assemble}/WEB-INF" />
<copy todir="${assemble}/WEB-INF/classes/">
<fileset dir="${build}/shared/" includes="**/*.class" />
</copy>
<copy file="web.xml" todir="${assemble}/WEB-INF" />
<copy file="jaxrpc-ri.xml" todir="${assemble}/WEB-INF" />
<jar jarfile="${assemble}/${portable-war}" >
<fileset dir="${assemble}" includes="WEB-INF/**" />
</jar>
<move file="${assemble}/${portable-war}" todir="../" /> </target>
当被执行时，这个XML文件把文件打包成一个名为hello-portable.war的WAR文件。这个WAR文件还不能被部署，因为没有包含tie类。WAR（web 应用存档）文件包括了压缩格式下完整的web应用程序。
文件根目录下的一个特定目录WEB-INF中包含了与不在应用程序公共文件树上的应用程序相关的一切。没有任何一个WEB-INF中的文件能够直接服务于客户端。WEB-INF的内容包括：
- /WEB-INF/classes/*，存放servlet和其他类的目录
- /WEB-INF/lib/*.jar， 存放包含bean和其他工具类的JAR文件的目录
- /WEB-INF/web.xml 和 /WEB-INF/sun-web.xml， 基于XML的配置描述文件，其中指定了web应用程序的配置，包括映射、初始化参数、和安全约束。
Web应用程序目录结构符合J2EE规范中描述的结构。
在本例中，hello-portable.war包含以下文件：
- WEB-INF/classes/hello/HelloIF.class
- WEB-INF/classes/hello/HelloImpl.class
- WEB-INF/jaxrpc-ri.xml
- WEB-INF/web.xml
2．定义指定服务名称及其服务终端接口和类的配置文件。配置文件的名称必须是jaxrpc-ri.xml。下面是本例子的配置文件：
<?xml version="1.0" encoding="UTF-8"?>
<webServices
xmlns="http://java.sun.com/xml/ns/jax-rpc/ri/dd"
version="1.0"
targetNamespaceBase="http://hello.org/wsdl"
typeNamespaceBase="http://hello.org/types"
urlPatternBase="/ws">
<endpoint
name="HelloWorld"
displayName="HelloWorld Service"
description="A simple web service"
interface="samples.webservices.jaxrpc.simple.HelloIF"
implementation="samples.webservices.jaxrpc.simple. HelloImpl"/>
<endpointMapping
endpointName="HelloWorld"
urlPattern="/simple"/>
</webServices>
配置文件包含了以下web服务属性：
- Web服务元素，包括名称、类型命名空间、和目标命名空间属性。
- 名称属性用来生成在公共注册中心发布的WSDL文件。
- 类型命名空间属性为wscompile工具生成的类型在WSDL文件内定义了命名空间。
- 目标命名空间属性用来限定WSDL文件中的任何其他东西。
关于用于创建运行时配置文件的XML schema的信息，请参见"XML Schema定义".
3． 创建web.xml配置描述文件，其中包含了部署服务所需的信息，例如服务到URL的映射、指定WAR文件中配置文件的位置等等。
想要了解关于配置描述文件的更多信息，请参见Sun ONE应用服务器开发人员指南。
关于DTD文件以及XML的基本信息，请参考XML规范，位于：
http://www.w3.org/TR/REC-xml
下面是本例的配置描述文件：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
<display-name>Hello World Application</display-name>
<description>A web application containing a simple JAX-RPC endpoint</description>
<session-config>
<session-timeout>60</session-timeout>
</session-config>
</web-app>
关于用于创建运行时配置文件的XML schema的信息，请参见"XML Schema定义".
Web服务应用程序拥有一个目录结构，通过到应用程序文件根目录的映射 (例如, /hello)，整个结构都能够被访问。
4． 使用wsdeploy工具创建可部署的WAR模块。Wsdeploy工具执行wscompile工具来生成stub、tie类、以及其他必要的类。
wsdeploy -keep tmpdir tempdir -o hello.war hello-portable.war
当wsdeploy命令被执行时，完成了以下任务：
- 读取hello-portable.war作为输入。
- 从hello-portable.war文件里的jaxrpc-ri.xml文件中获得信息。
- 为服务生成tie类。
- 生成名为HelloWorld.wsdl的WSDL文件。
- 组装tie类，HelloWorld.wsdl文件、和hello-portable.war文件的内容，形成一个可部署的WAR文件。
关于使用wsdeploy命令行工具的信息，请参见"wsdeploy工具"，
5． 使用asadmin部署命令部署WAR模块。
例如，
asadmin> deploy --user admin --password admin --host localhost --port 4848 --type web --instance server1 /sun/appserver7/samples/webservices/jaxrpc/simple/Hello.war
关于使用asadmin命令行工具的更多信息，请参见Sun ONE应用服务器开发人员指南。 
|
本类阅读TOP10