WebService-01-使用JAX-WS发布WebService服务

一、写在前面的话

近来项目中使用WebService技术，从早期的Axis2到现在的CXF，闲来无事，做做笔记，以备后用，后续会写CXF的基本用法、拦截器、Map类型在WebService的使用、通过自定义拦截器实现权限的验证等。

JAX-WS位于JDK的javax.jws包下，主要包括@WebService，@WebMethod等几个注解，使用这些注解，便可发布WebService服务，被发布成服务的类可以是一个最简单的类，也可以是某个接口的实现类，即“接口+实现”的方式，笔记中的示例代码均为“接口+实现”的方式。以HelloWorld接口为例，接口中两个方法：sayHi,sayHello，简介的说一下@WebService和@WebMethod的使用。

二、服务端（@WebService）

接口代码：

package com.wds.ws.server.helloworld;

import javax.jws.WebService;

/**
 * @WebService 将 Java 类标记为实现 Web Service，或者将 Java 接口标记为定义 Web Service 接口
 * 
 * @author wds
 *
 */
@WebService
public interface HelloWorld {
	
	public String sayHi(String name);

	public String sayHello(String name);
}

提供一个实现类，同时实现sayHi，sayHello的方法，实现类代码如下：

package com.wds.ws.server.helloworld;

import java.util.Date;

import javax.jws.WebService;

/**
 * 如果注解中填写了endpointInterface这个属性，那么这个属性值所指定的接口上，也必须有@webservice的注解
 * 
 * portName指定了wsdl中port的名称
 * 
 * serviceName指定了wsdl中服务的名称
 * 
 * @author wds
 */
@WebService(endpointInterface="com.wds.ws.server.helloworld.HelloWorld", portName="hwPort", serviceName="hw")
public class HelloWorldWs implements HelloWorld{
	
	public String sayHello(String name) {
		System.out.println(new Date() + " sayHello " + name);
		return name + ", Hello World!";
	}
	
	public String sayHi(String name) {
		System.out.println(new Date() + " sayHi " + name);
		return name  + ", welcome webservice world!";
	}
	
}

如果将HelloWorldWs发布出去呢，采用Endpoint的方式，代码如下：

package com.wds.ws.server.helloworld;

import javax.xml.ws.Endpoint;

/**
 * 服务发布类
 * 
 * @author wds
 *
 */
public class Publish {

	/**
	 * @param args
	 */
	public static void main(String[] args) {
		Endpoint.publish("http://localhost:567/helloworld", new HelloWorldWs());
	}

}

运行此类，在浏览器中输入http://localhost:567/helloworld?wsdl，如果正常打开，说明发布服务成功，其wsdl文件内容如下：

  <?xml version="1.0" encoding="UTF-8" ?> 
- <!--  Published by JAX-WS RI at http://jax-ws.dev.java.net.