web service

/*title:   web   service入门学习笔记
**date:   2007/01/16
**author:laomai
**url:   http://blog.csdn.net/laomai/
*/
web   service入门学习笔记
最近要做一个java项目，里面用到了webservice技术，
经过一个多月的磕磕绊绊的摸索，总算如了点门。现将我的学习笔记贴出来，供大家参考。

说明，本笔记第七部分主要参考了  
http://blog.csdn.net/lin_bei/archive/2006/11/07/1371131.aspx
的内容，由于这位兄弟翻译的不是很通顺，我就按照自己的理解来改编成了
hellowrold的例子:-)。
其他部分为我原创，转载时请注明出处。

一、实验环境
  win2k   +   jdk1.6     +   javee5.0     +   Myeclipse5.1
jdk和javee5.0均可从
http://java.sun.com/javase/downloads/index.jsp
下载，安装文件名为
jdk-6-windows-i586.exe
java_ee_sdk-5_02-windows.exe
没有myeclipse的也可以用eclipse代替，只要ide能执行
ant脚本就可以.

/*title:   web   service入门学习笔记（二）
**date:   2007/01/16
**author:laomai
**url:   http://blog.csdn.net/laomai/
*/
 
二、第一个最简单的例子
jsee5安装以后会在系统中建立一个Application   Server   pe9，这是sun自带的网络服务器，
和tomcat、weblogic的性质类似。
在D:\Sun\SDK\samples\javaee5\webservices\hello-jaxws下有一个自带的web   service入门例子,
(D:\Sun\SDK\为我机器上javaee5的安装路径)
我们就先实验它，来理解webservice的本质
1、把jdk的安装路径如D:\Java\jdk1.6.0\bin   加到系统的path环境变量中
2、运行sun自带的网络服务器，具体方法为
        开始-> 程序-> Sun   Microsystems-> Application   Server   PE   9-> Start   Default   Server
        然后当弹出的cmd窗口中出现提示“按任意键继续时”输入回车，窗口会关闭，此时在浏览器输入
        http://localhost:8080,应该出现如下内容：
              Sun   Java   System   Application   Server   Platform   Edition   9.0    
Your   server   is   up   and   running!

说明服务器已经启动了

3、在Myeclipse打开刚才的例子目录D:\Sun\SDK\samples\javaee5\webservices\hello-jaxws
下的build.xml文件，这个一个ant脚本，具体含义我们以后再讲，现在先执行它
3、在build.xml文件中单击右键，在弹出菜单中选择 "run   as "-> "1   ant   build "，此时build.xml里的
内容会被执行，在Myeclipse的console中会输出:
buildfile:   D:\Sun\SDK\samples\javaee5\webservices\hello-jaxws\build.xml
init:
compile-deploy-service:
          [echo]   d:/Sun/SDK
get-artifacts-windows:
get-artifacts-unix:
get-artifacts:
compile-client:
        [javac]   Compiling   1   source   file   to   D:\Sun\SDK\samples\javaee5\webservices\hello-jaxws\build
run-client-windows:
          [exec]   Hello   result   =   Hello   Administrator!
run-client-unix:
run-client:
all:
BUILD   SUCCESSFUL
Total   time:   43   seconds

其中
[exec]   Hello   result   =   Hello   Administrator!
的输出结果说明客户端调用服务器的webservice已经成功。
第一个例子就完成了。我们下面会对这个例子进行详细讲解.

/*title:   web   service入门学习笔记（三）、（四）
**date:   2007/01/16
**author:laomai
**url:   http://blog.csdn.net/laomai/
*/

三、WebService的本质
从搞c的程序员的眼光来看，webservice实际上就是用java实现的rpc(远端过程调用)，
或者说是dll的变形。服务器把它的接口对外发布成一个wsdl文件，客户端根据这个wsdl的内容生成
本地的代理类，再通过代理类调用远端的接口，代理再把接口的执行执行结果回传给客户端，
进行下一步处理。
 
 
 
四、例子源代码剖析
D:\Sun\SDK\samples\javaee5\webservices\hello-jaxws（以后简称为hello-jaxws）
项目里的源文件只有三个  
hello-jaxws\src\endpoint\Hello.java       提供webservice的服务器端实现类
hello-jaxws\src\client\Client.java         调用webservice的客户端测试类
hello-jaxws\build.xml                                   自动编译的ant脚本

下面我们把这三个文件的内容看一下
1、服务器端的service实现类文件Hello.java，
/*   src\endpoint\Hello.java文件的内容   */
package   endpoint;
import   javax.jws.WebService;

