JAX-WS 学习实例一

 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;
  }
 
}

ＯＫ。第一个JAX-WS就完成了。