Java Web Service的客户端实现

原创 2007年10月08日 16:02:00
 Java Web Service的客户端实现有三种
1. 生成的stub
2. 动态代理
3. 动态调用接口
其中生成stub是最常用的。stub是用JAX-RPC编译器根据WSDL文档生成的,其主要功能是将对endpoint接口的方法调用转化为SOAP 消息,并且负责将返回的SOAP响应转换为方法的返回值,把SOAP fault转化为方法的异常。JAX-RPC编译器产生的stub除了要实现endpoint接口外,还需要实现或继承 javax.xml.rpc.Stub接口或其实现的子类(Axis中是org.apache.axis.client.Stub)。 javax.xml.rpc.Stub接口主要定义了和网络通讯和认证相关的属性的设置和获取的机制。
Java Web Service的客户端实现有三种
1. 生成的stub
2. 动态代理
3. 动态调用接口
其中生成stub是最常用的。stub是用JAX-RPC编译器根据WSDL文档生成的,其主要功能是将对endpoint接口的方法调用转化为SOAP 消息,并且负责将返回的SOAP响应转换为方法的返回值,把SOAP fault转化为方法的异常。JAX-RPC编译器产生的stub除了要实现endpoint接口外,还需要实现或继承 javax.xml.rpc.Stub接口或其实现的子类(Axis中是org.apache.axis.client.Stub)。 javax.xml.rpc.Stub接口主要定义了和网络通讯和认证相关的属性的设置和获取的机制。其代码如下:
package javax.xml.rpc;
import java.util.Iterator;

public interface Stub {

    // Standard property: The Web service's Internet address.
    public static String ENDPOINT_ADDRESS_PROPERTY;
    // Standard property: Password for authentication.
    public static String PASSWORD_PROPERTY;
    // Standard property: User name for authentication.
    public static String USERNAME_PROPERTY;
    // Standard property: Boolean flag for maintaining an HTTP session.
    public static String SESSION_MAINTAIN_PROPERTY;

    // Given a property name, get its value.
    public Object _getProperty(java.lang.String name);
    // Get the names of all the properties the stub supports.
    public Iterator _getPropertyNames();
    // Configure a property on the stub.
    public void _setProperty(java.lang.String name, java.lang.Object value);
}

JAX-RPC编译器产生还可以产生一个和WSDL中service元素对应的Service接口,该接口组合了多个port,也就是多个Stub。该接口继承了javax.xml.rpc.Service。在J2EE环境中Service接口通常通过JNDI lookup得到。
在J2EE中使用生成的stub的典型用例如下:
代码:
package com.jwsbook.jaxrpc;
import javax.servlet.http.*;
import javax.servlet.*;
import javax.naming.InitialContext;

