使用CXF发布WebService服务简单实例

一、说明:

前面介绍了使用axis2来发布Webservice服务,现在介绍一种更popular,更高效的Webservice服务发布技术:CXF

Apache CXF = Celtix + XFire,Apache CXF 的前身叫 Apache CeltiXfire,现在已经正式更名为 Apache CXF 了,以下简称为 CXF。CXF 继承了 Celtix 和 XFire 两大开源项目的精华,提供了对 JAX-WS 全面的支持,并且提供了多种 Binding 、DataBinding、Transport 以及各种 Format 的支持,并且可以根据实际项目的需要,采用代码优先(Code First)或者 WSDL 优先(WSDL First)来轻松地实现 Web Services 的发布和使用。目前它仍只是 Apache 的一个孵化项目。

Apache CXF 是一个开源的 Services 框架,CXF 帮助您利用 Frontend 编程 API 来构建和开发 Services ,像 JAX-WS 。这些 Services 可以支持多种协议,比如:SOAP、XML/HTTP、RESTful HTTP 或者 CORBA ,并且可以在多种传输协议上运行,比如:HTTP、JMS 或者 JBI,CXF 大大简化了 Services 的创建,同时它继承了 XFire 传统,一样可以天然地和 Spring 进行无缝集成。

CXF 框架是一种基于 Servlet 技术的 SOA 应用开发框架,要正常运行基于 CXF 应用框架开发的企业应用,除了 CXF 框架本身之外,还需要 JDK 和 Servlet 容器的支持。

二、利用CXF进行简单webservice服务的发布与调用

①.  新建一个Java Project  ,CXFDemo ,并在工程下新建lib文件夹,加入CXF的jar包:

cxf-core-3.1.4.jar
jaxb-core-2.2.11.jar
jaxb-impl-2.2.11.jar
neethi-3.0.3.jar
wsdl4j-1.6.3.jar
xmlschema-core-2.2.1.jar

然后build path ,将架包加入到类路径下。

②.  在src下,新建3个package ,并分别在各个包下创建对应的相关接口和类:

com.elgin.cxf.entities
com.elgin.cxf.service
com.elgin.cxf.service.impl

❶、在service包下新建接口  HelloService

package com.elgin.cxf.service;

import javax.jws.WebParam;
import javax.jws.WebService; import com.elgin.cxf.entities.User; @WebService
public interface HelloService { public String sayHello(@WebParam(name="text")String text); public String sayHellloToUser(User user);
}

❷、在service.impl 包下新建接口的实现类 HelloServiceImpl

package com.elgin.cxf.service.impl;

import javax.jws.WebService;

import com.elgin.cxf.entities.User;
import com.elgin.cxf.service.HelloService; @WebService(endpointInterface="com.elgin.cxf.service.HelloService",serviceName="HelloService")
public class HelloServiceImpl implements HelloService { @Override
public String sayHello(String text) {
System.out.println("param text is :" + text);
return "hello " + text;
} @Override
public String sayHellloToUser(User user) {
System.out.println("param user is :" +user);
return "hello " + user.getName();
} }

❸、entities包下新建用到的User类:

package com.elgin.cxf.entities;

public class User {
private String name; public String getName() {
return name;
} public void setName(String name) {
this.name = name;
} public User(){} public User(String name) {
super();
this.name = name;
} @Override
public String toString() {
return "User [name=" + name + "]";
} }

③.  新建package  :com.elgin.cxf.publish

并在此包下新建类: Server  用来发布webservice服务:

package com.elgin.cxf.publish;

import javax.xml.ws.Endpoint;

import com.elgin.cxf.service.impl.HelloServiceImpl;

public class Server {
public static void main(String[] args) {
System.out.println("cxf service start..");
HelloServiceImpl serviceImpl=new HelloServiceImpl();
String address="http://localhost:8080/service/hello";
Endpoint.publish(address, serviceImpl);
}
}

④  运行查看发布情况:

在浏览器输入:http://localhost:8080/service/hello?wsdl ,出现下图所示数据,表示发布webservice服务成功

使用CXF发布WebService服务简单实例

⑤ 服务调用代码以及结果:

package com.elgin.cxf.client;

import java.net.URL;

import javax.xml.namespace.QName;
import javax.xml.ws.Service;
import javax.xml.ws.soap.SOAPBinding; import com.elgin.cxf.entities.User;
import com.elgin.cxf.service.HelloService; public class Client {
private static final QName SERVICE_NAME
= new QName("http://impl.service.cxf.elgin.com/", "HelloService");
private static final QName PORT_NAME
= new QName("http://impl.service.cxf.elgin.com/", "HelloServicePort"); private Client() {} public static void main(String args[]) throws Exception {
rightInvoker();
exceptionInvoker();
} /*
* @Title: rightInvoker
* @Description: 可成功调用,返回正确的结果
* @throws Exception 参数
*/
public static void rightInvoker() throws Exception {
// Endpoint Address
String endpointAddress = "http://localhost:8080/service/hello";
URL url=new URL(endpointAddress);
Service service = Service.create(url,SERVICE_NAME); HelloService hs = service.getPort(HelloService.class);
System.out.println(hs.sayHello("World")); User user = new User("Jack");
System.out.println(hs.sayHellloToUser(user));
} /*
* @Title: exceptionInvoker
* @Description: 调用时出现异常错误信息:
*
* Exception in thread "main" javax.xml.ws.WebServiceException:
* WSDL Metadata not available to create the proxy,
* either Service instance or ServiceEndpointInterface com.elgin.cxf.service.HelloService should have WSDL information
*
* 对于造成上述异常的具体原因尚不明确,很有可能是缺少CXF某个jar包引起
*/
public static void exceptionInvoker(){
// Endpoint Address
Service service = Service.create(SERVICE_NAME);
String endpointAddress = "http://localhost:8080/service/hello";
service.addPort(PORT_NAME, SOAPBinding.SOAP11HTTP_BINDING, endpointAddress);
HelloService hs = service.getPort(HelloService.class);
System.out.println(hs.sayHello("World")); User user = new User("Jack");
System.out.println(hs.sayHellloToUser(user));
}
}

正确运行结果:

hello World
hello Jack
上一篇:jsp中获取当前文件路径


下一篇:JSP中request获取值