Webservice-Java-Xfire

最近公司最近需要将以前提供出去的接口统一用一个标准来实现,考虑到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 中缀转后缀