Webservice-Java-Xfire

2023-08-15 19:40:46

最近公司最近需要将以前提供出去的接口统一用一个标准来实现，考虑到webservice这个是标 准，因此我花时间大概学习了一下webservice，也对JAVA的几个webservice框架进行了一些小例子的学习。

JAVA调用webservice，当你刚开始接触的时候你会觉得它是一个恶梦，特别是没有一个统一的标准实现，比起.net的那些几步就可以完成的webservice实现，我们看着JAVA的实现真是伤心啊。但就算是伤心，我们也还是要完成的。JAVA也不乏比较好的实现，如xfire,jersey,CXF。有人会说axis2，那个东西，看着就伤心，它不包括在比较好里面，比较差里面反倒有它的一席之位。怎么差，这里先不说，我们慢慢地来看看这几个框架的实现。

今天我们就先一起来看一下xfire的实现，接下来的几天我们会慢慢一起来学习另外的框架。

1）首先，当然是要下包啦，这个普通人都知道。http://xfire.codehaus.org/Download可以到这里去下，可以下all也可以下distribution。但建议还是下all的，免得一堆奇怪的问题搞得你一点信心都没了。

包弄下来了那么怎么办呢？放进项目里啊。貌似废话，但很多人就是不知道下下来要干什么用。

建一个新项目，比较我的是xfireWebservice，这里当然是建web项目啦。

Webservice-Java-XfireWebservice-Java-Xfire

我这里是把它所有的包都放到这里面了，毕竟我们写例子，就没必要挑三拣四了，随便点吧，如果想看看异常信息的朋友可以不把全部放进去，慢慢地加入，以后遇到错误也好排除，但我们这里就不那么做了，毕竟一般缺少什么类那些的异常没什么难看的，大家可以自己排除。

2）我们首先来了解一下xfire与其他webservice框架的不同，它最大的不同之处在于它需要一个接口，而且如果需要用xfire来调用相应的webservice必须知道接口的定义，感觉这里有点限制了。但除了这点，xfire调用webservice，那是相当的方便，就跟调用本地方法一样。我们直接来看例子：

首先是最重要的接口：

  1. public interface IReaderService {
  2. public Reader getReader(String name,String password);
  3. public List<Reader> getReaders();
  4. }

有接口，当然也要有实现类，不然接口就没什么意义了。

  1. public class ReaderService implements IReaderService{
  2. public Reader getReader(String name,String password) {
  3. return new Reader(name,password);
  4. }
  5. public List<Reader> getReaders(){
  6. List<Reader> readerList = new ArrayList<Reader>();
  7. readerList.add(new Reader("shun1","123"));
  8. readerList.add(new Reader("shun2","123"));
  9. return readerList;
  10. }
  11. }

也看一下JAVABEAN，Reader类：

  1. public class Reader{
  2. private static final long serialVersionUID = 1L;
  3. private String name;
  4. private String password;
  5. public Reader(){}
  6. public Reader(String name,String password) {
  7. this.name = name;
  8. this.password = password;
  9. }
  10. //Get/Set方法省略
  11. public String toString(){
  12. return "Name:"+name+",Password:"+password;
  13. }
  14. }

注意，我们这里的Reader类实现了Serializable接口，为什么呢？这里，首先我们需要了解webservice的原理，对于JAVA来讲，如果我们需要在互联网上传对象，很多人当然会想到序列化，对了，这里就是序列化，因为我们需要把reader作为参数来传递。这在以前的版本中是需要强制实现，否则会报错，但现在的最新的版本（其实最新的也是07年的，因为xfire已经停止开发，被apache合并为CXF项目，这个我们之后再讲）已经不需要了，至于是用什么方式实现的，我们这里暂时不深究，因为它已经被合并到CXF中，我们如果要深入学习，应该学习CXF较好。

