stephanenicolas/robospice

Overview

We froze RS last week, the library is not maintained anymore. Personnally, I now always use a mix of retrofit and Rx instead, RS has sailed a long way home and yes, the latest constraints in android O don't make it easy for RS at all, it's probably the last nail in its coffin. @stephanenicolas

Thx to all RS users for your warm support, it's been a pleasure to ofer this library to the community. Thx to @rciovati too for his important contributions to RS !

RoboSpice is a modular android library that makes writing asynchronous network requests easy !

To learn more about RoboSpice in 30 seconds, try [this infographics] (https://raw.github.com/stephanenicolas/robospice/master/gfx/RoboSpice-InfoGraphics.png).

If you want to start using RoboSpice right now, jump to the Wiki or the samples.

The Wiki has a fully detailed section to quickly setup you up whether you use Gradle, Maven or ant/eclipse.

Main features of RoboSpice

supports Android starting from SDK version 8 (Froyo / 2.2.x)
executes network requests asynchronously (in a background AndroidService)
supports REST out of the box (using Spring Android or Google Http Client or Retrofit).
is strongly typed ! You query webservices using POJOs as parameters and you get POJOs as request results.
enforces no constraints neither on POJOs used for requests nor on Activity classes you use in your projects
caches results in Json with both Jackson or Jackson2 or Gson, or Xml, or flat text files, or binary files, even using ORM Lite (still in beta)
notifies your activities (or any other context) of the result of the network request with respect to their lifecycles.
notifies your activities (or any other context) on the UI Thread
no memory leaks at all, like Android Loaders, unlike Android AsyncTasks
uses a simple but robust exception handling model
supports multi-threading of request executions
is stable, efficient and designed to respect Android philosophy
supports request cancelling, request priorization and requests aggregation
supports aggregation of different web services
is a full featured replacement for long running AsyncTasks even if they are not related to networking.
is open source ;)
and tested (more than 200 tests)

RoboSpice is under Quality control on Sonar's Nemo instance. Thanks to Sonar Source.

To learn more about RoboSpice

To learn more, look at the presentation slides we created for DroidCon UK 2012, they are available in the download section.

A few links :

Browse RoboSpice's full documentation on the Wiki.
Javadocs.
Maven site.
Discussion group on google.
Stack Over Flow questions about RoboSpice

Example code & demo

The RoboSpice team proposes a lot of sample applications in their own GitHub repo.

We also propose a few demo :

RoboSpice Motivations : a pedagogical app that explains the motivations behind RoboSpice.
and a demo that illustrates non-network related requests (offline).

A project initiated by Octo Technology

RoboSpice has been incubated at Octo Technology, a french company based in Paris, focused on software design and quality. It offers its employees to work part time on Research & Development projects. RoboSpice was one of them.

RoboSpice is the news

RoboSpice has been featured in

Android dev weekly mailing list, issue 31.
Android weekly mailing list, issue 44.
An article of Geeek.org

RoboSpice has been presented at :

DroidCon London, October 2013
DroidCon Paris, June 2013
Nantes GDG Dev Fest, France, November 2012
Paris Android User Group, November 2012
DroidCon Amsterdam, November 2012
DroidCon London, October 2012

RoboSpice video at DroidConLondon

Robospice presentation by David Stemmer

License

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.

Alternatives to RoboSpice

Projects related to RoboSpice

Blandware Android AtLeap Core is a library accelerating development. It contains universal Content Provider (for SQLite, ORMLite), Drawer, Account Authenticator, etc. AtLeap Sample is a good example of RoboSpice, Retrofit, ORMLite, Picasso integration.
SpiceAnnotations : using RoboSpice and Android Annotations by Daniel Dekanski. Also read his blog post.