[Rails] Routes

1. 是什么

Routes 的存在是為了匹配請(qǐng)求中的URL和定義的controller#action.
讓我來簡(jiǎn)單地舉個(gè)例子:config/routes.rb是你程序的大門买乃,門后有許多細(xì)小的路徑通向你想要真正到達(dá)的目的地饭弓,每條路徑的入口處都有一個(gè)路牌斋荞,告訴你目的地的名稱盲憎,通過辨別路牌你就可以到達(dá)最終想要的目的地而不用擔(dān)心迷路幼驶。那么分析一下上述例子汇鞭,每一條路徑就是你定義的一個(gè)你定義的route規(guī)則,路口的路牌是請(qǐng)求中HTTP動(dòng)詞 + URL的組合碌冶,道路通向的目的地是某個(gè)控制器的特定行為湿痢。除匹配功能之外,路徑還提供了些附帶功能扑庞,比如自動(dòng)生成_url 和 _path幫助方法譬重,分別用來表示該路徑的絕對(duì)路徑和相對(duì)路徑,而不需要使用硬編碼字符串罐氨。

2. 在哪定義

快速瀏覽routes.rb: 所有路徑的定義在傳給 Rails.application.routes.draw的一個(gè)大大的block中臀规。定義路徑的代碼是簡(jiǎn)單的紅寶石代碼,你需要按照特定的規(guī)則定義路徑栅隐,主要的定義方式有兩種: 普通路徑和資源路徑塔嬉,稍后會(huì)詳細(xì)介紹狠怨。當(dāng)有請(qǐng)求進(jìn)入時(shí),代碼塊中的代碼自頂向下執(zhí)行邑遏,請(qǐng)求會(huì)查看每個(gè)路徑的路牌是否匹配,并被分發(fā)到第一個(gè)匹配的路徑恰矩,如果沒有匹配的路徑记盒,程序會(huì)返回給調(diào)用者一個(gè)HTTP 404.

3. 普通路徑

普通路徑又稱為非資源路徑,雖然大多數(shù)情況下你使用的都是資源型的路徑外傅,但是某些特定的情況纪吮,普通路徑會(huì)更加合理,比如某些無法抽象成資源的時(shí)候萎胰,或是在遺留系統(tǒng)中給老的URL匹配一些新的行為等等碾盟。下面列出了一些常見的例子:
root to: 'pages#main'
get 'users/:id', to: 'users#show'
get 'users/:id', to: 'users#show', defaults: { format: 'json' }
get 'users/:id', to: 'users#show', as: :members # members_path(@user)

4. 資源路徑

資源路徑使用一條語句可以快速定義多條路徑規(guī)則,這些路徑規(guī)則符合特定規(guī)律技竟,所以便于其他程序員閱讀代碼冰肴。在學(xué)習(xí)資源路徑之前先要理解兩個(gè)概念: CRUD, RESTful.
RESTful 把事物抽象成資源,在不同層次統(tǒng)一操作類型榔组。如用戶注冊(cè)操作熙尉,發(fā)送一個(gè)對(duì)用戶資源的創(chuàng)建操作請(qǐng)求 -> 通過路徑匹配到了控制器的創(chuàng)建行為 -> 在數(shù)據(jù)庫(kù)中插一條新的用戶記錄。CRUD 把對(duì)資源的操作抽象為四類 CREATE, READ, UPDATE, DELETE.

4.1 幫助方法

RESTful 路徑會(huì)自動(dòng)生成一堆helper:
photos_url/path 映射到 index, create
new_photo_url/path 映射到 new
edit_photo_url/path 映射到 edit
photo_url/path 映射到 show, update, destroy
Tip: 可以在控制臺(tái)里通過使用 app.xxx_path來查看路徑
Tip: 可以在控制臺(tái)里通過使用 app.url_for(@user)來查看完整路徑
Tip: 若URL中包含subdomain要使用_url來確保路徑是完整的

4.2 單資源

單資源沒有index
單資源生成如下的helper:
new_geocoder_url/path 映射到 new
edit_geocoder_url/path 映射到 edit
geocoder_url/path 映射到 create, show, update, destroy
Tip: 資源名是單數(shù)形式搓扯,但是對(duì)應(yīng)的controller名稱依然是復(fù)數(shù)
Tip: 單資源在使用form_for定義表單時(shí)检痰,要制定url,否則會(huì)錯(cuò)誤
form_for @geocoder, url: geocoder_path do |f|

5. 路徑高級(jí)用法

