?Java API for XML Web Services (JAX-WS),缩写 JAX-WS.下面的例子从 Java 类着手,使用 Annotation 来生成 WSDL 文件和 Java 接口。
?
1.写web service实现类.
package demo.hw.server;
import javax.jws.WebMethod;
import javax.jws.WebService;
public interface HelloWorld {
??? String sayHi(String text);
}
package demo.hw.server;
import javax.jws.WebMethod;
import javax.jws.WebService;
public class HelloWorldImpl implements HelloWorld {
??? public String sayHi(String text) {
??????? System.out.println("sayHi called");
??????? return "Hello " + text;
??? }
}
2使用 WebService Annotation 进行了标注
package demo.hw.server;
import javax.jws.WebMethod;
import javax.jws.WebService;
@WebService(serviceName="HelloWorldService",
????? portName="HelloWorldService",
????? targetNamespace="http://demo.hw.server/helloworld")
public interface HelloWorld {
?@WebMethod
??? String sayHi(String text);
}
package demo.hw.server;
import javax.jws.WebMethod;
import javax.jws.WebService;
@WebService(serviceName="HelloWorldService",
???? portName="HelloWorldService",
???? targetNamespace="http://demo.hw.server/helloworld")
public class HelloWorldImpl implements HelloWorld {
?@WebMethod
??? public String sayHi(String text) {
??????? System.out.println("sayHi called");
??????? return "Hello " + text;
??? }
}
3.使用wsgen命令生成文件
wsgen -cp . -s ./? demo.hw.server.HelloWorldImpl -wsdl
wsgen 命令说明
wsgen是在JDK的bin目录下的一个exe文件(Windows版),该命令的主要功能是用来生成合适的JAX-WS。它读取Web Service的终端类文件,同时生成所有用于发布Web Service所依赖的源代码文件和经过编译过的二进制类文件。这里要特别说明的是,通常在Web Service Bean中用到的异常类会另外生成一个描述Bean,如果Web Service Bean中的方法有申明抛出异常,这一步是必需的,否则服务器无法绑定该对像。此外,wsgen还能辅助生成WSDL和相关的xsd文件。wsgen从资源文件生成一个完整的操作列表并验证web service是否合法,可以完整发布。
命令参数说明:
? -cp 定义classpath
? -r 生成 bean的wsdl文件的存放目录
? -s 生成发布Web Service的源代码文件的存放目录(如果方法有抛出异常,则会生成该异常的描述类源文件)
? -d 生成发布Web Service的编译过的二进制类文件的存放目录(该异常的描述类的class文件)
注意:如果是用eclipse一类的工具,src和bin是分开的文件夹,需要先用javac在源文件同级目录下生成class文件后,在cmd命令中进入src目录执行wsgen命令才可以。生成jaxws文录文件和wsdl,xsd文件。
?
4.发布WEB服务
package demo.hw.server;
import javax.xml.ws.Endpoint;
public class HelloWorldPublic {
?public static void main(String args[]){
??Endpoint.publish("http://localhost:8088/HelloWorldService/HelloWorldImpl",new HelloWorldImpl());
?}
}
5.使用命令wsimport生成文件
wsimport -d ./bin -s ./src -p demo.hw.client http://localhost:8088/HelloWorldService/HelloWorldImpl?wsdl
wsimport 命令说明:
wsimport也是在JDK的bin目录下的一个exe文件(Windows版),主要功能是根据服务端发布的wsdl文件生成客户端存根及框架,负责与Web Service 服务器通信,并将其封装成实例,客户端可以直接使用,就像使用本地实例一样。对Java而言,wsimport帮助程序员生存调用web service所需要的客户端类文件.java和.class。要提醒指出的是,wsimport可以用于非Java的服务器端,如:服务器端也许是C#编写的web service,通过wsimport则生成Java的客户端实现。
命令参数说明:
? -d 生成客户端执行类的class文件的存放目录
? -s 生成客户端执行类的源文件的存放目录
? -p 定义生成类的包名
注意:wsimprt生成客户端相关文件。可以新建个工程,然后执行wsimport文件。
6新建客户端类,调用服务器端程序。
package demo.hw.client;
import java.net.MalformedURLException;
import java.net.URL;
import javax.xml.namespace.QName;
public class SoapClient {
?
?public static void main(String args[]) throws MalformedURLException{
??SoapClient sc = new SoapClient();
??HelloWorldService service = new HelloWorldService(sc.getWsURL(),new QName("http://demo.hw.server/helloworld",
"HelloWorldService"));?
??try{
???HelloWorldImpl port = service.getHelloWorldService();
???String strback = port.sayHi("aabbcc");
???System.out.println(strback);
??}catch(Exception e){
???e.printStackTrace();
??}
??
?}
?
? public URL getWsURL() throws MalformedURLException {
?? URL url = null;
???????? try {
???????????? URL baseUrl;
???????????? baseUrl = demo.hw.client.HelloWorldService.class.getResource(".");
???????????? url = new URL(baseUrl,"http://localhost:8088/HelloWorldService/HelloWorldImpl?wsdl");
???????? } catch (MalformedURLException e) {
??
???????? }
????? return url;
? }
?
}
OK。第一个JAX-WS就完成了。