`

转:利用Java编写简单的WebService实例

 
阅读更多

利用Java编写简单的WebService实例

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

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

编写服务代码

      服务代码提供了两个函数,分别为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;
    }

}

发布WebService

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

在Tomcat下创建Web应用

     在该例子中,在Tomcat下创建了一个context path为ws的WEB应用。

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

          ws

               WEB-INF

                    lib

                    classes

     2. 在WEB-INF文件夹下创建web.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
axis-schema.jar
commons-discovery-0.2.jar
commons-logging-1.0.4.jar
jaxrpc.jar
log4j-1.2.8.jar
mailapi.jar
saaj.jar
wsdl4j-1.5.1.jar
xmlsec-1.3.0.jar

     复制WebService服务主文件

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

测试发布的Web应用

     启动Tomcat服务,打开IE浏览器,访问地址http:host:port/ws/services,如果看到如下界面就说明AXIS部署成功了。

 

 

发布WebService

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

创建deploy.wsdd文件

     文件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>

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

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

 


java -cp E:\Stephen\Lib\axislib\activation.jar;E:\Stephen\Lib\axislib\axis-ant.jar;E:\Stephen\Lib\axislib\axis-schema.jar;E:\Stephen\Lib\axislib\axis.jar;E:\Stephen\Lib\axislib\commons-discovery-0.2.jar;E:\Stephen\Lib\axislib\commons-logging-1.0.4.jar;E:\Stephen\Lib\axislib\jaxrpc.jar;E:\Stephen\Lib\axislib\log4j-1.2.8.jar;E:\Stephen\Lib\axislib\mailapi.jar;E:\Stephen\Lib\axislib\saaj.jar;E:\Stephen\Lib\axislib\wsdl4j-1.5.1.jar;E:\Stephen\Lib\axislib\xmlsec-1.3.0.jar org.apache.axis.client.AdminClient -lhttp://localhost:8090/ws/services/AdminService deploy.wsdd

     其中E:\Stephen\Lib\axislib是存放axis对应的jar文件的文件夹,现在将所有的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://host:port/ws/services/HelloServices?wsdl可以看到如下wsdl的内容:

 


<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions targetNamespace="http://localhost:8090/ws2/services/HelloServices" xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="http://localhost:8090/ws2/services/HelloServices" xmlns:intf="http://localhost:8090/ws2/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.3
Built on Oct 05, 2005 (05:23:37 EDT)
-->

   
<wsdl:message name="sayHelloResponse">

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

   
</wsdl:message>

   
<wsdl:message name="sayHelloToPersonResponse">

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

   
</wsdl:message>

   
<wsdl:message name="sayHelloToPersonRequest">

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

   
</wsdl:message>

   
<wsdl:message name="sayHelloRequest">

   
</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://localhost:8090/ws2/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://localhost:8090/ws2/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://localhost:8090/ws2/services/HelloServices"/>

      
</wsdl:port>

   
</wsdl:service>

</wsdl:definitions>

用Java调用WebService实例

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

 


/*
 * 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://localhost:8090/ws/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));
            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!");
    }
}
 
 
分类: WebService
标签: webservicejavaaxis
分享到:
评论

相关推荐

    利用Java编写简单的WebService实例

    ### 利用Java编写简单的WebService实例 #### Axis2:新一代的WebService引擎 Axis2作为Apache组织下的一款开源WebService引擎,自其诞生起便受到了广泛的关注。相比于前代产品Axis1.x,Axis2进行了全面的重构与...

    利用Java编写简单的WebService实例.docx

    【Java编写简单的WebService实例】 Java WebService是一种基于标准的、平台无关的方式,允许不同系统间的应用程序进行通信。本文档提供了一个简单的示例,演示如何使用Java编写并发布一个WebService,以便其他应用...

    Java开发WebService实例

    本文将基于给定的“Java开发WebService实例”内容,深入解析如何在Tomcat中间件环境下,利用Java语言开发WebService,并通过具体示例来阐述相关的知识点。 #### WebService概念简述 WebService是一种遵循特定协议...

    PB调用JAVA WEBSERVICE实例

    标题中的“PB调用JAVA WEBSERVICE实例”指的是使用PowerBuilder(PB)应用程序调用由Java编写的Web服务。在企业级应用开发中,不同语言之间的互操作性是非常重要的,而Web服务提供了一种标准的方式来实现这一点。让...

    delphi调用Java webservice实例

    综上所述,"Delphi调用Java WebService实例"主要是关于在Delphi环境中如何利用各种工具和组件,通过SOAP协议调用并处理Java WebService的响应。具体实现需要理解WSDL,生成Delphi客户端代理,以及正确地发送请求和...

    利用Axis编写简单的WebService

    【标题】:“利用Axis编写简单的WebService” 在Java世界中,创建和使用Web服务是一个常见的任务,而Axis是一个流行的开源工具,用于实现基于SOAP(简单对象访问协议)的Web服务。本篇文章将指导你如何利用Axis来...

    Java调用C#的WebService例子

    本示例介绍如何在Java环境中利用Xfire库来调用C#编写的WebService服务。 首先,理解WebService的核心概念:它是一种基于标准的、平台无关的、用于应用程序之间交互的技术,通过SOAP(Simple Object Access Protocol...

    java-webservice实例

    Java WebService实例是一个实际操作教程,它展示了如何在Java环境中创建和发布Web服务。Web服务是一种基于开放标准的,能够使应用程序在不同平台之间交换数据的技术。本实例着重于使用Java API for XML Web Services...

    java code Webservice实例详解

    通过这个实例,我们了解了使用Java代码和XFire框架创建Web服务的基本流程,包括项目创建、服务代码编写、部署以及测试。掌握了这些基础知识,你就可以根据实际需求扩展和实现更复杂的Web服务功能。同时,需要注意的...

    webservice实例

    本实例是关于Web Service的实现,采用Java技术栈,利用Maven作为项目管理工具,并通过IntelliJ IDEA进行开发。项目分为服务端(Server)和客户端(Client),下面将详细介绍这两个部分以及相关的知识点。 1. Maven...

    Java6上开发WebService的实例

    总的来说,这个实例展示了如何利用Java 6的JAX-WS和注解来轻松创建和部署一个WebService。对于初学者来说,这是一个很好的起点,可以深入理解Java中WebService的工作原理以及如何与其他系统进行交互。

    webservice客户端简单实例

    本实例将探讨如何在Windows 7环境下,利用Apache Tomcat 6.0.33和JDK 1.6.0_32创建一个简单的Web服务客户端。 首先,我们需要了解WebService的基本概念。WebService是一种通过SOAP(Simple Object Access Protocol...

    WebService应用实例及教程

    5. WebService实例 - 假设我们有一个名为“WeatherService”的WebService,提供获取天气预报的功能。 - 在WSDL中,定义了一个名为“getWeather”操作,接受城市名作为参数,返回当前天气信息。 - 客户端通过调用...

    XFire建立Webservice实例,入门级别,适合初学者

    【XFire建立Webservice实例详解】对于初学者来说,理解并构建一个Web Service是一个重要的学习步骤,而XFire作为一款曾经流行的开源框架,提供了一种简单的方法来创建和部署Web Service。本文将详细介绍如何利用...

    WebService实例、以及文档

    标题中的"WebService实例"指的是实际的WebService应用案例,这可能包括创建、调用和测试WebService的各种步骤。开发者通常会通过编写服务端接口,然后用Java的JAX-WS或其他工具如XFire来实现这些接口,将其转换为可...

    SoapToolkit3.0和c++调用java写的webservice的几个实例

    本主题主要关注的是如何使用C++通过SoapToolkit 3.0调用由Java编写的Web服务。让我们深入探讨这个过程,以及涉及到的关键技术。 首先,`SoapToolkit 3.0`是一个用于处理SOAP(简单对象访问协议)消息的工具包,它...

    java_webservice_axis2简单开发实例

    【Java Webservice Axis2简单开发实例详解】 在Java开发中,Web Service是一种常见的通信机制,用于不同系统间的互操作性。Axis2是Apache组织提供的一个轻量级、高性能的Web Service框架,它使得开发者能够方便地...

    Java调用CXF WebService接口的两种方式实例

    Java调用CXF WebService接口的两种方式实例 Java调用CXF WebService接口是Java开发者在开发过程中经常遇到的问题。今天,我们将讨论Java调用CXF WebService接口的两种方式实例,即静态调用和动态调用。 静态调用 ...

Global site tag (gtag.js) - Google Analytics