org.jboss.aerogear.android.pipe.loader

Class LoaderAdapter<T>

java.lang.Object

org.jboss.aerogear.android.pipe.loader.LoaderAdapter<T>

All Implemented Interfaces:

android.app.LoaderManager.LoaderCallbacks<HeaderAndBody>, LoaderPipe<T>, Pipe<T>

public class LoaderAdapter<T>
extends Object
implements LoaderPipe<T>, android.app.LoaderManager.LoaderCallbacks<HeaderAndBody>

This class wraps a Pipe in an asynchronous Loader.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LoaderAdapter.CallbackHandler<T>

Field Summary

Fields inherited from interface org.jboss.aerogear.android.pipe.LoaderPipe

CALLBACK, FILTER, ITEM, METHOD, REMOVE_ID, SAVE_ID

Constructor Summary

Constructors

Constructor and Description
LoaderAdapter(android.app.Activity activity, Pipe<T> pipe, String name)
LoaderAdapter(android.app.Fragment fragment, android.content.Context applicationContext, Pipe<T> pipe, String name)

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.
android.content.Loader<HeaderAndBody>	onCreateLoader(int id, android.os.Bundle bundle)
void	onLoaderReset(android.content.Loader<HeaderAndBody> loader)
void	onLoadFinished(android.content.Loader<HeaderAndBody> loader, HeaderAndBody data)
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 idx, 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 toRemoveId, org.jboss.aerogear.android.core.Callback<Void> callback) Removes an object from the underlying server connection.
void	reset() Calls reset on all loaders associated with this pipe.
void	save(T item, org.jboss.aerogear.android.core.Callback<T> callback) Saves or updates a given object on the server.
void	setLoaderIds(Map<String,List<Integer>> idsForNamedPipes) Passes in a multimap of ids for the named pipe.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LoaderAdapter

public LoaderAdapter(android.app.Activity activity,
                     Pipe<T> pipe,
                     String name)

LoaderAdapter

public LoaderAdapter(android.app.Fragment fragment,
                     android.content.Context applicationContext,
                     Pipe<T> pipe,
                     String name)

Method Detail

getUrl

public URL getUrl()

Description copied from interface: Pipe

Returns the URL to which this Pipe object points.

Specified by:

getUrl in interface Pipe<T>

Returns:

the endpoint URL

read

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

Description copied from interface: Pipe

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

Specified by:

read in interface Pipe<T>

Parameters:

idx - representing the ‘id’ of the object

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

read

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

Description copied from interface: Pipe

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

Specified by:

read in interface Pipe<T>

Parameters:

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

read

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

Description copied from interface: Pipe

Reads all the data from the underlying server connection.

Specified by:

read in interface Pipe<T>

Parameters:

filter - a ReadFilter for performing pagination and querying.

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

save

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

Description copied from interface: Pipe

Saves or updates a given object on the server.

Specified by:

save in interface Pipe<T>

Parameters:

item - the item to save or update

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

remove

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

Description copied from interface: Pipe

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

Specified by:

remove in interface Pipe<T>

Parameters:

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

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

getHandler

public PipeHandler<T> getHandler()

Description copied from interface: Pipe

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

Specified by:

getHandler in interface Pipe<T>

Returns:

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

getRequestBuilder

public RequestBuilder<T> getRequestBuilder()

Description copied from interface: Pipe

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

Specified by:

getRequestBuilder in interface Pipe<T>

Returns:

the current RequestBuilder instance

getResponseParser

public ResponseParser<T> getResponseParser()

Description copied from interface: Pipe

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

Specified by:

getResponseParser in interface Pipe<T>

Returns:

the current ResponseParser instance

getKlass

public Class<T> getKlass()

Specified by:

getKlass in interface Pipe<T>

Returns:

the class which travels on this pipe

onCreateLoader

public android.content.Loader<HeaderAndBody> onCreateLoader(int id,
                                                            android.os.Bundle bundle)

Specified by:

onCreateLoader in interface android.app.LoaderManager.LoaderCallbacks<HeaderAndBody>

onLoadFinished

public void onLoadFinished(android.content.Loader<HeaderAndBody> loader,
                           HeaderAndBody data)

Specified by:

onLoadFinished in interface android.app.LoaderManager.LoaderCallbacks<HeaderAndBody>

onLoaderReset

public void onLoaderReset(android.content.Loader<HeaderAndBody> loader)

Specified by:

onLoaderReset in interface android.app.LoaderManager.LoaderCallbacks<HeaderAndBody>

reset

public void reset()

Description copied from interface: LoaderPipe

Calls reset on all loaders associated with this pipe.

Specified by:

reset in interface LoaderPipe<T>

setLoaderIds

public void setLoaderIds(Map<String,List<Integer>> idsForNamedPipes)

Description copied from interface: LoaderPipe

Passes in a multimap of ids for the named pipe. LoaderPipe should manage this collection.

Specified by:

setLoaderIds in interface LoaderPipe<T>

Parameters:

idsForNamedPipes - A map of all LoaderIds for pipes hased by their name