梦幻之旅

转自http://cxshun.iteye.com/blog/1273147

最近公司最近需要将以前提供出去的接口统一用一个标准来实现，考虑到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项目啦。



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

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

首先是最重要的接口：

Java代码  

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

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

Java代码  

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

也看一下JAVABEAN，Reader类：

Java代码  

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

注意，我们这里的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。之后的结构如下：


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

我们直接看一下servics.xml:

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了。
修改后如下：

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.   
11.     <servlet-mapping>  
12.         <servlet-name>XFireServlet</servlet-name>  
13.         <url-pattern>/services/*</url-pattern>  
14.     </servlet-mapping>  
15. </web-app>  

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

我们可以看到：




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

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

Java代码  

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.           
10.         try {  
11.             //利用工厂返回相应的接口类  
12.             IReaderService readerService = (IReaderService)factory.create(srcModel,readerServiceUrl);  
13.   
14.             Reader reader = readerService.getReader("shun","123");  
15.             System.out.println(reader);  
16.         } catch (MalformedURLException e) {  
17.             e.printStackTrace();  
18.         }  
19.     }  
20. }  

这样，我们看到输出结果为：


很简单的调用，当我们取得接口后，一切就跟本地一样了。xfire发布和调用webservice相对其他框架来说是简单很多的。接下来几天，我们会继续学习另外的几个框架，CXF，axis2和jersey，axis2我们放到最后再讲，因为相对其他来说，它的灵活性比较差，而且比较麻烦。

另外问个小问题，有没有朋友知道怎么修改博客字体大小，我修改完成后保存，它只会在代码段那里加上<span>标签，但字体没有改变，其他的也是一样，有知道的朋友麻烦跟我说下。