java web项目(spring项目)中集成webservice ,实现对外开放接口

什么是WebService?webService小示例 点此了解

下面进入正题:

Javaweb项目(spring项目)中集成webservice ,实现对外开放接口步骤:

准备:

采用与spring兼容性较好的cxf来实现

cxf 的  jar下载地址: http://cxf.apache.org/download.html

选择zip格式下载,解压后的lib目录下的jar

需要最少的jar如下:

cxf-2.3.3.jar
geronimo-annotation_1.0_spec-1.1.1.jar
geronimo-jaxws_2.2_spec-1.0.jar
geronimo-stax-api_1.0_spec-1.0.1.jar
geronimo-ws-metadata_2.0_spec-1.1.3.jar
jaxb-api-2.2.1.jar
jaxb-impl-2.2.1.1.jar
neethi-2.0.4.jar
wsdl4j-1.6.2.jar
XmlSchema-1.4.7.jar
wstx-asl-3.2.9.jar

一：创建webservice服务器

1）创建一个服务接口

1. package com.service;
2. import javax.jws.WebParam;
3. import javax.jws.WebService;
4. @WebService
5. public interface IHelloWorld {
6. public String sayHello(@WebParam(name = "arg0") String text);
7. }

2）是接口实现类

1. package com.service.impl;
2. import javax.jws.WebService;
3. import com.service.IHelloWorld;
4. @WebService(endpointInterface = "com.service.IHelloWorld")
5. public class HelloWorldImpl implements IHelloWorld {
6. public String sayHello(String text) {
7. return "Hello : " + text;
8. }
9. }

3）创建spring配置文件，将服务类加入到容器中

webservice.xml

1. <?xml version="1.0" encoding="UTF-8"?>
2. <beans xmlns="http://www.springframework.org/schema/beans"
3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4. xmlns:p="http://www.springframework.org/schema/p"
5. xmlns:jaxws="http://cxf.apache.org/jaxws"
6. xmlns:cxf="http://cxf.apache.org/core"
7. xsi:schemaLocation="http://www.springframework.org/schema/beans
8. http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
9. http://cxf.apache.org/jaxws
10. http://cxf.apache.org/schemas/jaxws.xsd">
11. <import resource="classpath*:META-INF/cxf/cxf.xml" />
12. <import resource="classpath*:META-INF/cxf/cxf-extension-soap.xml" />
13. <import resource="classpath*:META-INF/cxf/cxf-servlet.xml" />
14. <!--下面的class属性值一定要跟你项目中服务实现类的包路径完全一致-->
15. <bean id="hello" class="com.service.impl.HelloWorldImpl"/>
16. <jaxws:endpoint id="helloWorld" implementor="#hello" address="/HelloWorld" />
17. </beans>

在web.xml中添加webservice.xml配置文件

1. <context-param>
2. <param-name>contextConfigLocation</param-name>
3. <param-value>
4. /WEB-INF/webservice.xml
5. </param-value>
6. </context-param>

4）在web.xml中加入cxf servlet

1. <servlet>
2. <display-name>CXF Servlet</display-name>
3. <servlet-name>CXFServlet</servlet-name>
4. <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
5. <load-on-startup>1</load-on-startup>
6. </servlet>
7. <servlet-mapping>
8. <servlet-name>CXFServlet</servlet-name>
9. <url-pattern>/webservice/*</url-pattern>
10. </servlet-mapping>

至此，webservice服务器就创建好了，

在浏览器中访问：http://localhost:8080/test/webservice/HelloWorld?wsdl，(test是项目名称)。如果出现了类似与

<wsdl:definitions xmlns:ns1="http://service.com/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://impl.service.com/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="HelloWorldImplService" targetNamespace="http://impl.service.com/">
。。。。

就配置成功了。

接下来贴几个运行时的错误解决方法

1：webservice.xml中提示cxf.xml，cxf-servlet.xml not found，我在上面写的路径是classpath*:META-INF/cxf/cxf.xml，这里的classpath后面还跟了一个“*”符号，没加符号表示只在类路径下查找cxf.xml文件，加了号表示不仅在类路径下查找xml文件，还在jar包中查找xml文件。所以当我们在项目类路径下没有假如cxf.xml等配置文件时，就一定要在classpath后加*，这样spring容器才会去所加入的jar包中找。

2：假如cxf servlet时，映射路径不要写成/*，否则会出现访问不了项目主页的情况，可以写成/webservice/*或者别的项目中没有使用过的路径来作为cxf servlet的请求路径。

二：创建webservice客户端

客户端可以和服务器放在同一个项目中用来测试，也可以新建一个Java项目来进行测试。

新建一个Java项目测试时，要假如对应的jar包，跟服务器一样，使用spring还要假如spring jar包。

我在这里新建一个项目，依旧使用spring来测试

1）首先要创建一个和服务器端一样的服务接口，（如果客户端和服务器端在同一个项目中则可以省略这步）

1. package com.service;
2. import javax.jws.WebParam;
3. import javax.jws.WebService;
4. @WebService
5. public interface IHelloWorld {
6. public String sayHello(@WebParam(name = "arg0") String text);
7. }

2）创建spring-client.xml，

1. <?xml version="1.0" encoding="UTF-8"?>
2. <beans xmlns="http://www.springframework.org/schema/beans"
3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"
4. xmlns:jaxws="http://cxf.apache.org/jaxws" xmlns:cxf="http://cxf.apache.org/core"
5. xsi:schemaLocation="http://www.springframework.org/schema/beans
6. http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
7. http://cxf.apache.org/jaxws
8. http://cxf.apache.org/schema/jaxws.xsd">
9. <bean id="client" class="com.service.IHelloWorld" factory-bean="clientFactory" factory-method="create" />
10. <bean id="clientFactory" class="org.apache.cxf.jaxws.JaxWsProxyFactoryBean">
11. <property name="serviceClass" value="com.service.IHelloWorld" />
12. <property name="address" value="http://localhost:8080/test/HelloWorld" />
13. </bean>
14. </beans>

3）测试类

1. package com.test;
2. import org.springframework.context.ApplicationContext;
3. import org.springframework.context.support.ClassPathXmlApplicationContext;
4. import com.service.IHelloWorld;
5. public class Test {
6. public static void main(String[] args) {
7. ApplicationContext ctx = new ClassPathXmlApplicationContext("spring-client.xml");
8. IHelloWorld client = (IHelloWorld) ctx.getBean("client");
9. String result = client.sayHello("你好!");
10. System.out.println(result);
11. }
12. }

运行成功后显示

Hello：你好！

文章参考: http://www.open-open.com/lib/view/open1405929509210.html