xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />
ejb2.1（enterprise javabeans 2.1）正式推荐版本已经出台，它产生的动力主要是enterprise javabeans对支持web service的需求，同时也是因为micr
osoft .net的发布，它对j2ee或者说对java技术来说已经构成了巨大威胁。在新版本的ejb2.1中，主要的变化主要集中在基于soap和wsdl的web service上。ejb已经成为一种新的web service平台。它对web service的支持主要体现在三个新的web service api上:分别是jax-rpc（java api for xml-rpc，它基本上是通过soap实现的java rmi，为rpc格式的soap消息提供远端接口）、saaj（soap api with attachments for java，它模仿soap消息的结构，同时也有功能有限的消息分发能力）和jaxm（java api for xml messaging，它类似于jms，提供发送和接收soap消息的消息架构），利用它们可以实现与其它类型的web service进行通讯，而且还允许无序的会话bean和消息驱动的bean来作为web service使用，使它们能够被任何与 soap1.1兼容的客户端所访问。例如：使用soap，我们就可以从其它平台web service来调用无序的会话bean的方法，象微软的.net，perl，apache axix和其他的语言和平台。ejb2.1中新的web service功能能够提供一种前所未有的跨平台互操作性，它主要是建立在两个崭新的j2ee soap工具包jax-rpc和jaxm。
web service代表了分布式计算的最新潮流，可能是自1995年java的出现和1998年xml出现以来最重要的技术了。其实，给web service下一个准确的定义是很难的，因为web service并不是任何特殊技术或者平台所特有的，web service是一种网络应用程序，以xml形式的文档，使用soap和wsdl进行信息交换。要更好地理解这句话的含义，你必须先理解soap和wsdl，下面是有关这方面的定义：
soap：简单对象访问协议（simple object access protocol），是在w3c的支持下，由microsoft，ibm和其他公司开发的，基于xml格式的一种协议，它是可伸缩和可扩展的，不象以前的dce rpc, corba iiop, java rmi-jrmp以及dcom，它已经被几乎所有的开发厂商所认可和接受。
wsdl：web服务描述语言（web service description language），也是在w3c的支持下，由microsoft，ibm和其他公司开发的，xml格式的语言，用来对web service进行描述，包括期望的消息格式类型、所使用的inte.net协议和web service的inte.net地址。
其实，web service代表了一种新的分布式对象技术，它和corba iiop和java rmi很相似，但也有许多差异，最大的差异应该就是真正的平台无关性。尽管java rmi和corba iiop都声称自己是平台无关的，但实际上，它们都需要它们自己的平台。要使用java rmi，你需要一个java虚拟机和java编程语言，对使用其它语言的开发者如visual basic或c++来说，java rmi并不是平台无关的。corba iiop也是有局限性的，iiop协议通常需要一个特定的架构如corba orb，也只有少数几个厂商支持corba。另一方面，web service着重描述信息交换的协议，而不是着重描述对这些协议的实现，换句话说，你可以用任何语言，在任何平台上，以任何你自己喜欢的方式来创建web service。
web service另外一个好处就是，不象其它的分布式对象体系，它建立在现有的技术架构的基础之上，因此大多说厂商很容易实现。soap和wsdl都是基于xml的，而xml已经被广泛支持，xml解析器在几乎每一种开发语言中都有，因此，处理soap消息和wsdl文档的基础已经存在了。此外，web service消息通常是通过tcp/ip进行交换的，也已经被几乎所有的平台和语言所支持。
jax-rpc和ejb
jax-rpc（java api for xml-rpc）实质上就是通过soap访问的java rmi。它和“本地的”java rmi (java rmi-jrmp)和java rmi-iiop很象，但是它是以soap作为通讯协议。要实现jax-rpc,最低要求是必须对通过http访问的soap支持rpc编码，但是，我们仍然可以提供对其他编码方式、消息格式和inte.net协议的支持。jax-rpc能够被用来从会话、实体和消息驱动的bean来调用web service的操作。jax-rpc能够用来访问其它平台的web service。例如：一个无序的会话bean可能会使用jax-rpc来调用.net web service的方法。如下图所示：
xml:namespace prefix = v ns = "urn:schemas-microsoft-com:vml" />
每个ejb开发商都会提供自己对jax-rpc的实现，但它们之间的差别是很小的，主要是因为所有的实现都必须遵照jax-rpc规范，jax-rpc能够当作客户端api来访问其它的web service，但是，它同时也是一个被称作“endpoint接口”的新型企业bean接口。当jax-rpc当作客户端api的时候，会话、实体或者消息驱动的bean能够使用它与其它平台的web service交换消息。jax-rpc定义了三种编程模型：generated stub、dynamic proxy和dii（dynamic invocation interface），我们在ejb环境中常用的generated stub模型。
如果使用jax-rpc去访问web service，那么，这个web service必须发行一个wsdl文档，ejb开发商提供的jax-rpc工具包产生java rmi接口和实现wsdl文档所描述的web service操作的stub，一旦stub和接口创建出来之后，我们就可以把它们与企业bean的jndi enc（environment naming context）进行绑定，然后与 web service进行通信。
wsdl把访问web service的接口描述成“端口”，每个端口有一个或者多个“操作”，端口和操作的概念和java的接口和方法类似。实际上，jax-rpc定义了wsdl和java rmi之间的映射关系，它产生来自端口的远端接口，并带有响应端口操作的方法。例如：一个wsdl文档可能描述一个被称作“bookprice”、并带有单个操作getboolprice的端口，下面就是bookprice wsdl文档的一些简单代码：
<?xml version="1.0"?>
<definitions name="bookprice"
targetnamespace="http://lucky.myrice.com/getbookprice"
xmlns:tns="http://lucky.myrice.com/getbookprice"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:xsd="http://www.w3.org/2001/xmlschema"
xmlns="http://schemas.xmlsoap.org/wsdl/">
<!-- 描述参数和返回值的message元素 -->
<message name="isbnmessage">
<part name="isbn" type="xsd:string" />
</message>
<message name="pricemessage">
<part name="price" type="xsd:float" />
</message>
<!-- 描述web service抽象接口的porttype元素 -->
<porttype name="bookprice">
<operation name="getbookprice">
<input name="isbn" message="tns:isbnmessage"/>
<output name="price" message="tns:pricemessage"/>
</operation>
</porttype>
<!-- 在这里进行绑定 -->
<!-- service元素告诉我们web service的地址 -->
<service name="bookpriceservice">
<port name="bookprice" binding="tns:bookprice_binding">
<soap:address location="http://lucky.myrice.com/bookprice" />
</port>
</service>
</definitions>
在部署的时候，jax-rpc stub生成工具会把wsdl端口转换成远程接口和stub，端口和服务stub可能是下面的样子：
public interface bookpriceservice extends javax.xml.rpc.service{
public bookprice getbookprice( ) throws remoteexception;
}
public interface bookprice extends java.rmi.remote {
public float getbookprice(string isbn)
throws remoteexception;
}
这里只是一个简单的例子，这个服务只有一个端口，而实际上一个服务会有多个端口，每个端口有相应的接口和stub。一旦接口和stub产生并被绑定到jndi enc之后，它们就可以在运行期调用web service的“操作”了，在下面的无序会话bean里，bookcatalog ejb利用jax-rpc从.net web webvices查找一本书的批发价格。
public class bookcatalog implements javax.ejb.sessionbean {
...
public float getwholesaleprice(string isbn) {
try {
initialcontext jndicontext = new initialcontext ( );
bookpriceservice service =
jndicontext.lookup("java:comp/env/service/bookpriceservice");
bookprice bookprice_port = service.getbookprice();
float price = bookprice_port.getbookprice( isbn );
return price;
catch(remoteexception re){
}catch(serviceexception se){
}catch(namingexception ne){
}
}...
}
当调用getbookprice()方法时，jax-rpc stub向.net web service发送soap信息，stub产生的soap信息可能会是下面的样子：
<?xml version='1.0' ?>
<env:envelope
xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"
xmlns:xyz='http://lucky.myrice.com/bookprice"
encodingstyle="http://schemas.xmlsoap.org/soap/encoding/">
<body>
<xyz:getbookprice>
<isbn xsi:type="string">1565928695
</xyz:getbookprice>
</body>
</env:envelope>
.net erb services处理soap信息，并把结果返回到stub，stub分析结果，最后向客户端发送最终结果。
jax-rpc stub中的方法可以有参数，参数类型可以是基本数据类型，如int,long等；基本包装类型，如java.lang.interger,java.lang.long等；数组；java标准类型，如string,date等；也可以是自定义对象类型。自定义对象必须符合jax-rpc规范的规则。
除了产生stub外，jax-rpc也支持动态代理服务，除了它的远程接口和stub的实现是在运行时动态产生的之外，动态代理服务的作用和stub一样。下面的例子就是jax-rpc产生动态stub的：
public class bookcatalog implements javax.ejb.sessionbean {
...
public float getwholesaleprice(string isbn) {
try {
initialcontext jndicontext = new initialcontext ( );
javax.xml.rpc.service service =
jndicontext.lookup("java:comp/env/service/dynamicservice");
bookprice bookprice_port = service.getport(bookprice.class);
float price = bookprice_port.getbookprice( isbn );
return price;
catch(remoteexception re){}
catch(serviceexception se){}
catch(namingexception ne){}
}
...
}
在运行时，getport()方法自动把bookprice接口映射到wsdl文档里定义的相应端口，然后产生stub实现接口的工作。
jax-rpc还支持名为dii（dynamic invocation interface）的动态api，dii允许开发人员在运行时调用soap方法。如果你使用过corba dynamic invocation interface的话，那你对jax-rpc dii一定很容易理解。jax-rpc dii类似于java的反射（reflection）,它允许你以方法的形式得到一个代表web service操作的对象的参考，调用那个方法，就无需再访问service factory或者再使用stub和远端接口。下面的例子就是企业bean访问bookprice端口的getbookprice()操作：
public class bookcatalog implements javax.ejb.sessionbean {
...
public float getwholesaleprice(string isbn) {
try {
initialcontext jndicontext = new initialcontext ( );
javax.xml.rpc.service service =
jndicontext.lookup("java:comp/env/service/dynamicservice");
qname port = new qname("http://lucky.myrice.com/getbookprice ","bookprice");
qname operation = new qname("http://lucky.myrice.com/getbookprice",
"getbookprice");
call callobject = service.createcall(port, operation);
object [] args = new object[1]; args[0] = isbn;
float price = (float) callobject.invoke( args );
return price.floatvalue();
}
catch(jaxrpcexception se){}
catch(namingexception ne){}
}
}
...
}
实际上，你可以在运行期配置参数、类型、编码等，你能用wsdl配置的所有信息都可以用dii动态配置。
jax-rpc另外还是一个称为终端接口（endpoint interface）的新型组件，这个新接口允许我们把无序的会话bean作为web service来实现，这个终端接口简化了javax.rmi.remote接口的实现，并且遵守jax-rpc规范中的规则。把一个无序的会话bean作为web service来实现是非常简单的：只需定义bean类和远端接口，然后使用开发商的提供的工具来实现。一旦建立了web service，它的方法就能够被任何soap兼容的、来自任何语言和平台的工具包来调用，比如：.net，perl，apache axis，c，c++等等。如下图所示：
由于jax-rpc仅仅是java rmi的另外一种形式，因此，利用它访问企业bean是很自然的，我们以前已经利用rmi-iiop和rmi访问过。利用jax-rpc与ejb进行通信意味着ejb可以当作web service来使用，至少无序的bean是可以的。ejb2.1允许我们利用jax-rpc，但只能是应用于无序的bean，这主要是因为soap是一种无序的消息协议，它没有对象识别的概念，因此它不能应用在有序的和实体的bean中。
ejb2.1为无序的bean定义了一个新的web service终端（endpoint）接口，web service界的人使用“终端”来称呼发送和接收soap信息的任何东西。在ejb中，终端就是一个无序的会话bean，它可以通过soap来访问，并且遵照jax-rpc规范中定义的从java-to-wsdl到java-to-soap的映射规则。使用jax-rpc最为ejb终端的基础是顺理成章的，因为jax-rpc规范中定义了soap消息和java方法调用以及从java远程接口产生wsdl文档的详细规则。
不象ejb开发者已经很熟悉的远端和本地接口,终端接口并没有继承ejb对象类型，如ejbobject或ejblocalobject。相反，终端接口直接继承了javax.ejb.remote接口。例如：在上面的例子中的bookprice的web service能够很轻易实现为ejb中的终端。下面的代码说明了一个bookprice的终端接口，和实现为web service的无序会话bean的部分列表。
public interface bookprice extends javax.rmi.remote {
public string getbookprice(string isbn) throws javax.rmi.remoteexception;
}
public class bookpricews implements bookprice, javax.ejb.sessionbean {
public float getbookprice(string isbn){
connection con = null;
statement stmt = null;
resultset rs;
try {
datasource ds = jdnienc.lookup("java:comp/env/jdbc/datasource");
con = ds.getconneciton();
stmt = con.createstatement();
rs = stmt.executequery("select wholesale from catalog where isbn = \'"
+isbn+"\'");
if(rs.next()){
float price = rs.getfloat("wholesale");
return price;
}else{
return 0;
}
}
catch (sqlexception se) {
//处理异常
}
}
...
}
终端接口比远程和本地接口一个很明显的好处就是它不会带来象ejbobject或者ejblocalobect无用方法等形式的额外负担，此外，终端接口没有包括home接口，soap不支持按引用传值。因此，你不能要求一个web services接口（home 接口）按引用传递到另外一个远端接口，更进一步讲，你不能创建或移除一个web service。
当我们把一个无序会话 bean开发成web service时，首先定义一个终端接口，然后利用它产生jax-rpc的客户端stub和wsdl文档或者如果你产生jax-rpc客户端stub，无需做任何改变，你可以把它包装成j2ee客户端jar，利用它去访问无序会话bean，利用soap做通讯协议。如果你从终端接口产生wsdl文档，其它的soap工具包也能够使用这个文档去访问你的无序bean。wsdl和soap是web service的基础，因此，为ejb web services发布wsdl可以实现与其它平台的交互。
saaj
saaj（soap with attachments api for java）是一个基于api的soap工具包，它定义了soap messages with attachments (swa)和soap用的mime信息格式。java开发人员能够利用saaj来创建、读取或者修改soap信息。这个api包含许多类和接口，用来定义soap元素（envelope, body, header, fault等），xml名称空间，属性，文字节点以及mime附件。你可以使用saaj操作简单的、没有附件的xml格式的soap信息，也可以操作更加复杂的、带mime附件的soap信息。saaj可以与jax-rpc结合使用，但也可以单独使用，它有自己的、通过http1.1实现的请求/应答方式的消息机制。
saaj是基于abstract factory模式的。saaj是类型的抽象集合，每一种类型的对象都是由saaj集合中另外的对象产生的。在abstract factory的saaj实现中，messagefactory类是根，它负责创建自己的实例，反过来创建soapmessage，soapmessage包含soappart，它代表soap文档、0个和多个attachmentpart（代表附件的对象，如gif,pdf等）。soappart包含soapenvelope、soapbody、soapheader和其它类型的对象。
<?xml version='1.0' ?>
<env:envelope
xmlns:env='http://schemas.xmlsoap.org/soap/envelope/'
xmlns:xsi='http://www.w3.org/2001/xmlschema-instance'
xmlns:book='http://lucky.myrice.com/bookprice'
encodingstyle='http://schemas.xmlsoap.org/soap/encoding/'>
<env:body>
<book:getbookprice>
<isbn xsi:type='string'>1565928695
</book:getbookprice>
</env:body>
</env:envelope>
而下面是用saaj创建的例子：
import javax.xml.soap.*;
public class example_1 {
public static void main(string [] args) throws soapexception{
messagefactory msgfactory = messagefactory.newinstance();
soapmessage message = msgfactory.createmessage();
soappart soap = message.getsoappart();
soapenvelope envelope = soap.getenvelope();
envelope.getheader().detachnode();
soapbody body = envelope.getbody();
soapelement getbookprice = body.addchildelement(
"getbookprice","book",
"http://lucky.myrice.com/bookprice");
getbookprice.setencodingstyle(soapconstants.uri_ns_soap_encoding);
soapelement isbn = getbookprice.addchildelement("isbn");
isbn.addnamespacedeclaration("xsi",
"http://www.w3.org/2001/xmlschema-instance");
name xsitype = envelope.createname("type","xsi",
"http://www.w3.org/2001/xmlschema-instance");
isbn.addattribute(xsitype,"string");
isbn.addtextnode("1565928695");
message.writeto(system.out);
}
}
如果我们对比上面的例子，就会发现saaj定义了swa消息格式的准确结构，soap消息的属性和saaj类型之间可以发现是一一对应的关系：envelope对应soapenvelope；body对应soapbody；getboolprice对应soapbodyelement；isbn对应soapelement(text)等。
当然，上面的例子是很简单的，它并没有包含任何附件，swa中的附件通常是二进制或者是其它的非xml格式的文件，它通常被soap文档引用。saaj靠jaf（ java activation framework）添加附件，并处理对象和数据流之间的相互转换。下面的这段示例代码利用saaj向soap附加一个pdf文件。
messagefactory msgfactory = messagefactory.newinstance();
soapmessage message = msgfactory.createmessage();
attachmentpart pdfattach = message.createattachmentpart();
filedatasource file = new filedatasource("testsaajattachment.pdf");
datahandler pdfdh = new datahandler(file);
pdfattach.setdatahandler(pdfdh);
要成功处理附件，我们必须先理解jaf，jaf是处理mime数据的极好框架，但它也有自己的局限性，大部分局限性与使用datacontenthandler类型有关。藏在jaf的局限性后面的细节问题是很复杂的，但我们可以使用jaf datasource类型来克服大部分的局限性，就象例子中的javax.activation.filedatasource那样。
saaj是一个用途广泛的api，可以让我们在几乎任何的应用中创建swa消息，在某些情况下，我们可以与jax-rpc一起在文字消息和soap消息中使用saaj，但也可以与其它的api如javamail，jms，jaxm一起使用。如果java应用已经创建了swa消息，它仍可以使用saaj把这个消息转换成二进制流，然后与使用其它api的web services进行交换信息。
jaxm 和 ejb
jaxm (java api for xml messaging)是和(java message service)类似的soap消息api，就象jms是一种通过面向消息的中间件来发送和接收消息的api一样，jaxm是一种通过web service来发送和接收消息的api。
jaxm是面向文档的，它把soap消息以xml格式的文档来进行传送的。jaxm客户端都是使用saaj（soap with attachments api for java）来装配、接收和使用soap消息的，saaj模仿soap消息的实际xml结构，这种机制与jax-rpc是有很大区别的，jax-rpc使用方法调用的语法，把soap消息隐藏到了java rmi代理的后面。使用jax-rpc，你 所看到的是仅仅由方法、参数、返回值组成的远端接口，而使用jaxm，你直接处理soap协议。象jax-rpc一样，jaxm必须与soap兼容的web service交换soap信息。例如：一个企业bean可能使用jaxm与用perl写的web service交换soap信息。ejb2.1开发者能够以jaxm作为一种新的消息驱动bean的基础，我们称它为基于jaxm的消息驱动bean（jaxm-mdb）。jaxm-mdb使用的是soap消息，但扮演的是web service的角色。jaxm-mdb能够实现单向的异步接口，就象基于jms的消息驱动的bean，也可以实现请求/应答式的同步接口。
jax-rpc和jaxm都允许企业bean访问不同平台上的web service，也可以作为用无序和消息驱动bean建立的web service的基础。但是，由于缺乏厂商的支持，jaxm的使用前景并不是很乐观。