Skip to content

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

License

Notifications You must be signed in to change notification settings

JoanZapata/android-asyncservice

Repository files navigation

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.

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

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages