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);