手把手帶你擼一個(gè)路由(2)--帶參跳轉(zhuǎn)

繼上一篇手把手帶你擼一個(gè)路由(1)--界面跳轉(zhuǎn)之后,這篇文章來(lái)說(shuō)一說(shuō)如何實(shí)現(xiàn)攜帶參數(shù)的跳轉(zhuǎn)

寫(xiě)在前頭,本系列文章為了更簡(jiǎn)單的講述一些路由的知識(shí),demo中的代碼寫(xiě)的十分簡(jiǎn)單和直接.所以會(huì)存在不少判斷不合理的地方.對(duì)demo有合理建議的人可以再評(píng)論處指出。

帶參跳轉(zhuǎn)

正常情況下Activity之間的跳轉(zhuǎn)如下

Intent intent = new Intent(this, TestActivity1.class);
intent.putExtra("name", "張三");
startActivity(intent);

//intent內(nèi)部維護(hù)著一個(gè)Bundle對(duì)象,而B(niǎo)undle實(shí)現(xiàn)了Parcelable接口,相對(duì)而言算是比較高效率的參數(shù)傳遞方式。

既然Android原生已經(jīng)有了高效的參數(shù)傳遞方式,那自然是要利用起來(lái)迈嘹。增加一個(gè) IntentWrapper.class用來(lái)表示對(duì)intent參數(shù)的封裝

public class IntentWrapper {

    private Bundle mBundle;
    private String originalUrl;
    private RouteDemo routeDemo;

    private volatile static IntentWrapper instance = null;

    public static IntentWrapper getInstance() {
        if (instance == null) {
            synchronized (IntentWrapper.class) {
                if (instance == null) {
                    instance = new IntentWrapper();
                }
            }
        }
        return instance;
    }

    public IntentWrapper build(RouteDemo routeDemo, String url) {
        this.routeDemo = routeDemo;
        this.originalUrl = url;
        mBundle = new Bundle();
        return this;
    }

    public IntentWrapper withString(String key, String value) {
        mBundle.putString(key, value);
        return this;
    }

    public IntentWrapper withInt(String key, int value) {
        mBundle.putInt(key, value);
        return this;
    }

    public void open() {
        routeDemo.open(originalUrl, mBundle);
    }

}

聲明一個(gè)Bundle對(duì)象,同時(shí)對(duì)外提供兩個(gè)簡(jiǎn)單的方法withString和withInt表锻。

接下來(lái)需要對(duì)RouteDemo進(jìn)行改造

在上一篇文章中,由于路由跳轉(zhuǎn)是沒(méi)有攜帶參數(shù)的,所以是以

RouteDemo.open("test");

這樣的簡(jiǎn)單形式蛀醉。

改造之后的調(diào)用方式

RouteDemo.getInstance().build("route://test")
    .withString("name", "張三")
    .withInt("age", 15)
    .open();

通過(guò)build函數(shù)獲取前文所提到的IntentWrapper對(duì)象,借由這個(gè)對(duì)象來(lái)傳遞參數(shù)饲齐。最后通過(guò)open()函數(shù)回調(diào)RouteDemo中的跳轉(zhuǎn)邏輯.

完整的RouteDemo.class

public class RouteDemo {

    private static HashMap<String, Class> activityMap = new HashMap<>();
    private static Application mApplication;

    private volatile static RouteDemo instance = null;

    public static RouteDemo getInstance() {
        if (instance == null) {
            synchronized (RouteDemo.class) {
                if (instance == null) {
                    instance = new RouteDemo();
                }
            }
        }
        return instance;
    }

