WebService《JavaEE6权威指南 基础篇第4版》

---

【Web服务】

为运行在不同平台和框架之上的软件提供了互操作的标准方式。良好的互操作性和可扩展性。消息采用自包含文档的形式。

——解决异构系统之间交互。解决异构系统通信问题： 

1.通过XML，JSON，字符串进行多语言的通讯。

2.共享数据库。

3.共享文件。

4.使用消息中间件。

 

Axis互通信比较好，对其他语言访问的兼容性比较多；

CXF非常容易的整合到Spring架构中；

 

【REST风格】

Representational State Transfer，表述性状态转移。Web应用：多使用JAX-RS服务类型。

 

随着云技术的发展，JAX-RS将会变得更加重要。

 

【JAX-WS】

调用与应答通过HTTP协议，以SOAP消息（XML文件）的形式在服务器端与客户端之间传输。

javax.jws.WebService注解将类声明为Web服务端点。

【对JAX-WS端点的要求】

实现类的业务方法必须是公有类型，且不能声明为static或final。

实现类不能声明为final或avstract。

实现类必须有一个默认的公有构造函数。

实现类不能定义finalize方法。

 

 

 

第13章 用JAX-RS构建REST式Web服务

---

REST风格其实是指一种架构风格，设定诸如统一接口之类的约束条件。

 

性能，可扩展性，可修改性等方面的提升。 

在这种架构风格中，数据和功能都被视为资源。可以用URL（统一资源描述符）来访问。

必须使用无状态的通信协议，典型的例子就是HTTP协议。

在REST架构风格里，客户端和服务器通过标准化的接口和协议来操作资源。

 

以下特性使得REST式应用简单、轻量化、开发速度也快：

---

1.通过URI识别资源。URI还可以用于服务发现。

2.统一接口。通过使用4个固定的操作来使用资源。PUT创建资源，GET读取资源，POST更新资源，DELETE删除资源。

3.自描述的消息。资源和它们的展示是松耦合的。与资源相关的元数据可以用于诸如控制缓存机制、检测传输错误、协商合适的展现格式、以及执行身份验证或者访问控制。

4.通过超链接实现有状态的交互。

 

创建一个REST式根资源类

---

根资源类（root resource class）使用@Path注解。或者POJO类使用“请求方法指示符”注解如@GET@POST@PUT@DELETE。

资源方法（resource method）是指在资源类中使用了请求方法指示符注解的方法。

本节内容讲述如何使用JAX-RS来注解Java类，以创建REST式Web服务。

 

JAX-RS 是Java提供的API，使用Java语言提供的注解功能。

定义资源、及能够用在资源上的操作。

 

JAX-RS注解是运行时的注解，因此运行时的反射功能能会为资源生成辅助类以及中间文件。

JavaEE应用归档文件包含：JAX-RS资源类、配置的资源、辅助类以及和中间文件、还有暴露给客户端的资源。

 

《JAX-RS注解总结》

---

@Path：注解的值是一个相对URI路径，/helloworld，/helloworld/{username}

@Produces("text/plain") 指定资源可以生成并发送给客户端的MIME媒体类型。

 

要得到用户输入的名字，可以在请求的方法参数里使用@PathParam注解。

 

@Path("/user/{username}")

public class UserResource{

    @GET

    @Produces("text/xml")

    public String getUser(@PathParam("username") String userName){

        ...

    }

}

响应HTTP资源

1.请求方法指示符注解

 

 

参考博客讲解

---

《使用JAX-RS创建RESTful Web Service》

 

《SOA，微服务与Docker》
 继面向对象编程思想又一种较新的编程思想面向服务编程，这样我们就不用顾虑语言的差别，提供规范的服务接口，我们无论使用什么语言，就都可以访问使用了，大大提高了程序的复用率。

 

 

 

---

《主流Web Service框架介绍：CXF和Axis2》

CXF和Axis2是目前java平台上最主流的两个框架，虽然两个项目都隶属ASF，但却是基于不同思想和风格实现的，因此也各有所长。

CXF：http://cxf.apache.org/

是由过去的Celtix和XFire两个框架合并而来，CXF在java社区有广泛的接受度是得益于它能很好的集成Spring。我认为CXF最突出的两个优势是：

1.对JAX-WS规范的完整实现。 作为java平台上的WebService标准，过去既有的WebService产品必然会向这一标准靠拢，而JAX-WS标准本身大大地降低了开发WebService的工作量，对于开发人员来说，是非常受欢迎的。

2.对Spring的友好支持。 CXF从Xfire继承而来，对Spring有着非常友好的支持。鉴于Spring的广泛应用，对很多团队来说这是非常有吸引力的一点。

Axis2: http://axis.apache.org/axis2/java/core/

与CXF这类嵌入式的框架相比，Axis2更像是一种是WS容器，它要求应用程序以aar包的形式部署到自己里面，这对于既有系统，特别是那些基于servlet容器的web应用来说，改造的代价可能会很大。Axis2的优势在于一方面它对WS-*协议族的支持比较全面，另一方面是它还支持C平台，这是一个值得我们关注的优势。

总得来说，如果是新生项目，选择CXF或Axis2在工作量上不会有太大的差别，对于那些使用了Spring的既有项目来说，CXF应该是首选，因为CXF是基于注解的。因此对于那些基于jvm1.4构建陈旧系统可能并不适用。Axis2的优势是支持C平台和比较全的WS-*协议族。（以上的考量都还没有考虑ESB的因素。）

【WebService优缺点】

From : http://blog.csdn.net/chaobeyond/article/details/2247117

最近做的几个项目都用到了webservice，通过自己的实践和网上资料的汇总，现在做个小结：
        当前WebService是一个热门话题。但是，WebService究竟是什么？，WebService有什么优点和缺点，什么情况下应该用WebService？什么情况下不应该用WebService？是需要我们正确认识的。
实际上，WebService的主要目标是跨平台的可互操作性。为了达到这一目标，WebService完全基于XML（可扩展标记语言）、XSD （XMLSchema）等独立于平台、独立于软件供应商的标准，是创建可互操作的、分布式应用程序的新平台。由此可以看出，在以下三种情况下，使用 WebService会带来极大的好处。
优点一：跨防火墙的通信
如果应用程序有成千上万的用户，而且分布在世界 各地，那么客户端和服务器之间的通信将是一个棘手的问题。因为客户端和服务器之间通常会有防火墙或者代理服务器。在这种情况下，使用DCOM就不是那么简 单，通常也不便于把客户端程序发布到数量如此庞大的每一个用户手中。传统的做法是，选择用浏览器作为客户端，写下一大堆ASP页面，把应用程序的中间层暴 露给最终用户。这样做的结果是开发难度大，程序很难维护。
举个例子， 在应用程序里加入一个新页面，必须先建立好用户界面(Web页面)，并在这个页面后面，包含相应商业逻辑的中间层组件，还要再建立至少一个ASP页面，用 来接受用户输入的信息，调用中间层组件，把结果格式化为HTML形式，最后还要把“结果页”送回浏览器。要是客户端代码不再如此依赖于HTML表单，客户 端的编程就简单多了。
如果中间层组件换成WebService的话，就可以从用户界面直接调用中间层组件，从而省掉建立ASP页面的 那一步。要调用WebService，可以直接使用MicrosoftSOAPToolkit或.NET这样的SOAP客户端，也可以使用自己开发的 SOAP客户端，然后把它和应用程序连接起来。不仅缩短了开发周期，还减少了代码复杂度，并能够增强应用程序的可维护性。同时，应用程序也不再需要在每次 调用中间层组件时，都跳转到相应的“结果页”。
从经验来看，在一个用户界面和中间层有较多交互的应用程序中，使用 WebService这种结构，可以节省花在用户界面编程上20%的开发时间。另外，这样一个由WebService组成的中间层，完全可以在应用程序集 成或其它场合下重用。最后，通过WebService把应用程序的逻辑和数据“暴露”出来，还可以让其它平台上的客户重用这些应用程序。
优点二：应用程序集成
企业级的应用程序开发者都知道，企业里经常都要把用不同语言写成的、在不同平台上运行的各种程序集成起来，而这种集成将花费很大的开发力量。应用程序经 常需要从运行在IBM主机上的程序中获取数据；或者把数据发送到主机或UNIX应用程序中去。即使在同一个平台上，不同软件厂商生产的各种软件也常常需要 集成起来。通过WebService，应用程序可以用标准的方法把功能和数据“暴露”出来，供其它应用程序使用。
例如，有一个订单登 录程序，用于登录从客户来的新订单，包括客户信息、发货地址、数量、价格和付款方式等内容；还有一个订单执行程序，用于实际货物发送的管理。这两个程序来 自不同软件厂商。一份新订单进来之后，订单登录程序需要通知订单执行程序发送货物。通过在订单执行程序上面增加一层WebService，订单执行程序可 以把“AddOrder”函数“暴露”出来。这样，每当有新订单到来时，订单登录程序就可以调用这个函数来发送货物了。
优点三：B2B的集成
用WebService集成应用程序，可以使公司内部的商务处理更加自动化。但当交易跨越供应商和客户、突破公司的界限时会怎么样呢？跨公司的商务交易集成通常叫做B2B集成。
WebService是B2B集成成功的关键。通过WebService，公司可以把关键的商务应用“暴露”给指定的供应商和客户。例如，把电子下单系 统和电子发票系统“暴露”出来，客户就可以以电子的方式发送订单，供应商则可以以电子的方式发送原料采购发票。当然，这并不是一个新的概念，EDI(电子 文档交换)早就是这样了。但是，WebService的实现要比EDI简单得多，而且WebService运行在Internet上，在世界任何地方都可 轻易实现，其运行成本就相对较低。不过，WebService并不像EDI那样，是文档交换或B2B集成的完整解决方案。WebService只是B2B 集成的一个关键部分，还需要许多其它的部分才能实现集成。
用WebService来实现B2B集成的最大好处在于可以轻易实现互操作 性。只要把商务逻辑“暴露”出来，成为WebService，就可以让任何指定的合作伙伴调用这些商务逻辑，而不管他们的系统在什么平台上运行，使用什么 开发语言。这样就大大减少了花在B2B集成上的时间和成本，让许多原本无法承受EDI的中小企业也能实现B2B集成。
优点四：软件和数据重用
软件重用是一个很大的主题，重用的形式很多，重用的程度有大有小。最基本的形式是源代码模块或者类一级的重用，另一种形式是二进制形式的组件重用。
当前，像表格控件或用户界面控件这样的可重用软件组件，在市场上都占有很大的份额。但这类软件的重用有一个很大的限制，就是重用仅限于代码，数据不能重用。原因在于，发布组件甚至源代码都比较容易，但要发布数据就没那么容易，除非是不会经常变化的静态数据。
WebService在允许重用代码的同时，可以重用代码背后的数据。使用WebService，再也不必像以前那样，要先从第三方购买、安装软件组 件，再从应用程序中调用这些组件；只需要直接调用远端的WebService就可以了。举个例子，要在应用程序中确认用户输入的地址，只需把这个地址直接 发送给相应的WebService，这个WebService就会帮你查阅街道地址、城市、省区和邮政编码等信息，确认这个地址是否在相应的邮政编码区 域。WebService的提供商可以按时间或使用次数来对这项服务进行收费。这样的服务要通过组件重用来实现是不可能的，那样的话你必须下载并安装好包 含街道地址、城市、省区和邮政编码等信息的数据库，而且这个数据库还是不能实时更新的。
另一种软件重用的情况是，把好几个应用程序的 功能集成起来。例如，要建立一个局域网上的门户站点应用，让用户既可以查询联邦快递包裹，查看股市行情，又可以管理自己的日程安排，还可以在线购买电影 票。现在Web上有很多应用程序供应商，都在其应用中实现了这些功能。一旦他们把这些功能都通过WebService“暴露”出来，就可以非常容易地把所 有这些功能都集成到你的门户站点中，为用户提供一个统一的、友好的界面。
将来，许多应用程序都会利用WebService，把当前基 于组件的应用程序结构扩展为组件/WebService的混合结构，可以在应用程序中使用第三方的WebService提供的功能，也可以把自己的应用程 序功能通过WebService提供给别人。两种情况下，都可以重用代码和代码背后的数据。
从以上论述可以看出，WebService在通过Web进行互操作或远程调用的时候是最有用的。不过，也有一些情况，WebService根本不能带来任何好处。
缺点一：单机应用程序
  目前，企业和个人还使用着很多桌面应用程序。其中一些只需要与本机上的其它程序通信。在这种情况下，最好就不要用WebService，只要用本地的 API就可以了。COM非常适合于在这种情况下工作，因为它既小又快。运行在同一台服务器上的服务器软件也是这样。最好直接用COM或其它本地的API来 进行应用程序间的调用。当然WebService也能用在这些场合，但那样不仅消耗太大，而且不会带来任何好处。
缺点二：局域网的同构应用程序
  在许多应用中，所有的程序都是用VB或VC开发的，都在Windows平台下使用COM，都运行在同一个局域网上。例如，有两个服务器应用程序需要相互 通信，或者有一个Win32或WinForm的客户程序要连接局域网上另一个服务器的程序。在这些程序里，使用DCOM会比SOAP/HTTP有效得多。 与此相类似，如果一个.NET程序要连接到局域网上的另一个.NET程序，应该使用.NETremoting。有趣的是，在.NETremoting中， 也可以指定使用SOAP/HTTP来进行WebService调用。不过最好还是直接通过TCP进行RPC调用，那样会有效得多。