A from-scratch, re-implementation of RxAndroid with a consistent, opinionated API.
This library will not have releases and is subject to deletion at any time.
Weak references should not be used. RxJava's subscription graph allows for proper garbage collections of reference-holding objects provided the caller unsubscribes.
Mapping an observable to an Android event (e.g., view clicks) is a direct mapping. The
library is not responsible for supporting multiple observables bound to the same view.
Multiple listeners to the same view events can be achieved through share().
Naming conventions of classes and their packages should provide unambiguous information
on where functionality can be found. Helpers for platform classes can be found in packages
of the same name but prefixed with rx. and classes of the same name but prefixed with Rx.
For example, android.widget.TextView helpers are in rx.android.widget.RxTextView.
Observable factory method names is the plural of the verb (e.g., click --> clicks()). These
are meant to be lightweight, zero/single-allocation for quick event observation. Each also has
a overload named in the singular and suffixed with "Events". This overload emits wrapper objects
containing additional information about the event (origin view, timestamp). The name of the
wrapper object is the concatenation of the view simple name, verb, and "Event". The
OnSubscribe classes for these are not in the public API.
Action factory method names are the property prefixed with "set" (e.g., setEnabled). If the
associated listener has a return value, an overload that accepts a Func1<E, T> named "handled"
will be present for determining that value. No error handling will be done. (TODO just name
these with the property? i.e., enabled)
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.