Eclipse+CXF框架开发Web服务实战
一、 说明 采用CXF框架开发webservice。 所用软件及版本如下。
? 操作系统:Window XP SP3。
? JDK:JDK1.6.0_07,http://www.oracle.com/technetwork/java/javase/downloads/index.html。
? Tomcat:apache-tomcat-6.0.14.exe,http://tomcat.apache.org/。
? IDE:eclipse-jee-juno-SR1-win32.zip,http://www.eclipse.org/downloads/。
? CXF:apache-cxf-2.6.10.zip,http://cxf.apache.org/download.html。
二、 JDK配置 安装JDK1.6.0,配置环境变量。
JAVA_HOME:C:\Program Files\Java\jre1.6.0_07。
Path:C:\Program Files\Java\jre1.6.0_07\bin。
CLASSPATH:C:\Program Files\Java\jre1.6.0_07\lib。
因本地只安装了JRE,故配置信息按JRE目录来设置。
三、 Tomcat配置 安装Tomcat,运行apache-tomcat-6.0.14.exe。 端口号:8080 用户名:admin 密码:111111
安装完成后,启动tomcat。 访问:http://localhost:8080/。出现如下界面则部署成功。
四、 CXF服务端 1、下载apache-cxf-2.6.10.zip包,解压后数据如下。
2、新建Dynamic Web Project。 File—New—Project。
工程名:MyService。
Target runtime要与安装的Tomcat一致,若不一致点击“New Runtime”设置。 比如我本地安装的Tomcat为v6.0。
Tomcat installation directory选择Tomcat安装目录。
Default output folder设置为:WebContent/WEB-INF/classes。
3、导入CXF库文件。 CXF库配置。
选中apache-cxf-2.6.10包下的lib目录,导入所有的jar文件。 本机目录为F: \Java开发\apache-cxf-2.6.10\lib。
添加完成后,会出现CXF名称库目录。
4、创建接口IcxfWB。 工程右键—New—Interface,添加代码:
- package com.yxj;
- import javax.jws.WebService;
- import javax.jws.WebParam;
- import javax.jws.WebMethod;
- @WebService
- public interface IcxfWB {
- @WebMethod
- String sayHello(@WebParam(name="name") String name);
- }
说明:
@WebService:标记表示该接口是一个WebService服务。
@WebMethod:标记表示WebService中的方法。
@WebParam(name="paramName")表示方法中的参数,name属性限制了参数的名称,若没有指定该属性,参数将会被重命名。
5、创建服务实现类CxfWBImpl。
- package com.yxj;
- public class CxfWBImpl implements IcxfWB {
- public String sayHello(String name) {
- return "Hello "+name;
- }
- }
6、编辑WebContent/WEB-INF下web.xml文件。
- <?xml version="1.0" encoding="UTF-8"?>
- <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
- <display-name>MyService</display-name>
- <context-param>
- <param-name>contextConfigLocation</param-name>
- <param-value>WEB-INF/service-beans.xml</param-value>
- </context-param>
- <listener>
- <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
- </listener>
- <servlet>
- <servlet-name>CXFServlet</servlet-name>
- <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
- </servlet>
- <servlet-mapping>
- <servlet-name>CXFServlet</servlet-name>
- <url-pattern>/*</url-pattern>
- </servlet-mapping>
- <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>
- </web-app>
7、在WebContent/WEB-INF下创建刚才指定的service-beans.xml文件。
- <?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:jaxws="http://cxf.apache.org/jaxws"
- xsi:schemaLocation="
- http://www.springframework.org/schema/beans
- http://www.springframework.org/schema/beans/spring-beans.xsd
- http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd">
- <import resource="classpath:META-INF/cxf/cxf.xml"/>
- <import resource="classpath:META-INF/cxf/cxf-extension-soap.xml"/>
- <import resource="classpath:META-INF/cxf/cxf-servlet.xml"/>
- <bean id="SayHello" class="com.yxj.CxfWBImpl" />
- <jaxws:endpoint id="sayHello" implementor="#SayHello" address="/sayHello"/>
- </beans>
五、 WebService部署
1、 打包工程
右键工程—Export—WAR file,指定输出路径。
2、 将war文件移动至apache-tomcat\webapps下。 本地操作是,复制F:\MyService.war到目录D:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps。
3、 复制CFX文件到tomcat下。 复制F:\常用软件\Java开发\apache-cxf-2.6.10\lib目录下文件到 F:\JavaRoot\workspace\MyService\WebContent\WEB-INF\lib。
4、 重启Tomcat。 5、 浏览器访问http://localhost:8080/MyService。
六、 CXF客户端
1、生成Stub CXF提供了一个名为“wsdl2java.bat”的工具,该工具可以通过WSDL为特定的服务创建 stub。
本地目录,F:\常用软件\Java开发\apache-cxf-2.6.10\bin\下wadl2java工具。
命令wsdl2java –p 生成代码的包名 –d 生成代码的路径 wsdl地址。
本地命令如下。 wsdl2java -p com.yxj.client -d F:\clientsrc http://localhost:8080/MyService/sayHello?wsdl
生成结果文件在F:\clientsrc,生成文件如图。
2、新建Java Project。
3、将第一步中生成的F:\clientsrc文件夹下的所有java文件移至工程src下,刷新工程。
4、添加CXF包。
使用创建Service时配置好的CXF库。
6、 新建包含有main方法的Class,代码如下。
- package com.yxj.client;
- import org.springframework.context.support.ClassPathXmlApplicationContext;
- import com.yxj.client.IcxfWB;
- public class ClientCall {
- /**
- * @param args
- */
- public static void main(String[] args) {
- // TODO Auto-generated method stub
- ClassPathXmlApplicationContext context
- = new ClassPathXmlApplicationContext(new String[] {"com/yxj/client/client-beans.xml"});
- IcxfWB client = (IcxfWB)context.getBean("sayHello2");
- String response = client.sayHello("World");
- System.out.println("Response: " + response);
- System.exit(0);
- }
- }
7、 在类ClientCall同级目录,即com/yxj/client下新建client-beans.xml配置文件。
文件内容如下。
- <?xml version="1.0" encoding="UTF-8"?>
- <beans xmlns="http://www.springframework.org/schema/beans"
- xmlns:jaxws="http://cxf.apache.org/jaxws"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://www.springframework.org/schema/beans
- http://www.springframework.org/schema/beans/spring-beans.xsd
- http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd">
- <jaxws:client id="sayHello2" serviceClass="com.yxj.client.IcxfWB" address="http://localhost:8080/MyService/sayHello?wsdl"/>
- </beans>
该方式访问ws服务是利用spring的依赖注入法,其中id是spring IOC容器唯一标识符,在代码中也是通过id获得服务对象的(context.getBean("sayHello2"));serviceClass是Webservices服务接口;address是服务的wsdl地址。
8、 运行客户端,控制台输出。
- Hello World
OK,至此大功告成!