java web service

1.编写服务代码

服务代码提供了两个函数，分别为sayHello和sayHelloToPerson，源代码如下：

 /*
  * File name: HelloService.java
  *
  * Version: v1.0
  *
  * Created on Aug 2, 2008 9:40:20 AM
  *
  * Designed by Stephen
  *
  * (c)Copyright 2008
  */
 package com.sinosoft.webservice;

 /**
  * @author Stephen
  *
  * Test web service
  */
 public class HelloService {
     /**
      * 不带参数的函数
      *
      * @return 返回Hello字符串
      */
     public String sayHello() {
         return "Hello";
     }

     /**
      * 带参数的函数
      *
      * @param name
      *            名称
      * @return 返回加上名称的欢迎词
      */
     public String sayHelloToPerson(String name) {
         if (name == null || name.equals("")) {
             name = "nobody";
         }
         return "Hello " + name;
     }
 }

2.发布webservice

要将上边写的HelloService类发布为WebService，需要先搭建Web应用。下面是在Tomcat下使用Axis创建WebService服务的例子。

在Tomcat下创建Web应用：

注释：免安装版tomcat的启动方式：

添加一个CATALINA_HOME变量 变量值为 D:\Program Files\apache-tomcat-5.5.20

然后点击 tomcat的bin下的startup.bat 就应该可以启动tomcat了

1. 在Tomcat的webapps下创建如下文件系统

ws

WEB-INF

lib

classes

WEB-INF文件目录结构：

