/android-asyncservice

AsyncService uses annotations to shorten the code needed to start asynchronous long running tasks and return result

Primary LanguageJavaOtherNOASSERTION

Android Arsenal

Logo

Motivation

AsyncService is born from an article I wrote a few weeks ago, which gave me a lot of feedbacks and interesting comments. AsyncService manages threading and caching transparently in your Android app. It's an alternative to AsyncTasks, Loaders, or more advanced libs like RxJava, Robospice, Groundy,… but AsyncService focuses on keeping your code short and simple!

Sample

Write your asynchronous service...

@AsyncService
public class DemoService {

    public User getUser(String name) {
        // Runs asynchronously.
        return …;
    }

}

... then use it.

… {
    service.getUser("joan");
}

@OnMessage void onUser(User e) {
    // Runs on UI thread.
}

Where to find it

AsyncService is hosted on Maven Central, just add this line to your gradle dependencies:

compile('com.joanzapata.android.asyncservice:android-asyncservice:0.0.5@aar') { transitive = true }

{ transitive = true } is required at the time of the writing because the android-plugin doesn't look for AAR transitive dependencies by default.

Learn more

Proguard

In case you use Proguard, you'll have to add these entries to your configuration file.

-dontwarn com.joanzapata.android.asyncservice.**
-keep @com.joanzapata.android.asyncservice.api.annotation.AsyncService class *
-keep class **Injector
-keepnames class **Injector
-keepnames class * {
    @com.joanzapata.android.asyncservice.api.annotation.InjectService *;
}
-keepnames class * {
    @com.joanzapata.android.asyncservice.api.annotation.OnMessage *;
}
-keep class com.esotericsoftware.kryo.** {*;}

License

Copyright 2014 Joan Zapata

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.

Build Status