介绍
-
远程调用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:UsersAdministratorDownloadsapache-cxf-3.1.14in
即解压出来文件的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