Source link: https://github.com/stanfy/enroscar-async

Enroscar Async

Makes it easy to put your asynchronous operations behind Android's Loader.

Main abstraction here is Async which represents some asynchronous operation.

How it is used

Read our recipes page. Here is a quick overview.

Describe an asynchronous operation.

class Foo {

@Load Async<String> loadGreeting(final String name) {

  return Tools.async(new Callable<String>() {

 public String call() {

try {
 Thread.sleep(1000);
 
}
 catch (InterruptedException ignored) {
 
}

return "Hello " + name;

 
}

  
}
);

}
 
}

In this example we create a simple Callable and pass it to Tools.async method that constructs an Async implementation running our Callable in Android's AsyncTask.

An annotations processor generates an operator class FooOperator that can be used to start/cancel your operations or subscribe to their execution results. Use it!

// this an object that provides operations Foo foo = new Foo();
  // prepare the operator // FooOperator is a generated class FooOperator operator = FooOperator.build()
  .withinActivity(activity)
  .operations(foo)
  .get();
  // subscribing operator.when().loadGreetingIsFinished()
  .doOnResult(new Action<String>() {

 @Override

 public void act(final String greeting) {

Log.i("Async", "Greeting loaded: " + greeting);

 
}

  
}
);
  // starting operator.loadGreeting();
  // cancelling operator.cancelLoadGreeting();

Note that working with an operator you actually control an Android Loader. Hence, using it within an Activity or Fragment you do not care about their lifecycle. Actions you provide subscribing to operations will be automatically attached to running tasks during Activity recreation.

Download

Gradle

compile 'com.stanfy.enroscar:enroscar-async:{
latestVersionHere
}
' // annotation processor should be added to 'provided' configuration // it will not be included to your apk provided 'com.stanfy.enroscar:enroscar-async-compiler:{
latestVersionHere
}
'

To use it with RxJava you'll also need

compile 'com.stanfy.enroscar:enroscar-async-rx:{
latestVersionHere
}
' compile 'com.netflix.rxjava:rxjava-core:{
latestVersionHere
}
'

License

 Copyright 2011-2015 Stanfy Corp.
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.

Source link: https://github.com/stanfy/enroscar-async

Resources