webService的初步认识和简单用例

阅读更多

一、什么是webService？

Web Service也叫XML Web Service WebService是一种可以接收从Internet或者Intranet上的其它系统中传递过来的请求，轻量级的独立的通讯技术。是:通过SOAP在Web上提供的软件服务，使用WSDL文件进行说明，并通过UDDI进行注册。

几个基本概念：

SOAP：简单对象存取协议，是webService的通信协议，是针对xml文档形式的调用方法的规范，可支持不同的底层接口，如http；

WSDL：是一个xml文档， 用于说明一组soap消息，以及如何交换这些消息；

UDDI：是一个主要针对Web服务供应商和使用者的新项目，是一种根据wsdl文件（描述文档）来引导客户端查找响应服务的机制。它是利用SOAP消息机制（标准的XML/HTTP）来发布，编辑，浏览以及查找注册信息。它采用XML格式来封装各种不同类型的数据，并且发送到注册中心或者由注册中心来返回需要的数据。

一言以蔽之：webService是一种典型，成熟的远程服务调用技术规范。如网站对天气预报接口的接入，对列车时刻表、航班的接口接入等。

 

二、服务端简单示例

1）服务端服务接口模拟

看之前网上的示例，都是一个接口服务对应一个wsdl文件的，然而我考虑到：如果会有不止一个接口呢？该咋办？——其实，当然我可以一个接口实现类对应一个wsdl文件，并且也测试过没问题，但现在我想要发布多个接口服务，但只生成一个wsdl文件。

实现这种效果很简单，只需用一个实现类，该实现类同时实现若干个接口即可。但这样会造成耦合（下面就来测试这种，具体应用中，一般是某一类服务对应于一个接口，此时还是要用到一个接口对应一个wsdl文件的模式。）

 

接口一：

@WebService
public interface IService {
	
	public void sayHello(@WebParam(name="username") String name);
	
	public int calculatr(int m, int n);
}

 接口二：

@WebService
public interface IService2 {
	public void getInfo(@WebParam(name="person") Person person);
}

其中，Person类是一个pojo，

public class Person implements Serializable{//因为要用于远程传输，所以需要序列化
	
	private static final long serialVersionUID = 1L;
	private String name;
	private int age;
	private String gender;
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public int getAge() {
		return age;
	}
	public void setAge(int age) {
		this.age = age;
	}
	public String getGender() {
		return gender;
	}
	public void setGender(String gender) {
		this.gender = gender;
	}
	@Override
	public String toString() {
		return "Pserson [name=" + name + ", age=" + age + ", gender=" + gender
				+ "]";
	}
	
}

  接口的实现类（这里我测试2个接口对应1个实现类，即生成一个wsdl文件，但现实中可能并不推荐这么做。。）

@WebService  //注意：实现类要有该注解，才能被发布
public class MutiServiceImpl implements IService, IService2 {

	@Override
	public void getInfo(Person person) {
		System.out.println("该人员的信息：" + person);
	}

	@Override
	public void sayHello(String name) {
		System.out.println("Hello, my name is " + name);
	}

	@Override
	public int calculatr(int m, int n) {
		return m * n;
	}

}

 服务端接口服务的发布：

public class ServicePublish {
	
	public static void main(String[] args) {
		String address = "http://localhost:9001/Service/service";
//address由自己来指定  不过要符合规范 http://ip地址:端口/服务名/具体服务
//第二个参数必须是具体实现类
		Endpoint.publish(address, new MutiServiceImpl());
		System.out.println("webService之服务端服务发布成功！");
	}
	
}

 运行main方法，可以看到打印信息，说明接口服务发布成功！（其实测试webService不是非得建立web project，普通的工程即可~~）

 

我们不妨在浏览器上输入刚刚发布的地址：http://localhost:9001/Service/service?wsdl（要加上?wsdl），即可看到一个自动生成的xml格式的描述文件：

This XML file does not appear to have any style information associated with it. The document tree is shown below.

这里顺便简单讲一下这个wsdl文件的一些关键字段 。

1）definitions元素——wsdl文件的根元素

2）type元素——作为一容器，定义了自定义的特殊数据类型，在声明消息部分（有效负载）的时候，messages定义使用了types元素中定义的数据类型与元素。

3）Message元素描述了Web服务的有效负载。相当于函数调用中的参数和返回值。

4）PortType元素定义了Web服务的抽象接口，它可以由一个或者多个operation元素，每个operation元素定义了一个RPC样式或者文档样式的Web服务方法，相当于类接口的名称。

5）Operation元素要用一个或者多个messages消息来定义它的输入、输出以及错误，相当于接口中包含的函数。

6）Binding元素将一个抽象的portType映射到一组具体的协议（SOAP或者HTTP）、消息传递样式（RPC或者document）以及编码样式（literal或者SOAP encoding）。

7）Service元素包含一个或者多个Port元素，每个Port元素对应于一个web服务

 

三、客户端简单示例（开另一个工程，不一定是web工程）

生成了wsdl文件之后，我们就需要根据该wsdl文件【自动】生成客户端的调用代码了。

一般而言，使用Jdk1.6+自带的命令会比较简单。（前提是你已配置好jdk环境变量）

具体命令格式为：

wsimport -s "src目录" -p “生成类所在包名” -keep “wsdl发布地址”

在本例中，为 wsimport -s  E:\xxx\the_client\src -p org.webservice.client -keep http://localhost:9001/Service/service?wsdl  （因为服务端和客户端都在同一台机器，所以直接用localhost，如果不是同一台机器，则客户端需要准确输入服务端的地址）

成功执行完命令之后，刷新会发现多了如下类：

 接下来，我们就开始远程调用测试了：

public class ClientSub {
	public static void main(String[] args) {
		try {
			MutiServiceImpl impl = new MutiServiceImplService().getMutiServiceImplPort();
			
			int x = impl.calculatr(30, 2);
			System.out.println("计算结果:" + x);
			
			Person person = new Person();
			person.setAge(23);
			person.setGender("男");
			person.setName("Karl");
			impl.getInfo(person);
			
			impl.sayHello("Connor");
			
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}

运行该服务的订阅类，会发现分别在服务端和客户端的控制台打印如下： 

服务端：

 客户端：

 

说明：利用webService来进行远程调用接口服务成功！

• 
• 大小: 7 KB

• 
• 大小: 6.5 KB

• 
• 大小: 2.8 KB

• 查看图片附件