File	Doc	Category	Size	Date	Package
DataChannel.java	API Doc	Android 1.5 API	3506	Wed May 06 22:42:46 BST 2009	com.android.im.imps

DataChannel

• java.lang.Object

Fields Summary
protected ImpsConnection	mConnection
protected PrimitiveParser	mParser
protected PrimitiveSerializer	mSerializer
protected long	mMinPollMillis

Constructors Summary
protected DataChannel(ImpsConnection connection) mConnection = connection;

Methods Summary
public abstract void	connect() Establishes a data channel with the IMPS server. throws ImException if an error occur during establishing the data channel.
public abstract long	getLastActiveTime() Gets the time when the last primitive was sent to the server through the data channel. return the time last primitive was sent.
public abstract boolean	isSendingQueueEmpty() Tells if there is any primitive waiting to send. return true if there is one or more primitives waiting to send.
public abstract Primitive	receivePrimitive() Receives a primitive from this data channel, waiting until a primitive from the server arrived or being interrupted. return the received primitive throws InterruptedException
public abstract boolean	resume() Resume the suspended data channel. return true if the channel is resumed successfully; false if the channel is timeout and a new one must be established.
public abstract void	sendPrimitive(Primitive p) Sends a CSP primitive to the IMPS server through this data channel. param p the primitive to send.
public void	setServerMinPoll(long interval) Set the ServerMinPoll value (in seconds) after capability negotiation. The DataChannel MUST NOT send more than 1 PollingRequest within this interval. mMinPollMillis = interval * 1000;
public abstract void	shutdown() Shutdown the data channel.
public abstract void	startKeepAlive(long interval) Starts the keep alive task. KeepAliveRequest will be sent to the server if no other transaction has occurred during the KeepAliveTime interval.
public abstract void	suspend() Suspend the data channel. No data will be sent through the data channel after suspended. It can be recovered from {@link #resume()}.