远程调用服务框架-CXF(WebServic)

介绍

远程调用web服务,不需要自己编写具体代码,只需要调用作者给出的接口即可.
我们可以调用互联网上查询天气信息Web服务，然后将它嵌入到我们的程序(C/S或B/S程序)当中来，当用户从我们的网点看到天气信息时，他会认为我们为他提供了很多的信息服务，但其实我们什么也没有做，只是简单调用了一下服务器上的一段代码而已。

规则

基于http 协议
传输的内容为xml格式
SOAP作为一个基于XML语言的协议用于在网上传输数据。
- SOAP = 在HTTP的基础上+XML数据。
WSDL – WebService Description Language – Web服务描述语言。
- 用来描述服务的地址和基本方法,java程序通过WSDL来生成对应的代理类来调用具体的方法

Java内置WebService实现

服务端(java 项目),不需要引入jar。

// 服务端启动服务
@WebService   // 注解
public class HelloService {  
    
    public String sayHello(String name){
        System.out.println("服务端say hello");
        return "hello"+name;
    }
    
    public static void main(String[] args) {  // 启动服务
        String address="http://172.27.109.133:8081/hello";   // ip为本机ip  打开cmd  输入ipconfig 找到ipv4即可
        Object implementor=new HelloService();
        Endpoint.publish(address, implementor);
    }

}

当服务端启动服务以后，访问http://172.27.109.133:8081/hello?wsdl出现以下内容则表示服务成功启动，如下图：

客户端

首先需要通过wsimport命令解析出对应的Java文件,然后复制到项目目录

/*
 * 调用服务
 * cmd进入到任意目录 执行命令 wsimport -s . http://192.168.0.108:8080/hello?wsdl
 * 复制文件到项目
 * 然后进行调用 
 * */
public class app {
    public static void main(String[] args) {
    	// 调用方法
        HelloServiceService helloServiceService = new HelloServiceService();   
        HelloService helloServicePort = helloServiceService.getHelloServicePort();
        String sayHello = helloServicePort.sayHello("笑笑");
        System.out.println(sayHello);
    }

}

调用成功

使用CXF框架和Spring整合

CXF是apache旗下的开源框架，由Celtix + XFire这两门经典的框架合成，是一套非常流行的web service框架。

注意：CXF2.X版本和Spring4.X不兼容，要用CXF3.X

服务端

编写接口

@WebService
public interface HelloWorldInterface {
    String sayHello(String text);
}

编写实现类

//@WebService在实现类的注解让CXF知道WSDL创建时所使用的接口。
@WebService(endpointInterface = "webservice.service.HelloWorldInterface")
public class ServerToJava implements HelloWorldInterface {

public String sayHello(String text) {
    return "hello" + text;
}

}

```

导入项目jar Maven：

<properties>
	<spring.version>4.2.4.RELEASE</spring.version>
	<cxf.version>3.2.0</cxf.version>
</properties>

<dependencies>

	<!--spring -->
	<dependency>
		<groupId>org.springframework</groupId>
		<artifactId>spring-core</artifactId>
		<version>${spring.version}</version>
	</dependency>
	<dependency>
		<groupId>org.springframework</groupId>
		<artifactId>spring-beans</artifactId>
		<version>${spring.version}</version>
	</dependency>
	<dependency>
		<groupId>org.springframework</groupId>
		<artifactId>spring-context</artifactId>
		<version>${spring.version}</version>
	</dependency>
	<dependency>
		<groupId>org.springframework</groupId>
		<artifactId>spring-context-support</artifactId>
		<version>${spring.version}</version>
	</dependency>
	<dependency>
		<groupId>org.springframework</groupId>
		<artifactId>spring-test</artifactId>
		<version>${spring.version}</version>
	</dependency>
	<dependency>
		<groupId>org.springframework</groupId>
		<artifactId>spring-web</artifactId>
		<version>${spring.version}</version>
	</dependency>
	<dependency>
		<groupId>org.springframework</groupId>
		<artifactId>spring-webmvc</artifactId>
		<version>${spring.version}</version>
	</dependency>
	
	<dependency>
		<groupId>org.apache.cxf</groupId>
		<artifactId>cxf-rt-transports-http</artifactId>
		<version>3.1.8</version>
	</dependency> <!--web service 以下都是cxf必备的 --> <!--org.apache.cxf.transport.servlet.CXFServlet -->
	<dependency>
		<groupId>org.apache.cxf</groupId>
		<artifactId>cxf-rt-transports-http</artifactId>
		<version>3.1.8</version>
	</dependency> <!--不加这个包会报错Unable to locate spring NamespaceHandler for XML schema namespace 
		[http://cxf.apache.org/jaxws] -->
	<dependency>
		<groupId>org.apache.cxf</groupId>
		<artifactId>cxf-rt-frontend-jaxws</artifactId>
		<version>3.1.8</version>
	</dependency> <!--java实现webservice，不部署到tomcat，需要jetty包支持 -->
	<dependency>
		<groupId>org.apache.cxf</groupId>
		<artifactId>cxf-rt-transports-http-jetty</artifactId>
		<version>3.1.8</version>
	</dependency>
</dependencies>

配置web.xml，因为CXF是基于Servlet所以要配置对应的Servlet

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5"
xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
<display-name>webservice_server</display-name>
<welcome-file-list>
	<welcome-file>index.html</welcome-file>
	<welcome-file>index.htm</welcome-file>
	<welcome-file>index.jsp</welcome-file>
	<welcome-file>default.html</welcome-file>
	<welcome-file>default.htm</welcome-file>
	<welcome-file>default.jsp</welcome-file>
</welcome-file-list>

<context-param>
	<param-name>contextConfigLocation</param-name>
	<param-value>classpath:applicationContext-service.xml</param-value>
</context-param>
<listener>
	<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

<servlet>
	<servlet-name>CXFService</servlet-name>
	<servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
</servlet>
<servlet-mapping>
	<servlet-name>CXFService</servlet-name>
	<url-pattern>/webservice/*</url-pattern>
</servlet-mapping>

</web-app>

创建Spring配置文件， CXF配置可以放在Spring配置文件中，但不要放在SpringMVC文件中

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:p="http://www.springframework.org/schema/p"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:aop="http://www.springframework.org/schema/aop"
xmlns:tx="http://www.springframework.org/schema/tx"
xmlns:jaxws="http://cxf.apache.org/jaxws"
xsi:schemaLocation="
    http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans.xsd
    http://www.springframework.org/schema/context
    http://www.springframework.org/schema/context/spring-context.xsd 
    http://www.springframework.org/schema/aop
    http://www.springframework.org/schema/aop/spring-aop.xsd 
    http://www.springframework.org/schema/tx
    http://www.springframework.org/schema/tx/spring-tx.xsd
    http://cxf.apache.org/jaxws
    http://cxf.apache.org/schemas/jaxws.xsd">

<!-- jax-ws endpoint定义 -->
<bean id="webserviceServer" class="webservice.ServerToJava"/>
<!--发布webservice-->
<jaxws:endpoint id="myService" implementor="#webserviceServer" address="/web-publish"  />
    </beans>

访问时的路径：http://localhost:8080/webservice_server/webservice/web-publish?wsdl 规则为：主机+项目+CXFServlet的访问路径+address，出现对应的wsdl页面即部署成功。

客户端

普通Java程序调用
- 当自己有java的webservice的服务端，即拥有接口的时候，可以直接通过接口和地址进行调用
public class ClientForCXF {
public static MyWebService getInterFace() {
JaxWsProxyFactoryBean factoryBean = new JaxWsProxyFactoryBean();
factoryBean.setServiceClass(MyWebService.class);
factoryBean.setAddress("http://localhost:8080/server/web-publish");
return (MyWebService) factoryBean.create();
}
```
  public static void main(String[] args) {
      MyWebService myWebService = getInterFace();
      System.out.println("client: " + myWebService.add(1, 3));
  }
