目录:
- 概述
- 实验环境
- 服务端的实现
- 客户端的实现
[一]、概述
Java API for XML Web Services (JAX-WS)是Java程序设计语言一个用来创建Web服务的API。
在服务器端,用户只需要通过Java语言定义远程调用所需要实现的接口SEI(service endpoint interface),并提供相关的实现,通过调用JAX-WS的服务发布接口就可以将其发布为WebService接口。
在客户端,用户可以通过JAX-WS的API创建一个代理(用本地对象来替代远程的服务)来实现对于远程服务器端的调用。
当然 JAX-WS 也提供了一组针对底层消息进行操作的API调用,你可以通过Dispatch 直接使用SOAP消息或XML消息发送请求或者使用Provider处理SOAP或XML消息。
JAX-WS2.0 (JSR 224 )是Sun新的web services协议栈,是一个完全基于标准的实现。在binding层,使用的是the Java Architecture for XML Binding (JAXB, JSR 222 ),在parsing层,使用的是the Streaming API for XML (StAX, JSR 173 ),同时它还完全支持schema规范。
JAX-WS与JAX-RPC的区别 可参见:http://java.sun.com/xml/faq.html#JAX-WS-and-JAX-RPC-difference
JAX-WS一些参考资料:
[二]、实验环境
- java version “1.6.0_18″、Eclipse3.7
- maven构建项目:mvn archetype:create -DgroupId=com.micmiu.jaxws.demo -DartifactId=jaxws-demo -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
[三]、服务端的实现
1.最基本的实例
编写接口代码:ReportService.java
- package com.jshx.http.ws;
- public interface ReportService {
- String queryDate(String jsonStr);
- }
实现接口并添加webservice注释:ReportServiceImpl.java
- package com.jshx.http.ws.impl;
- import javax.jws.WebMethod;
- import javax.jws.WebParam;
- import javax.jws.WebService;
- import javax.jws.soap.SOAPBinding;
- import com.jshx.http.ws.ReportService;
- @WebService
- @SOAPBinding(style = SOAPBinding.Style.RPC)
- public class ReportServiceImpl implements ReportService {
- @WebMethod
- public String queryDate(@WebParam(name="jsonStr") String jsonStr) {
- return "hi," + jsonStr + " welcom to www.micmiu.com";
- }
- }
编写服务端发布代码:WsServerStart .java
- package com.jshx.http.ws;
- import javax.xml.ws.Endpoint;
- import com.jshx.http.ws.impl.ReportServiceImpl;
- public class WsServerStart {
- public static void main(String[] args) {
- ReportService ws = new ReportServiceImpl();
- Endpoint.publish("http://localhost:8080/ReportServer", ws);
- }
- }
浏览器打开:http://localhost:8080/ReportServer?wsdl 回车显示如下:
可见服务端已经发布成功。
如果出现问题:
原因:cxf需要jaxws-api-2.1.jar及jaxb-api-2.1.jar的支持
解决方案
1、将cxf所需的2.1的jar复制一份到jdk目录下的jre\lib\endorsed文件夹中。如果endorsed文件不存在,可新建。如果不行,可能还需要在public class XXX上方加入@SOAPBinding(style = SOAPBinding.Style.RPC)。
2、jdk升级到1.6.0_22版本以上。
二、MyEclipse利用网上公开发布WSDL文件,创建WebService Client,进行调用WebService
1. 打开MyEclipse,新建一个Web Project;然后新建 一个package,取名为com.test;
2. 然后再New一个Web Service Client;
点next ,然后录入 WSDL URL: http://localhost:8080/ReportServer?wsdl
点next,点finish;ok了,系统会自动帮忙生成很多代码。
2.编写客户端测试程序:ReportClient.java
- package com.jshx.http.ws.client;
- public class ReportClient {
- public static void main(String[] args) {
- ReportServiceImplService service = new ReportServiceImplService();
- ReportServiceImpl report = service.getReportServiceImplPort();
- System.out.println("start webservice client ...");
- System.out.println("send Michael to server ");
- System.out.println(report.queryDate("Michael"));
- System.out.println("test client end.");
- }
- }
运行测试程序,日志如下:
send Michael to server
hi,Michael welcom to www.micmiu.com
test client end.
可见客户端调用成功。
另一种方法:
- package com.wx.jaxws.example;
- //import javax.jws.WebMethod;
- //import javax.jws.WebService;
- //import javax.jws.soap.SOAPBinding;
- //@WebService(serviceName = "HelloService", portName = "HelloServicePort", targetNamespace = "http://example.jaxws.wx/jaxws/MyFirstOne")
- //@SOAPBinding(style = SOAPBinding.Style.DOCUMENT,
- use = SOAPBinding.Use.LITERAL, parameterStyle = SOAPBinding.ParameterStyle.WRAPPED)
- public class MyFirstOne {
- //@WebMethod public String sayHello(String s) {
- System.out.println("hello," + s);
- return "hello," + s;
- }
- }