rx.android.observables

Class AndroidObservable

java.lang.Object

rx.android.observables.AndroidObservable

public final class AndroidObservable
extends java.lang.Object

Method Summary

Methods

Modifier and Type	Method and Description
static <T> rx.Observable<T>	bindActivity(android.app.Activity activity, rx.Observable<T> source) Binds the given source sequence to an activity.
static <T> rx.Observable<T>	bindFragment(java.lang.Object fragment, rx.Observable<T> source) Binds the given source sequence to a fragment (native or support-v4).
static rx.Observable<android.content.Intent>	fromBroadcast(android.content.Context context, android.content.IntentFilter filter) Create Observable that wraps BroadcastReceiver and emmit received intents.
static rx.Observable<android.content.Intent>	fromBroadcast(android.content.Context context, android.content.IntentFilter filter, java.lang.String broadcastPermission, android.os.Handler schedulerHandler) Create Observable that wraps BroadcastReceiver and emmit received intents.
static rx.Observable<android.content.Intent>	fromLocalBroadcast(android.content.Context context, android.content.IntentFilter filter) Create Observable that wraps BroadcastReceiver and connects to LocalBroadcastManager to emmit received intents.
static rx.Observable<java.lang.String>	fromSharedPreferencesChanges(android.content.SharedPreferences sharedPreferences) Create Observable that emits String keys whenever it changes in provided SharedPreferences Items will be observed on the main Android UI thread

Methods inherited from class java.lang.Object

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

Method Detail

bindActivity

public static <T> rx.Observable<T> bindActivity(android.app.Activity activity,
                                rx.Observable<T> source)

Binds the given source sequence to an activity.

This helper will schedule the given sequence to be observed on the main UI thread and ensure that no notifications will be forwarded to the activity in case it is scheduled to finish.

You should unsubscribe from the returned Observable in onDestroy at the latest, in order to not leak the activity or an inner subscriber. Conversely, when the source sequence can outlive the activity, make sure to bind to new instances of the activity again, e.g. after going through configuration changes. Refer to the samples project for actual examples.

Parameters:

activity - the activity to bind the source sequence to

source - the source sequence

bindFragment

public static <T> rx.Observable<T> bindFragment(java.lang.Object fragment,
                                rx.Observable<T> source)

Binds the given source sequence to a fragment (native or support-v4).

This helper will schedule the given sequence to be observed on the main UI thread and ensure that no notifications will be forwarded to the fragment in case it gets detached from its activity or the activity is scheduled to finish.

You should unsubscribe from the returned Observable in onDestroy for normal fragments, or in onDestroyView for retained fragments, in order to not leak any references to the host activity or the fragment. Refer to the samples project for actual examples.

Parameters:

fragment - the fragment to bind the source sequence to

source - the source sequence

fromBroadcast

public static rx.Observable<android.content.Intent> fromBroadcast(android.content.Context context,
                                                  android.content.IntentFilter filter)

Create Observable that wraps BroadcastReceiver and emmit received intents.

Parameters:

filter - Selects the Intent broadcasts to be received.

fromBroadcast

public static rx.Observable<android.content.Intent> fromBroadcast(android.content.Context context,
                                                  android.content.IntentFilter filter,
                                                  java.lang.String broadcastPermission,
                                                  android.os.Handler schedulerHandler)

Create Observable that wraps BroadcastReceiver and emmit received intents.

Parameters:

filter - Selects the Intent broadcasts to be received.

broadcastPermission - String naming a permissions that a broadcaster must hold in order to send an Intent to you. If null, no permission is required.

schedulerHandler - Handler identifying the thread that will receive the Intent. If null, the main thread of the process will be used.

fromLocalBroadcast

public static rx.Observable<android.content.Intent> fromLocalBroadcast(android.content.Context context,
                                                       android.content.IntentFilter filter)

Create Observable that wraps BroadcastReceiver and connects to LocalBroadcastManager to emmit received intents.

Parameters:

filter - Selects the Intent broadcasts to be received.

fromSharedPreferencesChanges

public static rx.Observable<java.lang.String> fromSharedPreferencesChanges(android.content.SharedPreferences sharedPreferences)

Create Observable that emits String keys whenever it changes in provided SharedPreferences Items will be observed on the main Android UI thread