发布一个webservices的步骤

发布一个webservice的步骤:

准备:
1、 从apache 官网下载axis1.4,并解压到本地硬盘
2、 安装jdk1.5或以上版本,并设置JAVA_HOME环境变量
3、 安装tomcat6(或其他版本),并保证tomcat服务运行正常
4、 把axis1.4目录下的activation.jar、mail.jar、xerces.jar拷贝到<CATALINA_HOME>/lib目录下
5、 把axis1.4下的axis应用程序拷贝到<CATALINA_HOME>/webapps目录下(即:发布axis web应用)


开发:

1、 编写一个webservice的服务类,这个类和一般的类没什么区别,只要是public class ,并且暴露的方法是public的就可以了。
    如:HelloService类:
   
    package mypack;   
    public class HelloService {   
      public String sayHello(String username) {   
        return "Hello:"+username;
      }   
    }
   
2、编译HelloService.java,并把HelloService.class文件拷贝到<CATALINA_HOME>/webapps/axis/WEB-INF/classes目录下(如果类有包名,需要补全)。
   编译时需要依赖axis1.4下的lib目录下的jar包。
  
3、准备发布HelloService这个服务,需要编写一个以wsdd为扩展名的文件,如:
   <deployment name="test" xmlns="http://xml.apache.org/axis/wsdd/"
    xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
      <service name="urn:helloservice" provider="java:RPC">
        <parameter name="className" value="mypack.HelloService" />
        <parameter name="allowedMethods" value="sayHello" />
      </service>   
    </deployment>
    说明:
    a、<service> 节点描述了一个要发布的服务,其中name属性表示对外公开访问的地址;provider属性表示的是服务编写的语言及发布方式(rpc)
    b、<parameter> 节点描述了服务的参数,
        当服务参数名为“classname”时,其value表示服务对应的class;
        当服务参数名为“allowedMethods”时,其value的值为对外公开的方法,这里如果有多个方法需要公开,可以用"*"表示
    可以看出deploy.wsdd文件主要用来描述一个axis公开服务的详细信息

4、 发布HelloService服务
    需要执行java org.apache.axis.client.AdminClient deploy.wsdd 命令进行发布,其中AdminClient类是axis服务的客户端类,主要用来发布或撤销服务。

5、 运行一个服务
    运行服务需要编写SOAP客户端程序,其中需要用到了
       org.apache.axis.client.Service
       org.apache.axis.client.Call
       javax.xml.namespace.QName
    示例 HelloClient.java:
    package mypack;

    import org.apache.axis.client.Call;
    import org.apache.axis.client.Service;
    import javax.xml.namespace.QName;
   
    public class HelloClient
    {
       public static void main(String [] args) {
           try {
               String username="Guest";
               if(args.length!=0) username=args[0]; //从参数中读取第一个并赋值到username变量
              
               //helloservice服务的公开访问地址,其中http://localhost:8080/axis/services固定的,/helloservice是deploy.wsdd文件中暴露的服务的名称
               String endpoint = "http://localhost:8080/axis/services/helloservice";
        
               //调用axis客户端api进行远程过程调用(RPC)
               Service service = new Service();
               Call call = (Call) service.createCall();
   
               call.setTargetEndpointAddress( new java.net.URL(endpoint) );//对web服务进行封装,设置call的web服务的地址
               call.setOperationName(new QName("urn:helloservice", "sayHello") );//设置call的操作
               //执行call的invoke方法,参数为对象数组,这个参数一定要结合HelloService类的sayHello方法(一一对应)
               //call.invoke的效果相当于直接调用了axis的HelloService类的sayHello方法,这就成为 - RPC
               String ret = (String) call.invoke( new Object[] { username} );
   
               System.out.println(ret);
           } catch (Exception e) {
               e.printStackTrace();
           }
       }
    }   
   
6、注销web服务
   a、需要编写一个wsdd文件,如: undeploy.wsdd
   <undeployment name="test" xmlns="http://xml.apache.org/axis/wsdd/">
      <service name="urn:helloservice"/>
   </undeployment>
  
   b、执行java org.apache.axis.client.AdminClient undeploy.wsdd 注销已发布的服务

你可能感兴趣的:(apache,tomcat,Web,webservice,SOAP)