红黑web service入门学习笔记

/*title: web service入门学习笔记**date: 2007/01/16**author:laomai**url: /laomai/*/web service入门学习笔记最近要做一个java项目，里面用到了webservice技术，经过一个多月的磕磕绊绊的摸索，总算如了点门。

现将我的学习笔记贴出来，供大家参考。

说明，本笔记第七部分主要参考了/lin_bei/archive/2006/11/07/1371131.aspx的内容，由于这位兄弟翻译的不是很通顺，我就按照自己的理解来改编成了hellowrold的例子:-)。

其他部分为我原创，转载时请注明出处。

一、实验环境win2k + jdk1.6 + javee5.0 + Myeclipse5.1jdk和javee5.0均可从/javase/downloads/index.jsp下载，安装文件名为jdk-6-windows-i586.exejava_ee_sdk-5_02-windows.exe没有myeclipse的也可以用eclipse代替，只要ide能执行ant脚本就可以./*title: web service入门学习笔记（二）**date: 2007/01/16**author:laomai**url: /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.0Your 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.xmlinit:compile-deploy-service:[echo] d:/Sun/SDKget-artifacts-windows:get-artifacts-unix:get-artifacts:compile-client:[javac] Compiling 1 source file to D:\Sun\SDK\samples\javaee5\webservices\hello-jaxws\buildrun-client-windows:[exec] Hello result = Hello Administrator!run-client-unix:run-client:all:BUILD SUCCESSFULTotal time: 43 seconds其中[exec] Hello result = Hello Administrator!的输出结果说明客户端调用服务器的webservice已经成功。

第一个例子就完成了。

我们下面会对这个例子进行详细讲解./*title: web service入门学习笔记（三）、（四）**date: 2007/01/16**author:laomai**url: /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，[Copy to clipboard]CODE:/* src\endpoint\Hello.java文件的内容*/package endpoint;import javax.jws.WebService;@WebServicepublic class Hello{public String getHello(String name){return "Hello " + name + "!";}}有这个文件可以看出，编写一个service的实现类，把编写普通的java类差不多，只不过又多了三点①要在该类前一个@WebService说明，②引入javax.jws.WebService;③在公开的方法前加@WebMethod说明，如果不加的话，所有的public方法都会自动变成service的对外接口.2、客户端测试类的实现文件[Copy to clipboard]CODE:/* 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(""));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(""));3、ant 脚本build.xml[Copy to clipboard]CODE:<!-- 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}"/><javacsrcdir="./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.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.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: /laomai/*/五、精简后的ant脚本1、卸载webservice执行原build.xml里的clean和undeploy任务，把安装好的webservice删除掉，具体办法为：(1)在myeclipse里打开build.xml文件(2)在build.xml文件里单击右键菜单中的""run as"->"2 ant build..."",(3)在弹出的对话框中只选择clean和undelpoy任务。