public class BookQuoteServlet_1 extends javax.servlet.http.HttpServlet {
  protected void doGet(HttpServletRequest req, HttpServletResponse resp)
  throws ServletException,java.io.IOException {
    try{
      String isbn = req.getParameter("isbn");

      InitialContext jndiContext = new InitialContext();

      BookQuoteService service = (BookQuoteService)
      jndiContext.lookup("java:comp/env/service/BookQuoteService");

      BookQuote bookQuote = service.getBookQuotePort();

      float price = bookQuote.getBookPrice( isbn );

      java.io.Writer outStream = resp.getWriter();
      outStream.write("<html><body>The wholesale price for ISBN:"+isbn+
                    " = "+price+"</body></html>");
    }catch(javax.naming.NamingException ne){
      throw new ServletException(ne);
    }catch(javax.xml.rpc.ServiceException se){
      throw new ServletException(se);
    }
  }
部署说明文件:
<service-ref xmlns:mh="http://www.Monson-Haefel.com/jwsbook/BookQuote" >
    <service-ref-name>service/BookQuoteService</service-ref-name>
    <service-interface>com.jwsbook.jaxrpc.BookQuoteService</service-interface>
    <wsdl-file>BookQuote.wsdl</wsdl-file>
    <service-qname>mh:BookQuoteService</service-qname>
</service-ref>

一般都是通过JNDI查询到相应的Service接口,然后从Service接口中得到stub,最后调用web service的方法。部署文件中申明了名为"service/BookQuoteService"的Service接口,在代码里获取该接口的代码是 jndiContext.lookup("java:comp/env/service/BookQuoteService"),前缀"java: comp/env/"是所有J2EE资源在JNDI树种的parent Context。

在非J2EE环境中实现web service客户端
在非J2EE环境中也可以实现web service客户端,这时需要用到javax.xml.rpc.ServiceFactory(或其子类,在axis中是 org.apache.axis.client.ServiceFactory)的静态方法loadService得到service接口。接下来的调用代码和J2EE中的类似。

动态代理调用
动态代理调用是Java web service的另一种方式。对于使用该方式的客户端代码,和生成stub的方式相比较,其变化不是很大。它和生成stub的方式主要区别在于前者在编译时刻产生service接口和stub,后者则将这部分工作延迟到运行时刻。
动态代理调用的典型代码和部署说明文件:
package com.jwsbook.jaxrpc;
import javax.naming.InitialContext;

public class JaxRpcExample_2 {
  public static void main(String [] args) throws Exception{
    String isbn = args[0];

    InitialContext jndiContext = new InitialContext();

    javax.xml.rpc.Service service = (javax.xml.rpc.Service)
    jndiContext.lookup("java:comp/env/service/Service");

    BookQuote BookQuote_proxy = (BookQuote)
                                service.getPort(BookQuote.class);

    float price = BookQuote_proxy.getBookPrice( isbn );

    System.out.println("The price is = "+price);
  }
}

<service-ref xmlns:mh="http://www.Monson-Haefel.com/jwsbook/BookQuote" >
    <service-ref-name>service/Service</service-ref-name>
    <service-interface>javax.xml.rpc.Service</service-interface>
    <wsdl-file>BookQuote.wsdl</wsdl-file>
    <service-qname>mh:BookQuoteService</service-qname>
</service-ref>


由于不需要在编译时刻产生service接口和stub,用JNDI lookup和部署说明时只使用了javax.xml.rpc.Service。得到service接口后通过getPort方法可以取得动态代理的 stub。getPort有两种版本,getPort(java.lang.Class endpointInterface)和getPort(javax.xml.namespace.QName portName,java.lang.Class endpointInterface),通常当WSDL中一个PortType有一种以上的绑定时,如果需要得到某个绑定的port接口就使用后者,否者使用前者。QName是该绑定的完全限定名称,有命名空间加上局部名构成。对应的QName对象的构造方法有构造函数法和静态valueOf法,实例如下:
// Use constructor method
QName portName =
          new QName("http://www.Monson-Haefel/jwsbook/BookQuote",
          "BookQuoteLiteralPort");
          
// Use static valueOf() method
String s = "{http://www.Monson-Haefel/jwsbook/BookQuote}BookQuoteLiteralPort";
QName qname2 = QName.valueOf(s);

valueOf方法接受的String参数以"{namespace}localName"的模式构成。
PortType有一种以上的绑定时还需要在JAX-RPC Mapping 文件中说明不指定QName版本的getPort方法对应的port绑定。示例:
<?xml version='1.0' encoding='UTF-8' ?>
<java-wsdl-mapping
  xmlns="http://java.sun.com/xml/ns/j2ee"
  xmlns:mh="http://www.Monson-Haefel.com/jwsbook/BookQuote"...>
  ...
  <service-endpoint-interface-mapping>
    <service-endpoint-interface>com.jwsbook.jaxrpc.BookQuote
    </service-endpoint-interface>
    <wsdl-port-type>mh:BookQuote</wsdl-port-type>
    <wsdl-binding>mh:BookQuote_LiteralBinding</wsdl-binding>
    ...
  </service-endpoint-interface-mapping>
</java-wsdl-mapping>


使用QName的动态代理调用实例:
package com.jwsbook.jaxrpc;
import javax.naming.InitialContext;
import javax.xml.namespace.QName;

public class JaxRpcExample_3 {
  public static void main(String [] args) throws Exception{
    String isbn = args[0];

    InitialContext jndiContext = new InitialContext();

    javax.xml.rpc.Service service = (javax.xml.rpc.Service)
    jndiContext.lookup("java:comp/env/service/Service");

    QName portName =
          new QName("http://www.Monson-Haefel/jwsbook/BookQuote",
          "BookQuoteLiteralPort");

    BookQuote BookQuote_proxy = (BookQuote)
                               service.getPort(portName, BookQuote.class);

    float price = BookQuote_proxy.getBookPrice( isbn );

    System.out.println("The price is = "+price);
  }
}

动态代理的底层实现是用java的反射机制和java.lang.reflect.Proxy完成的。

动态调用接口(DII)

动态调用接口的通常使用顺序:
1. 获得一个通用的service接口,比如通过JNDI lookup
2. 构造代表WSDL中port和operation的QName对象,作为service接口的createCall方法的参数,得到Call对象。
3. 准备operation所需的参数,如果是原子类型则需要将其包装成相应的对象类型。视operation是否有返回值调用invoke或invokeOneWay方法。
4. 如果operation定义了INOUT,OUT参数,则在invoke后调用getOutputValues,比如:java.util.List outputParams = call.getOutputValues();
完整的代码示例:
package com.jwsbook.jaxrpc;
import javax.naming.InitialContext;
import javax.xml.rpc.Service;
import javax.xml.rpc.Call;
import javax.xml.namespace.QName;

public class JaxRpcExample_4 {
  public static void main(String [] args) throws Exception{
    String isbn = args[0];

    InitialContext jndiContext = new InitialContext();

    javax.xml.rpc.Service service = (javax.xml.rpc.Service)
    jndiContext.lookup("java:comp/env/service/Service");

    QName portName =
     new QName("http://www.Monson-Haefel.com/jwsbook/BookQuote",
               "BookQuotePort");
    QName operationName =
     new QName("http://www.Monson-Haefel.com/jwsbook/BookQuote",
               "getBookPrice");

    Call call = service.createCall(portName,operationName);

    Object [] inputParams = new Object[]{isbn};

    Float price = (Float)call.invoke(inputParams);

    System.out.println("The price is = "+price.floatValue());
 }
}

Java 开发Web Service的几种方式

webservice的应用已经越来越广泛了,下面介绍几种在Java体系中开发webservice的方式,相当于做个记录。 1.Axis2 Axis是apache下一个开源的webservice开发...
  • guoweimelon
  • guoweimelon
  • 2016年03月02日 11:31
  • 867

Java Json解析,Java Web Json解析,Java Web服务端获取Json数据,客户端通过HTTP获取Json数据

实现原因 目前主流的CS结构,数据都是通过RESTful接口形式呈现了,不管是桌面级应用程序还是手机端,接口是我们获取数据的大多数选择,主流数据接口呈现形式主要是Json和Xml,后...
  • u010883330
  • u010883330
  • 2016年09月25日 00:16
  • 500

Web Service--java代码实现客户端编写---[小结]

本文的前提是这样的:已经有现成的chengshou软件产品
  • xueer767
  • xueer767
  • 2014年06月26日 17:09
  • 681

java客户端调用webservice的例子

