码迷，mamicode.com
首页 > 编程语言 > 详细

利用Java编写简单的WebService实例

时间：2015-06-30 20:31:40      阅读：158      评论：0      收藏：0      [点我收藏+]

标签：webservice

  使用Axis编写WebService比较简单，就我的理解，WebService的实现代码和编写Java代码其实没有什么区别，主要是将哪些Java类发布为WebService。下面是一个从编写测试例子到发布WebService，以及编写测试代码的过程介绍。

      本例子的WebService提供了两个方法，分别是sayHello和sayHelloToPerson，第一个只是返回一个"Hello"字符串，没有参数，第二个函数接受一个字符串作为参数，返回"Hello 参数值"，该例子比较简单，但是清楚的说明了从编写代码到发布为WebService以及测试编写好的WebService全过程。

编写服务代码

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

Java代码  技术分享
  1. /* 
  2.  * File name: HelloService.java 
  3.  *  
  4.  * Version: v1.0 
  5.  *  
  6.  * Created on Aug 2, 2008 9:40:20 AM 
  7.  *  
  8.  * Designed by Stephen 
  9.  *  
  10.  * (c)Copyright 2008 
  11.  */  
  12. package com.sinosoft.webservice;  
  13.   
  14. /** *//** 
  15.  * @author Stephen 
  16.  *  
  17.  * Test web service 
  18.  */  
  19. public class HelloService {  
  20.     /** *//** 
  21.      * 不带参数的函数 
  22.      *  
  23.      * @return 返回Hello字符串 
  24.      */  
  25.     public String sayHello() {  
  26.         return "Hello";  
  27.     }  
  28.   
  29.     /** *//** 
  30.      * 带参数的函数 
  31.      *  
  32.      * @param name 
  33.      *            名称 
  34.      * @return 返回加上名称的欢迎词 
  35.      */  
  36.     public String sayHelloToPerson(String name) {  
  37.         if (name == null || name.equals("")) {  
  38.             name = "nobody";  
  39.         }  
  40.         return "Hello " + name;  
  41.     }  
  42. }  

 

 

