软件包 com.caucho.burlap.client

Portable client code for using Burlap services.

请参见：
描述

接口摘要

BurlapMetaInfoAPI

API retrieving burlap meta information.

类摘要

BurlapProxy	Proxy implementation for Burlap clients.
BurlapProxyFactory	Factory for creating Burlap client stubs.
BurlapProxyResolver	Looks up remote objects in the proxy.
BurlapRemote	Encapsulates a remote address when no stub is available, e.g. for Java MicroEdition.
MicroBurlapInput	Input stream for Burlap requests, compatible with microedition Java.
MicroBurlapOutput	Output stream for Burlap requests, compatible with microedition Java.

异常摘要

BurlapProtocolException	Exception for faults when the fault doesn't return a java exception.
BurlapRuntimeException	Wrapper for protocol exceptions thrown in the proxy.
BurlapServiceException	Exception for faults when the fault doesn't return a java exception.

软件包 com.caucho.burlap.client 的描述

Portable client code for using Burlap services. Since this package is independent of all Resin code, its classes can be copied to a non-Resin client jar.

RPC Proxy Clients - BurlapProxyFactory

Most application clients will use BurlapProxyFactory to create stub objects. The stub objects can be called with normal Java calls. Because the objects are remote, the client application needs to be able to deal with IOException caused by an unavailable server or a protocol error.

import com.caucho.burlap.client.BurlapProxyFactory;

...

URL url = new URL("http://localhost:8080/ejb/hello");
HelloHome hello = (HelloHome) factory.create(HelloHome.class, url);

System.out.println("hello: " + hello.hello());

Serialization

Since the Burlap protocol serializes Java objects to XML, the BurlapSerializerOutput and BurlapSerializerInput can be used for serialization.

Serialization

OutputStream os = new FileOutputStream("test.xml");
BurlapOutput out = new BurlapSerializerOutput(os);

out.writeObject(obj);
os.close();

Deserialization

InputStream is = new FileInputStream("test.xml");
BurlapInput in = new BurlapSerializerInput(in);

Object obj = in.readObject();

is.close();

MicroBurlapInput and MicroBurlapOutput

These two classes only require classes from Java MicroEdition. So they can be extracted separately into a burlap-micro.jar. Because of this restriction and their small size, these two classes are ideal for limited size devices like mobile phones and PDAs.