去年这个时候在亿阳工作,经理让我做数据同步功能,用到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文件;
下一篇讲解几个规范和工具。