(1) 一次定義多個(gè)資源:resources :photos, :books, :videos
(2) 嵌套資源:多層嵌套會(huì)污染路徑锨推,降低可讀性铅歼,保持單層嵌套
(3) 嵌套資源最佳實(shí)現(xiàn):淺嵌套,使用shallow只嵌套index, create, new
(4) 在資源中添加額外路徑:member, collection 注意兩者邏輯區(qū)別
(5) 使用controller來指定資源所對(duì)應(yīng)的控制器
例如:map.resources :photos, :controller => "images"
幫助方法時(shí)會(huì)依據(jù)資源的名稱生成换可,而不是controller的名稱
因此椎椰,在這個(gè)例子里,就會(huì)得到photos_path, new_photo_path等等.
(6) 使用namespace來管理你的路徑和控制器
控制器必須包裹在命名空間模塊中沾鳄,并所屬與相應(yīng)的文件目錄下俭识;
路徑包含相同的命名空間來和控制器相匹配
(7) 若想打破路徑命名空間和控制器模塊相匹配的規(guī)則,使用scope
使用module選項(xiàng)可以去除url路徑和幫助方法中的命名空間名稱洞渔,保持簡(jiǎn)潔
使用path選項(xiàng)可以在url中增添虛擬的命名空間名稱套媚,增加路徑的邏輯結(jié)構(gòu)
使用as選項(xiàng)可以在生成的幫助方法中添加前綴名稱
(8) 使用concern來共享某個(gè)路徑,如共享子資源磁椒,命名空間包含路徑等
(9) 使用only 和 except 限制自動(dòng)生成的路徑規(guī)則
(10) 使用constraints 生成自定義限制
constraints: { id: /^\d/ }限制參數(shù)格式
constraints subdomain: 'admin'限制子域名

6. 路徑的查看和測(cè)試

個(gè)人覺得給路徑寫測(cè)試沒什么必要堤瘤,使用以下方式看看一就好啦
網(wǎng)頁版查看路徑信息:http://localhost:3000/rails/info/routes
命令行查看路徑信息:$ rake routes # -g 過濾請(qǐng)求條件, -c 過濾控制器條件
$ rake routes -g new_user
$ rake routes -g POST
$ rake routes -g /admin/users/:id
$ rake routes -c users
$ rake routes -c admin/users

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市浆熔,隨后出現(xiàn)的幾起案子本辐,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 217,657評(píng)論 6 505
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件慎皱,死亡現(xiàn)場(chǎng)離奇詭異老虫,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)茫多,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,889評(píng)論 3 394
  • 文/潘曉璐 我一進(jìn)店門祈匙,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人天揖,你說我怎么就攤上這事夺欲。” “怎么了今膊?”我有些...
    開封第一講書人閱讀 164,057評(píng)論 0 354
  • 文/不壞的土叔 我叫張陵些阅,是天一觀的道長(zhǎng)。 經(jīng)常有香客問我斑唬,道長(zhǎng)市埋,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,509評(píng)論 1 293
  • 正文 為了忘掉前任恕刘,我火速辦了婚禮腰素,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘雪营。我一直安慰自己弓千,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,562評(píng)論 6 392
  • 文/花漫 我一把揭開白布献起。 她就那樣靜靜地躺著洋访,像睡著了一般。 火紅的嫁衣襯著肌膚如雪谴餐。 梳的紋絲不亂的頭發(fā)上姻政,一...
    開封第一講書人閱讀 51,443評(píng)論 1 302
  • 那天,我揣著相機(jī)與錄音岂嗓,去河邊找鬼汁展。 笑死,一個(gè)胖子當(dāng)著我的面吹牛厌殉,可吹牛的內(nèi)容都是我干的食绿。 我是一名探鬼主播,決...
    沈念sama閱讀 40,251評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼公罕,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼器紧!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起楼眷,我...
    開封第一講書人閱讀 39,129評(píng)論 0 276
  • 序言:老撾萬榮一對(duì)情侶失蹤铲汪,失蹤者是張志新(化名)和其女友劉穎熊尉,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體掌腰,經(jīng)...
    沈念sama閱讀 45,561評(píng)論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡狰住,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,779評(píng)論 3 335
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了齿梁。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片催植。...
    茶點(diǎn)故事閱讀 39,902評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖士飒,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情蔗崎,我是刑警寧澤酵幕,帶...
    沈念sama閱讀 35,621評(píng)論 5 345
  • 正文 年R本政府宣布,位于F島的核電站缓苛,受9級(jí)特大地震影響芳撒,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜未桥,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,220評(píng)論 3 328
  • 文/蒙蒙 一笔刹、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧冬耿,春花似錦舌菜、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,838評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至缤骨,卻和暖如春爱咬,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背绊起。 一陣腳步聲響...
    開封第一講書人閱讀 32,971評(píng)論 1 269
  • 我被黑心中介騙來泰國(guó)打工精拟, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人虱歪。 一個(gè)月前我還...
    沈念sama閱讀 48,025評(píng)論 2 370
  • 正文 我出身青樓蜂绎,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親笋鄙。 傳聞我的和親對(duì)象是個(gè)殘疾皇子荡碾,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,843評(píng)論 2 354

推薦閱讀更多精彩內(nèi)容