@WebService
public   class   Hello
{
      public   String   getHello(String   name)
        {
                return   "Hello   "   +   name   +   "! ";
        }
}

有这个文件可以看出，编写一个service的实现类，把编写普通的java类
差不多，只不过又多了三点
①要在该类前一个@WebService说明，
②引入javax.jws.WebService;
③在公开的方法前加@WebMethod说明，如果不加的话，
所有的public方法都会自动变成service的对外接口.

2、客户端测试类的实现文件
/*   src\client\Client.java文件的内容   */
package   client;
import   javax.xml.ws.WebServiceRef;
import   endpoint.HelloService;
import   endpoint.Hello;

public   class   Client
{
        @WebServiceRef(wsdlLocation= "http://localhost:8080/Hello/HelloService?WSDL ")
        static   HelloService   service;
       
        public   static   void   main(String[]   args)
        {
                Client   client   =   new   Client();
                client.doHello();
        }
       
        public   void   doHello()
        {
                try
                {
                        Hello   port   =   service.getHelloPort();
                        String   ret   =   port.getHello(System.getProperty( "user.name "));
                        System.out.println( "Hello   result   =   "   +   ret);
                }
                catch(Exception   e)
                {
                        e.printStackTrace();
                }
        }
}
客户端调用代码要点为:
①导入WebServiceRef包
import   javax.xml.ws.WebServiceRef;
②导入本地生成的stub类，另外编译时也要指明stub类的路径
import   endpoint.HelloService;
import   endpoint.Hello;
③指明服务器的wsdl路径
@WebServiceRef(wsdlLocation= "http://localhost:8080/myhello/HelloService?WSDL ")
④声明一个静态的service对象
static   HelloService   service;
⑤对要调用的远程方法声明一个代理对象，通过代理来调用真正的远程方法
Hello   port   =   service.getHelloPort();
        String   ret   =   port.getHello(System.getProperty( "user.name "));

3、ant   脚本build.xml
<!--   ant   脚本build.xml的内容   -->
<?xml   version= "1.0 "   encoding= "UTF-8 "?>
<project   name= "hello-jaxws "   default= "all "   basedir= ". ">
        <!--   include   user   specific   build   properties   -->

<!--   导入预先j2ee预先写好的设置文件-->
        <property   file= "../../../bp-project/build.properties "/>
        <property   file= "${user.home}/build.properties "/>
        <property   file= "../../../bp-project/app-server.properties "/>
       
        <!--   设置发布目录和类的输出目录   -->
        <property   name= "autodeploydir "   value= "${javaee.domaindir}/autodeploy "/>
        <property   name= "classesdir "   value= "./build "/>

<!--   设置java的类库路径   -->
        <path   id= "classpath ">
                <pathelement   location= "${javaee.home}/lib/j2ee.jar "/>
                <pathelement   location= "${classesdir} "/>
        </path>
       
        <!--   项目的最终任务   -->
        <target   name= "all "   depends= "run-client ">
                <!--antcall   target= "restore "/-->
        </target>

<!--   测试操作系统环境-->
        <target   name= "init ">
                <condition   property= "windows ">
                        <os   family= "windows "   />  
                </condition>
                <condition   property= "unix ">
                        <os   family= "unix "   />  
                </condition>
        </target>

<!--   编译服务器端并把它自动发布到sun的服务器上   -->
        <target   name= "compile-deploy-service "   depends= "init ">
                <mkdir   dir= "${classesdir} "/>
                <echo   message= "${javaee.home} "/>
                <javac  
                        srcdir= "./src "  
                        includes= "endpoint/** "
                        destdir= "${autodeploydir} "
                        classpath= "${javaee.home}/lib/j2ee.jar "  
                />
                <waitfor   maxwait= "100 "   maxwaitunit= "second ">
                      <or>
                                <available   file= "${autodeploydir}/endpoint/Hello.class_deployed "/>
                                <available   file= "${autodeploydir}/endpoint/Hello.class_deployFailed "/>
                      </or>
                </waitfor>
                <condition   property= "deploy_succeeded ">
                                <available   file= "${autodeploydir}/endpoint/Hello.class_deployed "/>
                </condition>
                <condition   property= "deploy_failed ">
                                <available   file= "${autodeploydir}/endpoint/Hello.class_deployFailed "/>
                </condition>
        </target>

        <target   name= "get-artifacts "   depends= "compile-deploy-service,get-artifacts-windows,get-artifacts-unix "/>

