Meepo

项目地址:nekocode/Meepo
简介:模仿 Retrofit 来实现页面跳转路由
更多:作者   提 Bug   
标签:
Router-Retrofit-

Apache 2.0 License Release

Meepo is a router generator for android, similar to retrofit. You can use it to create routers for Activities, Fragments and even any things.

Install

repositories {
    maven { url "https://jitpack.io" }
}
dependencies {
    compile 'com.github.nekocode:Meepo:{lastest-version}'
}

Usage

Declare the router interface first and then Meepo turns your navigation methods into a Java interface.

public interface Router {
    @TargetPath("user/{user_id}/detail")
    boolean gotoUserDetail(Context context, @Path("user_id") String userId, 
                           @Query("show_title") boolean showTitle);

    @TargetClass(StoreActivity.class)
    @TargetFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP)
    void gotoB(Context context, @Bundle("title") String title);
}

If you want to use URI to open your Activity, you need to add an <intent-filter> element in your manifest file to the corresponding <activity> element.

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

Use the Meepo class to build an implementation for 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 use the router's methods to navigate activity instead of startActivity() directly.

boolean isSucess = router.gotoUserDetail(this, "123", true);

Router Annotation

Meepo supports below router annotations currently:

Annotation Description
@TargetClass Declare the target Class (Such as target Activity or Fragment)
@TargetPath Declare the path of URI path (and MimeType)
@TargetAction Declare the Intent action
@TargetFlags Declare the Intent flags
@Bundle Put data into the Intent's Bundle
@Path Replace the URI path's corresponding replacement block with string parameter
@Query Query parameter of the URI
@QueryMap Map of Query parameters
@RequestCode Request code for startActivityForResult()

Custom Parser and GotoAdapter

You can create custom Parser and GotoAdapter for Meepo. See the sample for more details. It means that you have the ability to make router for anything.

final ModuleRouter moduleRouter = new Meepo.Builder()
        .config(new ModuleConfig("TEST"))
        .parser(new ModuleParser())
        .adapter(new GotoModuleAdapter())
        .build()
        .create(ModuleRouter.class);
Android 开发经验分享
Android 开发经验分享