WebService详解

WebService 前端之家
前端之家收集整理的这篇文章主要介绍了WebService详解，前端之家小编觉得挺不错的，现在分享给大家，也给大家做个参考。

1、WebService简述

WebService是一个平台独立的，低耦合的，自包含的、基于可编程的web的应用程序，可使用开放的XML（标准通用标记语言下的一个子集）标准来描述、发布、发现、协调和配置这些应用程序，用于开发分布式的互操作的应用程序。 
WebService是应用程序之间的远程调用，调用是跨语言的调用，具有开放性。

2、名词

  • XML

XML. Extensible Markup Language －扩展性标记语言 
XML，用于传输格式化的数据，是Web服务的基础。 
namespace-命名空间。 
xmlns=“http://xxx.cn” 使用默认命名空间。 
xmlns:xxx=“http://xxx.cn”使用指定名称的命名空间。

  • WSDL

WSDL – WebService Description Language – Web服务描述语言。 
通过XML形式说明服务在什么地方－地址。 
通过XML形式说明服务提供什么样的方法 – 如何调用。

  • SOAP

SOAP-Simple Object Access Protocol(简单对象访问协议) 
SOAP作为一个基于XML语言的协议用于有网上传输数据。 
SOAP = 在HTTP的基础上+XML数据。 
SOAP是基于HTTP的。 
SOAP的组成如下：

Envelope – 必须的部分。以XML的根元素出现。 
Headers – 可选的。 
Body –必须的。在body部分，包含要执行的服务器的方法。和发送到服务器的数据。

3、简单入门

3.1、使用JDK发布webService

在JDK1.6中JAX-WS规范定义了如何发布一个webService服务。JAX-WS是指Java Api for XML – WebService。

@H_502_53@ 1、用Jdk1.6.0_21以后的版本发布一个WebService服务. 
2、与Web服务相关的类，都位于javax.jws.*包中。

  • @WebService 
    这是jdk1.6提供的一个注解。它位于：javax.jws.*包中，用在类上指定将此类发布成一个ws服务。 
    给类添加上@WebService注解后，类中所有的非静态方法都将会对外公布。 
    不支持静态方法（static），final方法。 
    如果一个类上，被添加了@WebService注解，则必须此类至少有一个可以公开的方法，否则将会启动失败。

  • Endpoint 
    此类为端点服务类，它的方法publish用于将一个已经添加了@WebService注解对象绑定到一个地址的端口上。 
    Endpoint也是jdk提供的一个专门用于发布服务的类，它的publish方法接收两个参数，一个是本地的服务地址，二是提供服务的类。它位于javax.xml.ws.*包中。

    static Endpoint.publish(String address,Object implementor) 
    ——在给定地址处针对指定的实现者对象创建并发布端点。 
    stop方法用于停止服务。 
    EndPoint发布完成服务以后，将会独立的线程运行。所以，publish之后的代码，可以正常执行。

  • @WebMethod 
    如果希望某个方法(非static,非final)不对外公开，可以在方法上添加@WebMethod(exclude=true)，阻止对外公开
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
package cn.com.webService; import javax.jws.WebMethod; import javax.jws.WebService; import javax.xml.ws.Endpoint; @WebService//添加注解 public class HelloMx { //至少包含一个可以对外公开的服务方法 public String sayHello(String name ){ return "Mx--> "+name; } //此方法不对外发布 @WebMethod(exclude=true) public String sayMx(){ "你好"; } public static void main(String[] args) { //参数一：发布地址 //参数二：提供服务者 Endpoint.publish("http://172.20.43.163:9999/hello",new HelloMx()); } }

可以查看发布后的wsdl说明。地址为你发布的地址+?wsdl 
http://172.20.43.163:9999/hello?wsdl

3.2、wsimport调用发布的webService

