rx.plugins

Class RxJavaPlugins

java.lang.Object

rx.plugins.RxJavaPlugins

public class RxJavaPlugins
extends java.lang.Object

Registry for plugin implementations that allows global override and handles the retrieval of correct implementation based on order of precedence:

1. plugin registered globally via register methods in this class
2. plugin registered and retrieved using System.getProperty(String) (see get methods for property names)
3. default implementation

See Also:

RxJava Wiki: Plugins

Method Summary

Methods

Modifier and Type	Method and Description
RxJavaDefaultSchedulers	getDefaultSchedulers() Retrieves the instance of RxJavaDefaultSchedulers to use based on order of precedence as defined in the RxJavaPlugins class header.
RxJavaErrorHandler	getErrorHandler() Retrieves an instance of RxJavaErrorHandler to use based on order of precedence as defined in RxJavaPlugins class header.
static RxJavaPlugins	getInstance() Retrieves the single RxJavaPlugins instance.
RxJavaObservableExecutionHook	getObservableExecutionHook() Retrieves the instance of RxJavaObservableExecutionHook to use based on order of precedence as defined in RxJavaPlugins class header.
void	registerDefaultSchedulers(RxJavaDefaultSchedulers impl) Registers an RxJavaDefaultSchedulers implementation as a global override of any injected or default implementations.
void	registerErrorHandler(RxJavaErrorHandler impl) Registers an RxJavaErrorHandler implementation as a global override of any injected or default implementations.
void	registerObservableExecutionHook(RxJavaObservableExecutionHook impl) Register an RxJavaObservableExecutionHook implementation as a global override of any injected or default implementations.

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static RxJavaPlugins getInstance()

Retrieves the single RxJavaPlugins instance.

Returns:

the single RxJavaPlugins instance

getErrorHandler

public RxJavaErrorHandler getErrorHandler()

Retrieves an instance of RxJavaErrorHandler to use based on order of precedence as defined in RxJavaPlugins class header.

Override the default by calling RxJavaPlugins.registerErrorHandler(RxJavaErrorHandler) or by setting the property rxjava.plugin.RxJavaErrorHandler.implementation with the full classname to load.

Returns:

RxJavaErrorHandler implementation to use

registerErrorHandler

public void registerErrorHandler(RxJavaErrorHandler impl)

Registers an RxJavaErrorHandler implementation as a global override of any injected or default implementations.

Parameters:

impl - RxJavaErrorHandler implementation

Throws:

java.lang.IllegalStateException - if called more than once or after the default was initialized (if usage occurs before trying to register)

getObservableExecutionHook

public RxJavaObservableExecutionHook getObservableExecutionHook()

Retrieves the instance of RxJavaObservableExecutionHook to use based on order of precedence as defined in RxJavaPlugins class header.

Override the default by calling RxJavaPlugins.registerObservableExecutionHook(RxJavaObservableExecutionHook) or by setting the property rxjava.plugin.RxJavaObservableExecutionHook.implementation with the full classname to load.

Returns:

RxJavaObservableExecutionHook implementation to use

registerObservableExecutionHook

public void registerObservableExecutionHook(RxJavaObservableExecutionHook impl)

Register an RxJavaObservableExecutionHook implementation as a global override of any injected or default implementations.

Parameters:

impl - RxJavaObservableExecutionHook implementation

Throws:

java.lang.IllegalStateException - if called more than once or after the default was initialized (if usage occurs before trying to register)

getDefaultSchedulers

public RxJavaDefaultSchedulers getDefaultSchedulers()

Retrieves the instance of RxJavaDefaultSchedulers to use based on order of precedence as defined in the RxJavaPlugins class header.

Override the default by calling RxJavaPlugins.registerDefaultSchedulers(RxJavaDefaultSchedulers) or by setting the property rxjava.plugin.RxJavaDefaultSchedulers.implementation with the full classname to load.

Returns:

the RxJavaDefaultSchedulers implementation in use

registerDefaultSchedulers

public void registerDefaultSchedulers(RxJavaDefaultSchedulers impl)

Registers an RxJavaDefaultSchedulers implementation as a global override of any injected or default implementations.

Parameters:

impl - RxJavaDefaultSchedulers implementation

Throws:

java.lang.IllegalStateException - if called more than once or after the default was initialized (if usage occurs before trying to register)