2. 在WEB-INF文件夹下创建web.xml文件，该文件的内容如下：

 <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web
 Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">

 <web-app>
   <display-name>Apache-Axis</display-name>

     <listener>
         <listener-class>org.apache.axis.transport.http.AxisHTTPSessionListener</listener-class>
     </listener>

   <servlet>
     <servlet-name>AxisServlet</servlet-name>
     <display-name>Apache-Axis Servlet</display-name>
     <servlet-class>
         org.apache.axis.transport.http.AxisServlet
     </servlet-class>
   </servlet>

   <servlet>
     <servlet-name>AdminServlet</servlet-name>
     <display-name>Axis Admin Servlet</display-name>
     <servlet-class>
         org.apache.axis.transport.http.AdminServlet
     </servlet-class>
     <load-on-startup>100</load-on-startup>
   </servlet>

   <servlet>
     <servlet-name>SOAPMonitorService</servlet-name>
     <display-name>SOAPMonitorService</display-name>
     <servlet-class>
         org.apache.axis.monitor.SOAPMonitorService
     </servlet-class>
     <init-param>
       <param-name>SOAPMonitorPort</param-name>
       <param-value>5001</param-value>
     </init-param>
     <load-on-startup>100</load-on-startup>
   </servlet>

   <servlet-mapping>
     <servlet-name>AxisServlet</servlet-name>
     <url-pattern>/servlet/AxisServlet</url-pattern>
   </servlet-mapping>

   <servlet-mapping>
     <servlet-name>AxisServlet</servlet-name>
     <url-pattern>*.jws</url-pattern>
   </servlet-mapping>

   <servlet-mapping>
     <servlet-name>AxisServlet</servlet-name>
     <url-pattern>/services/*</url-pattern>
   </servlet-mapping>

   <servlet-mapping>
     <servlet-name>SOAPMonitorService</servlet-name>
     <url-pattern>/SOAPMonitor</url-pattern>
   </servlet-mapping>

  <!-- uncomment this if you want the admin servlet -->
  <!--
   <servlet-mapping>
     <servlet-name>AdminServlet</servlet-name>
     <url-pattern>/servlet/AdminServlet</url-pattern>
   </servlet-mapping>
  -->

     <session-config>
         <!-- Default to 5 minute session timeouts -->
         <session-timeout>5</session-timeout>
     </session-config>

     <!-- currently the W3C havent settled on a media type for WSDL;
     http://www.w3.org/TR/2003/WD-wsdl12-20030303/#ietf-draft
     for now we go with the basic 'it's XML' response -->
   <mime-mapping>
     <extension>wsdl</extension>
      <mime-type>text/xml</mime-type>
   </mime-mapping>

   <mime-mapping>
     <extension>xsd</extension>
     <mime-type>text/xml</mime-type>
   </mime-mapping>

   <welcome-file-list id="WelcomeFileList">
     <welcome-file>index.jsp</welcome-file>
     <welcome-file>index.html</welcome-file>
     <welcome-file>index.jws</welcome-file>
   </welcome-file-list>

 </web-app>

在上面的web.xml中主要是配置了axis的相关配置。

3 .axis的相关配置

在上述的web.xml文件中已经对axis进行了配置，但是还需要进行额外的配置。

复制axis相关的jar文件

 将axis的相关jar文件复制到WEB-INF\lib文件夹下。这些文件包括：

复制WebService服务主文件

将HelloService.java编译后的class文件复制到WEB-INF\classes文件夹下，也就是说在WEB-INF\classes文件夹下的文件夹结构为：com\sinosoft\webservice，在webservice文件夹下有一个helloservice.class文件。

测试发布的Web应用

启动Tomcat服务，打开IE浏览器 输入 http://localhost:8080/ws/services   如果看到如下界面就说明AXIS部署成功了。

　　　　　　　　　　　　　　　　　　　　　　

4.发布WebService服务

　　　　创建deploy.wsdd文件

<?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">
    <service name="HelloServices" provider="java:RPC">
        <parameter name="className" value="com.sinosoft.webservice.HelloService"/>
        <parameter name="allowedMethods" value="*"/>
    </service>
</deployment>

将此文件放置在WEB-INF目录下。

启动DOS，将目录切换到WEB-INF目录下，输入如下命令：

java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient -l http://localhost:8080/services/AdminService deploy.wsdd

如下显示，则发布成功

　　-l后的参数是本地要发布WebService的AdminService对应的访问地址。

最后deploy.wsdd是对应的配置文件名称。

测试：输入 http://localhost:8080/ws/services 如果显示如下，则发布成功：

从上图可以看出，发布成功后，多了一个HelloServices的服务。这样就说明HelloService发布成功了。

5.用Java调用WebService实例

下面为用java编写的调用webservice的例子

需要引用的包为：

package com.test;

import java.io.IOException;
import java.net.MalformedURLException;
import java.rmi.RemoteException;

import javax.xml.namespace.QName;
import javax.xml.rpc.ServiceException;

import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

public class Test {
    private static final String HELLO_SERVICE_ENDPOINT = "http://localhost:8080/ws/services/HelloServices?wsdl";
    private static final Log log = LogFactory.getLog(Test.class);
     public static void main(String[] args) {
         Test tester = new Test();
            // tester.callSayHello();
         tester.callSayHelloToPerson();
        }
    public void callSayHello() throws ServiceException, MalformedURLException{
        Service service = new Service();
         Call call = (Call) service.createCall();
         call.setTargetEndpointAddress(new java.net.URL(HELLO_SERVICE_ENDPOINT));
         call.setOperationName(new QName("http://webservice.sinosoft.com/",
                 "sayHello"));
         call.setReturnType(org.apache.axis.Constants.XSD_STRING);
         try {
            String ret = (String) call.invoke(new Object[] {});
            System.out.println("The return value is:" + ret);
            return;
        } catch (RemoteException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }
    public void callSayHelloToPerson(){
         try {
                Service service = new Service();
                Call call = (Call) service.createCall();
                call.setTargetEndpointAddress(new java.net.URL(HELLO_SERVICE_ENDPOINT));
                call.setOperationName(new QName("http://webservice.sinosoft.com/",
                        "sayHelloToPerson"));
                call.addParameter("name", org.apache.axis.Constants.XSD_STRING,
                        javax.xml.rpc.ParameterMode.IN);
                call.setReturnType(org.apache.axis.Constants.XSD_STRING);
                try {
                    String ret = (String) call.invoke(new Object[] { "Stephen" });
                    System.out.println("The return value is:" + ret);
                    return;
                } catch (IOException e) {
                    e.printStackTrace();
                }
            } catch (MalformedURLException e) {
                e.printStackTrace();
            } catch (ServiceException e) {
                e.printStackTrace();
            }
            log.error("call sayHello service error!");
        }
}