用JAX-WS在Tomcat中发布WebService

 1 <?xml version="1.0" encoding="UTF-8"?> 2 <project xmlns="http://maven.apache.org/POM/4.0.0" 3 ?????????xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 4 ?????????xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> 5 ????<modelVersion>4.0.0</modelVersion> 6 ?7 ????<groupId>top.jimc</groupId> 8 ????<artifactId>wsi</artifactId> 9 ????<version>1.0-SNAPSHOT</version>10 ????<packaging>war</packaging>11 12 ????<properties>13 ????????<junit.version>4.12</junit.version>14 ????????<jaxws-rt.version>2.2.10</jaxws-rt.version>15 ????</properties>16 17 ????<dependencies>18 ????????<!-- junit -->19 ????????<dependency>20 ????????????<groupId>junit</groupId>21 ????????????<artifactId>junit</artifactId>22 ????????????<version>${junit.version}</version>23 ????????????<scope>test</scope>24 ????????</dependency>25 26 ????????<!-- JAXWS-RI -->27 ????????<dependency>28 ????????????<groupId>com.sun.xml.ws</groupId>29 ????????????<artifactId>jaxws-rt</artifactId>30 ????????????<version>${jaxws-rt.version}</version>31 ????????</dependency>32 ????</dependencies>33 34 ????<build>35 ????????<plugins>36 ????????????<!-- 配置控制jdk版本的插件 -->37 ????????????<plugin>38 ????????????????<groupId>org.apache.maven.plugins</groupId>39 ????????????????<artifactId>maven-compiler-plugin</artifactId>40 ????????????????<version>3.7.0</version>41 ????????????????<configuration>42 ????????????????????<source>1.8</source>43 ????????????????????<target>1.8</target>44 ????????????????????<encoding>utf-8</encoding>45 ????????????????</configuration>46 ????????????</plugin>47 ????????</plugins>48 ????</build>49 50 </project>

 1 package top.jimc.wsi.api; 2 ?3 import top.jimc.wsi.entity.Person; 4 ?5 import javax.jws.WebService; 6 import java.util.Date; 7 ?8 /** 9 ?* WebService接口10 ?* @author Jimc.11 ?* @since 2018/8/31.12 ?*/13 @WebService(name = "helloWSoap", targetNamespace = "http://wsi.jimc.top/api/hello")14 public interface HelloWService {15 16 ????/**17 ?????* 两个整数相加18 ?????*19 ?????* @param x20 ?????* @param y21 ?????* @return 相加后的值22 ?????*/23 ????Integer add(Integer x, Integer y);24 25 ????/**26 ?????* 返回当前时间27 ?????*28 ?????* @return29 ?????*/30 ????Date now();31 32 ????/**33 ?????* 获取复杂类型34 ?????* @param name 用户姓名35 ?????* @param age 用户年龄36 ?????* @return 返回用户类37 ?????*/38 ????Person getPerson(String name, Integer age);39 40 }

 1 package top.jimc.wsi.entity; 2 ?3 import java.io.Serializable; 4 ?5 /** 6 ?* @author Jimc. 7 ?* @since 2018/8/31. 8 ?*/ 9 public class Person implements Serializable {10 ????private static final long serialVersionUID = -7211227224542440039L;11 12 ????private String name;13 ????private Integer age;14 15 ????public String getName() {16 ????????return name;17 ????}18 ????public void setName(String name) {19 ????????this.name = name;20 ????}21 ????public Integer getAge() {22 ????????return age;23 ????}24 ????public void setAge(Integer age) {25 ????????this.age = age;26 ????}27 }

 1 package top.jimc.wsi.api.impl; 2 ?3 import top.jimc.wsi.api.HelloWService; 4 import top.jimc.wsi.entity.Person; 5 ?6 import javax.jws.WebService; 7 import java.util.Date; 8 ?9 /**10 ?* WebService接口实现11 ?* @author Jimc.12 ?* @since 2018/8/31.13 ?*/14 @WebService(endpointInterface = "top.jimc.wsi.api.HelloWService",15 ????????????portName = "HelloWSoap",16 ????????????serviceName = "HelloWService",17 ????????????targetNamespace = "http://wsi.jimc.top/api/hello")18 public class HelloWServiceImpl implements HelloWService {19 20 ????@Override21 ????public Integer add(Integer x, Integer y) {22 ????????return x + y;23 ????}24 25 ????@Override26 ????public Date now() {27 ????????return new Date();28 ????}29 30 ????@Override31 ????public Person getPerson(String name, Integer age) {32 ????????Person person = new Person();33 ????????person.setName(name);34 ????????person.setAge(age);35 ????????return person;36 ????}37 }

