Sync Android SDK  0.9.0
com.twilio.sync.Stream Class Reference

Stream is an ordered message delivery queue. More...

Classes

class  Message
 Single message in a Stream. More...
 

Public Member Functions

native String getSid ()
 An immutable system-assigned identifier of this Message Stream. More...
 
native String getUniqueName ()
 An optional unique name for this stream, assigned at creation time. More...
 
void publishMessage (JSONObject data, SuccessListener< String > listener)
 Publish a new message to this message stream. More...
 
void setTtl (int ttl, SuccessListener< Void > listener)
 Set time to live for stream object in seconds. More...
 
void removeStream (SuccessListener< Void > listener)
 Remove the stream from the system, deleting it. More...
 

Public Attributes

final int InfiniteDuration = 0
 Time to live for a stream, specifying no expiry.
 

Detailed Description

Stream is an ordered message delivery queue.

You can publish messages and listen for incoming messages.

To obtain an instance of a Stream use SyncClient#openStream.

Member Function Documentation

native String com.twilio.sync.Stream.getSid ( )

An immutable system-assigned identifier of this Message Stream.

Returns
A string containing Message Stream SID.
native String com.twilio.sync.Stream.getUniqueName ( )

An optional unique name for this stream, assigned at creation time.

Returns
The unique name.
void com.twilio.sync.Stream.publishMessage ( JSONObject  data,
SuccessListener< String >  listener 
)

Publish a new message to this message stream.

Parameters
dataContains the payload of the dispatched message. Maximum size in serialized JSON: 4KB.
listenerAsync result listener. See SuccessListener.
void com.twilio.sync.Stream.removeStream ( SuccessListener< Void >  listener)

Remove the stream from the system, deleting it.

Parameters
listenerAsync result listener. See SuccessListener.
void com.twilio.sync.Stream.setTtl ( int  ttl,
SuccessListener< Void >  listener 
)

Set time to live for stream object in seconds.

This TTL specifies the minimum time the Stream will live, sometime soon after this time the object will be deleted.

If time to live is not specified, object lives infinitely long.

TTL could be used in order to auto-recycle old unused objects, but it is not recommended to build some app logic like timers using ttl.

Parameters
ttlTime to live in seconds from now or InfiniteDuration to indicate no expiry.
listenerAsync result listener. See SuccessListener.