wsimport是jdk自带的,可以根据wsdl文档生成客户端调用代码的工具.当然,无论服务器端的WebService是用什么语言写的,都将在客户端生成Java代码.服务器端用什么写的并不重要 
wsimport.exe位于JAVA_HOME\bin目录下. 
常用参数为: 
-d<目录> - 将生成.class文件。默认参数。 
-s<目录> - 将生成.java文件。 
-p<生成的新包名> -将生成的类，放于指定的包下。 
(wsdlurl) - http://server:port/service?wsdl，必须的参数。 
示例： 
C:/> wsimport –s . http://172.20.43.163:9999/hello?wsdl 
注意：-s不能分开，-s后面有个小点，用于指定源代码生成的目录。点即当前目录。

如果使用了-s参数则会在目录下生成两份代码，一份为.class代码。一份为.java代码。 
.class代码，可以经过打包以后使用。.java代码可以直接Copy到我们的项目中运行。

 3.3 调用天气预报 

 使用wsimport命令生成客户端代码 
 wsimport –s . http://webservice.webxml.com.cn/WebServices/WeatherWS.asmx?wsdl
 

 如果报错
 
@H_502_53@ [WARNING] src-resolve.4.2: 解析组件 ‘s:schema’ 时出错。在该组件中检测到 ‘s:schem 
 a’ 位于名称空间 ‘http://www.w3.org/2001/XMLSchema’ 中,但无法从方案文档 ‘http:// 
 webservice.webxml.com.cn/WebServices/WeatherWS.asmx?wsdl#types?schema1’ 引用此名 
 称空间的组件。如果这是不正确的名称空间,则很可能需要更改 ‘s:schema’ 的前缀。如果 
 这是正确的名称空间,则应将适当的 ‘import’ 标记添加到 ‘http://webservice.webxml.c 
 om.cn/WebServices/WeatherWS.asmx?wsdl#types?schema1’。 
 line 15 of http://webservice.webxml.com.cn/WebServices/WeatherWS.asmx?wsdl#typ 
 es?schema1 
 [WARNING] src-resolve: 无法将名称 ‘s:schema’ 解析为 ‘element declaration’ 组件。
 
 

 则右键另存为到本地 WeatherWS.wsdl,将
 

 替换成
 

26
  
  
  • 27
    • 
  
  
  • 28
    • 
  
  
  • 29
    • 
  
  
  • 30
    • 
  
  
  • 31
    • 
  
  
  • 32
    • 
  
  
  • 33
    • 
  
  
  • 34
    • 
  
  
  • 35
    • 
 
 package cn.com.test;

import java.util.List;

import cn.webservice.HelloMx;
import cn.HelloMxService.webxml.ArrayOfString.WeatherWS.WeatherWSSoap;

public class TestWebService {

