xfire1.2.6+spring2.5
应用场景:现有一个业务系统,有大量的业务接口,现在根据客户的需求,需要将某些接口的某些方法的包装成webService接口供外部调用。那么该如何实现呢?注意有的接口的方法是不能暴露成外部调用的。
请看下面的例子。假如有两个接口Echo,Hello,Echo中有一个方法echo(),Hello接口中有两个方法say(),say2()。 say()需要包装成webService接口,而say2则不需要。(为了方便学习,举的例子比较简单,但是完全符合上边的场景)。
代码如下:
Echo.java
- package org.codehaus.xfire.spring.example;
- public interface Echo {
- public String echo(String in);
- }
EchoImpl.java
- public class EchoImpl implements Echo
- {
- @Override
- public String echo(String in) {
- return in+"echo的方法正被调用.............";
- }
- }
Hello.java
- package org.codehaus.xfire.spring.example;
- public interface Hello {
- public String say(String name);
- public String say2(String name);
- }
HelloImpl.java
- package org.codehaus.xfire.spring.example;
- public class HelloImpl implements Hello {
- @Override
- public String say(String name) {
- System.out.println(this);
- return "你的程序开始允许对外提供服务"+name;
- }
- @Override
- public String say2(String name) {
- System.out.println(this);
- return "这个接口不能对外提供服务"+name;
- }
- }
大家看到上面代码了,知道该如何解决吗?解决的方法就是用到了xfire中提出的窄接口的概念。我刚开始学习的时候对这个概念一直不理解,知道最近 才有所领悟。所谓的窄接口就是要把包装成了webService的方法写到单独的一个窄接口类中,在这里就是方法echo(),和say(),这两个方法 来自于不同的接口类中。
开发一个窄接口类JrpcxxxxJ.java
- package com.test;
- public interface JrpcxxxxJ {
- public String echo(String in);
- public String say(String name);
- }
窄接口的实现类
- package com.test;
- import org.codehaus.xfire.spring.example.Echo;
- import org.codehaus.xfire.spring.example.Hello;
- /**
- * 定义一个窄接口类
- * @author Administrator
- *
- */
- public class JrpcJmpl implements JrpcxxxxJ{
- private Hello hello;
- private Echo echo;
- @Override
- public String echo(String in) {
- return echo.echo(in);
- }
- @Override
- public String say(String name) {
- return hello.say(name);
- }
- public Hello getHello() {
- return hello;
- }
- public void setHello(Hello hello) {
- this.hello = hello;
- }
- public Echo getEcho() {
- return echo;
- }
- public void setEcho(Echo echo) {
- this.echo = echo;
- }
- }
好了,通过上面的配置我们可以把想包装的方法放到一个单独的接口类中,通过spring 的依赖注入来调用。然后
配置xfire-servlet.xml(这个文件放到/WEB-INF/),内容如下
- <?xml version="1.0" encoding="UTF-8"?>
- <!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN"
- "http://www.springframework.org/dtd/spring-beans.dtd">
- <beans>
- <bean
- class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
- <property name="urlMap">
- <map>
- <entry key="/jpcxx" >
- <ref bean="jpcxx" />
- </entry>
- </map>
- </property>
- </bean>
- <!-- 使用XFire导出器 -->
- <bean id="baseWebService" class="org.codehaus.xfire.spring.remoting.XFireExporter" lazy-init="false" abstract="true">
- <!-- 引用xfire.xml中定义的工厂 -->
- <property name="serviceFactory" ref="xfire.serviceFactory" />
- <!-- 引用xfire.xml中的xfire实例 -->
- <property name="xfire" ref="xfire" />
- </bean>
- <bean id="jpcxx" parent="baseWebService">
- <!-- 业务服务bean -->
- <property name="serviceBean" ref="jpc" />
- <!-- 业务服务bean的窄接口类 -->
- <property name="serviceClass" value="com.test.JrpcxxxxJ" />
- </bean>
- </beans>
下一步就是applicationContext.xml文件(可以放到classpath下,也可以方法web-INF/下,这个通过web.xml指定就可以)
- <beans xmlns="http://www.springframework.org/schema/beans"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xmlns:aop="http://www.springframework.org/schema/aop"
- xmlns:tx="http://www.springframework.org/schema/tx"
- xmlns:context="http://www.springframework.org/schema/context"
- xsi:schemaLocation="
- http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
- http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.5.xsd
- http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.5.xsd
- http://www.springframework.org/schema/context
- http://www.springframework.org/schema/context/spring-context-2.5.xsd">
- <bean id="echoBean" class="org.codehaus.xfire.spring.example.EchoImpl"/>
- <bean id="helloBean" class="org.codehaus.xfire.spring.example.HelloImpl"/>
- <bean id="jpc" class="com.test.JrpcJmpl">
- <property name="echo" ref="echoBean"></property>
- <property name="hello" ref="helloBean"></property>
- </bean>
- </beans>
最后我们来配置web.xml文件,整合xfire+spring2.5,
第一种方法是:这个官方文档提供的方法
- <context-param>
- <param-name>contextConfigLocation</param-name>
- <param-value>
- classpath:applicationContext.xml,
- classpath:org/codehaus/xfire/spring/xfire.xml
- </param-value>
- </context-param>
- <listener>
- <listener-class>
- org.springframework.web.context.ContextLoaderListener
- </listener-class>
- </listener>
- <servlet>
- <servlet-name>xfire</servlet-name>
- <servlet-class>
- org.springframework.web.servlet.DispatcherServlet
- </servlet-class>
- </servlet>
- <servlet-mapping>
- <servlet-name>xfire</servlet-name>
- <url-pattern>/service/*</url-pattern>
- </servlet-mapping>
注意这种方式整合,访问的服务地址是由我们自己指定的。在上边的xfire-servlet.xml文件中,有一段
- <bean
- class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
- <property name="urlMap">
- <map>
- <entry key="/jpcxx" >
- <ref bean="jpcxx" />
- </entry>
- </map>
- </property>
- </bean>
key=jpcxx,其中的jpcxx就是我们webservice访问地址。如下:
http://localhost:8080/工程名/service/jpcxx?wsdl
第二种方式:web.xml
- <servlet>
- <servlet-name>xfire</servlet-name>
- <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
- </servlet>
- <servlet-mapping>
- <servlet-name>xfire</servlet-name>
- <url-pattern>*.ws</url-pattern>
- </servlet-mapping>
- <servlet>
- <!-- 配合Spring容器中XFire一起工作的Servlet-->
- <servlet-name>xfireServlet</servlet-name>
- <servlet-class>org.codehaus.xfire.spring.XFireSpringServlet</servlet-class>
- </servlet>
- <servlet-mapping>
- <servlet-name>xfireServlet</servlet-name>
- <!-- 在这个URI下开放Web Service服务 -->
- <url-pattern>/service/*</url-pattern>
- </servlet-mapping>
- <!-- end XFire 配置 -->
配置好后,你只需要访问http://localhost:8080/工程名service/,就可以看到你当前发布的可用的webservice服务,
如下图:
上面的web.xml中一段注释<!---在URI开发WebService服务->就是上边的效果。
用户只要点击wsdl连接,就可以看到完整的url。注意第二种方式:webService的地址是窄接口类的类名
http://localhost:7979/xfire-spring201/service/JrpcxxxxJ?wsdl,大家可以在Myeclipse用浏览器测试,也可以自己写Client测试。
个人感觉第二种方式比较好,可以随意采用没有多大的区别。至于浏览器测试webService,在我上篇笔记提供的资源地址上有介绍,很方便的。