    public void init(Application application) {
        mApplication = application;
        try {
            //通過(guò)反射調(diào)用AutoCreateModuleActivityMap_app類的方法,并給activityMap賦值
            Class clazz = Class.forName("com.dly.routeDemo.AutoCreateModuleActivityMap_app");
            Method method = clazz.getMethod("initActivityMap", HashMap.class);
            method.invoke(null, activityMap);
            for (String key : activityMap.keySet()) {
                System.out.println("activityMap = " + activityMap.get(key));
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public IntentWrapper build(String url) {
        return IntentWrapper.getInstance().build(this,url);
    }
    
    public void open(String url, Bundle bundle) {
        for (String key : activityMap.keySet()) {
            if(url.equals(key)){
                Intent intent = new Intent(mApplication, activityMap.get(key));
                intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                intent.putExtras(bundle);
                mApplication.startActivity(intent);
            }
        }
    }

    public void open(String url) {
        for (String key : activityMap.keySet()) {
            if (url.equals(key)) {
                Intent intent = new Intent(mApplication, activityMap.get(key));
                intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                mApplication.startActivity(intent);
            }
        }
    }
  
}

如果只是像上述那樣顯示跳轉(zhuǎn),那路由毫無(wú)意義字支。通常我們更多的需求會(huì)是服務(wù)器返回一個(gè)url,客戶端根據(jù)這個(gè)url進(jìn)行匹配跳轉(zhuǎn)雷厂。

比如首頁(yè)的一個(gè)banner頁(yè),昨天要求跳轉(zhuǎn)到testActivity1這個(gè)界面,今天又突然改需求,要求跳轉(zhuǎn)到testActivity2這個(gè)界面惋增。這個(gè)時(shí)候路由的動(dòng)態(tài)配置就派上用場(chǎng)了。

比較常見(jiàn)的調(diào)用方法如下

RouteDemo.getInstance().open("route://test?name=555");

再講述URL跳轉(zhuǎn)之前,必須得先說(shuō)明一下Android下的URL和URI,以及他們之間的關(guān)系和格式,為之后URI解析做下鋪墊改鲫。

URL,URN,URI的關(guān)系 (對(duì)URI比較熟悉的可以跳過(guò)這一段)###

URI在于I(Identifier)是統(tǒng)一資源標(biāo)識(shí)符,可以唯一標(biāo)識(shí)一個(gè)資源诈皿。
URL在于L(Location)是統(tǒng)一資源定位符,可以提供找到該資源的路徑林束。
URN在于N( name)統(tǒng)一資源名稱,通過(guò)名字標(biāo)識(shí)資源。

一般來(lái)說(shuō)URL和URN都是URI的子集,它們兩者共同組成了URI稽亏。

比如https://www.zhihu.com/question/21950864,這一串地址可以唯一標(biāo)識(shí)一個(gè)資源,所以是一個(gè)URI,同時(shí)也可以通過(guò)這個(gè)地址找到資源,所以也是一個(gè)URL壶冒。

還有一種情況,urn:isbn:0-486-27557-4這是一本書(shū)的isbn,可以唯一標(biāo)識(shí)一本書(shū),但我們無(wú)法通過(guò)這一串isbn找到書(shū)籍,所以這里是URI,不是URL,準(zhǔn)確說(shuō)這一串isbn是一個(gè)URN。

URI的結(jié)構(gòu)

URI的幾種劃分形式

基本劃分

[scheme:]scheme-specific-part[#fragment]

進(jìn)一步劃分

[scheme:][//authority][path][?query][#fragment]

再進(jìn)一步劃分

[scheme:][//host:port][path][?query][#fragment]

其中有一些簡(jiǎn)單的規(guī)則

path可以有多個(gè)截歉，每個(gè)用/連接胖腾，比如
scheme://authority/path1/path2/path3?query#fragment
query參數(shù)可以帶有對(duì)應(yīng)的值，也可以不帶瘪松，如果帶對(duì)應(yīng)的值用=表示咸作，如:
scheme://authority/path1/path2/path3?id = 1#fragment，這里有一個(gè)參數(shù)id宵睦，它的值是1
query參數(shù)可以有多個(gè)记罚，每個(gè)用&連接
scheme://authority/path1/path2/path3?id = 1&name = mingming&old#fragment
這里有三個(gè)參數(shù)：
參數(shù)1：id，其值是:1
參數(shù)2：name壳嚎，其值是:mingming
參數(shù)3：old桐智，沒(méi)有對(duì)它賦值，所以它的值是null
在android中烟馅，除了scheme说庭、authority是必須要有的，其它的幾個(gè)path郑趁、query刊驴、fragment，它們每一個(gè)可以選擇性的要或不要穿撮，但順序不能變缺脉，比如：
其中"path"可不要：scheme://authority?query#fragment
其中"path"和"query"可都不要：scheme://authority#fragment
其中"query"和"fragment"可都不要：scheme://authority/path
"path","query","fragment"都不要：scheme://authority

其中有一些簡(jiǎn)單的規(guī)則

path可以有多個(gè)，每個(gè)用/連接悦穿，比如
scheme://authority/path1/path2/path3?query#fragment
query參數(shù)可以帶有對(duì)應(yīng)的值攻礼，也可以不帶，如果帶對(duì)應(yīng)的值用=表示栗柒，如:
scheme://authority/path1/path2/path3?id = 1#fragment礁扮，這里有一個(gè)參數(shù)id技肩，它的值是1
query參數(shù)可以有多個(gè)灾螃，每個(gè)用&連接
scheme://authority/path1/path2/path3?id=1&name =張三&old#fragment
這里有三個(gè)參數(shù)：
參數(shù)1：id胧卤，其值是:1
參數(shù)2：name逝嚎，其值是:張三
參數(shù)3：old，沒(méi)有對(duì)它賦值渠概，所以它的值是null
在android中逼侦，除了scheme谚攒、authority是必須要有的曙痘，其它的幾個(gè)path芳悲、query立肘、fragment，它們每一個(gè)可以選擇性的要或不要名扛，但順序不能變谅年，比如：
其中"path"可不要：scheme://authority?query#fragment
其中"path"和"query"可都不要：scheme://authority#fragment
其中"query"和"fragment"可都不要：scheme://authority/path
"path","query","fragment"都不要：scheme://authority

做一個(gè)簡(jiǎn)單的例子匹配

http://www.java2s.com:8080/yourpath/fileName.htm?name=張三&id=4#niknowzcd

scheme:http
host:www.java2s.com
port:8080
path:/yourpath/fileName.htm
query:name=張三&id=4
fragment:niknowzcd

常用的api

同樣的例子

http://www.java2s.com:8080/yourpath/fileName.htm?name=張三&id=4#niknowzcd

getScheme() :獲取Uri中的scheme字符串部分，在這里即http
getSchemeSpecificPart():獲取Uri中的scheme-specific-part:部分肮韧，這里是：//www.java2s.com:8080/yourpath/fileName.htm?
getFragment():獲取Uri中的Fragment部分融蹂，niknowzcd
getAuthority():獲取Uri中Authority部分，即www.java2s.com:8080
getPath():獲取Uri中path部分弄企，即/yourpath/fileName.htm
getQuery():獲取Uri中的query部分超燃，即name=張三&id=4
getHost():獲取Authority中的Host字符串，即www.java2s.com
getPost():獲取Authority中的Port字符串拘领，即8080

另外還有兩個(gè)常用的屬性:getPathSegments()淋纲，getQueryParameter(String key)

List<String> getPathSegments() 會(huì)將整個(gè)path路徑保存下來(lái),并以/符號(hào)作為分隔符

String mUriStr = "http://www.java2s.com:8080/yourpath/fileName.htm?stove=10&path=32&id=4#harvic";  
Uri mUri = Uri.parse(mUriStr);  
List<String> pathSegList = mUri.getPathSegments();  
for (String pathItem:pathSegList){  
    Log.d("debug",pathItem);  
}  

//輸出
yourpath    
fileName.htm

getQueryParameter(String key): 則是根據(jù)key來(lái)獲取對(duì)應(yīng)的Query值

String mUriStr = "http://www.java2s.com:8080/yourpath/fileName.htm?name=張三&id=4#niknowzcd";  
mUri = Uri.parse(mUriStr);  
Log.d(debug,"getQueryParameter(\"name\"):"+mUri.getQueryParameter("name"));  
Log.d(debug,"getQueryParameter(\"id\"):"+mUri.getQueryParameter("id"));  

//輸出
getQueryParameter("name"):張三
getQueryParameter("id"):

在path中，即使針對(duì)某一個(gè)KEY不對(duì)它賦值是允許的院究，但在利用getQueryParameter()獲取該KEY對(duì)應(yīng)的值時(shí)，獲取到的是null;

匹配URI跳轉(zhuǎn)

我們回過(guò)頭看看之前寫(xiě)的路徑的匹配方式

public void open(String url) {
        for (String key : activityMap.keySet()) {
            if(url.equals(key)){
                Intent intent = new Intent(mApplication, activityMap.get(key));
                intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                mApplication.startActivity(intent);
            }
        }
    }

采用的是字符串Url全匹配的形式, 這種方式局限性很大,就拿

route://test?name=555

上述這個(gè)字符串來(lái)說(shuō),我希望的是跳轉(zhuǎn)的test對(duì)照的Activity中,并且攜帶參數(shù)name=555.

如果用全URL匹配的話,我們可能需要做的是在目標(biāo)Activity上加上類似的標(biāo)注

@Route("route://test?name=555")

這樣跳轉(zhuǎn)是能跳轉(zhuǎn)了,不過(guò)如何攜帶參數(shù)又成了問(wèn)題本涕。

這時(shí)再回去看看URI的結(jié)構(gòu)劃分,取其中一種適用性比較廣泛的如下

[scheme:][//host:port][path][?query][#fragment]

其中

[scheme:][//host:port][path]

這部分就足夠表示一個(gè)唯一的界面資源了业汰，后面的參數(shù)只是區(qū)分當(dāng)前界面所需要顯示的數(shù)據(jù)是那些而已。

就比如一個(gè)UserInfoActivity不管你傳入的userId是什么,你所在的view都是UserInfoActivity菩颖。

所以在匹配一個(gè)外部的URL的時(shí)候,需要匹配的是URL路徑部分,即

[scheme:][//host:port][path]

這一部分

順著個(gè)思路,來(lái)改寫(xiě)RouteDemo中的代碼样漆。

增加一個(gè)checkUrlPath函數(shù)

 //Uri的標(biāo)準(zhǔn)格式 scheme、authority 二者是必須的
private static boolean checkUrlPath(String targetUrl, String matchUrl) {
    Uri targetUri = Uri.parse(targetUrl);
    Uri matchUri = Uri.parse(matchUrl);

    Assert.assertNotNull(targetUri.getScheme());
    Assert.assertNotNull(targetUri.getHost());

    if (targetUri.getScheme().equals(matchUri.getScheme()) && targetUri.getHost().equals(matchUri.getHost())) {
        return TextUtils.equals(targetUri.getPath(), matchUri.getPath());
    } else {
        return false;
    }
}

這里還是采用了一個(gè)簡(jiǎn)單粗暴的方式,當(dāng)scheme,host,path三者都相等的時(shí)候,我們認(rèn)為匹配上了,這里沒(méi)提到port是因?yàn)槁酚芍型ǔＪ褂貌坏?code>port這個(gè)屬性,如果需要的話,可以getAuthority()去獲取晦闰。

匹配到了path之后,還需要一個(gè)步驟,就是把我們需要的參數(shù)傳遞過(guò)去放祟。使用
是getQueryParameterNames()和getQueryParameter(queryParameterName)

具體實(shí)現(xiàn)如下

private Intent parseParams(Intent intent, String targetUrl) {
    Uri uri = Uri.parse(targetUrl);
    Set<String> queryParameterNames = uri.getQueryParameterNames();
    for (String queryParameterName : queryParameterNames) {
        intent.putExtra(queryParameterName, uri.getQueryParameter(queryParameterName));
    }
    return intent;
}

最后再貼一下改造后的RouteDemo的函數(shù)

public class RouteDemo {

    private static HashMap<String, Class> activityMap = new HashMap<>();
    private static Application mApplication;

    private volatile static RouteDemo instance = null;

    public static RouteDemo getInstance() {
        if (instance == null) {
            synchronized (RouteDemo.class) {
                if (instance == null) {
                    instance = new RouteDemo();
                }
            }
        }
        return instance;
    }

    public void init(Application application) {
        mApplication = application;
        try {
            //通過(guò)反射調(diào)用AutoCreateModuleActivityMap_app類的方法,并給activityMap賦值
            Class clazz = Class.forName("com.dly.routeDemo.AutoCreateModuleActivityMap_app");
            Method method = clazz.getMethod("initActivityMap", HashMap.class);
            method.invoke(null, activityMap);
            for (String key : activityMap.keySet()) {
                System.out.println("activityMap = " + activityMap.get(key));
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public IntentWrapper build(String url) {
        return IntentWrapper.getInstance().build(this,url);
    }

    public void open(String url, Bundle bundle) {
        for (String key : activityMap.keySet()) {
            if (checkUrlPath(url, key)) {
                Intent intent = new Intent(mApplication, activityMap.get(key));
                intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                intent.putExtras(bundle);
                mApplication.startActivity(intent);
            }
        }
    }


    public void open(String url) {
        for (String key : activityMap.keySet()) {
            if (checkUrlPath(url, key)) {
                Intent intent = new Intent(mApplication, activityMap.get(key));
                intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                intent = parseParams(intent, url);
                mApplication.startActivity(intent);
            }
        }
    }

    private Intent parseParams(Intent intent, String targetUrl) {
        Uri uri = Uri.parse(targetUrl);
        Set<String> queryParameterNames = uri.getQueryParameterNames();
        for (String queryParameterName : queryParameterNames) {
            intent.putExtra(queryParameterName, uri.getQueryParameter(queryParameterName));
        }
        return intent;
    }


    //Uri的標(biāo)準(zhǔn)格式 scheme、authority 二者是必須的
    private static boolean checkUrlPath(String targetUrl, String matchUrl) {
        Uri targetUri = Uri.parse(targetUrl);
        Uri matchUri = Uri.parse(matchUrl);

        Assert.assertNotNull(targetUri.getScheme());
        Assert.assertNotNull(targetUri.getHost());

        if (targetUri.getScheme().equals(matchUri.getScheme()) && targetUri.getHost().equals(matchUri.getHost())) {
            return TextUtils.equals(targetUri.getPath(), matchUri.getPath());
        } else {
            return false;
        }
    }

}

github 地址

RouteDemo

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者

人面猴
序言：七十年代末呻右，一起剝皮案震驚了整個(gè)濱河市跪妥，隨后出現(xiàn)的幾起案子，更是在濱河造成了極大的恐慌声滥，老刑警劉巖眉撵，帶你破解...
沈念sama閱讀 216,470評(píng)論 6贊 501
死咒
序言：濱河連續(xù)發(fā)生了三起死亡事件，死亡現(xiàn)場(chǎng)離奇詭異落塑，居然都是意外死亡纽疟，警方通過(guò)查閱死者的電腦和手機(jī)，發(fā)現(xiàn)死者居然都...
沈念sama閱讀 92,393評(píng)論 3贊 392
救了他兩次的神仙讓他今天三更去死
文/潘曉璐我一進(jìn)店門(mén)憾赁，熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)污朽，“玉大人，你說(shuō)我怎么就攤上這事龙考◇∷粒” “怎么了矾睦？”我有些...
開(kāi)封第一講書(shū)人閱讀 162,577評(píng)論 0贊 353
道士緝兇錄：失蹤的賣姜人
文/不壞的土叔我叫張陵，是天一觀的道長(zhǎng)颓芭。經(jīng)常有香客問(wèn)我顷锰，道長(zhǎng)，這世上最難降的妖魔是什么亡问？我笑而不...
開(kāi)封第一講書(shū)人閱讀 58,176評(píng)論 1贊 292
?港島之戀（遺憾婚禮）
正文為了忘掉前任官紫，我火速辦了婚禮，結(jié)果婚禮上州藕，老公的妹妹穿的比我還像新娘束世。我一直安慰自己，他們只是感情好床玻，可當(dāng)我...
茶點(diǎn)故事閱讀 67,189評(píng)論 6贊 388
惡毒庶女頂嫁案：這布局不是一般人想出來(lái)的
文/花漫我一把揭開(kāi)白布毁涉。她就那樣靜靜地躺著，像睡著了一般锈死。火紅的嫁衣襯著肌膚如雪贫堰。梳的紋絲不亂的頭發(fā)上，一...
開(kāi)封第一講書(shū)人閱讀 51,155評(píng)論 1贊 299
城市分裂傳說(shuō)
那天待牵，我揣著相機(jī)與錄音其屏，去河邊找鬼。笑死缨该，一個(gè)胖子當(dāng)著我的面吹牛偎行，可吹牛的內(nèi)容都是我干的。我是一名探鬼主播贰拿，決...
沈念sama閱讀 40,041評(píng)論 3贊 418
雙鴛鴦連環(huán)套：你想象不到人心有多黑
文/蒼蘭香墨我猛地睜開(kāi)眼蛤袒，長(zhǎng)吁一口氣：“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼！你這毒婦竟也來(lái)了膨更？” 一聲冷哼從身側(cè)響起妙真，我...
開(kāi)封第一講書(shū)人閱讀 38,903評(píng)論 0贊 274
萬(wàn)榮殺人案實(shí)錄
序言：老撾萬(wàn)榮一對(duì)情侶失蹤，失蹤者是張志新（化名）和其女友劉穎荚守，沒(méi)想到半個(gè)月后隐孽，有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體，經(jīng)...
沈念sama閱讀 45,319評(píng)論 1贊 310
?護(hù)林員之死
正文獨(dú)居荒郊野嶺守林人離奇死亡健蕊，尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛以下內(nèi)容為張勛視角年9月15日...
茶點(diǎn)故事閱讀 37,539評(píng)論 2贊 332
?白月光啟示錄
正文我和宋清朗相戀三年菱阵，在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片缩功。...
茶點(diǎn)故事閱讀 39,703評(píng)論 1贊 348
活死人
序言：一個(gè)原本活蹦亂跳的男人離奇死亡晴及，死狀恐怖，靈堂內(nèi)的尸體忽然破棺而出嫡锌，到底是詐尸還是另有隱情虑稼，我是刑警寧澤琳钉，帶...
沈念sama閱讀 35,417評(píng)論 5贊 343
?日本核電站爆炸內(nèi)幕
正文年R本政府宣布，位于F島的核電站蛛倦，受9級(jí)特大地震影響歌懒，放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜溯壶，卻給世界環(huán)境...
茶點(diǎn)故事閱讀 41,013評(píng)論 3贊 325
男人毒藥：我在死后第九天來(lái)索命
文/蒙蒙一及皂、第九天我趴在偏房一處隱蔽的房頂上張望。院中可真熱鬧且改，春花似錦验烧、人聲如沸。這莊子的主人今日做“春日...
開(kāi)封第一講書(shū)人閱讀 31,664評(píng)論 0贊 22
一樁弒父案碍拆，背后竟有這般陰謀
文/蒼蘭香墨我抬頭看了看天上的太陽(yáng)。三九已至慨蓝，卻和暖如春感混，著一層夾襖步出監(jiān)牢的瞬間，已是汗流浹背礼烈。一陣腳步聲響...
開(kāi)封第一講書(shū)人閱讀 32,818評(píng)論 1贊 269
情欲美人皮
我被黑心中介騙來(lái)泰國(guó)打工浩习，沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留，地道東北人济丘。一個(gè)月前我還...
沈念sama閱讀 47,711評(píng)論 2贊 368
代替公主和親
正文我出身青樓，卻偏偏與公主長(zhǎng)得像洽蛀，于是被迫代替她去往敵國(guó)和親摹迷。傳聞我的和親對(duì)象是個(gè)殘疾皇子，可洞房花燭夜當(dāng)晚...
茶點(diǎn)故事閱讀 44,601評(píng)論 2贊 353