    public static void main(String[] args) {
        WeatherWS ws = new WeatherWS();
        WeatherWSSoap ww = ws.getWeatherWSSoap();
        ArrayOfString as = ww.getWeather("广州",null);
        List<String> list = as.getString();
        for (String string : list) {
            System.out.println(string);
        }
        /* * 广东 广州 广州 2350 2015/07/14 21:19:35 今日天气实况：气温：31℃；风向/风力：东南风 1级；湿度：68% * 空气质量：暂无；紫外线强度：中等 太阳镜指数：非常必要。建议佩戴透射比3级且100%UV吸收的遮阳镜。 * 穿衣指数：炎热。建议穿短衫、短裤等清凉夏季服装。 旅游指数：一般。天气热，外出请注意防暑降温和防晒。 * 运动指数：较不宜。注意适当减少运动时间并降低运动强度。 洗车指数：较适宜。无雨且风力较小，易保持清洁度。 * 化妆指数：防脱水。请选用防脱水化妆品。 感冒指数：少发。感冒机率较低，避免长期处于空调屋中。 空气污染指数：暂无。 * 紫外线指数：中等。涂擦SPF大于15、PA+防晒护肤品。 舒适度指数：很不舒适。烈日炎炎，很热。 * * 7月14日 多云 26℃/35℃ 无持续风向微风 1.gif 1.gif 7月15日 多云 27℃/35℃ 无持续风向微风 1.gif * 1.gif 7月16日 多云转雷阵雨 26℃/35℃ 无持续风向微风 1.gif 4.gif 7月17日 多云 26℃/32℃ * 无持续风向微风 1.gif 1.gif 7月18日 多云 26℃/32℃ 无持续风向微风 1.gif 1.gif */
    }
} 

     3.4、简单分析
     

      

    1.  
       WebService只采用HTTP POST方式传输数据，不使用GET方式; – 握手，WSDL-get, 
       普通http post的contentType为application/x-www-form-urlencoded 
       WebService的contentType为－即在Http的基础上发SOAP协议 
       text/xml 这是基于soap1.1协议。 
       application/soap+xml 这是基于soap1.2协议。
       
      2.  
 
    2.  
       WebService从数据传输格式上作了限定。WebService所使用的数据均是基于XML格式的。目前标准的WebService在数据格式上主要采用SOAP协议。SOAP协议实际上就是一种基于XML编码规范的文本协议。
       
      3.  
 
    3.  
       SOAP – Simple Object Access protocol 简单对像访问协议。是运行在HTTP协议基础之上的协议。其实就是在HTTP协议是传输XML文件，就变成了SOAP协议。
       
      4.  
 
    4.  
       SOAP1.1和SOAP1.2的 namespace不一样。可以通过查看类 
       javax.xml.ws.soap.SOAPBinding来查看里面的常量 
       默认情况下，Jdk1.6只支持soap1.1 
       即：@BindingType(value=javax.xml.ws.soap.SOAPBinding.SOAP11HTTP_BINDING)
       
      5.  

    

     3.5、WebService和Web服务器的区别
     

      

    1. 我们可以把WebService看作是Web服务器上应用；反过来说，Web服务器是WebService运行时所必需的容器。这就是它们的区别和联系。
      2.  
 
    2. 使用JDK1.6发布的简单Web服务，其内部其实是使用Socket实现。可以查看：SUN公司未对外公布的API类com.sun.xml.internal.ws.transport.http.server. ServerMgr获知，请使用反编译工具
      3.  

    

     3.6、WebService的特点
     

      

    1. WebService通过HTTP POST方式接受客户的请求
      2.  
 
    2. WebService与客户端之间一般使用SOAP协议传输XML数据
      3.  
 
    3. 它本身就是为了跨平台或跨语言而设计的
      4.  

    

     3.7、修改wsdl文件
     

     WSDL文件的内容，一般由服务默认生成，但为了更好的向开发人员提供使用说明书，一般应做一些简单的修改。至少不应该暴露我们的包结构。而targetNamespace默认情况下为倒置的包名，这已经暴露了我们的包结构。 
     通过在类文件上添加以下注解，可以修改wsdl生成的各元素，而不是直接去修改wsdl文件，直接去修改wsdl文件是无效的。 
     WebService的注解包括： 
     @WebService-定义服务 –类上 
     @WebMethod-定义方法 － 方法 
     @WebResult-定义返回值 – 返回值 
     @WebParam-定义参数 – 参数
     

     4、使用CXF发布WebService
     

     4.1、搭建环境
     

      

    1. 下载cxf 
       Apache CXF = Celtix + XFire，开始叫 Apache CeltiXfire，后来更名为 Apache CXF 了，以下简称为 CXF。CXF 继承了 Celtix 和 XFire 两大开源项目的精华，提供了对 JAX-WS 全面的支持，并且提供了多种 Binding 、DataBinding、Transport 以及各种 Format 的支持，并且可以根据实际项目的需要，采用代码优先（Code First）或者 WSDL 优先（WSDL First）来轻松地实现 Web Services 的发布和使用。Apache CXF已经是一个正式的Apache顶级项目。（来自百度百科） 
       可以去Apache官网下载最近版本。http://cxf.apache.org/ 
       下载后可以配置cxf环境变量，使用wsdl2java生成客户端代码，使用jdk的wsimport只能soap1.1版本，不支持soap1.2。
      2.  
 
    2. jar包 
       新建web项目 拷贝cxf lib下的jar包至项目中。
      3.  
 
    3. 配置cxf核心servlet 
       在项目web.xml 中配置cxf 核心servlet
      4.  

    

     4.2、非接口发布 


  • 发布配置
    •  


  • 客户端调用 
     wsdl2java -d . http://127.0.0.1:8080/demo/cxf/hello?wsdl 
     生成客户端代码
    •  


     4.3、带接口发布 

      

    • 接口类
      •  

    

  • 实现类
    •  


  • 配置服务
    •  


  • 客户端调用
    •  


     4.4、配置spring启动加载cxf配置文件 

    web-app version="2.4" "http://java.sun.com/xml/ns/j2ee" "http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

    <!-- 通过上下文参数指定spring配置文件的位置 -->
    context-param>
        param-name>contextConfigLocationparam-name>
        param-value>
    context-param>
    listener>
        listener-class>
            org.springframework.web.context.ContextLoaderListener
        listener-class>
    listener>

    <!-- 通过初始化参数指定cxf配置文件的位置 -->
        <!-- <init-param> <param-name>config-location</param-name> <param-value>classpath:cxf-servlet.xml</param-value> </init-param> -->
    servlet-mapping>
  welcome-file-list>
    welcome-file>index.jspwelcome-file>
  welcome-file-list>
