CXF框架webservice教程.pdf

Apache CXF是一个开源的Java框架，用于构建和部署SOAP（Simple Object Access Protocol）和RESTful（Representational State Transfer）Web服务。本教程将详细介绍如何使用CXF框架来创建和消费Web服务。 你需要从Apache官方网站下载CXF的开发包，例如在本例中是`apache-cxf-2.4.3.zip`。这个ZIP文件包含了所有必要的JAR文件，你需要将它们添加到你的Java项目的类路径中。如果你使用的是JDK 1.6，可能会遇到一个问题，即JAXB 2.1 API与CXF中的版本冲突。为解决这个问题，你需要将CXF库中的`endorsed`目录复制到JDK的`jre\lib`目录下，以便正确加载所需的API。 接下来，创建一个普通的Java项目，例如`HelloCxfServer`，并定义一个名为`HelloWorld`的接口和它的实现类`HelloWorldImpl`。在接口上添加`@WebService`注解，声明这是一个Web服务接口。然后在实现类上同样添加`@WebService`注解，表示这是接口的实现。例如： ```java package test; import javax.jws.WebService; @WebService public interface HelloWorld { String sayHello(String name); } package test; import javax.jws.WebService; @WebService public class HelloWorldImpl implements HelloWorld { @Override public String sayHello(String name) { System.out.println("sayHello方法被调用 ..."); return "hello, " + name; } } ``` CXF内置了一个Web服务容器Jetty，它可以作为一个轻量级的Web服务器，类似于Tomcat，用于发布Web服务。为了启动服务，你可以创建一个`MainServer`类，使用`JaxWsServerFactoryBean`来配置和创建服务器，并设置服务类和发布地址。例如： ```java package test; import org.apache.cxf.endpoint.Server; import org.apache.cxf.jaxws.JaxWsServerFactoryBean; public class MainServer { public static void main(String[] args) { JaxWsServerFactoryBean factory = new JaxWsServerFactoryBean(); factory.setServiceClass(HelloWorldImpl.class); factory.setAddress("http://localhost:6666/MyCxfService"); Server server = factory.create(); server.start(); } } ``` 运行`MainServer`类后，服务会在指定地址（如`http://localhost:6666/MyCxfService`）上发布。你可以通过浏览器访问`http://localhost:6666/MyCxfService?wsdl`来查看生成的WSDL（Web服务描述语言）文件，它是Web服务的接口规范。 为了消费这个Web服务，你需要创建一个客户端。这通常可以通过使用CXF的`JaxWsProxyFactoryBean`来实现，它可以帮助你创建一个代理对象，这个对象可以像调用本地Java对象一样调用远程Web服务。例如： ```java package test; import org.apache.cxf.frontend.ClientProxyFactoryBean; public class HelloWorldClient { public static void main(String[] args) { ClientProxyFactoryBean factory = new ClientProxyFactoryBean(); factory.setServiceClass(HelloWorld.class); factory.setServiceEndpointAddress("http://localhost:6666/MyCxfService"); HelloWorld proxy = (HelloWorld) factory.create(); System.out.println(proxy.sayHello("World")); } } ``` 当你运行`HelloWorldClient`时，它会调用服务器上的`sayHello`方法，并打印出结果。 总结来说，Apache CXF提供了一套完整的工具和API，使得创建、发布和消费Web服务变得简单。通过注解驱动的方式，开发者可以快速地构建符合WS-I标准的SOAP服务，同时也支持RESTful风格的服务。此外，CXF还集成了多种协议和数据绑定机制，如JAXB和XMLBeans，提供了灵活的配置选项和强大的故障排除工具。