发布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代码  技术分享
  1. <?xml version="1.0" encoding="ISO-8859-1"?>  
  2.   
  3. <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web  
  4. Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">  
  5.   
  6. <web-app>  
  7.   <display-name>Apache-Axis</display-name>  
  8.       
  9.     <listener>  
  10.         <listener-class>org.apache.axis.transport.http.AxisHTTPSessionListener</listener-class>  
  11.     </listener>  
  12.       
  13.   <servlet>  
  14.     <servlet-name>AxisServlet</servlet-name>  
  15.     <display-name>Apache-Axis Servlet</display-name>  
  16.     <servlet-class>  
  17.         org.apache.axis.transport.http.AxisServlet  
  18.     </servlet-class>  
  19.   </servlet>  
  20.   
  21.   <servlet>  
  22.     <servlet-name>AdminServlet</servlet-name>  
  23.     <display-name>Axis Admin Servlet</display-name>  
  24.     <servlet-class>  
  25.         org.apache.axis.transport.http.AdminServlet  
  26.     </servlet-class>  
  27.     <load-on-startup>100</load-on-startup>  
  28.   </servlet>  
  29.   
  30.   <servlet>  
  31.     <servlet-name>SOAPMonitorService</servlet-name>  
  32.     <display-name>SOAPMonitorService</display-name>  
  33.     <servlet-class>  
  34.         org.apache.axis.monitor.SOAPMonitorService  
  35.     </servlet-class>  
  36.     <init-param>  
  37.       <param-name>SOAPMonitorPort</param-name>  
  38.       <param-value>5001</param-value>  
  39.     </init-param>  
  40.     <load-on-startup>100</load-on-startup>  
  41.   </servlet>  
  42.   
  43.   <servlet-mapping>  
  44.     <servlet-name>AxisServlet</servlet-name>  
  45.     <url-pattern>/servlet/AxisServlet</url-pattern>  
  46.   </servlet-mapping>  
  47.   
  48.   <servlet-mapping>  
  49.     <servlet-name>AxisServlet</servlet-name>  
  50.     <url-pattern>*.jws</url-pattern>  
  51.   </servlet-mapping>  
  52.   
  53.   <servlet-mapping>  
  54.     <servlet-name>AxisServlet</servlet-name>  
  55.     <url-pattern>/services/*</url-pattern>  
  56.   </servlet-mapping>  
  57.   
  58.   <servlet-mapping>  
  59.     <servlet-name>SOAPMonitorService</servlet-name>  
  60.     <url-pattern>/SOAPMonitor</url-pattern>  
  61.   </servlet-mapping>  
  62.   
  63.  <!-- uncomment this if you want the admin servlet -->  
  64.  <!--  
  65.   <servlet-mapping>  
  66.     <servlet-name>AdminServlet</servlet-name>  
  67.     <url-pattern>/servlet/AdminServlet</url-pattern>  
  68.   </servlet-mapping>  
  69.  -->  
  70.   
  71.     <session-config>  
  72.         <!-- Default to 5 minute session timeouts -->  
  73.         <session-timeout>5</session-timeout>  
  74.     </session-config>  
  75.   
  76.     <!-- currently the W3C havent settled on a media type for WSDL;  
  77.     http://www.w3.org/TR/2003/WD-wsdl12-20030303/#ietf-draft  
  78.     for now we go with the basic ‘it‘s XML‘ response -->  
  79.   <mime-mapping>  
  80.     <extension>wsdl</extension>  
  81.      <mime-type>text/xml</mime-type>  
  82.   </mime-mapping>  
  83.     
  84.   
  85.   <mime-mapping>  
  86.     <extension>xsd</extension>  
  87.     <mime-type>text/xml</mime-type>  
  88.   </mime-mapping>  
  89.   
  90.   <welcome-file-list id="WelcomeFileList">  
  91.     <welcome-file>index.jsp</welcome-file>  
  92.     <welcome-file>index.html</welcome-file>  
  93.     <welcome-file>index.jws</welcome-file>  
  94.   </welcome-file-list>  
  95.   
  96. </web-app>  

 

 

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

axis的相关配置

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

     复制axis相关的jar文件(官网下载axis-bin-1_4.zip 就有如下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部署成功了。

注意点：本人当时使用的时候 新建的web项目名字为webservice

 

技术分享

 

发布WebService

     发布WebService需要使用现有的AdminService来实现，这里我写了一个批处理文件来发布WebService，以后如果需要发布其他文件，只需要修改相应的参数就可以了。

创建deploy.wsdd文件

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

Xml代码  技术分享
  1. <?xml version="1.0" encoding="UTF-8"?>  
  2. <deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">  
  3.     <service name="HelloServices" provider="java:RPC">  
  4.         <parameter name="className" value="com.sinosoft.webservice.HelloService"/>  
  5.         <parameter name="allowedMethods" value="*"/>  
  6.     </service>  
  7. </deployment>  

 

 

创建发布WebService服务的批处理文件

批处理文件deploywebservice.bat内容如下：

Xml代码  技术分享
  1. 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  
  2.   
  3. pause  

 

 

  其中上面的jar包我都拷到和bat文件在同一个目录，现在将所有的jar文件都加入到classpath中进行执行。

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

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

发布WebService服务

将deploy.wsdd文件和deploywebservice.bat文件复制到同一个文件夹下，执行deploywebservice.bat批处理文件，就可以将deploy.wsdd中描述的Java类发布为WebService。  项目文件目录结构

技术分享


发布完成之后在访问http://127.0.0.1:8080/WebServiceTest/services如下图所示：


 技术分享

 

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

查看HelloServices的wsdl

     访问http://127.0.0.1:8080/WebServiceTest/services/HelloServices?wsdl可以看到如下wsdl的内容：

Xml代码  技术分享
  1. <?xml version="1.0" encoding="UTF-8"?>  
  2. <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">  
  3. <!--WSDL created by Apache Axis version: 1.4  
  4. Built on Apr 22, 2006 (06:55:48 PDT)-->  
  5.   
  6.    <wsdl:message name="sayHelloToPersonRequest">  
  7.   
  8.       <wsdl:part name="name" type="soapenc:string"/>  
  9.   
  10.    </wsdl:message>  
  11.   
  12.    <wsdl:message name="sayHelloRequest">  
  13.   
  14.    </wsdl:message>  
  15.   
  16.    <wsdl:message name="sayHelloToPersonResponse">  
  17.   
  18.       <wsdl:part name="sayHelloToPersonReturn" type="soapenc:string"/>  
  19.   
  20.    </wsdl:message>  
  21.   
  22.    <wsdl:message name="sayHelloResponse">  
  23.   
  24.       <wsdl:part name="sayHelloReturn" type="soapenc:string"/>  
  25.   
  26.    </wsdl:message>  
  27.   
  28.    <wsdl:portType name="HelloService">  
  29.   
  30.       <wsdl:operation name="sayHello">  
  31.   
  32.          <wsdl:input message="impl:sayHelloRequest" name="sayHelloRequest"/>  
  33.   
  34.          <wsdl:output message="impl:sayHelloResponse" name="sayHelloResponse"/>  
  35.   
  36.       </wsdl:operation>  
  37.   
  38.       <wsdl:operation name="sayHelloToPerson" parameterOrder="name">  
  39.   
  40.          <wsdl:input message="impl:sayHelloToPersonRequest" name="sayHelloToPersonRequest"/>  
  41.   
  42.          <wsdl:output message="impl:sayHelloToPersonResponse" name="sayHelloToPersonResponse"/>  
  43.   
  44.       </wsdl:operation>  
  45.   
  46.    </wsdl:portType>  
  47.   
  48.    <wsdl:binding name="HelloServicesSoapBinding" type="impl:HelloService">  
  49.   
  50.       <wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>  
  51.   
  52.       <wsdl:operation name="sayHello">  
  53.   
  54.          <wsdlsoap:operation soapAction=""/>  
  55.   
  56.          <wsdl:input name="sayHelloRequest">  
  57.   
  58.             <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://webservice.sinosoft.com" use="encoded"/>  
  59.   
  60.          </wsdl:input>  
  61.   
  62.          <wsdl:output name="sayHelloResponse">  
  63.   
  64.             <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://127.0.0.1:8080/WebServiceTest/services/HelloServices" use="encoded"/>  
  65.   
  66.          </wsdl:output>  
  67.   
  68.       </wsdl:operation>  
  69.   
  70.       <wsdl:operation name="sayHelloToPerson">  
  71.   
  72.          <wsdlsoap:operation soapAction=""/>  
  73.   
  74.          <wsdl:input name="sayHelloToPersonRequest">  
  75.   
  76.             <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://webservice.sinosoft.com" use="encoded"/>  
  77.   
  78.          </wsdl:input>  
  79.   
  80.          <wsdl:output name="sayHelloToPersonResponse">  
  81.   
  82.             <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://127.0.0.1:8080/WebServiceTest/services/HelloServices" use="encoded"/>  
  83.   
  84.          </wsdl:output>  
  85.   
  86.       </wsdl:operation>  
  87.   
  88.    </wsdl:binding>  
  89.   
  90.    <wsdl:service name="HelloServiceService">  
  91.   
  92.       <wsdl:port binding="impl:HelloServicesSoapBinding" name="HelloServices">  
  93.   
  94.          <wsdlsoap:address location="http://127.0.0.1:8080/WebServiceTest/services/HelloServices"/>  
  95.   
  96.       </wsdl:port>  
  97.   
  98.    </wsdl:service>  
  99.   
  100. </wsdl:definitions>  

 

用Java调用WebService实例

     下面是用Java调用刚发布的WebService例子。

 

Java代码  技术分享
  1. /* 
  2.  * File name: TestHelloService.java 
  3.  *  
  4.  * Version: v1.0 
  5.  *  
  6.  * Created on Aug 2, 2008 9:54:10 AM 
  7.  *  
  8.  * Designed by Stephen 
  9.  *  
  10.  * (c)Copyright 2008 
  11.  */  
  12. package test.com.sinosoft.webservice;  
  13.   
  14. import java.io.IOException;  
  15. import java.net.MalformedURLException;  
  16.   
  17. import javax.xml.namespace.QName;  
  18. import javax.xml.rpc.ServiceException;  
  19.   
  20. import org.apache.axis.client.Call;  
  21. import org.apache.axis.client.Service;  
  22. import org.apache.commons.logging.Log;  
  23. import org.apache.commons.logging.LogFactory;  
  24.   
  25. /** 
  26.  * @author Stephen 
  27.  *  
  28.  * 测试调用WebService 
  29.  */  
  30. public class TestHelloService {  
  31.     private static final Log log = LogFactory.getLog(TestHelloService.class);  
  32.     private static final String HELLO_SERVICE_ENDPOINT = "http://127.0.0.1:8080/WebServiceTest/services/HelloServices?wsdl";  
  33.   
  34.     public static void main(String[] args) {  
  35.         TestHelloService tester = new TestHelloService();  
  36.         // tester.callSayHello();  
  37.         tester.callSayHelloToPerson();  
  38.     }  
  39.   
  40.     public void callSayHello() {  
  41.         try {  
  42.             Service service = new Service();  
  43.             Call call = (Call) service.createCall();  
  44.             call.setTargetEndpointAddress(new java.net.URL(  
  45.                     HELLO_SERVICE_ENDPOINT));  
  46.             //下面名字查询的http://127.0.0.1:8080/WebServiceTest/services/HelloServices?wsdl文件里有  
  47.             call.setOperationName(new QName("http://webservice.sinosoft.com/",  
  48.                     "sayHello"));  
  49.             call.setReturnType(org.apache.axis.Constants.XSD_STRING);  
  50.             try {  
  51.                 //远程调用发布的方法  
  52.                 String ret = (String) call.invoke(new Object[] {});  
  53.                 System.out.println("The return value is:" + ret);  
  54.                 return;  
  55.             } catch (IOException e) {  
  56.                 e.printStackTrace();  
  57.             }  
  58.         } catch (MalformedURLException e) {  
  59.             e.printStackTrace();  
  60.         } catch (ServiceException e) {  
  61.             e.printStackTrace();  
  62.         }  
  63.         log.error("call sayHello service error!");  
  64.     }  
  65.   
  66.     public void callSayHelloToPerson() {  
  67.         try {  
  68.             Service service = new Service();  
  69.             Call call = (Call) service.createCall();  
  70.             call.setTargetEndpointAddress(new java.net.URL(HELLO_SERVICE_ENDPOINT));  
  71.             call.setOperationName(new QName("http://webservice.sinosoft.com/",  
  72.                     "sayHelloToPerson"));  
  73.             call.addParameter("name", org.apache.axis.Constants.XSD_STRING,  
  74.                     javax.xml.rpc.ParameterMode.IN);  
  75.             call.setReturnType(org.apache.axis.Constants.XSD_STRING);  
  76.             try {  
  77.                 String ret = (String) call.invoke(new Object[] { "Stephen" });  
  78.                 System.out.println("The return value is:" + ret);  
  79.                 return;  
  80.             } catch (IOException e) {  
  81.                 e.printStackTrace();  
  82.             }  
  83.         } catch (MalformedURLException e) {  
  84.             e.printStackTrace();  
  85.         } catch (ServiceException e) {  
  86.             e.printStackTrace();  
  87.         }  
  88.         log.error("call sayHello service error!");  
  89.     }  
  90. }  