 java调用webservice的一段代码:import javax.xml.namespace.QName;import org.apache.axis.client.Call;import or...
  • Johnson_Hong
  • Johnson_Hong
  • 2008年01月30日 16:14
  • 2439

Java对WebService实现类的方法做单元测试

作者:Java兔学会了使用Junit4对webService接口做单元测试后,这次在service实现类中写了个方法,不是接口,写好方法后想写个单元测试测试一下,却忽然不知道该如何测试起来。由于这是个...
  • huangjp_hz
  • huangjp_hz
  • 2017年08月16日 15:04
  • 540

开发web service的接口实现方法

一、WebService的开发手段   使用Java开发WebService时可以使用以下两种开发手段     1、 使用JDK开发(1.6及以上版本)     2、使用CXF框架开...
  • wu_chengwei
  • wu_chengwei
  • 2017年02月24日 10:31
  • 2054

Java开发Web Service的几种解决方案

转自:http://blog.csdn.net/zolalad/article/details/25158995 Java开发中经常使用到的几种WebService技术实现方案       ...
  • guoweimelon
  • guoweimelon
  • 2016年03月02日 11:54
  • 2023

用Spring建立RESTful Web Service的Server和Client

本文讲述如何用Spring做与Web Service相关的工作,包括建立服务器端和客户端。...
  • fangzhenpeng
  • fangzhenpeng
  • 2015年08月19日 12:17
  • 3460

webservice--四种客户端调用方式

Webservice的四种客户端调用方式 公网服务地址: http://www.webxml.com.cn/zh_cn/index.aspx 一、生成客户端调用方式 1、Wsimpor...
  • CSDN_GIA
  • CSDN_GIA
  • 2017年02月04日 15:51
  • 18338

走进Java Web开发 ——客户端与服务器的交互原理

在web程序中不太容易搞清楚的就是客户端和服务器。这也是B/S结构的一大特点,C/S结构的客户端和服务器非常明了,没有其他的辅助技术。在B/S中将很多技术都分离出来成为独立的技术,让其变得更加灵活。(...
  • pengzhenjie36
  • pengzhenjie36
  • 2016年09月09日 11:18
  • 2411
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Java Web Service的客户端实现
举报原因:
原因补充:

(最多只允许输入30个字)