web-app>

    猜你在找的WebService相关文章

    WebService支持多平台上传文件的实现
    要使用网站上传文件，在ASP.NET的范畴，我基本上能想到的有两类，一类是通过HTTP POST请求...
    在centos上部署docker与wordpress
    简介 有一个wordpress服务器需要迁移了，之前都是别人维护的，现在需要迁移到自己维护，给...
    RESTful设计中的常见疑问
    最近写了几个有关RESTful的API相关内容，也谈谈对常见问题的自己的理解。 1.什么是RESTful...
    SourceTree使用教程--创建分支，合并分支
    https://www.jianshu.com/p/ea9ebad692d2
    .htaccess
    RewriteEngine On# 将404页面跳转到 http://abc.com/ ErrorDocument 404 http://abc.com/#...
    透视和调整你的企业和商务系统（Ⅰ：Analyzing、Requirement）
    透视和调整你的企业和商务系统（Ⅰ：Analyzing、Requirement）   小气的神 2001-10-09  ...
    透视和调整你的企业和商务系统（Ⅲ：SOAP、WebService、Client）
    透视和调整你的企业和商务系统（Ⅲ：SOAP、WebService、Client）   小气的神 2001-10-13 ...
    透视和调整你的企业和商务系统（Ⅲ：SOAP、WebService、Server）
    透视和调整你的企业和商务系统（Ⅲ：SOAP、WebService、Server）   小气的神 2001-10-12 ...
    透视和调整你的企业和商务系统（Ⅳ：WebService、dotNET）
    透视和调整你的企业和商务系统（Ⅳ：WebService、dotNET）   小气的神 2001-10-15     ...
    增补透视一文：将ADO.NET或Webservice返回的DataSet转换成ADODB.Recordset
    增补透视一文：将ADO.NET或Webservice返回的DataSet转换成ADODB.Recordset   小气的神 20...
    LinuxWindowsCentOSUbuntuNginxWebServiceScalaMemcacheApacheRedisDockerBashAzureTomcatLNMPShell数据结构服务器运维网络安全
    xebugnodemondocker-copydcoselasticsearcwindows-contdocker-windodocker-awsamazon-cloudenvoyproxyhashicorp-vaswisscomdevkafka-pythonzscalerphoton-osdocker-swarmkamongoogle-cloudconcoursewso2-ampersistent-vapi-managerprocess-manamanjarojenkins-workhypriotremoteapikeystonejsbitcoindbitcoin-test