<!--   生成客户端所需的stub   -->
        <target   name= "get-artifacts-windows "   if= "windows ">
                <exec   executable= "${javaee.home}/bin/wsimport.bat ">
                        <arg   line= "-keep   -d   ${classesdir}   http://${javaee.server.name}:${javaee.server.port}/Hello/HelloService?WSDL "/>
                </exec>
        </target>

        <target   name= "get-artifacts-unix "   if= "unix ">
                <exec   executable= "${javaee.home}/bin/wsimport ">
                        <arg   line= "-keep   -d   ${classesdir}   http://${javaee.server.name}:${javaee.server.port}/Hello/HelloService?WSDL "/>
                </exec>
        </target>

    <!--   编译客户端   -->
        <target   name= "compile-client "   depends= "get-artifacts ">
                <javac   srcdir= "./src/client "   destdir= "${classesdir} ">
                        <classpath   refid= "classpath "/>
                </javac>
        </target>
       
       
        <target   name= "run-client "   depends= "compile-client,run-client-windows,run-client-unix "/>

<!--   执行客户端   -->
        <target   name= "run-client-windows "   if= "windows ">
                <exec   executable= "${javaee.home}/bin/appclient.bat "   dir= "${classesdir} ">
                        <arg   value= "client.Client "/>        
                </exec>        
        </target>

        <target   name= "run-client-unix "   if= "unix ">  
                <exec   executable= "${javaee.home}/bin/appclient "   dir= "${classesdir} "   failifexecutionfails= "false ">
                        <arg   value= "client.Client "/>        
                </exec>        
        </target>
       
        <!--   以下几个任务用与清理和卸载-->
        <!--   删除生成的类文件-->
        <target   name= "clean ">
        <delete   dir= "${classesdir} "/>
        </target>

<!--   删除和卸载服务器的webservice-->
        <target   name= "restore ">
                <delete>
                <fileset   dir= "${autodeploydir}/endpoint "   includes= "Hello*.* "/>
                </delete>
        </target>

        <target   name= "undeploy ">
                <antcall   target= "restore "/>
        </target>
</project>

这个脚本有许多在windows平台用不到的步骤，下面我们对其进行改造，把它精简一下.

/*title:   web   service入门学习笔记（五）
**date:   2007/01/18
**author:laomai
**url:   http://blog.csdn.net/laomai/
*/
 
五、精简后的ant脚本
1、卸载webservice
执行原build.xml里的clean和 undeploy任务，把安装好的webservice删除掉，具体办法为：
(1)在myeclipse里打开build.xml文件
(2)在build.xml文件里单击右键菜单中的 " "run   as "-> "2   ant   build... " ",
(3)在弹出的对话框中只选择clean和undelpoy任务。 然后单击 "run "按钮。
此时再访问http://localhost:8080/Hello/HelloService?WSDL,出现http   404错误，说明卸载成功

2、简化后的脚本内容，在hello-jaxws目录下新建一个buildtest.xml文件，内容为
<?xml   version= "1.0 "   encoding= "UTF-8 "?>
<project   name= "hello-jaxws "   default= "all "   basedir= ". ">
<!--   javaee安装目录的设置，代替了原来脚本中的导入语句   -->
<property   name= "javaee.home "   value   =   "d:/Sun/SDK "/>
<property   name= "javaee.domaindir "   value= "${javaee.home}/domains/domain1 "/>
<property   name= "javaee.server.name "   value= "localhost "/>
<property   name= "javaee.server.port "   value= "8080 "/>

  <!--   设置发布目录和类的输出目录   -->
<property   name= "autodeploydir "   value= "${javaee.domaindir}/autodeploy "/>
<property   name= "classesdir "   value= "./build "/>        

<!--   设置java类库路径   -->
<path   id= "classpath ">
<pathelement   location= "${javaee.home}/lib/j2ee.jar "/>
<pathelement   location= "${classesdir} "/>
</path>

<target   name= "all "   depends= "run-client ">
<!--antcall   target= "restore "/-->
</target>

<target   name= "run-client "   depends= "compile-client,run-client-windows "   />

<!--   运行测试类，为项目的最后一个步骤-->
<target   name= "run-client-windows ">
<exec   executable= "${javaee.home}/bin/appclient.bat "   dir= "${classesdir} ">
<arg   value= "client.Client "   />
</exec>
</target>

<!--   编译测试webservice的客户类,为项目的第三个步骤，本步骤的输出文件为
${classesdir}/client/Client.class
-->

<target   name= "compile-client "   depends= "get-artifacts ">
<javac   srcdir= "./src/client "   destdir= "${classesdir} ">
<classpath   refid= "classpath "   />
</javac>
</target>

<target   name= "get-artifacts "   depends= "compile-deploy-service,get-artifacts-windows "/>