```
}
```
  ```
```
- 而往往服务端可能由别的语言实现，或者服务端并非我们自己实现，我们没有服务端接口，我们只能获得暴漏的wsdl，并进行调用，这就需要使用wsdl2java生成该wsdl的java客户端并调用了
  - 首先将从官网下载的文件解压，并且配置环境变量为C:\Users\Administrator\Downloads\apache-cxf-3.1.14\bin 即解压出来文件的bin目录
  - 在cmd中输入wsdl2java -help输出信息即表示配置完成，注意，这里不能使用jdk的wsimport
  - cmd进入任意文件夹，运行命令wsdl2java -encoding utf-8 http://localhost:8080/webservice_server/webservice/web-publish?wsdl 然后将生成的文件复制到目录下，随后直接调用就可以
public static void main(String[] args)
ServerToJavaService javaService = new ServerToJavaService();
HelloWorldInterface c = javaService.getServerToJavaPort();
String a = c.sayHello("s");
System.out.println(a);
}
```

通过Spring容器

需要有CXF和Spring的jar
先将接口（只是接口即可）生成出来放到项目中

编写配置文件

    <?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:p="http://www.springframework.org/schema/p"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:aop="http://www.springframework.org/schema/aop"
xmlns:tx="http://www.springframework.org/schema/tx"
xmlns:jaxws="http://cxf.apache.org/jaxws"
xsi:schemaLocation="
    http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans.xsd
    http://www.springframework.org/schema/context
    http://www.springframework.org/schema/context/spring-context.xsd 
    http://www.springframework.org/schema/aop
    http://www.springframework.org/schema/aop/spring-aop.xsd 
    http://www.springframework.org/schema/tx
    http://www.springframework.org/schema/tx/spring-tx.xsd
    http://cxf.apache.org/jaxws
    http://cxf.apache.org/schemas/jaxws.xsd">


<jaxws:client id="crmClient" 
	serviceClass="webservice_client.HelloWorldInterface"   <!-- 对应的接口-->
	address="http://localhost:8080/webservice_server/webservice/web-publish"/> <!-- 地址 -->

</beans>

最后和使用平常的bean一样使用就可以

   public static void main(String[] args) {
        ApplicationContext applicationContext = new ClassPathXmlApplicationContext("applicationContext-service.xml");
        HelloWorldInterface c = (HelloWorldInterface) applicationContext.getBean("crmClient");
        String str = c.sayHello("终于等到你");
        System.out.println(str);

 }

结果

类似的框架还有Alibaba的开源项目Dubbo ，这是入门介绍：http://www.cnblogs.com/liyuhui-Z/p/7799615.html

参考文章：http://www.imooc.com/article/14635

posted @ 2017-11-09 15:30 cccc_hi 阅读(2691) 评论(0) 编辑收藏举报

刷新页面返回顶部