原文转载自:http://blog.csdn.net/lifetragedy/article/details/7205832
http://blog.csdn.net/tanguang_honesty/article/details/38661605 |
package ctsjavacoe.ws.fromjava;
import javax.jws.WebMethod; import javax.jws.WebService;
@WebService public class Hello { @WebMethod public String say(String name) { return ("Hello: "+name); } } |
注意:
@WebService
注释在了Class之上,这告诉了JAXWS,此类为Webservice。
@WebMethod
注释在了public方法上,这告诉了JAXWS,此方法为soap方法,该方法有两个参数,一个input的String,一个output的String。
业务逻辑很简单,客户端调用传入一个Name,服务端返回给客户端一个”Hello: “+name的字串。
现在我们通过Java文件来生成Webservice相关布署文件以及调用接口。
JAX-WS 2.0 有两种开发过程:自顶向下和自底向上。自顶向下方式指通过一个 WSDL 文件来创建Web Service,自底向上是从 Java 类出发创建 Web Service。两种开发过程最终形成的文件包括:
1.SEI。一个SEI对应WSDL中WebService的一个port,在Java中是一个Java接口。
2.SEI实现类。
3.WSDL和XSD文件。
结合公司内项目的特点,我们更多的是碰到以下两种情况:
1. Onsite要我们做一个Webservice或者是客户要求我们提供Webservice接口;
2. Onsite已经有一个Webservice了,现在要我们做客户端集成。
因此,我们选用Server端通过Java Class生成webservice,而客户端通过wsdl生成Java调用类的做法。
JAXWS为我们提供了两个工具:
ü wsgen
主要用于Server端通过Java类编译成Webservice及相关的wsdl文件
ü wsimport
主要用于Client端(调用端)通过wsdl编译出调用Server端的Java文件
我们就来生成一下上面的这个Hello,打开一个command窗口,键入如下命令:
-wsdl参数代表生成webservice
- s参数代表生成的.java文件置于何处
-d 参数代表生成的编译class文件置于何处(这个可以忽略,我们利用eclipse编译)
-r 参数代表生成的.wsdl文件与.xsd文件生成在何处
-cp参数代表classpath,即Hello.class的所在,为什么我们的-cp后是这么长一个路径呢?请看Eclipse里工程编译输出目录的路径就知道了:
好,我们现在回到eclipse工程里,刷新一下工程:
看到在wssrc目录下已经生成了我们所需的java文件了,请手工cut(对,是cut)这些文件到我们工程的”src”目录,如果不cut,下次继续使用该目录生成webservice类时,wsgen有时会生成不了,但也不报错,不知道为什么,查了一下,可能是一个bug,因该会在后续的jdk1.6.30up里改进。
这里我们有两个文件,一个是wsdl文件,这个就是我们的webservice的entry,一个是xsd文件,这个是什么?
这个就是我们java的方法里的参数的对应,或者换句话说,它就是xml格式的java bean,在webservice的世界里,xsd是作为数据结构描述用的。
现在我们的webservice的服务端有了。
布署前的准备:
在工程的WEB-INF目录下建立“sun-jaxws.xml”文件,内容如下:
<?xml version="1.0" encoding="UTF-8"?> <endpoints xmlns='http://java./xml/ns/jax-ws/ri/runtime' version='2.0'> <endpoint name='Hello' implementation='ctsjavacoe.ws.fromjava.Hello' url-pattern='/HelloService' /> </endpoints> |
将ctsjavacoe.ws.fromjava.Hello声明为Web Service。
如果是从WSDL生成的Web Service,则写法为,
<?xml version="1.0" encoding="UTF-8"?> <endpoints version="2.0" xmlns="http://java./xml/ns/jax-ws/ri/runtime"> <endpoint implementation="ctsjavacoe.ws.fromjava.HelloSEI" name="Hello" url-pattern="/HelloService" /> </endpoints>
|
修改WEB-INF目录下的web.xml文件,增加如下内容:
<servlet> <servlet-name>Hello</servlet-name> <servlet-class>com.sun.xml.ws.transport.http.servlet.WSServlet</servlet-class> <load-on-startup>2</load-on-startup> </servlet> <servlet-mapping> <servlet-name>Hello</servlet-name> <url-pattern>/HelloService</url-pattern> </servlet-mapping> |
为每一个WebService声明一个com.sun.xml.ws.transport.http.servlet.WSServlet。
开始布署:
1. 在tomcat的webapps目录下建立一个目录叫“D:\tomcat2\webapps\JaxWSSample”
2. 把eclipse工程JaxWSSample下WebContent目录下所有的东西copy至该目录下
3. 重启tomcat
在ie中输入:
http://localhost:9090/JaxWSSample/HelloService?wsdl
可以看到我们的webservice已经生成了。
同步调用,很好理解,即一来一回,Client端request到Server端,Sever端立刻回一个response。
异步调用,就是客户端调用一次服务端后,服务端处理事务并不是即时返回的,比如说传一个600MB文件给服务端,服务端在处理接收和解析文件时,客户端不会马上得到一个响应,它会等待一段时间,等服务器处理完后,再通知客户端“我处理完了”。
我们新建一个eclipse的工程,只需要是JAVA工程就行了,不需要web工程的,因为我们这边只用代码做调用:
把Server端的wsdl及xsd都手工copy到客户端工程的wsdl目录下。
打开一个cmd窗口敲入如下的命令:
wsimport -keep -d bin -s src wsdl/HelloService.wsdl |
以上是产生同步客户端的命令。
如果要产生异步客户端命令,需要在工程根目录下建一个binding.xml的文件,内容如下:
<?xml version="1.0" encoding="UTF-8"?> <bindings xmlns:xsd="http://www./2001/XMLSchema" xmlns:wsdl="http://schemas./wsdl/" wsdlLocation="wsdl/HelloService.wsdl" xmlns="http://java./xml/ns/jaxws"> <bindings node="wsdl:definitions"> <enableAsyncMapping>true</enableAsyncMapping> </bindings> </bindings> |
然后产生客户端代码的wsimport命令也会不一样:
wsimport -keep –b binding.xml -d bin -s src wsdl/HelloService.wsdl |
我们来看异步调用的代码(同步代码比异步调用简单,留给大家自己做练习)
wsimport命令会在eclipse工程的src目录中生成你在调用时所用的java src文件。
Hello.java与HelloService.java是wsimport给我们生成的供客户端调用的java文件。
我们把HelloService文件打开,可以看到两行:
file:/D:/workspace/JaxWSClient/wsdl/HelloService.wsdl |
把它们改成:
http://localhost:9090/JaxWSSample/HelloService?wsdl |
有两行,尤其是Url url=这一行,千万不要漏改了。
我们创建一个调用类,叫:HelloAsyncPollingClient.java文件,内容如下:
package ctsjavacoe.ws.fromjava;
import javax.xml.ws.Response;
public class HelloAsyncPollingClient {
/** * @param args */ public static void main(String[] args) throws Exception { HelloService service = new HelloService(); Hello port = service.getHelloPort(); Response<SayResponse> sayAsync = port.sayAsync("Mk"); while (!sayAsync.isDone()) { System.out.println("is not down"); } try { SayResponse callNameResponse = sayAsync.get(); String message = callNameResponse.getReturn(); System.out.println(message); } catch (Exception ex) { } }
} |
运行,得到结果如下:
在旧的基于JAX-RPC的webservice编程model中,是不支持异步的service 调用的,在最新的Jax-ws webservice 编程model中,加入了对webservice的异步调用的支持。
首先我来讲一下它的原理,大家不要以为在异步的调用下,从client到server 之间的soap message 流也是异步的,其实不是,Soap/Http 协议在同步跟异步的调用下是一样的,都是客户端的service在运行时打开一个connectin,发送请求,然后接收返回,这些都在同一个connection中。这种方式对我们有什么影响呢?从客户端程序的角度来讲,没有影响,客户端的编程模型是由WSDL中的messages跟port types 来定义的,只要这些东西没有改变,request 跟response是不是在同一个Tcp/ip 的session 中来发送对与我们来说没由影响,然后从架构跟资源的角度来讲,对我们的影响就大了,把连接层的资源跟应用层的程序运行状态绑定起来是由许多弊端的,假如在异步调用时,程序运行出现了异常,将会导致连接层的资源被一直占用,这样会极大的影响我们程序的,稳定性,可靠性,资源的使用跟性能。
上例中实现的是一种“polling方式的异步调用”,下面给出“callback”方式的异步调用客户端。
由于此callBack当请求发出去以后当前的这个connection就会关闭 ,为了达到测试的目的,加入了sleep,让客户端程序等待服务器端得返回。
callback类型的client要传入一个javax.xml.ws.AsyncHandler类型的匿名内部类,当soapMessage 到达时,Jax-ws会调handleResponse这个方法来处理response.
客户端测试代码如下:
package ctsjavacoe.ws.fromjava; import javax.xml.ws.AsyncHandler; import javax.xml.ws.Response; public class HelloAsyncCallBackClient { public static void main(String[] args) throws Exception { HelloService service = new HelloService(); Hello port = service.getHelloPort(); port.sayAsync("Mk", new AsyncHandler<SayResponse>() { public void handleResponse(Response<SayResponse> res) { try { SayResponse response = null; response = res.get(); String message = response.getReturn(); System.out.println(message); } catch (Exception e) { e.printStackTrace(); } } }); Thread.sleep(1000); } } |
|