使用Axis发布��单的Web服务

Tue, 10 Jan 2006 04:11:00 GMT

使用Axis�Q�要发布一个Web服务非常��单，��直不能再��单了�Q�尽��看��h��q�程和相关代码有些长。我�q�个帖子里用��C��q�些软�g�Q�Axis 1.1、Eclipse 2.1和Eclipse的Tomcat插�g2.2�Q?A >Sysdeo Tomcat plugin�Q�。发布的�Ҏ(gu��)��如下�Q?/P>

我要发布的服务是一个图书商店，公布的方法有��d��图书addBook、列表图书listBooks、删除图书deleteBook�{�等�Q��ؓ��单�v见这里就只发布一个添加图书方法，因�ؓ其他�Ҏ(gu��)��的发布是�c�M��的�?/P>

1、首先在Eclipse里新��Z��个名为bookstore的Tomcat工程�Q�注意要安装了前面说的Tomcat插�g才有�q�个选项的。如果没有安装可以徏立一个java工程�Q�然后手动徏立必要的目录�l�构�Q�WEB-INF�{�）�Q��ƈ在Tomcat的server.xml里手动增加与��目对应�?lt;context>��V�?/P>

2、接下来建立图书�c�（com.bookstore.model.Book�Q�，图书有名�U�、ISDN号和��|��三个属性，�q�是一个Bean�c�，代码如下�Q?/P>

package com.bookstore.model;

public class Book {
    private String name;
    private String ISDN;
    private int page;

    public String getISDN() {
        return ISDN;
    }

    public String getName() {
        return name;
    }

    public int getPage() {
        return page;
    }

    public void setISDN(String string) {
        ISDN = string;
    }

    public void setName(String string) {
        name = string;
    }

    public void setPage(int i) {
        page = i;
    }

}

3、接下来建立用来提供服务的类�Q�com.bookstore.BookSvc�Q�，�q�个�c�d��是实际的功能�c�M��Q�它里面只有一个public的addBook()�Ҏ(gu��)��Q�而它的参数只有一个就是要��d��的图书。代码如下：

package com.bookstore;

import com.bookstore.model.Book;

public class BookSvc {

    public void addBook(Book book){
        //here you save a book into database
        System.out.println("Book has been added.");
    }
}

4、现在，把下载来的Axis解压�~�到一个文件夹�Q�这里假设你解到C:\axis-1_1。把C:\axis-1_1\webapps\axis\WEB-INF\lib目录下的所�?jar文�g复制��C��的这个web应用�E�序的WEB-INF\lib下，再把C:\axis-1_1\webapps\axis\WEB-INF目录下的web.xml复制��C��的web应用�E�序的WEB-INF下。这个步骤相当于在你的web应用�E�序中配�|�了Axis�?/P>

5、�ؓ了让Axis知道你要发布哪些服务�Q�你得在WEB-INF下徏立一个名为server-config.wsdd的文�Ӟ��内容如下�Q?/P>

xml version="1.0" encoding="UTF-8"?>
<deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
<globalConfiguration>
  <parameter name="adminPassword" value="admin"/>
  <parameter name="attachments.Directory" value="C:\eclipse\workspace\bookstore\WEB-INF\attachments"/>
  <parameter name="attachments.implementation" value="org.apache.axis.attachments.AttachmentsImpl"/>
  <parameter name="sendXsiTypes" value="true"/>
  <parameter name="sendMultiRefs" value="true"/>
  <parameter name="sendXMLDeclaration" value="true"/>
  <parameter name="axis.sendMinimizedElements" value="true"/>
  <requestFlow>
   <handler type="java:org.apache.axis.handlers.JWSHandler">
    <parameter name="scope" value="session"/>
   handler>
   <handler type="java:org.apache.axis.handlers.JWSHandler">
    <parameter name="scope" value="request"/>
    <parameter name="extension" value=".jwr"/>
   handler>
  requestFlow>
globalConfiguration>
<handler name="LocalResponder" type="java:org.apache.axis.transport.local.LocalResponder"/>
<handler name="Authenticate" type="java:org.apache.axis.handlers.SimpleAuthenticationHandler"/>
<handler name="URLMapper" type="java:org.apache.axis.handlers.http.URLMapper"/>
<service name="Version" provider="java:RPC">
  <parameter name="allowedMethods" value="getVersion"/>
  <parameter name="className" value="org.apache.axis.Version"/>
service>
<service name="BookSvc" provider="java:RPC">
  <parameter name="allowedMethods" value="*"/>
  <parameter name="className" value="com.bookstore.BookSvc"/>
service>
<service name="AdminService" provider="java:MSG">
  <parameter name="allowedMethods" value="AdminService"/>
  <parameter name="enableRemoteAdmin" value="false"/>
  <parameter name="className" value="org.apache.axis.utils.Admin"/>
  <namespace>http://xml.apache.org/axis/wsdd/namespace>
service>
<transport name="local">
  <responseFlow>
   <handler type="LocalResponder"/>
  responseFlow>
transport>
<transport name="http">
  <requestFlow>
   <handler type="URLMapper"/>
   <handler type="java:org.apache.axis.handlers.http.HTTPAuthHandler"/>
  requestFlow>
transport>
deployment>

�q�个文�g里发布了三个服务�Q�Version、AdminService和我们的BookSvc。还有一个方法可以生成这个文�Ӟ��好象Axis推荐使用�q�种生成的方法，��是在同��L(f��ng)��录下写一个deploy.wsdd文�g�Q�如果不想看可以直接跛_��下一步）�Q�内容如下：

<deployment xmlns="http://xml.apache.org/axis/wsdd/"
            xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
<service name="BookSvc" provider="java:RPC">
  <parameter name="className" value="com.bookstore.BookSvc"/>
  <parameter name="allowedMethods" value="*"/>
service>
deployment>

也就是说deploy.wsdd里只包含关于我们的服务的描述�Q�确认Tomcat已经启动�Q�然后在同一目录下用下面�q�个命��o生成server-config.wsdd文�g�Q?/P>

java org.apache.axis.client.AdminClient -lhttp://localhost:8080/bookstore/services/AdminService deploy.wsdd

其中bookstore是我�q�个web应用�E�序的虚拟�\径�?/P>

6、重新启动Tomcat�Q�访问�\�?A href="http://localhost:8080/bookstore/services">http://localhost:8080/bookstore/services�Q�就可以看到现在发布了三个Web服务�Q�如下图。点��L��个服务后的wsdl链接可以看到对应的WSDL描述�?/P>

可以看出�Q�在Axis里书写deploy.wsdd�q�利用org.apache.axis.client.AdminClient发布�Q�其主要工作��是�?lt;service>标签中的内容��d��在server-config.wsdd里，所以一般直接编辑server-config.wsdd文�g会更方便一些。不�q�当你还没有server-config.wsdd文�g�Ӟ��使用deploy.wsdd的方法会更方便些�Q�因为AdminClient会帮你生成一些额外的xml元素�Q?lt;handler>�{�等�Q�，而这些元素是必要的�?/P>

服务发布以后�Q�就可以在IE��览器里看到它的WSDL�Q�一般是服务的URL后面加一个�?wsdl”，例如��d��图书的WSDL可以通过http://localhost:8080/bookstore/services/BookSvc?wsdl看到。至于Java�c�L��以何�U�规则映��到WSDL的，请参�?A >JAX-RPC规范�Q�WSDL本��n的说明见�q�里�Q��ؓ了搞清生成的WSDL中各�U�URL格式的名�U�空��_��最好对XML Schema有所了解�Q�我觉得�q�篇文章�q�不错�?/P>

我们�q�可以通过IE��览器直接调用服务，�Ҏ(gu��)��是在服务URL后加“method=xxx”，其中xxx是要调用的方法名�U�。例如可以通过http://localhost:8080/bookstore/services/BookSvc?method=addBook调用��d��图书�Ҏ(gu��)��Q�按照我们的服务�c�，在Tomcat的控制台上应该可以看到打��Z��“Book has been added.”的字样�?/P>

因�ؓ��d��图书�Ҏ(gu��)��的参数是一个自定义�c�d��Q�所以在IE里调用时不能指定参数��|��或者是可以以其他格式指定，但我�q�不知道�Q�；如果参数是简单类型，��可以指定了。例如我们可以�ؓBookSvc增加一个echo()�Ҏ(gu��)��Q�参数是一个java.lang.String�c�d��的��|��如下所�C�，然后重新�~�译�q�启动Tomcat�Q�server-config.wsdd文�g不必更改�Q��?/P>

public void echo(String str){
System.out.println("Hello "+str);
}

在IE里输�?A href="http://localhost:8080/bookstore/services/BookSvc?method=echo&str=Mike">http://localhost:8080/bookstore/services/BookSvc?method=echo&str=Mike�Q�就会看到Tomcat的控制台里打��Z��“Hello Mike”。如果有多个参数�Q�只要把�q�些参数都列在URL里即可�?/P>

�?/a> 2006-01-10 12:11 发表评论

久久亚洲精品11p,国产成人精品久久亚洲,亚洲精品无码mv在线观看网站

使用Axis发布���单的Web服务

使用Axis发布��单的Web服务