WebService技术入门

    一、Webservice简介

             1、 WebService是一种跨编程语言和跨操作系统平台的远程调用技术。具有异构平台的互通性,软件的复用性等优点。

             2、WebService的三要素： 

       （1）SOAP(简单对象访问协议)，基于HTTP协议，采用XML格式，用来传递信息的格式。

       （2）WSDL: 用来描述如何访问具体的服务。（相当于说明书）

       （3）UDDI: 用户自己可以按UDDI标准搭建UDDI服务器，用来管理，分发，查询WebService 。其他用户可以自己注册   发布WebService调用。

二、实现

                  1、在编写客户端代码时，需要先了解WSDL文件的基本信息。在所给的WebService访问地址的后面加上“？wsdl”，在 在浏览器中打开访问webservice接口的wsdl文件。需要了解wsdl文件的三个基本属性，在客户端编码时，需要用到这几个属性值。

            2、 基于JDK开发的实现方式

               服务端的实现一般分为三步：

               (1)编写接口

public interface WeatherWS { public String getMsg(String CityName); } 

             （2）实现类(需要在实现类中加入注解@Webservice)

@WebService public class WeatherWSImpl implements WeatherWs{ @Override public String getMsg(String CityName) { return "大阴天"+CityName; } } 

        （3）发布

public class AppWebService { public static void main( String[] args ) { Endpoint.publish("http://localhost:8080/webservice",new WeatherImpl()); System.out.println("发布成功"); } } 

     其中http://localhost:8080/webservice为发布地址，运行程序后，可用http://localhost:8080/webservice?wsdl访问，访问发布成功后的wsdl文件。

     客户端的实现步骤：（并未与上述的服务端配对，只是实现思路）

    （1）使用wsimport命令，根据服务端发布的地址在所建项目的src目录下，生成代码。

             在黑窗口切换到所建立客户端项目的src目录，再采用wsimport命令生成代码，操作如下图。

     （2）编写实现类

public class WeatherClient{ public static void main(String[] args) { //1.创建服务类，wsdl文件的server属性。 MobileCodeWS ms=new MobileCodeWS(); //2.创建实现类对象,wsdl文件的端口类型属性。 MobileCodeWSSoap port= ms.getPort(MobileCodeWSSoap.class); //3.获取实现方法，wsdl文件的端口类型属性里面的实现方法。 String msg=port.getMobileCodeInfo("手机号码",null); System.out.println(msg); } } 

      另外，有些网络上发布的地址，在生成客户端代码时，会出现错误。例如http://www.webxml.com.cn/zh_cn/web_services.aspx  发布的天气预报，根据其wsdl文件生成代码时，会出现错误。

解决方法：把网络上的wsdl文件源码复制下来，在本地创建一个wsdl文件，然后用 
替换掉
 
 部分，再根据本地wsdl生成代码即可。

3、基于CXF的实现方式

    (1)CXF简介：Apache CXF （ CXF=celtix+Xfire的组合）是一个开源的 WebService 框架，CXF可以用来构建和开发           WebService，CXF 大大简化了WebService并且可以天然地和 Spring 进行无缝集成，核心是org.apache.cxf.Bus(总线)。

    (2)实现

      前提：需要下载CXF框架，并配置好CXF的环境变量，然后把CXF框架中的lib文件下的jar包添加到项目中（客户端和服务端端都一样）。

      服务端代码的编写一般分为三步：

      第一、编写接口

@WebService public interface WeatherWS { public String getMsg(String CityName); } 

      第二、实现类

public class WeatherImpl implements WeatherWs{ @Override public String getMsg(String CityName) { return "大晴天"+CityName; } } 

  第三、发布

public class Weathermain{ public static void main(String[] args) { JaxWsServerFactoryBean factoryBean=new JaxWsServerFactoryBean(); //1.设置服务地址 factoryBean.setAddress("http://localhost:8888/weather"); //2.设置服务接口 factoryBean.setServiceClass(WeatherWs.class); //3.设置服务实现类 factoryBean.setServiceBean(new WeatherImpl()); //通过工厂创建服务 factoryBean.create(); System.out.println("发布成功！"); } } 

客户端的实现：（并未与上述的服务端配对，只是实现思路）

第一、类似于JDK的实现方式，通过 “wsdl2java  –d  .  wsdl文件” 命令，在src目录下生成代码。

第二、编写实现代码

public class test { public static void main(String[] args) { JaxWsProxyFactoryBean svr = new JaxWsProxyFactoryBean(); //1、设置地址，在wsdl文件上有。 svr.setAddress("http://localhost:8888/weather"); //2.实现服务接口，为wsdl上端口类型属性 svr.setServiceClass(Weatherdao.class); //3.创建实现对象 Weatherdao wea=(Weatherdao)svr.create(); //调用方法 String Msg=wea.getMsg("海南"); System.out.println("jname"+name); } } 

4、Sprintboot整合CXF实现Webservice

   （1）添加依赖(我在使用Springboot版本

2.2.1.RELEASE
，发生运行错误，可以使用

2.0.1.RELEASE
这个版本)

 
   
   
   
     org.apache.cxf 
    
   
     cxf-rt-transports-http 
    
   
     3.1.11 
    
   
   
   
     org.apache.cxf 
    
   
     cxf-rt-frontend-jaxws 
    
   
     3.1.11 
    
  

  （2）编写代码

          服务端代码的编写：

         第一、编写接口

@WebService(targetNamespace="http://webservice_cxf.prior.prior/") public interface WeatherWS{ @WebMethod public @WebResult String WeatherMsg(@WebParam(CityNeme= "userName") String CityNeme); } 

        第二，实现类

@Component("WeatherImpl") @WebService( serviceName="WeatherService",//【对外发布的服务名 】：需要见名知意 targetNamespace="http://webservice_cxf.prior.prior/",//【名称空间】：【实现类包名的反缀】 endpointInterface = "prior.prior.webservice_cxf.WeatherWs")//【服务接口全路径】 【接口的包名】 public class WeatherImpl implements WeatherWs{ @Override public String WeatherMsg(String CityName) { return "大阴天： " + CityName; } }

    第三、发布

@Configuration//注册到spring启动中 public class CxfConfig { @Bean public ServletRegistrationBean dispatcherServlet() { return new ServletRegistrationBean(new CXFServlet(), "/cxf/*");// 发布服务名称 localhost:8080/cxf } @Bean(name = Bus.DEFAULT_BUS_ID) public SpringBus springBus() { return new SpringBus(); } @Bean public Endpoint hello() { EndpointImpl endpoint = new EndpointImpl(springBus(), new WeatherImpl());// 绑定要发布的服务实现类 endpoint.publish("/weather"); // 接口访问地址 return endpoint; } } 

   客户端代码的编写:（并未与上述的服务端配对，只是实现思路）

   第一、根据CXF客户端生成代码的命令，生成客户端代码。

   第二、编写实现类

public class getPhoneAddress{ public static String getPhoneMessage(String phone) { //1.生成服务对象 MobileCodeWS ms=new MobileCodeWS(); //2.创建实现类对象 MobileCodeWSSoap port= ms.getPort(MobileCodeWSSoap.class); //3.获取实现方法 String msg=port.getMobileCodeInfo("手机号",null); return msg; }