Axis2和CXF是目前流行的Webservice框架,这两个框架都属于重量级框架。
相对而言,JAX-WS RI是一个轻量级的框架。
开发WebService只需要很简单的几个步骤:写接口和实现->发布->生成客户端(测试或使用)。
服务端写接口和实现
1、新建一个Maven Web项目,在项目中添加JAX-WS RI引用,pom.xml配置文件如下
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.test</groupId>
<artifactId>jwsDemo</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>war</packaging>
<name>jwsDemo</name>
<url>http://maven.apache.org</url>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<!-- JAXWS-RI -->
<dependency>
<groupId>com.sun.xml.ws</groupId>
<artifactId>jaxws-rt</artifactId>
<version>2.2.10</version>
</dependency>
</dependencies>
<build>
<finalName>jwsDemo</finalName>
<defaultGoal>compile</defaultGoal>
</build>
</project>
2、创建服务接口
接口中把类注明为@WebService,把方法注明为@WebMethod,其余如@WebResult、@WebParam等都不是必要的,
而客户端和服务端的通信用RPC 和Message-Oriented两种。
package service;
import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
@WebService
@SOAPBinding(style = SOAPBinding.Style.RPC)
public interface HelloService {
@WebMethod
void say1();
@WebMethod
void say2(@WebParam(name = "name") String name);
}
3、创建接口的实现类
package service.imp;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import service.HelloService;
@WebService(endpointInterface = "service.HelloService")
@SOAPBinding(style = SOAPBinding.Style.RPC)
public class HelloServiceImp implements HelloService{
@Override
public void say1() {
System.out.println("Hi, abc!");
}
@Override
public void say2(String name) {
System.out.println("Hi, " + name + "!");
}
}
4、基于web服务器Servlet方式发布服务
(1)在WEB-INF中创建WebService配置文件sun-jaxws.xml,配置文件中一个WebService对应一个Endpoint。
<?xml version = "1.0"?>
<?xml version="1.0" encoding="UTF-8"?>
<endpoints xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime" version="2.0">
<!-- 服务路径http://站点路径/service/hello?wsdl-->
<endpoint name="HelloService" implementation="service.imp.HelloServiceImp" url-pattern="/service/hello" />
</endpoints>
(2)在web.xml中添加WSServlet,如果Web项目使用Servlet 3.0或以上则不需要。
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
version="3.0">
<display-name>jwsDemo</display-name>
<!-- Servlet 3.0或者以上不需要配置 -->
<!-- <listener>
<listener-class>
com.sun.xml.ws.transport.http.servlet.WSServletContextListener
</listener-class>
</listener>
<servlet>
<servlet-name>HelloService</servlet-name>
<servlet-class>com.sun.xml.ws.transport.http.servlet.WSServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>HelloService</servlet-name>
<url-pattern>/service/hello</url-pattern>
</servlet-mapping> -->
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
</web-app>
(3)生成
选择项目 -> Run as -> Maven Install,在“workspace名称\项目名称\target”会生成“项目名称.war”,即jwsDemo.war
(4)选择项目 -> Run as -> Run on Server,在Eclipse中的浏览器中输入地址
http://localhost:8090/jwsDemo/service/hello?wsdl (备注:本机把默认端口8080改了8090)
能看到东西就说明正常
(5)部署
把jwsDemo.war复制到tomcat的webapps目录下,执行bin里面的startup.bat启动,tomcat自动把“项目名称.war”解压出来并启动。
客户端调用
1、使用jdk自带工具wsimport生成客户端的Java类:
"%java_home%\bin\wsimport" -keep -Xnocompile -d d:\java -p webservice.client http://localhost:8090/jwsDemo/service/hello?wsdl
几个参数说明:
-keep 保留生成的文件
-d <directory> 指定放置生成的输出文件的位置
-p <pkg> 指定目标程序包
-Xnocompile 不编译生成的 Java 文件
在d:\java\webservice\client生成了2个文件HelloService.java、HelloServiceImp.java
2、把生成的Java类添加到客户端相应的Package下
客户端调用
package test;
import webservice.client.HelloService;
import webservice.client.HelloServiceImpService;
public class Hello{
public void say() {
HelloService service = new HelloServiceImpService().getHelloServiceImpPort();
service.say1();
service.say2("cdfefcg");
}
}
附,项目截图: