Web Service入门

为了学习更多web service知识，让我们首先理解面向服务架构的概念。

什么是面向服务的架构？

面向服务的架构（Service Oriented Architecture，SOA）是表示所谓服务的自包含功能单元的一种软件设计原则和架构设计模式。SOA推崇松耦合、复用性和粗粒度的服务设计原则。在企业架构方面，SOA带来的好处包括对业务需求的敏捷交付和迅速反应，通过降低集成成本提高投资回报率，通过复用组件降低开放成本。企业架构一般使用企业服务总线(ESB)作为大型企业线上应用的集成层。

什么是WebService

Web Service是面向服务架构的一种实现形式，它能够以一种平台无关的方式在不同系统之间进行交互。服务提供方定义由WSDL描述的接口，并使用SOAP消息与服务使用方进行消息交互。这些消息能够通过HTTP、FTP或者SMTP协议进行传输。WebService可以是基于SOAP或者REST的。
在今天的逐步向导中我们将探索如何创建基于SOAP的web 服务和使用web服务的使用者。我们将使用JAX-WS（Java API for XML Web Services）创建web服务。

使用软件：

Weblogic Application Server 12c
Eclipse Oepe 12c
Weblogic Webservice Tool – 这个工具将自动创建所有需要的代码和WSDL文件，让开发者专注于业务逻辑。

第一步：

在你的Eclipse中创建一个新的Dynamic Web Project。

点击modify，增加Weblogic Webservice组件的Facets。

第二步：

点击复选框，以确保所有依赖的模块被包含进来，如截屏中所示

第三步：

Default Context根节点是CalculatorService, web模块的内容目录是WebContent，点击Finish。

第四步：

此刻点击新建的项目，在你的项目上增加Weblogic Web Service模块。

第五步：

创建一个新的web service。给webservice添加名称和包详情

第六步：

Eclipse的webservice工具将创建一个带有默认hello()方法的服务端点接口(约定)。我们可以用方法add()来代替这个默认方法。最好的实践是创建一个接口，接口中声明的方法都被映射为网络服务操作。这个接口被称为服务端点接口（SEI,Service Endpoint Interface）。只要我们看到@WebService注解，它标示该接口即为一个SEI。

第七步：

创建CalculatorImpl.java作为JWS类（Java Web服务）
替代CalculatorImpl.java的现有默认代码，增加add()方法的具体实现。

第八步：

下图解释了@webService注解的webservice实现和wsdl之间的映射。Javax.jws.WebService告诉应用服务器这个类需要被看作webservice。Javax.jws.WebService的属性包括：

• name —— webservice的名称，对应WSDL文件的元素
• targetNameSpace —— 从该Web服务生成的WSDL和XML元素使用的XML命名空间
• serviceName —— web服务的服务名称。默认值为jws文件名加上后缀‘service’
• wsdlLocation —— wsdl文件的URL
• endpointInterface —— 这个属性基于存在的webservice服务端点
  

  上图中Calculator接口的webservice名称被映射为WSDL中portType元素提及的webservice名称。
  Calculator.java中的portName，serviceName，targetNameSpace和服务端点接口(SEI)被映射为CalculatorService.wsdl文件

第九步：

现在是时候在Weblogic 12c Server上来运行webservice了。右键点击项目，选择Run on Server，添加CalculatorService项目到Weblogic服务器并配置它们。

第十步：

现在webservice已经部署到服务器上，并暴露给使用的用户。可以通过weblogic服务器控制台使用和控制它。

可以从截屏所示的位置查看和测试wsdl文件。

第十一步：

远程地址的wsdl文件。http://10.0.2.15:7001/CalculatorServiceServer/CalculatorServer?WSDL

第十二步：

下图展示了CalculatorService.wsdl文件，并解释了WSDL文件的主要元素。WSDL是客户端和服务提供者的服务约定。
Definition —— WSDL文件最外层的元素是，它是wsdl文档中定义的所有其他元素的容器，总之，它就是根元素。

• types —— 描述客户端和服务端交互的消息所用到和关联的所有数据类型。它是一个可选字段，types部分引用了定义数据类型的XSD（XML schema definition）。如果这部分为空，则该web服务仅适用简单数据类型。
• message —— 定义了webservice服务方和使用方交换的数据。创建的消息都属于上面的数据类型。
• portType —— 表示称为operations的web服务，每个operation可以有一个或多个消息。
• binding —— 定义了消息如何传输。它可以使用HTTP GET，HTTP POST，SOAP（HTTP协议的上层）。从binding部分WSDL定义从抽象走向具体，提供了关于web服务的具体详情。binding元素必须说明在portType中抽象定义的webservice的实现详情。
• service —— 指定端点，客户端可以从这个路径访问web服务。
  

第十三步：

我们可以在Weblogic Test客户端的帮助下测试webservice。

第十四步：

Weblogic测试客户端能够显示出add操作的成功结果，并给出请求和回复的SOAP消息。

第十五步：

现在我想要创建一个servlet作为webservice客户端，来使用我们上一步创建的Calculator服务。创建一个新的动态Web工程 ——CalculatorServiceClient，增加Oracle WebLogic Web Service Clients切面。

第十六步：

右键点击CalculatorServiceClient工程，依循project->Select New -> Select other -> Search Weblogic Web Service Client向导来创建一个新的web服务客户端。现在输入WSDL文件的引用，在这个例子里我们将使用WSDL文件的远程定义。点击前请确保验证过WSDL文件。

点击下一步将CalculatorServiceServer代码输出到CalculatorService.jar。再点击下一步指定运行时WSDL文件的位置。这里我已经使用了Copy WSDL into client jar(将WSDL复制到客户端的jar包)的选项

第十七步：

现在创建一个用来关联WebService的Servlet类

第十八步：

让我们看一下客户端Servlet的代码：

1

2

3

4

5

6

7

8

9

protectedvoid doGet(HttpServletRequest request, HttpServletResponse response)throws ServletException, IOException {

        CalculatorService service =new CalculatorService();

        Calculator addservice = service.getCalculatorPort();

        intsum = addservice.add(1,6);

        response.setContentType("text/html");

        PrintWriter out = response.getWriter();

        out.println("<h1> SUM="+ sum + "</h1>");      

        System.out.println("result sum-"+ sum);

}

servlet的输出显示了add操作的结果。