J2ME Web 服务入门

答案：简介 

WSA 设计用于与 J2ME 配置文件协同工作，J2ME 配置文件要么基于 Connected Device Configuration (CDC)，要么基于 Connected Limited Device Configuration (CLDC 1.0 或 CLDC 1.1)。远程调用 API 基于 J2SE 的 Java API for XML-Based RPC (JAX-RPC 1.1) 的一个完整子集，它包含了一些远程方法调用（Remote Method Invocation，RMI）类，以满足 JAX-RPC 依赖。XML 解析 API 基于 Simple API for XML, v2 (SAX2)的一个完整子集。

WSA 的目标是把对 Web 服务调用和 XML 解析的基本支持集成到设备的运行时环境，这样开发人员就不必在每个应用程序中嵌入这样的功能了——在像移动电话和个人数字助理这样资源有限的设备中，这算是一个特别浪费资源的问题。 

核心规范 

Web Services Interoperability Organization (WS-I) 促进了定义 Web 服务的核心规范和应用层协议，并且它们受 World Wide Web Consortium (W3C) 和 Organization for the Advancement of Structured Information Standards (OASIS) 的指导。4 个关键标准规定了如何创建、部署、发现以及如何使用 Web 服务：

Web 服务标准 描述 
Simple Object Access Protocol (SOAP) 1.1 定义了传输和数据编码 
Web Services Definition Language (WSDL) 1.1 定义了如何描述远程服务 
Universal Description, Discovery, & Integration (UDDI) 2.0 定义了如何发现远程服务 
Extensible Markup Language (XML) 1.0 和 XML Schema 定义了可扩展标记语言（Extensible Markup Language ，XML） 和 XML 模式（Schema） 

这些主要规范往往非常广泛，而且 Web 服务开发人员已发现难以实现完全互操作性。为了解决标准解释中存在的差异，WS-I 已定义了一组称作 WS-I Basic Profile, version 1.0 的一致性规则。JSR 172 符合基本配置文件（Basic Profile）。 

J2ME 平台上的 Web 服务 

JSR 172 规定了标准化客户端技术，允许 J2ME 应用程序在典型 Web 服务架构上使用远程服务，如图 1 所示：
 
图 1  在典型 Web 服务架构上的 J2ME Web 服务  

在高层，该 Web 服务架构具有三个元素：

驻留在支持 WSA 无线设备上的网络感知应用程序。该应用程序包括使用 JSR 172 运行库与网络进行通信的 JSR 172 存根。下文将会描述存根和运行库所扮演的角色。 
无线网络和 Internet 以及对应的通信和数据编码协议，包括二进制协议、HTTP 以及 SOAP/XML. 
Web 服务器，扮演服务提供者的角色，通常在一个或多个防火墙和代理网关后面。Web 服务器通常提供对专用网络上后端应用程序和服务器的访问。 
WSA 的第一个版本只解决了 Web 服务的使用，不支持服务端点的创建和开发；J2ME 设备可以是服务用户，但不可以是服务提供者。JSR 172 还没有规定使用 UDDI 的服务发现的 API。

了解 JSR 172

首先考查如何组织典型的基于 JSR 172 的应用程序，开始了解 J2ME Web Services 是如何运作的：
 

该应用程序本身是一个基于移动信息设备配置文件（Mobile Information Device Profile，MIDP）或个人基础配置文件（Personal Basis Profile，PBP)）的智能客户机，具有特定于业务的逻辑、用户界面、持久性逻辑以及生命周期和应用程序状态管理。该应用程序可以使用 JAXP 子集 API 来处理 XML 文档。还可以使用 JAX-RPC 子集 API 来使用 Web 服务，从而使用 JSR 172 存根和运行库。

在像手提电话这样的设备中，应用程序和 JSR 172 存根通常驻留在设备内存中，而所有 JSR 172 元素连同基础配置文件和配置一起嵌入到设备本身。

JSR 172 运行库和服务提供者接口


在 JSR 172 操作的中心是运行库，带有服务提供者接口，允许存根执行所有与调用 RPC 服务端点有关的任务：

设置特定于 RPC 调用的属性。 
描述 RPC 调用输入和返回值。 
编码输入值。 
调用 RPC 服务端点。 
对应用程序解码并为其返回服务端点所返回的全部值。 
图 3 描绘出了客户机应用程序、存根以及运行库三者之间的关系：

 
图 3  JSR 172 运行库和 SPI  

虽然 JSR 172 运行库隐藏了像连接管理和数据编码这样的复杂性，但 SPI 从运行库实现细节分离出了存根，从而允许存根在供应商实现之间的可移植性。

客户机应用程序不直接与运行库和 SPI 进行交互；而是使用存根。运行库和 SPI 主要为打算开发 JSR 172 运行库和自动化工具的第三方供应商所关心，比如开发人员用于生成存根的 WSDL 到 Java 映射工具。 

由于应用程序开发人员不直接使用 SPI，因此本文不会较详尽地介绍运行库和 SPI。如果想了解关于它们的更多信息，可以查阅 JSR 172 规范。

JSR 172 JAX-RPC 子集 API

正如前面所提到的，JSR 172 Web 服务远程调用 API 基于 J2SE 的 JAX-RPC 1.1 API 的一个完整子集。以下列表在高层描述了该子集。要了解详细信息，请参阅 JSR 172 specification：

