Sun ONE Application Server 开发者指南(8)

类别:Java 点击:0 评论:0 推荐:
组装并部署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应用服务器开发人员指南。

本文地址:http://com.8s8s.com/it/it16917.htm