博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
分分钟带你玩转 Web Services【1】JAX-WS
阅读量:6613 次
发布时间:2019-06-24

本文共 4578 字,大约阅读时间需要 15 分钟。

   当大型需求被数个公司分割开来,各公司系统相互交换数据的问题就会接踵而来。

   毕竟是多家不同的公司的产品,研发开发语言、采用技术框架基本上是百花齐放。

   怎样让自家系统提供的服务具有跨平台、跨语言、跨各种防火墙,让其他公司的研发使用起来没障碍并且爽呢?

   进过前期的技术调研和实践,最终将目光放在了轻量级 Web Services 服务上面。

 

   

 

1. Web Services 服务技术的关键点 

  • XML:     做为 Web Services 的基本数据表示,特点即容易组织和分析,而且又与开发平台和语言无关。
  • SOAP:   做为 Web Services 的通讯协议,基于 XML能运行在任何传输协议 HTTP/TCP/UDP/ 上面,将程序中的对象编码为 XML 的规则,执行远程调用。

    TCP/HTTP/UDP 传输协议可以理解为寄信时信封上的格式怎么写,贴什么邮票,SOAP 通讯协议使用 HTTP 来发送XML 格式的信息。

  • WSDL:  做为描述 Web Services 的语言,你能很清晰的知道提供的服务是什么、入参、返回的数据,机器和人都很容器进行阅读。

   公司自己实现 Web Services 服务框架肯定是不现实的,如果你公司有一群热爱技术的大牛、有一颗想造轮子的匠心,有老总的支持,还是可以放手一战的。

   目前已有的 Web Services 开发框架有:  Axis、Axis2、Xfire、CXF、JAX-WS。

   除了 JAX-WS 为 JDK 1.6 发布的的 Web Services 开发框架以外,其余的都是第三方开源框架。

   其中 Axis 和 XFire 随着技术更新和发展已经慢慢的谈出了人们的视线,并且官方已经有很长时间没有更新,这里暂且不表。

   CXF是Apache旗下一个重磅的SOA简易框架,它实现了ESB(企业服务总线)。

   CXF 原型来源与 XFire + Client, 就像 Struts2 来自 WebWork 一样,当然你也能预言到 XFire 的命运会和 WebWork 一样,会淡出开发者的视线。

   Axis2 是 Apache 下的一个重量级 Web Services框架,准确说它是一个Web Services / SOAP / WSDL 的引擎,是 Web Services 框架的集大成者。

   Axis2 不但能制作和发布WebService,而且可以生成Java和其他语言版WebService客户端和服务端代码。这是它的优势所在。

   丰满意味着臃肿和庞大,这样的优势也不可避免的导致了Axis2的复杂性,听使用过她的人,它所依赖的包数量和大小都是很惊人的,打包部署发布很麻烦。

   源于对第三方开源框架的恐惧和颤抖,结合自身公司的业务复杂度,技术团队一致选定 JDK JAX-WS 作为公司的 Web Services 框架。

   上述参考出处:

   

   

2. JAX-WS 服务端无 MVC 框架开发实践

   我这里的说的无 MVC 框架指的是没有使用任何像 Struts/Spring MVC/WebWork....这些东西,Java EE 项目最纯真的 Servlet 时代。

   在 main 函数中静态方式发布这里就不提了,确实有点 low,咱需要 Web Services 服务和 web 项目一起启动起来,同呼吸共命运。

   main 静态发布方式参考:。

  • a.maven 依赖

com.sun.xml.ws
jaxws-rt
2.2.10

   如果是非 mavn的传统项目, 需要的 jar (大概 5M)

  • b.服务类和实现类

   项目包结构

@WebService@SOAPBinding(style = SOAPBinding.Style.RPC)public interface MyFirstWebService {    /**     * 执行测试的WebService方法(有参)     */    @WebMethod    String sayHi(@WebParam(name = "name") String name);}
@WebService(endpointInterface = "com.rambo.cwe.jws.inter.MyFirstWebService")@SOAPBinding(style = SOAPBinding.Style.RPC)public class MyFirstWebServiceImpl implements MyFirstWebService {    public String sayHi(String name) {        return "Hi, " + name + "! ";    }}
  •  c.web 项目的起点,web.xml 的配置

