真正的轻量级WebService框架—使用JAX-WS(JWS)发布WebService（转载）

2024-09-02 14:48
文章标签 使用 框架 发布 webservice 转载 轻量级 ws 真正 jax jws

本文主要是介绍真正的轻量级WebService框架—使用JAX-WS(JWS)发布WebService（转载），希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

java内集了webservice服务，javax.jws，完全使用自带api。用jdk6.0自带的webservice，就不用载入第三方jar包了，部署方式都是在main方法中使用endpoint.publish来发布的，web服务器都不用。

 WebService历来都很受重视，特别是Java阵营，WebService框架和技术层出不穷。知名的XFile(新的如CXF)、Axis1、Axis2等。

 而Sun公司也不甘落后，从早期的JAX-RPC到现在成熟的、支持RPC调用与消息传递的JAX-WS都经过了市场的考验，十分成熟，而且使用JAX-WS开发WebService的收益是很大的，它是轻量级的。

我们使用JAX-WS开发WebService只需要很简单的几个步骤：写接口和实现=>发布=>生成客户端(测试或使用

而在开发阶段我们也不需要导入外部jar包，因为这些api都是现成的。首先是接口的编写(接口中只需要把类注明为@WebService，把要暴露给客户端的方法注明为@WebMethod即可，其余如@WebResult、@WebParam等都不是必要的，而客户端和服务端的通信用RPC和Message-Oriented两种，区别和配置以后再说)：

 复制代码

 1 package service;
 2 
 3 import java.util.Date;
 4 
 5 import javax.jws.WebMethod;
 6 import javax.jws.WebParam;
 7 import javax.jws.WebResult;
 8 import javax.jws.WebService;
 9 import javax.jws.soap.SOAPBinding;
10 
11 /**
12  * 作为测试的WebService接口
13  * 
14  * @author Johness
15  * 
16  */
17 @WebService
18 @SOAPBinding(style = SOAPBinding.Style.RPC)
19 public interface SayHiService {
20 
21     /**
22      * 执行测试的WebService方法
23      */
24     @WebMethod
25     void SayHiDefault();
26 
27     /**
28      * 执行测试的WebService方法(有参)
29      * 
30      * @param name
31      */
32     @WebMethod
33     void SayHi(@WebParam(name = "name") String name);
34 
35     /**
36      * 执行测试的WebService方法(用于时间校验)
37      * 
38      * @param clentTime 客户端时间
39      * @return 0表示时间校验失败 1表示校验成功
40      */
41     @WebMethod
42     @WebResult(name = "valid")
43     int CheckTime(@WebParam(name = "clientTime") Date clientTime);
44 }
复制代码

 

　　然后是实现类(注解@WebService及其endpointInterface属性是必要的)：

 

 

复制代码 
 1 package service.imp;
 2 
 3 import java.text.SimpleDateFormat;
 4 import java.util.Date;
 5 
 6 import javax.jws.WebService;
 7 import javax.jws.soap.SOAPBinding;
 8 
 9 import service.SayHiService;
10 
11 /**
12  * 作为测试的WebService实现类
13  * 
14  * @author Johness
15  * 
16  */
17 @WebService(endpointInterface = "service.SayHiService")
18 @SOAPBinding(style = SOAPBinding.Style.RPC)
19 public class SayHiServiceImp implements SayHiService {
20 
21     @Override
22     public void SayHiDefault() {
23         System.out.println("Hi, Johness!");
24     }
25 
26     @Override
27     public void SayHi(String name) {
28         System.out.println("Hi, " + name + "!");
29     }
30 
31     @Override
32     public int CheckTime(Date clientTime) {
33         // 精确到秒
34         String dateServer = new java.sql.Date(System.currentTimeMillis())
35                 .toString()
36                 + " "
37                 + new java.sql.Time(System.currentTimeMillis());
38         String dateClient = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss")
39                 .format(clientTime);
40         return dateServer.equals(dateClient) ? 1 : 0;
41     }
42 
43 }
复制代码

 然后是发布(一般有两种方式)：

 方式一(此方式只能作为调试，有以下bug：

 jdk1.6以下编译器不支持以Endpoint.publish方式发布document方式的soap，必须在service接口和实现类添加“@SOAPBinding(style = SOAPBinding.Style.RPC)”注解；

访问受限，似乎只能本机访问(应该会绑定到publish的URL上，如下使用localhost的话就只能本机访问)……)：

 

复制代码 
 1 package mian;
 2 
 3 import javax.xml.ws.Endpoint;
 4 
 5 import service.imp.SayHiServiceImp;
 6 
 7 public class Main {
 8 
 9     /**
10      * 发布WebService
11      * 简单
12      */
13     public static void main(String[] args) {
14         Endpoint.publish("http://localhost:8080/testjws/service/sayHi", new SayHiServiceImp());
15     }
16 
17 }
复制代码

 方式二(基于web服务器Servlet方式)：

以Tomcat为例，首先编写sun-jaxws.xml文件并放到WEB-INF下：

 复制代码

1 <?xml version="1.0" encoding="UTF-8"?>
2 <endpoints xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime"
3     version="2.0">
4     <endpoint name="SayHiService"
5         implementation="service.imp.SayHiServiceImpl"
6         url-pattern="/service/sayHi" />
7 </endpoints>
复制代码

 然后改动web.xml，添加listener和servlet(url-pattern要相同哦)：

复制代码 
 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" version="2.5">
 3     
 4     <listener>  
 5         <listener-class>
 6             com.sun.xml.ws.transport.http.servlet.WSServletContextListener  
 7         </listener-class>
 8     </listener>
 9     <servlet>
10         <servlet-name>SayHiService</servlet-name>  
11         <servlet-class>
12             com.sun.xml.ws.transport.http.servlet.WSServlet  
13         </servlet-class>
14     </servlet>  
15     <servlet-mapping>  
16         <servlet-name>SayHiService</servlet-name>  
17         <url-pattern>/service/sayHi</url-pattern>  
18     </servlet-mapping>
19     
20     <welcome-file-list>
21         <welcome-file>index.html</welcome-file>
22         <welcome-file>index.htm</welcome-file>
23         <welcome-file>index.jsp</welcome-file>
24     </welcome-file-list>
25 </web-app>
复制代码

 最后部署到Tomcat里，值得一提的是您可能需要添加以下jar包(因为Tomcat没有)：　　　　　　　　　　　

 

启动Tomcat。

服务端工作就完成了，注意两个事情。

注意：项目需要使用UTF-8编码(至少sun-jaxws.xml必须是UTF-8格式的)；

对于MyEclipse的内置Tomcat，可能会出现不需要手动添加上述jar包，但独立部署时应该添加，因为它们使用的class-path不一样；

多个不同路径的接口也要使用同一个WSServlet；

最好加上@SOAPBinding(style = SOAPBinding.Style.RPC)注解。

 部署好了之后打开浏览器输入网址：http://localhost:8080/testjws/service/sayHi?wsdl。可以看到东西就证明发布成功了。

附上项目树状图：

 

　　

 

　　最后是客户端使用，由于WebService是平台和语言无关的基于xml的，所以我们完全可以使用不同语言来编写或生成客户端。

 

　　一般有三种方式来使用(对于Java语言而言)：

 

　　　　一，使用jdk自带工具wsimport生成客户端：

 

　　

 

　　jdk自带的wsimport工具生成，上图我是把客户端文件生成到了桌面src文件中(-d)，并保留了源文件(-keep)，指定了包名(-p)。

 然后我们就可以使用生成的文件来调用服务器暴露的方法了：

 

　　　　　　　　　　　　

 

　　　　值得一提的是你生成使用的jdk和你客户端的jre需要配套！

 从上面的目录结构我们可以发现：服务端的每个webmethod都被单独解析成为了一个类(如果使用了实体，实体也会被解析到客户端，并且是源码，所以建议使用实体时慎重)。

 　　

 

　　（上面的图是旧图，只是为了表示一下jaxws是为每个webmethod生成类的情况）

 

　　而我们的service则被生成了一个代理类来调用服务，接下来我们看看使用情况：

 

复制代码 
 1 package test;
 2 
 3 import java.util.Date;
 4 import java.util.GregorianCalendar;
 5 
 6 import javax.xml.datatype.DatatypeConfigurationException;
 7 import javax.xml.datatype.DatatypeFactory;
 8 import javax.xml.datatype.XMLGregorianCalendar;
 9 
10 import testjws.client.SayHiService;
11 import testjws.client.SayHiServiceImpService;
12 
13 public class Main {
14 
15     public static void main(String[] args) throws DatatypeConfigurationException {
16         // 获取service
17         SayHiService service = new SayHiServiceImpService().getSayHiServiceImpPort();
18         
19         // sayhi
20         service.sayHiDefault();
21         service.sayHi("Ahe");
22         
23         // checktime
24         // 这里主要说一下时间日期的xml传递，方法还略显复杂
25         GregorianCalendar calender = new GregorianCalendar();
26         calender.setTime(new Date(System.currentTimeMillis()));
27         XMLGregorianCalendar xmldate = DatatypeFactory.newInstance().newXMLGregorianCalendar(calender);
28         System.out.println(service.checkTime(xmldate));
29 
30     }
31 
32 }
复制代码

 

　　看看服务器的输出，我们是否调用成功：

 

　　

 

　　　　

 

　　　　成功了！

 

　　　　对于校验时间的方法客户端也收到反馈了：

 

　　　　　　　　

 

　　　　二，使用诸如MyEclipse（Eclipse for Jave EE也可以）创建一个Web Service Client的项目

 

　　　　　　　　

 

　　　　然后填入wsdl地址即可，后续步骤我就不贴出了。

 

　　　　三，自己写代码-_-，其实这个方法不得不说是最好的。

这篇关于真正的轻量级WebService框架—使用JAX-WS(JWS)发布WebService（转载）的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1130261。

相关文章

中文分词jieba库的使用与实景应用（一）

中文分词jieba库的使用与实景应用（一）

知识星球：https://articles.zsxq.com/id_fxvgc803qmr2.html 目录 一.定义： 精确模式（默认模式）： 全模式： 搜索引擎模式： paddle 模式（基于深度学习的分词模式）： 二 自定义词典 三.文本解析   调整词出现的频率 四. 关键词提取 A. 基于TF-IDF算法的关键词提取 B. 基于TextRank算法的关键词提取
阅读更多...
使用SecondaryNameNode恢复NameNode的数据

使用SecondaryNameNode恢复NameNode的数据

1）需求： NameNode进程挂了并且存储的数据也丢失了，如何恢复NameNode 此种方式恢复的数据可能存在小部分数据的丢失。 2）故障模拟 （1）kill -9 NameNode进程 [lytfly@hadoop102 current]$ kill -9 19886 （2）删除NameNode存储的数据（/opt/module/hadoop-3.1.4/data/tmp/dfs/na
阅读更多...
Hadoop数据压缩使用介绍

Hadoop数据压缩使用介绍

一、压缩原则 （1）运算密集型的Job，少用压缩 （2）IO密集型的Job，多用压缩 二、压缩算法比较 三、压缩位置选择 四、压缩参数配置 1）为了支持多种压缩/解压缩算法，Hadoop引入了编码/解码器 2）要在Hadoop中启用压缩，可以配置如下参数
阅读更多...
Makefile简明使用教程

Makefile简明使用教程

文章目录 规则makefile文件的基本语法：加在命令前的特殊符号：.PHONY伪目标: Makefilev1 直观写法v2 加上中间过程v3 伪目标v4 变量 make 选项-f-n-C Make 是一种流行的构建工具，常用于将源代码转换成可执行文件或者其他形式的输出文件(如库文件、文档等)。Make 可以自动化地执行编译、链接等一系列操作。 规则 makefile文件
阅读更多...
使用opencv优化图片（画面变清晰）

使用opencv优化图片（画面变清晰）

文章目录 需求影响照片清晰度的因素 实现降噪测试代码 锐化空间锐化Unsharp Masking频率域锐化对比测试 对比度增强常用算法对比测试 需求 对图像进行优化，使其看起来更清晰，同时保持尺寸不变，通常涉及到图像处理技术如锐化、降噪、对比度增强等 影响照片清晰度的因素 影响照片清晰度的因素有很多，主要可以从以下几个方面来分析 1. 拍摄设备 相机传感器：相机传
阅读更多...
高效+灵活，万博智云全球发布AWS无代理跨云容灾方案！

高效+灵活，万博智云全球发布AWS无代理跨云容灾方案！

摘要 近日，万博智云推出了基于AWS的无代理跨云容灾解决方案，并与拉丁美洲，中东，亚洲的合作伙伴面向全球开展了联合发布。这一方案以AWS应用环境为基础，将HyperBDR平台的高效、灵活和成本效益优势与无代理功能相结合，为全球企业带来实现了更便捷、经济的数据保护。 一、全球联合发布 9月2日，万博智云CEO Michael Wong在线上平台发布AWS无代理跨云容灾解决方案的阐述视频，介绍了
阅读更多...
pdfmake生成pdf的使用

pdfmake生成pdf的使用

实际项目中有时会有根据填写的表单数据或者其他格式的数据，将数据自动填充到pdf文件中根据固定模板生成pdf文件的需求 文章目录 利用pdfmake生成pdf文件1.下载安装pdfmake第三方包2.封装生成pdf文件的共用配置3.生成pdf文件的文件模板内容4.调用方法生成pdf 利用pdfmake生成pdf文件 1.下载安装pdfmake第三方包 npm i pdfma
阅读更多...
零基础学习Redis(10) -- zset类型命令使用

零基础学习Redis(10) -- zset类型命令使用

zset是有序集合，内部除了存储元素外，还会存储一个score，存储在zset中的元素会按照score的大小升序排列，不同元素的score可以重复，score相同的元素会按照元素的字典序排列。 1. zset常用命令 1.1 zadd  zadd key [NX | XX] [GT | LT]   [CH] [INCR] score member [score member ...]
阅读更多...
git使用的说明总结

git使用的说明总结

Git使用说明 下载安装(下载地址) macOS: Git - Downloading macOS Windows: Git - Downloading Windows Linux/Unix: Git (git-scm.com) 创建新仓库 本地创建新仓库：创建新文件夹，进入文件夹目录，执行指令 git init ，用以创建新的git 克隆仓库 执行指令用以创建一个本地仓库的
阅读更多...
【北交大信息所AI-Max2】使用方法

【北交大信息所AI-Max2】使用方法

BJTU信息所集群AI_MAX2使用方法 使用的前提是预约到相应的算力卡，拥有登录权限的账号密码，一般为导师组共用一个。 有浏览器、ssh工具就可以。 1.新建集群Terminal 浏览器登陆10.126.62.75 （如果是1集群把75改成66） 交互式开发 执行器选Terminal 密码随便设一个（需记住） 工作空间：私有数据、全部文件 加速器选GeForce_RTX_2080_Ti
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2