目录:
[一]、前言概述
在2010年3月曾经写过一篇?xfire webservices图文介绍详细步骤,当时只是写了一个XFire中最基本功能的演示,本次打算对XFire一系列应用配合实际的代码演示逐步做下介绍。
[二]、环境配置
[三]、构建项目
创建项目?xfire-base-demo:
class="brush: bash; gutter: true; first-line: 1">mvn archetype:create -DgroupId=com.micmiu.xfire.demo -DartifactId=xfire-base-demo -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false
转为Eclipse项目并导入到Eclipse 中:
mvn eclipse:eclipse
创建和配置相关的源目录和编译目录,.classpath?文件内容如下:
<?xml version="1.0" encoding="UTF-8"?> <classpath> <classpathentry kind="src" output="target/classes" path="src/main/java"/> <classpathentry kind="src" output="target/classes" path="src/main/resources"/> <classpathentry kind="src" output="target/test-classes" path="src/test"/> <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/> <classpathentry kind="con" path="org.maven.ide.eclipse.MAVEN2_CLASSPATH_CONTAINER"/> <classpathentry kind="output" path="target/classes"/> </classpath>
添加相关的依赖,修改POM.xml?添加如下内容:
<dependency> <groupId>javax.servlet</groupId> <artifactId>servlet-api</artifactId> <version>2.3</version> <type>jar</type> <scope>compile</scope> </dependency> <dependency> <groupId>org.codehaus.xfire</groupId> <artifactId>xfire-all</artifactId> <version>1.2.6</version> <type>jar</type> <scope>compile</scope> </dependency>
[四]、服务端的实现
创建基础的package:com.micmiu.xfire.demo.base
1.服务端接口:HelloWorldService.java
package com.micmiu.xfire.demo.base; /** * * @blog http://www.micmiu.com * @author Michael */ public interface HelloWorldService { /** * return welcome * @param username * @return */ String sayHello(String username); }
2.服务端接口的实现:HelloWorldServiceImpl.java
package com.micmiu.xfire.demo.base; /** * @blog http://www.micmiu.com * @author Michael */ public class HelloWorldServiceImpl implements HelloWorldService { public String sayHello(String username) { return "Hi," + username + " welcome,see more http://www.micmiu.com"; } }
3.XFire相关配置
在源目录 src/main/java 下创建两级目录:META-INF/xfire?,然后在该目录下创建文件:services.xml?,具体内容如下:
<!-- START SNIPPET: services --> <beans xmlns="http://xfire.codehaus.org/config/1.0"> <service> <name>HelloWorldService</name> <namespace>http://demo.xfire.micmiu.com/HelloWoldService</namespace> <serviceClass>com.micmiu.xfire.demo.base.HelloWorldService </serviceClass> <implementationClass>com.micmiu.xfire.demo.base.HelloWorldServiceImpl </implementationClass> </service> </beans> <!-- END SNIPPET: services -->
修改文件: src\main\webapp\WEB-INF\web.xml?,内容如下:
<web-app> <display-name>Michael's demo www.micmiu.com</display-name> <servlet> <servlet-name>XFireServlet</servlet-name> <display-name>XFire Servlet</display-name> <servlet-class> org.codehaus.xfire.transport.http.XFireConfigurableServlet </servlet-class> </servlet> <servlet-mapping> <servlet-name>XFireServlet</servlet-name> <url-pattern>/servlet/XFireServlet/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>XFireServlet</servlet-name> <url-pattern>/services/*</url-pattern> </servlet-mapping> </web-app>
4.发布webservice
方法一:运用eclipse 中Jetty插件,直接运行该项目,日志如下:
Running Jetty 6.1.26 2012-07-27 14:33:49.020:INFO::Logging to STDERR via org.mortbay.log.StdErrLog ParentLoaderPriority enabled Context path:/xfire-base-demo ProjectClassLoader: entry=... ...... ProjectClassLoader: entry=... Excluded entry=D:\workspace_dev\xfire-examples\xfire-base-demo\target\test-classes 2012-07-27 14:33:49.112:INFO::jetty-6.1.26 2012-07-27 14:33:49.666:INFO::Started SelectChannelConnector@0.0.0.0:8080
方法二:如果没有安装jetty插件,在POM.xml 文件的节点<build><plugins>…</plugins></build>中增加:
<plugin> <groupId>org.mortbay.jetty</groupId> <artifactId>maven-jetty-plugin</artifactId> <version>6.1.26</version> <configuration> <webAppSourceDirectory>${basedir}/src/main/webapp</webAppSourceDirectory> </configuration> </plugin>
再配置goals相关参数:jetty:run?即可运行
不管用哪种方法运行后,浏览器中打开webservice的URL如下:
看到上图中的信息,服务已经发布成功。
ps:?本机已经把 demo.micmiu.com 映射到localhost
[五]、客户端的实现
编写客户端代码:HelloWorldClient.java
package com.micmiu.xfire.demo.base; import org.codehaus.xfire.client.XFireProxyFactory; import org.codehaus.xfire.service.Service; import org.codehaus.xfire.service.binding.ObjectServiceFactory; /** * * @blog http://www.micmiu.com * @author Michael */ public class HelloWorldClient { /** * @param args */ public static void main(String[] args) { String url = "http://demo.micmiu.com:8080/xfire-base-demo/services/HelloWorldService"; try { Service serviceModel = new ObjectServiceFactory() .create(HelloWorldService.class); System.out.println(" ----> 初始客户端 <---- "); HelloWorldService client = (HelloWorldService) new XFireProxyFactory() .create(serviceModel, url); System.out.println(client.sayHello("Michael")); System.out.println(" ----> 客户端调用结束 <---- "); } catch (Exception e) { e.printStackTrace(); } } }
运行日志:
----> 初始客户端 <---- Hi,Michael welcome,see more http://www.micmiu.com ----> 客户端调用结束 <----
从上面的日志信息可以看出调用成功了。
附录:完整实现后项目的基本目录结构如下:
D:\workspace_dev\xfire-examples\xfire-base-demo> │ .classpath │ .project │ pom.xml │ ├─.settings │ org.eclipse.jdt.core.prefs │ org.maven.ide.eclipse.prefs │ ├─src │ ├─main │ │ ├─java │ │ │ ├─com │ │ │ │ └─micmiu │ │ │ │ └─xfire │ │ │ │ └─demo │ │ │ │ └─base │ │ │ │ HelloWorldClient.java │ │ │ │ HelloWorldService.java │ │ │ │ HelloWorldServiceImpl.java │ │ │ │ │ │ │ └─META-INF │ │ │ └─xfire │ │ │ services.xml │ │ │ │ │ ├─resources │ │ └─webapp │ │ │ index.jsp │ │ │ │ │ └─WEB-INF │ │ web.xml │ │ │ └─test └─target │ xfire-base-demo.war │ ├─classes │ ├─com │ │ └─micmiu │ │ └─xfire │ │ └─demo │ │ └─base │ │ HelloWorldClient.class │ │ HelloWorldService.class │ │ HelloWorldServiceImpl.class │ │ │ └─META-INF │ └─xfire │ services.xml │ ├─maven-archiver │ pom.properties │ ├─surefire ├─test-classes └─xfire-base-demo