JAX-WS 构建简单webservice部署到tomcat上
前言:
虽然构建本地的jax-ws的webservice很简单,但要部署到tomcat上要绕过点弯。
tomcat本身和jdk都没有jaw-ws的API,所以部署的时候需要额外做点事情,有两种选择
1、下载必要的jar库,JAX-WS RI,地址:https://jax-ws.java.net/
2、使用其他服务器,比如TomEE(tomcat的加强版)等。(未测试),可以参考:
Step by Step JAX-WS Web Services with Eclipse, TomEE, and Apache CXF
因为平时用tomcat比较多,就用第一种方式。
一、准备工作
下载jax-ws RI。
配置:根据文档,
To install on Tomcat
Set CATALINA_HOME to your Tomcat installation.
Run
ant install
This essentially copies lib/*.jar from the root of JAX-WS RI extracted bundle to $CATALINA_HOME/shared/lib
为了安全,还是把tomcat目录下的share/lib中的jar包复制到tomcat_home/lib下。
二、创建一个动态web project
2.1 创建工程
如下:
wsdl目录是自己建的。
2.2 写一个Hello的web service
复制代码
package org.ccnt.jax.web.server;
import javax.jws.WebMethod;
import javax.jws.WebService;
@WebService
public class Hello {
@WebMethod
public String say(String name) {
return "hello, " + name;
}
}
复制代码
注意:
@WebService
注释在了Class之上,这告诉了JAXWS,此类为Webservice。
@WebMethod
注释在了public方法上,这告诉了JAXWS,此方法为soap方法,该方法有两个参数,一个input的String,一个output的String。
业务逻辑很简单,客户端调用传入一个Name,服务端返回给客户端一个”Hello: “+name的字串。
现在我们通过Java文件来生成Webservice相关布署文件以及调用接口。
2.3 用wsgen生成相应的类和wsdl文件
命令:
wsgen -cp ./build/classes -s ./src -r ./wsdl -d ./build/classes -wsdl org.ccnt.jax.web.server.Hello
生成一下目录:
JAX-WS 2.0 有两种开发过程:自顶向下和自底向上。自顶向下方式指通过一个 WSDL 文件来创建Web Service,自底向上是从 Java 类出发创建 Web Service。两种开发过程最终形成的文件包括:
1.SEI。一个SEI对应WSDL中WebService的一个port,在Java中是一个Java接口。
2.SEI实现类。
3.WSDL和XSD文件。