利用Java編寫簡單的WebService實例

轉自http://nopainnogain.iteye.com/blog/791525

使用Axis編寫WebService比較簡單，就我的理解，WebService的實現代碼和編寫Java代碼其實沒有什麼區別，主要是將哪些Java類發佈爲WebService。下面是一個從編寫測試例子到發佈WebService，以及編寫測試代碼的過程介紹。

本例子的WebService提供了兩個方法，分別是sayHello和sayHelloToPerson，第一個只是返回一個"Hello"字符串，沒有參數，第二個函數接受一個字符串作爲參數，返回"Hello 參數值"，該例子比較簡單，但是清楚的說明了從編寫代碼到發佈爲WebService以及測試編寫好的WebService全過程。

編寫服務代碼

服務代碼提供了兩個函數，分別爲sayHello和sayHelloToPerson，源代碼如下：


Java代碼  

/* 

 * 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;  

    }  

}

發佈WebService

要將上邊寫的HelloService類發佈爲WebService，需要先搭建Web應用。下面是在Tomcat下使用Axis（http://ws.apache.org/axis/）創建WebService服務的例子。

在Tomcat下創建Web應用

在該例子中，在Tomcat下創建了一個context path爲ws的WEB應用。

1. 在myeclipse中創建WebServiceTest的webproject

2. 在WEB-INF文件夾下web.xml文件，該文件的內容如下：


Xml代碼  

<?xml version="1.0" encoding="ISO-8859-1"?>  

<!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的相關配置。

axis的相關配置

在上述的web.xml文件中已經對axis進行了配置，但是還需要進行額外的配置。

複製axis相關的jar文件

將axis的相關jar文件複製到WEB-INF\lib文件夾下。這些文件包括：

activation.jar
axis.jar
axis-ant.jar
commons-discovery-0.2.jar
commons-logging-1.0.4.jar
jaxrpc.jar
log4j-1.2.8.jar
saaj.jar
wsdl4j-1.5.1.jar

測試發佈的Web應用

啓動Tomcat服務，打開IE瀏覽器，訪問地址http://127.0.0.1:8080/WebServiceTest/services，如果看到如下界面就說明AXIS部署成功了。

發佈WebService

發佈WebService需要使用現有的AdminService來實現，這裏我寫了一個批處理文件來發布WebService，以後如果需要發佈其他文件，只需要修改相應的參數就可以了。

創建deploy.wsdd文件

文件deploy.wsdd內容如下所示：


Xml代碼  

<?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>

創建發佈WebService服務的批處理文件

批處理文件deploywebservice.bat內容如下：


Xml代碼  

java -cp axis-ant.jar;axis-schema.jar;axis.jar;commons-discovery-0.2.jar;commons-logging-1.0.4.jar;jaxrpc.jar;log4j-1.2.8.jar;saaj.jar;wsdl4j-1.5.1.jar;xmlsec-1.3.0.jar org.apache.axis.client.AdminClient -lhttp://localhost:8080/WebServiceTest/services/AdminService deploy.wsdd  

pause

其中上面的jar包我都拷到和bat文件在同一個目錄，現在將所有的jar文件都加入到classpath中進行執行。

-l後的參數是本地要發佈WebService的AdminService對應的訪問地址。

最後deploy.wsdd是對應的配置文件名稱。

發佈WebService服務

將deploy.wsdd文件和deploywebservice.bat文件複製到同一個文件夾下，執行deploywebservice.bat批處理文件，就可以將deploy.wsdd中描述的Java類發佈爲WebService。發佈完成之後在訪問http://host:port/ws/services如下圖所示：

從上圖可以看出，發佈成功後，多了一個HelloServices的服務。這樣就說明HelloService發佈成功了。

查看HelloServices的wsdl

訪問http://127.0.0.1:8080/WebServiceTest/services/HelloServices?wsdl 可以看到如下wsdl的內容：


Xml代碼  

<?xml version="1.0" encoding="UTF-8"?>  

<wsdl:definitions targetNamespace="http://127.0.0.1:8080/WebServiceTest/services/HelloServices" xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="http://127.0.0.1:8080/WebServiceTest/services/HelloServices" xmlns:intf="http://127.0.0.1:8080/WebServiceTest/services/HelloServices" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xsd="http://www.w3.org/2001/XMLSchema">  

<!--WSDL created by Apache Axis version: 1.4  

Built on Apr 22, 2006 (06:55:48 PDT)-->  

   <wsdl:message name="sayHelloToPersonRequest">  

      <wsdl:part name="name" type="soapenc:string"/>  

   </wsdl:message>  

   <wsdl:message name="sayHelloRequest">  

   </wsdl:message>  

   <wsdl:message name="sayHelloToPersonResponse">  

      <wsdl:part name="sayHelloToPersonReturn" type="soapenc:string"/>  

   </wsdl:message>  

   <wsdl:message name="sayHelloResponse">  

      <wsdl:part name="sayHelloReturn" type="soapenc:string"/>  

   </wsdl:message>  

   <wsdl:portType name="HelloService">  

      <wsdl:operation name="sayHello">  

         <wsdl:input message="impl:sayHelloRequest" name="sayHelloRequest"/>  

         <wsdl:output message="impl:sayHelloResponse" name="sayHelloResponse"/>  

      </wsdl:operation>  

      <wsdl:operation name="sayHelloToPerson" parameterOrder="name">  

         <wsdl:input message="impl:sayHelloToPersonRequest" name="sayHelloToPersonRequest"/>  

         <wsdl:output message="impl:sayHelloToPersonResponse" name="sayHelloToPersonResponse"/>  

      </wsdl:operation>  

   </wsdl:portType>  

   <wsdl:binding name="HelloServicesSoapBinding" type="impl:HelloService">  

      <wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>  

      <wsdl:operation name="sayHello">  

         <wsdlsoap:operation soapAction=""/>  

         <wsdl:input name="sayHelloRequest">  

            <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://webservice.sinosoft.com" use="encoded"/>  

         </wsdl:input>  

         <wsdl:output name="sayHelloResponse">  

            <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://127.0.0.1:8080/WebServiceTest/services/HelloServices" use="encoded"/>  

         </wsdl:output>  

      </wsdl:operation>  

      <wsdl:operation name="sayHelloToPerson">  

         <wsdlsoap:operation soapAction=""/>  

         <wsdl:input name="sayHelloToPersonRequest">  

            <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://webservice.sinosoft.com" use="encoded"/>  

         </wsdl:input>  

         <wsdl:output name="sayHelloToPersonResponse">  

            <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://127.0.0.1:8080/WebServiceTest/services/HelloServices" use="encoded"/>  

         </wsdl:output>  

      </wsdl:operation>  

   </wsdl:binding>  

   <wsdl:service name="HelloServiceService">  

      <wsdl:port binding="impl:HelloServicesSoapBinding" name="HelloServices">  

         <wsdlsoap:address location="http://127.0.0.1:8080/WebServiceTest/services/HelloServices"/>  

      </wsdl:port>  

   </wsdl:service>  

</wsdl:definitions>

用Java調用WebService實例

下面是用Java調用剛發佈的WebService例子。


Java代碼  

/* 

 * File name: TestHelloService.java 

 *  

 * Version: v1.0 

 *  

 * Created on Aug 2, 2008 9:54:10 AM 

 *  

 * Designed by Stephen 

 *  

 * (c)Copyright 2008 

 */  