<!--   本步骤的目的是生成客户端的stub文件，是项目的第二个步骤，本步骤的输出文件为
在${classesdir}下面自动生成了如下的文件
GetHello.java
GetHelloResponse.java
Hello.java
HelloService.java
ObjectFactory.java
package-info.java
package-info.class
GetHello.class
GetHelloResponse.class
Hello.class
HelloService.class
ObjectFactory.class
-->
<target   name= "get-artifacts-windows ">
<exec   executable= "${javaee.home}/bin/wsimport.bat ">
<arg   line= "-keep   -d   ${classesdir}   http://${javaee.server.name}:${javaee.server.port}/Hello/HelloService?WSDL "   />
</exec>
</target>

<!--   本步骤的目的是编译服务器类，并自动产生wsdl.是项目的第一个步骤，本步骤的主要输出文件为
${autodeploydir}\endpoint\Hello.class
${autodeploydir}\domain1\autodeploy\endpoint\Hello.class_deployed

在d:\Sun\SDK\domains\domain1\applications\j2ee-modules
下建立一个endpoint_Hello目录，

在d:\Sun\SDK\domains\domain1\generated\ejb\j2ee-modules建立一个
endpoint_Hello目录，这个目录下又建立了一个endpoint\jaxws目录，里面有如下内容
GetHello.java
GetHelloResponse.java
GetHello.class
GetHelloResponse.class

在D:\Sun\SDK\domains\domain1\generated\xml\j2ee-modules\下建立一个
endpoint_Hello目录，这个目录下又有一个WEB-INF子目录，内容为
wsdl子目录

sun-web.xml     文件
web.xml             文件
webservices.xml     文件
wsdl子目录下又有两个文件
HelloService.wsdl
HelloService_schema1.xsd
当我们在浏览器输入http://localhost:8080/Hello/HelloService?WSDL时，显示的正是
这个domains\domain1\generated\xml\j2ee-modules\endpoint_Hello\WEB-INF\wsdl
文件的内容
-->

<target   name= "compile-deploy-service ">
<mkdir   dir= "${classesdir} "   />
<echo   message= "${javaee.home} "   />
<javac  
                        srcdir= "./src "  
                        includes= "endpoint/** "                      
                        destdir= "${autodeploydir} "          
                        classpath= "${javaee.home}/lib/j2ee.jar "  
                />
<waitfor   maxwait= "100 "   maxwaitunit= "second ">
<or>
<available   file= "${autodeploydir}/endpoint/Hello.class_deployed "/>
<available   file= "${autodeploydir}/endpoint/Hello.class_deployFailed "/>
</or>
</waitfor>
<condition   property= "deploy_succeeded ">
<available   file= "${autodeploydir}/endpoint/Hello.class_deployed "/>
</condition>
<condition   property= "deploy_failed ">
<available   file= "${autodeploydir}/endpoint/Hello.class_deployFailed "/>
</condition>
</target>

<!--   以下的任务用于清理和卸载-->
<target   name= "clean ">
<delete   dir= "${classesdir} "/>
</target>

<target   name= "restore ">
<delete>
<fileset   dir= "${autodeploydir}/endpoint "   includes= "Hello*.* "/>
</delete>
</target>

<target   name= "undeploy ">
<antcall   target= "restore "/>
</target>
</project>

3、运行结果
在myeclipse里执行这个刚才编写的buildtest.xml脚本，console里的输出为
Buildfile:   D:\Sun\SDK\samples\javaee5\webservices\hello-jaxws\buildtest.xml
compile-deploy-service:
        [mkdir]   Created   dir:   D:\Sun\SDK\samples\javaee5\webservices\hello-jaxws\build
          [echo]   d:/Sun/SDK
        [javac]   Compiling   1   source   file   to   D:\Sun\SDK\domains\domain1\autodeploy
get-artifacts-windows:
get-artifacts:
compile-client:
        [javac]   Compiling   1   source   file   to   D:\Sun\SDK\samples\javaee5\webservices\hello-jaxws\build
run-client-windows:
          [exec]   Hello   result   =   Hello   Administrator!
run-client:
all:
BUILD   SUCCESSFUL
Total   time:   50   seconds

也执行成功
 
 
/*title:   web   service入门学习笔记（六）
**date:   2007/01/19
**author:laomai
**url:   http://blog.csdn.net/laomai/
*/

六、一个通用的ant脚本
1、脚本内容
  上面的buildtest.xml脚本虽然对原始的build.xml做了精简，但是还不够通用，
比如服务器的类名和方法名等等都写死了，显然还不适合我们的需要，于是我又写了一个相对通用的脚本
mybuild.xml，内容如下
<?xml   version= "1.0 "   encoding= "UTF-8 "?>

