Webservice-初级实例（二）

去年这个时候在亿阳工作，经理让我做数据同步功能，用到WS，于是草草研究之后，就投入使用了。前两天同事给我讲解分配给我的项目时，讲到其中一块是数据同步功能，我不禁一笑，同事问笑什么，我说世界真是奇妙，去年这时候在做数据同步，今年换公司换项目换领导，还让我做数据同步。其实，从这也看出，随着信息化在中国的大力推进，像移动、广电这样的单位用的企业系统已经不止是一个两个，而是几十个，甚至上百，也就必然出现了系统间的通信和数据传输的问题，WS、SOA这些技术应该就是在此背景下出来的。

翻了翻之前关于WS的博客，就写了一篇《Webservice-初涉（一）》，我看有必要继去年的博客写个系列了。上篇大概提了几个关于WS的点，我们先做一个快速实例，暂且抛开CXF、Axis等框架，从简单的例子入手，再一步步来究其原理。创建两个Java Project，一个为服务器01_service，另一个为客户端01_service_client。首先编写服务器端：

1. 实体类User

package cn.net.easyway.service;

public class User {

	private int id;

	private String username;

	private String password;

	public int getId() {
		return id;
	}

	public void setId(int id) {
		this.id = id;
	}

	public String getUsername() {
		return username;
	}

	public void setUsername(String username) {
		this.username = username;
	}

	public String getPassword() {
		return password;
	}

	public void setPassword(String password) {
		this.password = password;
	}
}

2. 提供服务的接口类

package cn.net.easyway.service;

import javax.jws.WebParam;
import javax.jws.WebResult;
import javax.jws.WebService;

@WebService() //将此接口发布成WS
public interface IMyService {

	@WebResult(name="loginUser") //在生成wsdl文件时，返回值显示成为loginUser
	//在生成wsdl文件时，参数不是arg，而显示为username，password
	public User login(@WebParam(name="username")String username,@WebParam(name="password")String password);
}

此接口称为服务提供接口，SEI（Service Endpoint Interface），以上代码中，@WebResult和@WebParam是可选注

解，读者在去掉前后观察wsdl文档，看看究竟发生了哪些变化。

3. 实现类

package cn.net.easyway.service;

import javax.jws.WebService;

@WebService(endpointInterface="cn.net.easyway.service.IMyService") //endpointInterface：接入点接口
public class MyServiceImpl implements IMyService {

	@Override
	public User login(String username, String password) {

		System.out.println(username + "is logining");

		User user = new User();

		user.setId(1);
		user.setUsername(username);
		user.setPassword(password);

		return user;
	}
}

此类称为服务实现Bean，SIB（Serviceimplemention Bean），

endpointInterface属性指向接口。

4. 服务发布类

package cn.net.easyway.service;

import javax.xml.ws.Endpoint;

public class Server {

	public static void main(String[] args) {

		String address = "http://localhost:8888/ws";

		//两个参数，一个是发布服务地址，一个是发布的服务实现
		Endpoint.publish(address, new MyServiceImpl());
	}
}

编写完服务发布类后，读者可运行起来，在浏览器中敲入：http://localhost:8888/ws?wsdl，即可看到相应的wsdl文档。到此时服务已经发布成功，接下来我们编写客户端，在项目01_service_client中创建类TestClient，代码如下：

package cn.net.easyway.service;

import java.net.MalformedURLException;
import java.net.URL;

import javax.xml.namespace.QName;

public class TestClient {

	public static void main(String[] args) throws MalformedURLException {
		//创建访问wsdl服务地址的url
		URL url = new URL("http://localhost:8888/ws?wsdl");
		//通过Qname指明服务的具体信息
		QName sname = new QName("http://service.easyway.net.cn/","MyServiceImplService");

		//-------------------------方式一-------------------------
		MyServiceImplService msis = new MyServiceImplService(url, sname);

		IMyService ms1 = msis.getMyServiceImplPort();
		System.out.println(ms1.login("张三", "123"));

		//------------------------方式二----------------------------------------
		//创建服务
		//Service service = Service.create(url,sname);
		//实现接口
		//IMyService ms = service.getPort(IMyService.class);
		//System.out.println(ms.login("李四", "123"));
	}
}

此时，你会看到自己编辑器报错，那是因为客户端这个项目中还没有创建和服务端一致的接口，把服务端源代码直接拷贝明显是行不通，因为在实际项目开发中，别人给你提供接口，是没有必要把源代码给你的，因此这里我们需要一个命令wsimport，这是一个JDK自带的命令，如果您安装了jdk，那么就可以在命令窗口使用该命令了，该命令是将wsdl文档生成相应的类文件，我们可以把生成的这个类文件拷贝到客户端目录下，如同在本地调用一样，调用服务端了，生成的源文件大家可以看一下，是和服务端完全不同的代码，此时，我的客户端项目目录如下图：

wsimport命令参数解释如下：

wsimport -dd   :/wsimport -keep -verbosehttp://localhost:8888/ws?wsdl

-d d:/temp     ：指定生成的目录；

-keep          ：指定是否生成Java源文件；

-verbose       ：显示生成的详细过程；

http://localhost:8888/ws?wsdl：网络中的wsdl文件；

下一篇讲解几个规范和工具。