JAVA JDK6内置支持的webservice使用示例

webService是一种跨语言的系统间交互标准。在java中使用webservice根据服务器端的服务根据描述生成WSDL文件,并将应用与此WSDL文件一起放入HTTP服务器中,借助服务工具根据WSDL文件生成客户端STUB代码。此代码的作用是将产生的对象请求信息封装成标准的SOAP格式数据,并发送到服务器端,服务器端根据接收到的SOAP格式数据进行转换,并最终通过反射调用响应类的响应方法。

jdk 6中集成了WEB service的支持,通过WebService 的annotation来暴露服务的实现,并通过Endpoint.publish将服务发布到指定的地址,客户端通过wsimport来访问响应地址的wsdl文件,生成调用服务器端服务的stub类信息,客户端即可通过生成的类来调用服务器的服务了。

具体示例如下:

1.对外暴露的接口

public interface TestWebService {
public String echo();
}

2.服务器端的实现类,并通过@WebService来指定对外提供服务的服务名称,客户端生成的类目和包名

import javax.jws.WebService;
import javax.xml.ws.Endpoint;
@WebService(name="MyTestWS",serviceName="MyWebService",targetNamespace="http://localhost/client")
public class WebServiceImpl implements TestWebService{
@Override
public String echo() {
return "webservice return msg";
}
public static void main(String[] args) {
Endpoint.publish("http://localhost:8080/MyWebService", new WebServiceImpl());
}
}

附javax.jws.WebService类中方案的说明

package javax.jws;
import java.lang.annotation.Annotation;
public interface WebService extends Annotation {
/**
* Web Service 的名称。
* 当映射到 WSDL 1.1 时,该名称被用作 wsdl:portType 的名称。
* specdefault Java 类或接口的简单名称。
* */
public abstract String name();
/**
* 如果 @WebService.targetNamespace 注释是关于某一服务端点接口的,
* 则 targetNamespace 用于 wsdl:portType(以及关联的 XML 元素)的名称空间。
* 如果 @WebService.targetNamespace 注释是关于某个没有引用服务端点接口(通过 endpointInterface 属性)的服务实现 bean 的,
* 则 targetNamespace 既可以用于 wsdl:portType 也可以用于 wsdl:service(以及关联的 XML 元素)。
* 如果 @WebService.targetNamespace 注释是关于某个引用服务端点接口(通过 endpointInterface属性)的服务实现 bean 的,
* 则 targetNamespace 仅用于 wsdl:service(以及关联的 XML 元素)。
* specdefault 随实现而定,正如 JAX-WS 2.0 [5] 第 3.2 节中描述的那样。
* */
public abstract String targetNamespace();
/**
* Web Service 的服务名称。
* 当映射到 WSDL 1.1 时,此名称被用作 wsdl:service 的名称。
* 不允许在端点接口上使用此成员值。
* specdefault Java class + "Service" 的简单名称。
* */
public abstract String serviceName();
/**
* Web Service 的端口名称。
* 当映射到 WSDL 1.1 时,此名称被用作 wsdl:port 的名称。
* 不允许在端点接口上使用此成员值。
* specdefault @WebService.name+"Port"。
* */
public abstract String portName();
/**
* 描述服务的预定义 WSDL 的位置。
* wsdlLocation 是引用预先存在的 WSDL 文件的 URL(相对或绝对)。
* wsdlLocation值的存在指示服务实现 bean 将实现预先定义的 WSDL 协定。
* 如果服务实现 bean 与此 WSDL 中声明的 portType和绑定不一致,则 JSR-181 工具必须提供反馈。
* 注意,单个 WSDL 文件可能包含多个 portType 和多个绑定。
* 服务实现 bean上的注释确定对应于 Web Service 的特定 portType 和绑定。
* */
public abstract String wsdlLocation();
/**
* 定义服务抽象 Web Service 协定的服务端点接口的完整名称。
* 此注释允许开发人员将接口协定与实现分离。
* 如果此注释存在,则使用服务端点接口来确定抽象 WSDL 协定(portType和绑定)。
* 服务端点接口可以包含用来定制 Java 到 WSDL的映射关系的 JSR-181 注释。
* 服务实现 bean 可以实现服务端点接口,但并不要求这样做。
* 如果此成员值不存在,则 Web Service协定是根据服务实现 bean 上的注释生成的。
* 如果目标环境需要一个服务端点接口,则将生成一个由实现定义的包,该包具有由实现定义的名称。
* 不允许在端点接口上使用此成员值。
* */
public abstract String endpointInterface();
}

3.然后运行服务器的WebServiceImpl的main函数,暴露服务并将服务注册到一个http服务地址上,客户端通过jdk的bin下面的wsimport命令来获取服务器的wsdl文件并生成客户端的stub类信息

wsimport -keep http://localhost:8080/MyWebService?wsdl  

4.然后在你的路径上就会生成下面几个类

点击查看原图

5.然后我们编写客户端的调用代码

import localhost.client.MyWebService;
public class WebServiceClient {
public static void main(String[] args) {
MyWebService myWebService = new MyWebService();
System.out.println(myWebService.getMyTestWSPort().echo());
}
}

6.执行客户端的调用代码,输出如下:

点击查看原图

7.我们看下最终生成客户端服务调用的类内容

package localhost.client;
import java.net.MalformedURLException;
import java.net.URL;
import javax.xml.namespace.QName;
import javax.xml.ws.Service;
import javax.xml.ws.WebEndpoint;
import javax.xml.ws.WebServiceClient;
/**
* This class was generated by the JAXWS SI.
* JAX-WS RI 2.0_02-b08-fcs
* Generated source version: 2.0
*
*/
@WebServiceClient(name = "MyWebService", targetNamespace = "http://localhost/client", wsdlLocation = "http://localhost:8080/MyWebService?wsdl")
public class MyWebService extends Service{
private final static URL MYWEBSERVICE_WSDL_LOCATION;
static {
URL url = null;
try {
url = new URL("http://localhost:8080/MyWebService?wsdl");
} catch (MalformedURLException e) {
e.printStackTrace();
}
MYWEBSERVICE_WSDL_LOCATION = url;
}
public MyWebService(URL wsdlLocation, QName serviceName) {
super(wsdlLocation, serviceName);
}
public MyWebService() {
super(MYWEBSERVICE_WSDL_LOCATION, new QName("http://localhost/client", "MyWebService"));
}
/**
*
* @return
*     returns MyTestWS
*/
@WebEndpoint(name = "MyTestWSPort")
public MyTestWS getMyTestWSPort() {
return (MyTestWS)super.getPort(new QName("http://localhost/client", "MyTestWSPort"), MyTestWS.class);
}
}
喜欢本文,别忘了分享给朋友们
小提示:您可以按快捷键 Ctrl + D,或点此 加入收藏
阅读本文后,您的心情是:
 
恶心
愤怒
强赞
感动
路过
无聊
雷囧
关注
<a href="http://uquwu.com/go/?url=http://www.awell.com.cn" target="_blank" rel="external nofollow">视频贺卡</a>
2013-07-07 09:18 (1L) 回复

可以用就用咯