package test.com.sinosoft.webservice;  

import java.io.IOException;  

import java.net.MalformedURLException;  

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;  

/** 

 * @author Stephen 

 *  

 * 測試調用WebService 

 */  

public class TestHelloService {  

    private static final Log log = LogFactory.getLog(TestHelloService.class);  

    private static final String HELLO_SERVICE_ENDPOINT = "http://127.0.0.1:8080/WebServiceTest/services/HelloServices?wsdl";  

    public static void main(String[] args) {  

        TestHelloService tester = new TestHelloService();  

        // tester.callSayHello();  

        tester.callSayHelloToPerson();  

    }  

    public void callSayHello() {  

        try {  

            Service service = new Service();  

            Call call = (Call) service.createCall();  

            call.setTargetEndpointAddress(new java.net.URL(  

                    HELLO_SERVICE_ENDPOINT));  

            //下面名字查詢的http://127.0.0.1:8080/WebServiceTest/services/HelloServices?wsdl文件裏有  

            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 (IOException e) {  

                e.printStackTrace();  

            }  

        } catch (MalformedURLException e) {  

            e.printStackTrace();  

        } catch (ServiceException e) {  

            e.printStackTrace();  

        }  

        log.error("call sayHello service error!");  

    }  

    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!");  

    }  

}

利用Java編寫簡單的WebService實例

編寫服務代碼

在Tomcat下創建Web應用

axis的相關配置

發佈WebService

創建deploy.wsdd文件

發佈WebService服務

查看HelloServices的wsdl

用Java調用WebService實例

iBATIS入門程序六大步詳解

利用Java編寫簡單的WebService實例

tns

Oracle JOB 設置

oracle常用表和視圖

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結