<project   name= "hello-jaxws "   default= "all "   basedir= ". ">
<!--   javaee安装目录的设置，代替了原来脚本中的导入语句   -->
<property   name= "javaee.home "   value   =   "d:/Sun/SDK "/>
<property   name= "javaee.domaindir "   value= "${javaee.home}/domains/domain1 "/>
<property   name= "javaee.server.name "   value= "localhost "/>
<property   name= "javaee.server.port "   value= "8080 "/>

<!--   设置发布目录和类的输出目录   -->
<property   name= "autodeploydir "   value= "${javaee.domaindir}/autodeploy "/>
<property   name= "classesdir "   value= "./build "/>

<!--   设置java类库路径   -->
<path   id= "classpath ">
<pathelement   location= "${javaee.home}/lib/j2ee.jar "/>
<pathelement   location= "${classesdir} "/>
</path>

<!--   提供服务的类名   -->
<property   name= "serviceclass "   value= "Hello "   />
<property   name= "serverclasspath "   value= "endpoint "   /> <!--   服务器所在的package名称
也就是Hello.java文件中第一句
package   endpoint;语句中的endpoint
-->
<!--   调用webservice的测试类名-->
<property   name   =   "clientclass "   value= "Client "/>
<property   name   =   "clientclasspath "   value= "client "/> <!--   测试类所在的package名称，
          也就是Client.java文件中第一句
        package   client;语句中的client;
        -->