3）当我们完成上面的接口和JAVABEAN的编写后，很多人会问，我看很多webservice都会有WSDL文件，那你这个怎么来的？在讲这个之前，我们来讨论一下什么是WSDL。也许很多公司提供的接口都还是只是一个HTTP地址，返回XML这样的格式，我们的也是。这有一个好处，也有一个坏处。好处是我们开发的难度小了，而坏处是我们需要提供给用户一堆说明文件，每个返回的XML标签是什么意思，这倒也没啥，但就是比较烦而已。而webservice呢，坏处就是我们开发的东西稍微多了点，而好处是我们不用再写那么多说明文件，因为有一个统一的说明，叫WSDL，这个是webservice的说明文档，是统一的，无论什么语言都一样，所以不存在谁看不懂的问题。

而这里，当我们部署完成xfire后，它就可以帮我们生成WSDL文件。

问题是怎么部署，这个其实也简单。我们在src目录下新建一个文件夹META-INF，再建它的一个字文件夹xfire，里面建立文件services.xml。之后的结构如下：
Webservice-Java-Xfire

有人会问为什么要建到src目录下，其实不是规定建到这里的，但因为我们需要让开发工具帮我们自己部署这几个文件，所以我们放到这里，eclipse就可以帮我们自己部署到tomcat或者其他的容器中。注意，这个文件所在文件夹层次是固定的，不可以修改。

我们直接看一下servics.xml:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <beans xmlns="http://xfire.codehaus.org/config/1.0">
  3. <service>
  4. <!-- webserviceq名称，调用时需要指定这个 -->
  5. <name>readerService</name>
  6. <!-- 这个一般是自己公司的网址，意义不大 -->
  7. <namespace>http://test/HelloService</namespace>
  8. <!-- 接口类 -->
  9. <serviceClass>com.xfire.servlet.IReaderService</serviceClass>
  10. <!-- 实现类 -->
  11. <implementationClass>com.xfire.servlet.ReaderService</implementationClass>
  12. </service>
  13. </beans>

看着注释一般都没问题的。

4）很多人以为这样就行了，不，还没行，你指定了这个，那别人怎么访问呢。怎么把相应的请求转发到xfire那里，让它进行处理呢。这里又需要修改web.xml了。
修改后如下：

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3. xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
  4. xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
  5. id="WebApp_ID" version="3.0">
  6. <servlet>
  7. <servlet-name>XFireServlet</servlet-name>
  8. <servlet-class>org.codehaus.xfire.transport.http.XFireConfigurableServlet</servlet-class>
  9. </servlet>
  10. <servlet-mapping>
  11. <servlet-name>XFireServlet</servlet-name>
  12. <url-pattern>/services/*</url-pattern>
  13. </servlet-mapping>
  14. </web-app>

其实也就是添加了一个servlet和对应的mapping。接下来，我们在浏览器上直接输入:
http://localhost:8080/xfireWebService/services/readerService?wsdl

我们可以看到：

Webservice-Java-Xfire

这里显示的就是wsdl，它会显示我们定义的方法，返回的类型，这个文件我们这里就不分析了，http://webservices.group.iteye.com/group/topic/11467这位朋友在这里写得很清楚，想了解的朋友可以到这里看看。

5）上面四步完成后，我们就完成了webservice的部署了。别人就可以调用相应的webservice来访问我们的方法了。下面我们就用xfire提供的client来访问一下我们刚才发布的webservice:

  1. public class ReaderClient {
  2. public static void main(String[] args) {
  3. //这里是创建一个service，需要传入一个接口类，因为我们后面必须调用相应的接口方法
  4. Service srcModel = new ObjectServiceFactory().create(IReaderService.class);
  5. //代理工厂，这里是为了后面创建相应的接口类
  6. XFireProxyFactory factory = new XFireProxyFactory(XFireFactory.newInstance().getXFire());
  7. //webservice地址，不需要加wsdl
  8. String readerServiceUrl = "http://localhost:8080/xfireWebService/services/readerService";
  9. try {
  10. //利用工厂返回相应的接口类
  11. IReaderService readerService = (IReaderService)factory.create(srcModel,readerServiceUrl);
  12. Reader reader = readerService.getReader("shun","123");
  13. System.out.println(reader);
  14. } catch (MalformedURLException e) {
  15. e.printStackTrace();
  16. }
  17. }
  18. }

这样，我们看到输出结果为：
Webservice-Java-Xfire

上一篇：Titan-红号楼宗谱案例


下一篇：spoj ONP - Transform the Expression 中缀转后缀