com.sun.xml.ws.transport.http.servlet.WSServletContextListener
MyFirstWebService
com.sun.xml.ws.transport.http.servlet.WSServlet
1
MyFirstWebService
/services/sayHi
  •  d.服务配置文件 sun-jaxws.xml,放置到 WEB-INF

   注意服务配置文件中的 url-pattern 和 servlet 中的 url-pattern 是一致的。

   通过上面的4步的操作,启动 web 项目吧,不出什么意外的话,启动 web 容器打印日志是这样。

   浏览器访问 http://localhost:5050/cwe/services/sayHi

   示例项目: 

3. JAX-WS 服务端与 Spring 集成开发实践

   在 Spring 中集成相当简单,分分钟配置集成。

  • a.mavn 依赖需要添加的支持 jar(500K)

org.springframework.ws
spring-ws-core
2.3.0.RELEASE
  • b.Spring Bean 添加 Web Services 服务支持

   地址你随意,配置为和 web 项目一致也没问题。

  • c.服务实现类 Bean 配置

   大体的意思是你得让 Spring 知道有这样一个服务实现类。

   如果你比较传统,可以配置在 Spring-***.xml 中,像这样

...

   当然你也可以,使用注解,像这样

   简单的三步之后,把你的 web 容器启动起来吧,Web Services 服务就发布成功了。

   实例工程:

4. 客户端  JAX-WS 服务的调用

  服务端编写好之后,使用 JDk 自带的 wsimport 工具生成客户端代理类。

  wsimport 只需要指定 url 就能生成 java 调用的客户端,你完全不用去了解这个 WebServer 服务是用什么语言编写的。

wsimport -s f:  http://localhost:5050/cwe/services/sayHi?wsdl

  wsimport 常用参数参考:

参数 说明
-p 定义客户端生成类的包名称
-s 指定客户端执行类的源文件存放目录
-d 指定客户端执行类的class文件的存放目录
-keep                                                      表示生成客户端执行类的源代码
-b 指定jaxws/jaxb绑定文件或额外的schemas
-extension 使用扩展来支持SOAP1.2

  补充: 关于 wsimport 生成代理类:

  生成的代理类(生成姿势多种多样,自行参考上面常用参数,没有标准只有最适合):

   将代理类放入客户端项目,只需要两行代码就能实现 Web Services 服务的调用,如下

MyFirstWebServiceImplService service = MyFirstWebServiceImplService();            MyFirstWebService implPort = service.getMyFirstWebServiceImplPort();            System.out.println(implPort.sayHi("Orson"));

   其实我一直想尝试,不往客户端添加任何代码,调用 Web Services 服务,很遗憾没能成功。

   最接近的的是,在客户端放入服务端的接口类,代码可以这样写。

URL url = new URL("http://localhost:5050/cwe/services/sayHi?wsdl");            QName serviceName = new QName("http://impl.jws.cwe.rambo.com/", "MyFirstWebServiceImplService");            QName portName = new QName("http://impl.jws.cwe.rambo.com/", "MyFirstWebServiceImplPort");            Service service = Service.create(url,serviceName);            MyFirstWebService servicePort = service.getPort(portName,MyFirstWebService.class);            System.out.println(servicePort.sayHi("Orson"));

   自行定义连接地址、服务名称、、端口名称,生成服务实例进行访问,代码完全没有使用代理类那样清晰。

   等下次,你们公司需要给其他公司提供服务时,只需要编写好 Web Services,抽象好接口,撸好实现层。

   直接甩一个地址给其他公司,顺便可以把我这篇博客地址发过去,然后整个世界就安静了。

   

转载地址:http://uaaso.baihongyu.com/

你可能感兴趣的文章
JS动画效果链接汇总
查看>>
父类转为子类涉及到的安全问题
查看>>
网络流,流水线模拟
查看>>
知识点笔记
查看>>
陈云川的OPENLDAP系列
查看>>
django 模型-----自连接
查看>>
P1197 [JSOI2008]星球大战
查看>>
urllib模块
查看>>
XML转义字符
查看>>
微信小程序之简单记账本开发记录(六)
查看>>
死锁和活锁
查看>>
JavaScript的简单继承实现案例
查看>>
<Linux命令行学习 第一节> CentOS在虚拟机的安装
查看>>
mysql设置字符集CHARACTER SET
查看>>
Perl完全自学手册图文教程
查看>>
python(5)字典
查看>>
wordpress拿WebShell
查看>>
脚本结构和执行
查看>>
warden创建容器的过程
查看>>
【c++】size_t 和 size_type的区别
查看>>