<!--   生成的wsdl文件的uri的格式,注意value的值分成两行写时有问题，  
这里为了阅读方便而分行，拷贝时必须放到一行
我还没找到ant脚本里的续行符是什么:-(  
-->
<property   name= "wsdluri "  
    value= "http://${javaee.server.name}:${javaee.server.port}
    /${serviceclass}/${serviceclass}Service?WSDL "   />

<target   name= "all "   depends= "run-client ">
<!--   antcall   target= "restore "/   -->
</target>

<target   name= "run-client "   depends= "compile-client,run-client-windows "   />

<!--   运行测试类，为项目的最后一个步骤-->
<target   name= "run-client-windows ">
<exec   executable= "${javaee.home}/bin/appclient.bat "   dir= "${classesdir} ">
<arg   value= "${clientclasspath}.${clientclass} "   />
</exec>
</target>

<!--   编译测试webservice的客户类,为项目的第三个步骤，本步骤的输出文件为
${classesdir}/client/Client.class
-->

<target   name= "compile-client "   depends= "get-artifacts ">
<javac   srcdir= "./src/${clientclasspath} "   destdir= "${classesdir} ">
<classpath   refid= "classpath "   />
</javac>
</target>

<target   name= "get-artifacts "   depends= "compile-deploy- ②asadmin   deploy   --user   admin   --password   laomailaomai   --host   localhost   --port   4848   --contextroot   hello   --upload=true   --target   server
service,get-artifacts-windows "/>

<!--   生成客户端的stub类   -->
<target   name= "get-artifacts-windows ">
<exec   executable= "${javaee.home}/bin/wsimport.bat ">
<arg   line= "-keep   -d   ${classesdir}   ${wsdluri} "   />
</exec>
</target>

<!--   本步骤的目的是编译服务器类，并自动产生wsdl文件-->
<target   name= "compile-deploy-service ">
<echo   message= "${javaee.home} "   />
<javac  
                        srcdir= "./src "  
                        includes= "${serverclasspath}/** "                      
                        destdir= "${autodeploydir} "          
                        classpath= "${javaee.home}/lib/j2ee.jar "  
                />
<waitfor   maxwait= "100 "   maxwaitunit= "second ">
<or>
<available   file= "${autodeploydir}/${serverclasspath}/${serviceclass}.class_deployed "/>
<available   file= "${autodeploydir}/${serverclasspath}/${serviceclass}.class_deployFailed "/>
</or>
</waitfor>
<condition   property= "deploy_succeeded ">
<available   file= "${autodeploydir}/${serverclasspath}/${serviceclass}.class_deployed "/>
</condition>
<condition   property= "deploy_failed ">
<available   file= "${autodeploydir}/${serverclasspath}/${serviceclass}.class_deployFailed "/>
</condition>
</target>

<!--   以下的任务用于清理和卸载-->
<target   name= "clean ">
<delete   dir= "${autodeploydir}/${serverclasspath} "/>
<delete   dir= "${classesdir}/${serverclasspath} "/>
<delete   dir= "${classesdir}/${clientclasspath} "/>
</target>
</project>

2、脚本的使用方式
以后再写自己service时，只要按实际情况改变以下4条语句中的value值就可以了
<property   name= "serviceclass "   value= "Hello "   />    
<property   name= "serverclasspath "   value= "endpoint "   />
<property   name   =   "clientclass "   value= "Client "/>
<property   name   =   "clientclasspath "   value= "client "/>

/*title:   web   service入门学习笔记（七）
**date:   2007/01/19
**author:laomai
**url:   http://blog.csdn.net/laomai/
*/
 
 
七、命令行开发过程
      通过以上的学习，我们知道如何在ant脚本和ide环境中开发一个简单的webservice.
但是作为搞技术的人特别是搞c的人来看，上面的过程隐藏了太多的东西，
对我们有钻研精神的人，自然就想搞清楚脚本背后的过程。
假设我们的机器上没有ide环境和ant工具，
我们如何“手工”编译出自己的webservice呢？
这就是本节要讲述的内容--只用命令行工具开发webservice.

0、设置环境变量
把jdk和javaee的路径如
D:\Java\jdk1.6.0
D:\Sun\SDK\bin加到系统的path变量中去

1、建立项目目录
首先建立一个项目的目录，名为WebTest，项目目录下又包含三个子目录
  src\             本目录用于存放源代码，
  build\         本目录用于存放输出的文件
  deploy\       本目录用于对服务器打包
   
2、编写服务器类实现文件
在项目的src目录下建立一个个子目录endpoint，
在这个endpoint子目录下新建一个Hello.java文件，内容如下

/*src\endpoint\Hello.java文件      
提供webservice的服务器端实现类
*/
package   endpoint;
 
import   javax.jws.WebService;
import   javax.jws.WebMethod;
 
@WebService
public   class   Hello
{
@WebMethod
        public   String   getHello(String   name)
      {
                return   "Hello   "   +   name   +   "! ";
        }
  }
3、编译服务器类
①在build目录下建立一个子目录classes
    ②在命令行执行如下命令
    cd   WebTest     ;进入项目目录
    javac   -classpath   d:/Sun/SDK/lib/javaee.jar   -d   ./build/classes   src/endpoint/Hello.java     ;编译服务器类
    执行完后会产生一个build\classes\endpoint\Hello.class文件
   
4、生成wsdl文件
①在build目录下建立一个子目录generated
②生成wsdl文件,执行
wsgen   -cp   ./build/classes   -keep   -d   ./build/classes   -r   ./build/generated   -wsdl     endpoint.Hello

执行完成会在./build/generated产生两个文件
HelloService.wsdl
HelloService_schema1.xsd
并且在\build\class\endpoint下建立一个jaxws目录，下面有4个文件
GetHello.java                                                
GetHello.class
GetHelloResponse.java
GetHelloResponse.class

这些文件与与前面所说的ant脚本中生成的
D:\Sun\SDK\domains\domain1\generated\ejb\j2ee-modules\endpoint_Hello\endpoint\jaxws
下的文件相同

5、将服务器打包，做成war文件
①建立打包所需要的目录
      在项目的deploy目录下建立一个子目录/WEB-INF，
    WEB-INF子目录下再建立两个子目录
    classes/     用于存放服务器端类
    wsdl/           用于存放wsdl文件

②将各输出文件或目录拷贝到相应的目录下
(1)把build\classes\endpoint整个目录拷贝到deploy/WEB-INF/class目录下
(2)把build\generated目录下的两个文件
HelloService.wsdl、HelloService_schema1.xsd拷贝到
deploy/WEB-INF/wsdl目录下
③在deploy/WEB-INF/   目录下新建一个web.xml文件，内容为
<?xml   version= "1.0 "   encoding= "UTF-8 "?>
<web-app   xmlns= "http://java.sun.com/xml/ns/javaee "
xmlns:j2ee= "http://java.sun.com/xml/ns/javaee "
xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance "   version= "2.5 "
xsi:schemaLocation= "http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd ">
<description> WebTier   for   the   Hello   Service </description>
<display-name> HelloWAR </display-name>
<servlet>
<description> Endpoint   for   Hello   Web   Service </description>
<display-name> HelloWebService </display-name>
<servlet-name> Hello </servlet-name>
<servlet-class> endpoint.Hello </servlet-class>
<load-on-startup> 0 </load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name> Hello </servlet-name>
<url-pattern> /HelloService </url-pattern>
</servlet-mapping>
<session-config>
<session-timeout> 54 </session-timeout>
</session-config>
</web-app>
④将service打包,执行
(1)cd   WebTest\deploy     ;进入打包目录
(2)jar   cvf   hello.war   *     ;将当前目录下的所有内容打包到hello.war文件中
 
将service 类发布到网络服务器上
①启动sun   服务器
方法为
开始-> 程序-> Sun   Microsystems-> Application   Server   PE   9-> Start   Default   Server
②在项目目录下建立一个passwd文件，内容是sun服务器admin用户的密码，例如
AS_ADMIN_PASSWORD=testtesttest
③将hello.war发布到服务器上，执行
(1)cd   WebTest     ;进入项目目录
(2)发布服务器包，注意这个命令是在一行执行的，
我为了书写方便而断行。分号后面是注释
asadmin   deploy  
--user   admin                           ;管理员用户名
--passwordfile   passwd         ;密码文件名，就是我们刚才写的passwd文件
--host   localhost                  
--port   4848     ;管理端口号
--contextroot   myhello     ;上下文根名称
--upload=true    
--target   server
deploy/hello.war

④在浏览器中输入地址
http://localhost:8080/myhello/HelloService?WSDL，
如果浏览器能显示出正确的内容，就说明成功。

7、生成客户端的stub类
①在项目的build\classes目录下建立一个stub子目录
②执行
(1)cd   WebTest       ;进入项目子目录
(2)wsimport   -keep   -d   ./build/classes/stub   http://localhost:8080/myhello/HelloService?WSDL

执行完成后会在build/classes/stub下建立一个endpoint目录，下面有这些文件
GetHello.java
GetHelloResponse.java
Hello.java
HelloService.java
GetHello.class
GetHelloResponse.class
Hello.class
HelloService.class
ObjectFactory.class
ObjectFactory.java
package-info.java
package-info.class
这些文件和ant脚本中import执行的结果一样

8、编写客户端测试程序
在项目的src目录下建立一个子目录client，在这个目录下面建立一个
Client.java文件，内容为

//   src\client\Client.java文件   调用服务器提供的webservice的测试类  
package   client;

import   javax.xml.ws.WebServiceRef;
import   endpoint.HelloService;
import   endpoint.Hello;

public   class   Client
{
        @WebServiceRef(wsdlLocation= "http://localhost:8080/myhello/HelloService?WSDL ")
        static   HelloService   service;
public   static   void   main(String[]   args)
        {
                Client   client   =   new   Client();
                client.doHello();
        }
                public   void   doHello()
        {
                try
                {
                        Hello   port   =   service.getHelloPort();
                        String   ret   =   port.getHello(System.getProperty( "user.name "));
                        System.out.println( "Hello   result   =   "   +   ret);
                }
                catch(Exception   e)
                {
                        e.printStackTrace();
                }
        }
}

9、编译客户端程序
执行
(1)cd   WebTest     ;进入项目目录
(2)javac   -classpath   ./build/classes/stub;d:/Sun/SDK/lib/javaee.jar;d:/Sun/SDK/lib/appserv-ws.jar   -d   ./build/classes/stub   src/client/Client.java    
执行成功后会在F:\exercise\java\WebTest\build\classes目录下建立一个
client目录，下面有一个Client.class文件

10、运行客户端程序
(1)cd   WebTest\build\classes\stub     ;进入client的上级目录
(2)set     APPCPATH=.           ;设置环境变量APPCPATH，不然运行appclient程序时会出一堆莫名奇妙的错误
(3)> appclient   client.Client运行测试程序，结果为
Hello   result   =   Hello   Administrator!
执行成功
 
/*title:   web   service入门学习笔记（八）
**date:   2007/01/19
**author:laomai
**url:   http://blog.csdn.net/laomai/
*/

八、小结
开发webservice的基本步骤为
1、编写服务器端，要点有
①导入WebService包和WebMethod包
import   javax.jws.WebService;
import   javax.jws.WebMethod;
②实现的服务类前加@WebService符号
③为了代码清晰,类提供的公开方法前加@WebMethod符号,这个不写对编译也没影响，

2、编译服务器端，要点为
①javac命令的classpath选项中要有javaee.jar的路径，如
javac   -classpath   d:/Sun/SDK/lib/javaee.jar   -d   ./build   src/endpoint/Hello.java
②用wsgen命令生成wsdl文件.
③将服务器端打包
注意如果是sun的服务器，那么把service类直接编译到
javaee5安装目录\domains\domain1\autodeploy下，可以自动完成②和③的工作。
我们介绍的sun自带的入门脚本就是这么做的。
3、在客户端机器上自动生成stub类,要点为
①客户机上必须也装有jdk和javaee5
②用wsimport工具将服务器传过来的wsdl文件转换成本地的stub类
4、编写客户端调用代码，要点:
①导入WebServiceRef包
import   javax.xml.ws.WebServiceRef;
②导入本地生成的stub类，如
import   endpoint.HelloService;
import   endpoint.Hello;
③指明服务器的wsdl路径
@WebServiceRef(wsdlLocation= "http://localhost:8080/myhello/HelloService?WSDL ")
④声明一个静态的service对象
static   HelloService   service;
⑤对要调用的远程方法声明一个代理对象，通过代理来调用真正的远程方法
Hello   port   =   service.getHelloPort();
        String   ret   =   port.getHello(System.getProperty( "user.name "));
5、编译客户端调用程序，注意classpath参数中要有
①stub类的路径
②javaee.jar的路径
③appserv-ws.jar的路径

6、用appclient执行客户端程序，要点为
①进入到客户端程序的上级目录
②把APPCPATH的值设置为当前目录 "   .   "
③appclient的第一个参数为客户端程序名，
    后面的参数是传给客户端程序本身的命令行参数。

/*title:   web   service入门学习笔记（九）
**date:   2007/01/19
**author:laomai
**url:   http://blog.csdn.net/laomai/
*/

九、本文中用到的文件
1、WebTest项目文件列表
WebTest\passwd 保存密码的文件，手工建立
WebTest\src   子目录   手工建立，内容为
endpoint\Hello.java     服务器类的实现文件
client\Client.java       客户类的实现文件
WebTest\build
generated   子目录,手工建立，内容为
HelloService.wsdl 由wsgen命令生成
HelloService_schema1.xsd   由wsgen命令生成
classes   子目录,手工建立，内容为
endpoint\Hello.class     由javac命令生成
endpoint\jaxws子目录，由wsgen命令自动生成，内容为
GetHello.java
GetHelloResponse.java
GetHello.class
GetHelloResponse.class
stub   子目录，手工建立，内容为:
client\Client.class   由javac命令生成
endpoint   子目录   由wsimport命令自动生成，内容为:
GetHello.java
GetHelloResponse.java
Hello.java
HelloService.java
ObjectFactory.java
package-info.java
package-info.class
GetHello.class
GetHelloResponse.class
Hello.class
HelloService.class
ObjectFactory.class
WebTest\deploy子目录   手工建立，内容为
hello.war   将WEB-INF子目录打包后生成的文件，由jar命令生成
WEB-INF       打包的输入目录，手工建立。内容包括：
web.xml       手工建立
classes\endpoint子目录   为build\classes\endpoint的拷贝
wsdl子目录，由build\generated拷贝而来

2、生成的HelloService.wsdl文件的内容
<?xml   version= "1.0 "   encoding= "UTF-8 "   standalone= "yes "?>
<definitions   targetNamespace= "http://endpoint/ "   name= "HelloService "   xmlns= "http://schemas.xmlsoap.org/wsdl/ "   xmlns:tns= "http://endpoint/ "   xmlns:xsd= "http://www.w3.org/2001/XMLSchema "   xmlns:soap= "http://schemas.xmlsoap.org/wsdl/soap/ ">
    <types>
        <xsd:schema>
            <xsd:import   namespace= "http://endpoint/ "   schemaLocation= "HelloService_schema1.xsd "/>
        </xsd:schema>
    </types>
    <message   name= "getHello ">
        <part   name= "parameters "   element= "tns:getHello "/>
    </message>
    <message   name= "getHelloResponse ">
        <part   name= "parameters "   element= "tns:getHelloResponse "/>
    </message>
    <portType   name= "Hello ">
        <operation   name= "getHello ">
            <input   message= "tns:getHello "/>
            <output   message= "tns:getHelloResponse "/>
        </operation>
    </portType>
    <binding   name= "HelloPortBinding "   type= "tns:Hello ">
        <soap:binding   transport= "http://schemas.xmlsoap.org/soap/http "   style= "document "/>
        <operation   name= "getHello ">
            <soap:operation   soapAction= " "/>
            <input>
                <soap:body   use= "literal "/>
            </input>
            <output>
                <soap:body   use= "literal "/>
            </output>
        </operation>
    </binding>
    <service   name= "HelloService ">
        <port   name= "HelloPort "   binding= "tns:HelloPortBinding ">
            <soap:address   location= "REPLACE_WITH_ACTUAL_URL "/>
        </port>
    </service>
</definitions>

十、致谢
在学习WebService的过程中，我得到了csdn   java版的叶锋城朋友的许多指点，
饼子堂的兄弟们也给了很多有用的资料，这里一并表示谢意。本文也算是我给这些
朋友们的一个汇报和总结，呵呵。

（--end  
/*title:   web   service入门学习笔记
**date:   2007/01/23
**author:laomai
**url:   http://blog.csdn.net/laomai/*/）