Meepo
Meepo is a router generator for android, similar to retrofit. You can use it to create routers for Activities, Fragments and even any things.
Integration
Replace the ${last-version}
in below code to number .
repositories {
maven { url "https://jitpack.io" }
}
dependencies {
implementation "com.github.nekocode:Meepo:${last-version}"
}
Usage
Firstly, declare a router interface:
public interface Router {
@Path("user/{user_id}/detail")
@RequestCode(1)
boolean gotoUserDetail(Context context, @PathParam("user_id") String userId,
@QueryParam("show_title") boolean showTitle);
@Clazz(StoreActivity.class)
@Flags(Intent.FLAG_ACTIVITY_SINGLE_TOP)
void gotoB(Context context, @BundleParam("title") String title,
@RequestCodeParam int requestCode);
}
If you want to open your Activity via URI, you need to add a uri intent filter to the corresponding <activity>
element in the manifest file:
<activity android:name=".UserDetailActivity">
<intent-filter>
<action android:name="android.intent.action.VIEW"/>
<category android:name="android.intent.category.DEFAULT"/>
<data
android:host="meepo.com"
android:pathPattern="/user/.*/detail"
android:scheme="meepo"/>
</intent-filter>
</activity>
And then obtain an implementation of your router interface:
final Meepo meepo = new Meepo.Builder()
.config(new UriConfig().scheme("meepo").host("meepo.com"))
.build();
final Router router = meepo.create(Router.class);
Now, you can invoke the router's navigation methods:
boolean isSucess = router.gotoUserDetail(this, "123", true);
Router Annotation
This library currently provides the following annotations:
Method Annotation | Description |
---|---|
@Clazz | Class of target Activity |
@ClazzName | Class name of target Activity |
@Path | URI path and mime type of target Activity |
@Action | Action of Intent |
@Flags | Flags of Intent |
@RequestCode | Request code of Intent |
Parameter Annotation | Description |
---|---|
@BundleParam | Parameter that will be put into the extra of Intent |
@PathParam | Parameter that will be used to replace the URI path's corresponding replacement block |
@QueryParam | Query parameter of the URI |
@QueryMapParam | Map of Query parameters |
@RequestCodeParam | Request code of Intent |
Custom Parser and CallAdapter
You can create custom Parser and CallAdapter. You can reference the sample module. It means that you can create router for anything.
final ModuleRouter moduleRouter = new Meepo.Builder()
.config(new ModuleConfig("TEST"))
.parser(new ModuleParser())
.adapter(new ModuleCallAdapter())
.build()
.create(ModuleRouter.class);