EODistributionChannel

Inherits from:
Object

Package:
com.webobjects.eodistribution.client

Class Description

EODistributionChannel is an abstract class that defines the interface for objects implementing channels for communicating data between the client and the server in a distributed Enterprise Objects application. The com.apple.client.eodistribution package includes EOHTTPChannel, a concrete subclass of EODistributionChannel that handles communication via the HTTP protocol (the most common protocol in distributed Internet applications). You can create you own subclass of EODistributionChannel if you need client-server communication based on a different protocol such as CORBA/IIOP.

An EODistributionChannel object has a connection dictionary that contains the values required to establish a connection on the channel, for example port, host, and URL components. You can change the connection dictionary with the setConnectionDictionary method.

Method Types

Getting an EODistributionChannel

channelWithName

Sending data on the channel

establishConnection
responseToMessage

Setting and getting the connection dictionary

connectionDictionary
connectionKeys
setConnectionDictionary

Accessing the delegate

delegate
setDelegate

Static Methods

channelWithName

public static EODistributionChannel channelWithName(String className)

Returns an EODistributionChannel object instantiated from the class whose name is className. Returns null if there is no class with that name, or if there is an instantiation, illegal-access, or security exception.

Instance Methods

connectionDictionary

public NSDictionary connectionDictionary()

Returns the connection dictionary used by the receiver.

connectionKeys

public abstract NSArray connectionKeys()

Overridden by subclasses to return the set of keys used to access the values in the connection dictionary that the channel needs to connect with the server.

delegate

public Object delegate()

Returns the receiver's delegate.

establishConnection

public abstract void establishConnection()

Overridden by subclasses to establish a connection with the server using a specific protocol.

See Also: responseToMessage

responseToMessage

public abstract Object responseToMessage( Object aMessage, NSCoder aCoder)

Overridden by subclasses to send the message aMessage to the server and synchronously receive a response. Before it is sent the message should be encoded using aCoder.

See Also: establishConnection

setConnectionDictionary

public void setConnectionDictionary(NSDictionary aDictionary)

Sets the connection dictionary used by the receiver to aDictionary.

setDelegate

public void setDelegate(Object delegate)

Sets the receiver's delegate.