Routable
Routable is an in-app native URL router, for Android. Also available for iOS.
Usage
Set up your app's router and URLs:
import com.usepropeller.routable.Router;
public class PropellerApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// Set the global context
Router.sharedRouter().setContext(getApplicationContext());
// Symbol-esque params are passed as intent extras to the activities
Router.sharedRouter().map("users/:id", UserActivity.class);
Router.sharedRouter().map("users/new/:name/:zip", NewUserActivity.class);
}
}In your Activity classes, add support for the URL params:
import com.usepropeller.routable.Router;
public class UserActivity extends Activity {
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
Bundle intentExtras = getIntent().getExtras();
// Note this extra, and how it corresponds to the ":id" above
String userId = intentExtras.get("id");
}
}
public class NewUserActivity extends Activity {
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
Bundle intentExtras = getIntent().getExtras();
// Corresponds to the ":name" above
String name = intentExtras.get("name");
// Corresponds to the ":zip" above
String zip = intentExtras.get("zip");
}
}Anywhere else in your app, open some URLs:
// starts a new UserActivity
Router.sharedRouter().open("users/16");
// starts a new NewUserActivity
Router.sharedRouter().open("users/new/Clay/94303");Installation
Routable is currently an Android library project (so no Maven).
If you're in a hurry, you can just copy-paste the Router.java file.
Or if you're being a little more proactive, you should import the Routable project (this entire git repo) into Eclipse and reference it in your own project.
Features
Routable Functions
You can call arbitrary blocks of code with Routable:
Router.sharedRouter().map("logout", new Router.RouterCallback() {
public void run(Router.RouteContext context) {
User.logout();
}
});
// Somewhere else
Router.sharedRouter().open("logout");Open External URLs
Sometimes you want to open a URL outside of your app, like a YouTube URL or open a web URL in the browser. You can use Routable to do that:
Router.sharedRouter().openExternal("http://www.youtube.com/watch?v=oHg5SJYRHA0")Multiple Routers
If you need to use multiple routers, simply create new instances of Router:
Router adminRouter = new Router();
Router userRouter = new Router();Contact
Clay Allsopp (http://clayallsopp.com)
License
Routable for Android is available under the MIT license. See the LICENSE file for more info.