org.jboss.aerogear.android.pipe

Interface Pipe<T>

Type Parameters:

T - The data type of the Pipe operation

All Known Subinterfaces:

LoaderPipe<T>

All Known Implementing Classes:

LoaderAdapter, RestAdapter

public interface Pipe<T>

A Pipe represents a server connection. An object of this class is responsible to communicate with the server in order to perform read/write operations.

Method Summary

Modifier and Type	Method and Description
PipeHandler<T>	getHandler() Returns the instance which is responsible for handling read, save, and remove.
Class<T>	getKlass()
RequestBuilder<T>	getRequestBuilder() The RequestBuilder is responsible for turning objects in bodies of requests.
ResponseParser<T>	getResponseParser() The ResponseParser is responsible for turning responses from a SAVE into an object
URL	getUrl() Returns the URL to which this Pipe object points.
void	read(org.jboss.aerogear.android.core.Callback<List<T>> callback) Sends a signal to the Pipe to read its data and return it via the callback.
void	read(org.jboss.aerogear.android.core.ReadFilter filter, org.jboss.aerogear.android.core.Callback<List<T>> callback) Reads all the data from the underlying server connection.
void	read(String id, org.jboss.aerogear.android.core.Callback<T> callback) Sends a signal to the Pipe to read data by id and return it via the callback.
void	remove(String id, org.jboss.aerogear.android.core.Callback<Void> callback) Removes an object from the underlying server connection.
void	save(T item, org.jboss.aerogear.android.core.Callback<T> callback) Saves or updates a given object on the server.

Method Detail

getUrl

URL getUrl()

Returns the URL to which this Pipe object points.

Returns:

the endpoint URL

read

void read(String id,
          org.jboss.aerogear.android.core.Callback<T> callback)

Sends a signal to the Pipe to read data by id and return it via the callback.

Parameters:

id - representing the ‘id’ of the object

callback - The callback for consuming the result from the Pipe invocation.

read

void read(org.jboss.aerogear.android.core.Callback<List<T>> callback)

Sends a signal to the Pipe to read its data and return it via the callback.

Parameters:

callback - The callback for consuming the result from the Pipe invocation.

read

void read(org.jboss.aerogear.android.core.ReadFilter filter,
          org.jboss.aerogear.android.core.Callback<List<T>> callback)

Reads all the data from the underlying server connection.

Parameters:

filter - a ReadFilter for performing pagination and querying.

callback - The callback for consuming the result from the Pipe invocation.

save

void save(T item,
          org.jboss.aerogear.android.core.Callback<T> callback)

Saves or updates a given object on the server.

Parameters:

item - the item to save or update

callback - The callback for consuming the result from the Pipe invocation.

remove

void remove(String id,
            org.jboss.aerogear.android.core.Callback<Void> callback)

Removes an object from the underlying server connection. The given key argument is used as the objects ID.

Parameters:

id - representing the ‘id’ of the object to be removed

callback - The callback for consuming the result from the Pipe invocation.

getKlass

Class<T> getKlass()

Returns:

the class which travels on this pipe

getHandler

PipeHandler<T> getHandler()

Returns the instance which is responsible for handling read, save, and remove.

Returns:

the handler performing operations for this Pipe. May be the Pipe itself.

getRequestBuilder

RequestBuilder<T> getRequestBuilder()

The RequestBuilder is responsible for turning objects in bodies of requests.

Returns:

the current RequestBuilder instance

getResponseParser

ResponseParser<T> getResponseParser()

The ResponseParser is responsible for turning responses from a SAVE into an object

Returns:

the current ResponseParser instance