传参调用简便方法：
           说明：getSasmOrgUnits  为调用webwervice中的方法的名称  
            //
 private static final String HELLO_SERVICE_ENDPOINT = "http://172.16.100.129:6888/ormrpc/services/WSBaseSasmFacade?wsdl"; 
            Service service = new Service();  
            Call call = (Call) service.createCall();  
            call.setTargetEndpointAddress(new java.net.URL(  
                    HELLO_SERVICE_ENDPOINT));  
            String ret =  (String)call.invoke("getSasmOrgUnits", new Object[] {MD5("参数1"),MD5("参数2")});
                System.out.println("The return value is:" + ret);  


版权声明：本文为博主原创文章，未经博主允许不得转载。

利用Java编写简单的WebService实例

标签：webservice

原文地址：http://blog.csdn.net/baicp3/article/details/46698793
踩
(0)
赞
(0)
   
举报
评论 一句话评论（0）
登录后才能评论！
分享档案
更多>
2021年07月29日 (22)
2021年07月28日 (40)
2021年07月27日 (32)
2021年07月26日 (79)
2021年07月23日 (29)
2021年07月22日 (30)
2021年07月21日 (42)
2021年07月20日 (16)
2021年07月19日 (90)
2021年07月16日 (35)
周排行
mamicode.com排行更多图片
更多
友情链接
兰亭集智   国之画   百度统计   站长统计   阿里云   chrome插件   新版天听网
关于我们 - 联系我们 - 留言反馈
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码！