符合 WS-I Basic Profile。 
支持 SOAP 1.1。 
支持所有传输，比如 HTTP 1.1，它可以传送 SOAP 消息，而且具有一个捆绑 SOAP 1.1 的已定义协议。 
支持全套数据类型：逻辑型、字符型、短整型、整型、长整型、浮点型、双精度型、字符串型（String）、基本类型数组以及复杂类型（包括基本或复杂类型的结构）。  
   
 注意，真正的浮点支持只在基于 CDC 或基于 CLDC 1.1. On CLDC 1.0 的软件堆栈中出现，浮点型和双精度型映射为 String。还要注意，所支持的数据类型会约束所支持的 WSDL 数据类型。后面的部分将讨论 WSDL 到 Java 数据类型映射。   
 
 

支持表示 RPC 调用或响应(使用 Document/Literal 消息传递模式的 WSDL 操作)的 SOAP 消息的 Literal 表示；不支持 Encoded 表示。 
不支持带有附件的 SOAP 消息。 
不支持 SOAP 消息处理程序。 
不支持服务端点；即不允许设备是 Web 服务提供者。 
不提供发现支持(UDDI). 
要减少对网络带宽的需求——以及要节省用户的时间和每字节的开销，请不要在设备本身上强制使用 XML 编码。  
   
 注：实现可能会使用更高效的编码，比如设备与无线网关间的二进制协议，只要它对消费者和生产者来说都是透明的。   
 
 

下表描述了 JSR 172 JAX-RPC 子集中的软件包：

Java\ 软件包 描述 
javax.microedition.xml.rpc 定义了存根使用的 Type，它是合法简单类型的枚举：逻辑型、字节型、短整型、整型、长整型、浮点型、双精度型、 String 
定义了存根使用的 ComplexType，它是表示 WSDL xsd:complextype 定义的特殊类型 
定义了存根使用的 Element，它表示 WSDL xsd:element 定义 
定义了存根使用的 Operation，它表示服务端点的 WSDL wsdl:operation  
定义了 FaultDetailHandler，这是一个处理自定义故障的存根所实现的接口 
定义了存根使用的 FaultDetailException，这是一个 Exception 类，表示运行时实现抛出的作为 JAXRPCException 结果的异常；为 service-specificDefines 返回存根异常详细值所使用的 QName（限定名）类，并将相关的 QName 返回给 Stub 实例 
javax.xml.namespace 定义了存根所使用的 QName（限定名）类 
javax.xml.rpc 定义了 Stub 接口，这是所有 JAX-RPC 存根的基本接口；还定义了 NamespaceConstants 以及与 JAXRPCException 有关的类 
java.rmi 标准 java.rmi 软件包子集，包含它以满足 JAX-RPC 依赖性；只定义了 Remote 处理程序和三个异常类：MarshalException、 RemoteException 和 ServerException 

 

除了像 RemoteException 这样的异常，存根还使用大多数上述 API；应用程序本身使用存根。

在应用程序中使用 JAX-RPC 子集

创建 JSR 172 JAX-RPC 客户机的一般步骤如下：

从描述远程 Web 服务的 WSDL XML 文档生成 JSR 172 JAX-RPC 存根类。 
在自己的代码中创建生成存根的实例。 
实例化之后，调用生成存根的方法。这些方法与 WSDL XML 文档中服务端点的 wsdl:操作相对应。 
生成 JSR 172 JAX-RPC 存根

客户机应用程序通过存根和设备的 JSR 172 运行库与远程服务进行交互。该运行库隐藏了与连接、SOAP 以及数据编码管理相关的复杂性。 

要与运行库进行交互，客户机通常使用存根生成器所生成的存根或者 WSDL 到 Java 的映射工具，它们用于在 WSDL 文档中输入远程服务接口定义，并生成使用 JAX-RPC 子集 API 和运行库 SPI 的存根类。虽然也能手工开发这些存根，但使用该生成器效果会更佳。下图概述了存根的生成：

  

生成 JSR 172 存根的一般步骤。 最后所得到的存根类实现了 Stub Interface 和服务的远程接口，并使用了支持类。 

生成 JSR 172 JAX-RPC 存根的步骤类似于创建基于 RMI 的应用程序的步骤。在标准 RMI 中，RMI 编译器 (rmic) 从远程接口定义生成存根。如图 4 所示，创建 WSA 应用程序之后，WSDL 到 Java 的映射工具从 WSDL XML 文件生成存根。映射工具生成远程接口 Java 文件和支持类，它们由生成的存根本身所使用。然后将 JSR 172 存根编译为 Java 类，并同应用程序一起打包。

Sun 的 J2ME Wireless Toolkit V2.1 包含 JSR 172 JAX-RPC 存根生成器——本文稍后将讲述如何使用它。第三方供应商提供了自己的存根生成器。

使用 JSR 172 JAX-RPC 存根

存根一旦生成了，应用程序就可以使用它了。以下代码片段使用了称作 PubService 的服务，以便检索无线技术文章：

package j2medeveloper.pubwebservice

// MIDP

import javax.microedition.midlet.MIDlet;

import javax.microedition.lcdui.Display;

import javax.microedition.lcdui.Form;

...

// JAX-RPC

import java.rmi.RemoteException;
上一个：J2ME Wireless Toolkit 2.2 新改进
下一个：J2ME-MIDP1.0游戏完整实现-双人扫雷1.0（二）
更多图片编程知识:

java 基础数据类型

记得以前有人需要得到磁盘的剩余空间的，我找到了

J2ME游戏开发学习之高效&漂亮显示积分

Struts模块化编程教程(三)

J2EE Server下的第一个EJB程序（图文进阶篇）

Eclipse Release Build: 3.1正式发布! ——平台新特性（二）