1 <?xml version="1.0" encoding="UTF-8"?>2 <endpoints xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime" version="2.0">3 ????<endpoint name="hello" implementation="top.jimc.wsi.api.impl.HelloWServiceImpl" url-pattern="/api/hello"/>4 </endpoints>

 1 <?xml version="1.0" encoding="UTF-8"?> 2 <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" 3 ?????????xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 4 ?????????xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" 5 ?????????version="3.1"> 6 ?7 ????<!-- Servlet 3.0或者以上不需要配置 --> 8 ????<servlet> 9 ????????<servlet-name>jaxws</servlet-name>10 ????????<servlet-class>com.sun.xml.ws.transport.http.servlet.WSServlet</servlet-class>11 ????????<load-on-startup>1</load-on-startup>12 ????</servlet>13 ????<servlet-mapping>14 ????????<servlet-name>jaxws</servlet-name>15 ????????<url-pattern>/api/hello</url-pattern>16 ????</servlet-mapping>17 </web-app>

 1 用法: wsimport [options] <WSDL_URI> ??2 ???3 其中 [options] 包括: ??4 ??-b <path> ????????????????指定 jaxws/jaxb 绑定文件或附加模式 ??5 ????????????????????????????(每个 <path> 都必须具有自己的 -b) ??6 ??-B<jaxbOption> ???????????将此选项传递给 JAXB 模式编译器 ??7 ??-catalog <file> ??????????指定用于解析外部实体引用的目录文件 ??8 ????????????????????????????支持 TR9401, XCatalog 和 OASIS XML 目录格式。 ??9 ??-d <directory> ???????????指定放置生成的输出文件的位置 ?10 ??-encoding <encoding> ?????指定源文件所使用的字符编码 ?11 ??-extension ???????????????允许供应商扩展 - 不按规范 ?12 ????????????????????????????指定功能。使用扩展可能会 ?13 ????????????????????????????导致应用程序不可移植或 ?14 ????????????????????????????无法与其他实现进行互操作 ?15 ??-help ????????????????????显示帮助 ?16 ??-httpproxy:<host>:<port> ?指定 HTTP 代理服务器 (端口默认为 8080) ?17 ??-keep ????????????????????保留生成的文件 ?18 ??-p <pkg> ?????????????????指定目标程序包 ?19 ??-quiet ???????????????????隐藏 wsimport 输出 ?20 ??-s <directory> ???????????指定放置生成的源文件的位置 ?21 ??-target <version> ????????按给定的 JAXWS 规范版本生成代码 ?22 ????????????????????????????默认为 2.2, 接受的值为 2.0, 2.1 和 2.2 ?23 ????????????????????????????例如, 2.0 将为 JAXWS 2.0 规范生成兼容的代码 ?24 ??-verbose ?????????????????有关编译器在执行什么操作的输出消息 ?25 ??-version ?????????????????输出版本信息 ?26 ??-wsdllocation <location> ?@WebServiceClient.wsdlLocation 值 ?27 ??-clientjar <jarfile> ?????创建生成的 Artifact 的 jar 文件以及 ?28 ????????????????????????????调用 Web 服务所需的 WSDL 元数据。 ?29 ??-generateJWS ?????????????生成存根 JWS 实现文件 ?30 ??-implDestDir <directory> ?指定生成 JWS 实现文件的位置 ?31 ??-implServiceName <name> ??生成的 JWS 实现的服务名的本地部分 ?32 ??-implPortName <name> ?????生成的 JWS 实现的端口名的本地部分 ?33 ??34 扩展: ?35 ??-XadditionalHeaders ?????????????映射标头不绑定到请求或响应消息不绑定到 ?36 ???????????????????????????????????Java 方法参数 ?37 ??-Xauthfile ??????????????????????用于传送以下格式的授权信息的文件: ?38 ???????????????????????????????????http://username:password@example.org/stock?wsdl ?39 ??-Xdebug ?????????????????????????输出调试信息 ?40 ??-Xno-addressing-databinding ?????允许 W3C EndpointReferenceType 到 Java 的绑定 ?41 ??42 ??-Xnocompile ?????????????????????不编译生成的 Java 文件 ?43 ??-XdisableAuthenticator ??????????禁用由 JAX-WS RI 使用的验证程序, ?44 ???????????????????????????????????将忽略 -Xauthfile 选项 (如果设置) ?45 ??-XdisableSSLHostnameVerification 在提取 wsdl 时禁用 SSL 主机名 ?46 ???????????????????????????????????验证 ?47 ??48 示例: ?49 ??wsimport stock.wsdl -b stock.xml -b stock.xjb ?50 ??wsimport -d generated http://example.org/stock?wsdl ?

 1 import org.junit.Test; 2 import top.jimc.wst.HelloWService; 3 import top.jimc.wst.HelloWSoap; 4 ?5 /** 6 ?* @author Jimc. 7 ?* @since 2018/8/31. 8 ?*/ 9 public class WSTest {10 11 12 ????/**13 ?????* 调用14 ?????*/15 ????@Test16 ????public void helloTest() {17 ????????HelloWService helloWService = new HelloWService();18 ????????HelloWSoap hello = helloWService.getHelloWSoap();19 ????????System.out.println(hello.add(8, 9));20 ????????System.out.println(hello.now());21 ????????System.out.println(hello.getPerson("John", 22));22 ????}23 }