Vapor文檔學(xué)習(xí)廿七: HTTP - Request

Module: import HTTP

Request類是我們和HTTP模塊打交道最多的部分,喜愛(ài)滿看一些它常用的屬性:

public var method: Method
public var uri: URI
public var parameters: Node
public var headers: [HeaderKey: String]
public var body: Body
public var data: Content

Method

HTTP請(qǐng)求方法包括:GET毅该、POST、PUT、PATCH顿涣、DELETE。

URI

與請(qǐng)求相關(guān)的URI類酝豪,用來(lái)訪問(wèn)發(fā)送請(qǐng)求的uri的屬性涛碑。
比如:http://vapor.codes/example?query=hi#fragments-too

let scheme = request.uri.scheme // http
let host = request.uri.host // vapor.codes

let path = request.uri.path // /example
let query = request.uri.query // query=hi
let fragment = request.uri.fragment // fragments-too

Route Parameters

請(qǐng)求相關(guān)的url 參數(shù)。比如我們注冊(cè)了hello/:name/age/:age的路徑孵淘,那么我們可以獲取如下內(nèi)容:

let name = request.parameters["name"] // String?
let age = request.parameters["age"]?.int // Int?

或者你也可以用extract拋出nil和無(wú)效的變量蒲障。

let name = try request.parameters.extract("name") as String
let age = try request.parameters.extract("age") as Int

extract函數(shù)可以轉(zhuǎn)換任何NodeInitializable類型,包括自定義的類型瘫证。如果要了解更多請(qǐng)參考Node

注意:路由部分也說(shuō)明了類型安全的路由

Headers

請(qǐng)求相關(guān)的頭部信息揉阎。如果你準(zhǔn)備對(duì)外發(fā)送請(qǐng)求,你可以將自己的秘鑰添加到headers中背捌。

let contentType = request.headers["Content-Type"]  

向外部發(fā)送請(qǐng)求時(shí):

let request = Request ...
request.headers["Content-Type"] = "application/json"
request.headers["Authorization"] = ... my auth token

Extending Headers

我們總是盡可能的剔除字符串類型的代碼來(lái)提高程序代碼毙籽。我們可以通過(guò)擴(kuò)展向headers中添加變量。

extension HTTP.KeyAccessible where Key == HeaderKey, Value == String {
    var customKey: String? {
      get {
        return self["Custom-Key"]
      }
      set {
        self["Custom-Key"] = newValue
      }
    }
}

實(shí)現(xiàn)上面的模式之后毡庆,我們的字符串類型的Custom-key包含在了我們的代碼里】由模現(xiàn)在可以如下訪問(wèn):

let customKey = request.headers.customKey

// or

let request = ...
request.headers.customKey = "my custom value"

Body

body是請(qǐng)求相關(guān)的主體,承載這主要數(shù)據(jù)么抗。在body可以查看更多信息毅否。
為了傳到請(qǐng)求中,我們經(jīng)常這樣拉取body字節(jié):

let rawBytes = request.body.bytes

Content

通常乖坠,當(dāng)我們發(fā)送或接收請(qǐng)求時(shí)搀突,我們將其用作傳輸內(nèi)容的方式。 為此熊泵,Vapor提供了一個(gè)方便的data變量仰迁,與請(qǐng)求相關(guān)聯(lián),以一致的方式管理請(qǐng)求內(nèi)容顽分。
比如徐许,我從http://vapor.codes?hello=world接收一個(gè)請(qǐng)求:

let world = request.data["hello"]?.string

如果我們接收以下json數(shù)據(jù),上面的代碼同樣適用:

{
  "hello": "world"
}

這也適用于"multi-part"請(qǐng)求卒蘸,甚至可以通過(guò)Middleware擴(kuò)展新的類型雌隅,如XML或YAML翻默。
如果你喜歡更明確地訪問(wèn)給定的類型,那是完全正確的恰起。 data變量純粹為開(kāi)發(fā)者選擇方便修械。

JSON

可以直接通過(guò)json獲取請(qǐng)求的json數(shù)據(jù):

let json = request.json["hello"]

Query Parameters

query方法獲取查詢數(shù)據(jù):

let query = request.query?["hello"]  // String?
let name = request.query?["name"]?.string // String?
let age = request.query?["age"]?.int // Int?
let rating = request.query?["rating"]?.double // Double?

Key Paths

Key paths 適用于大多數(shù)Vapor類型的key-value嵌套。
如下json示例:

{
  "metadata": "some metadata",
  "artists" : {
    "href": "http://someurl.com",
    "items": [
      {
        "name": "Van Gogh",
      },
      {
        "name": "Mozart"
      }
    ]
  }
}

然后我們可以通過(guò)以下方式獲取值:

MetaData

獲取最外層值:

let type = request.data["metadata"].string // "some metadata"
Items

獲取嵌套值:

let items = request.data["artists", "items"] // [["name": "Van Gogh"], ["name": "Mozart"]]
Mixing Arrays and Objects

獲取第一個(gè)“artists”:

let first = request.data["artists", "items", 0] // ["name": "Van Gogh"]
Array Item

從item獲取key:

let firstName = request.data["artists", "items", 0, "name"] // "Van Gogh"
Array Comprehension

遍歷數(shù)組检盼,只取artists 的name:

let names = request.data["artists", "items", "name"] // ["Van Gogh", "Mozart"]
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末肯污,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子吨枉,更是在濱河造成了極大的恐慌蹦渣,老刑警劉巖,帶你破解...
    沈念sama閱讀 222,807評(píng)論 6 518
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件貌亭,死亡現(xiàn)場(chǎng)離奇詭異柬唯,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī)圃庭,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 95,284評(píng)論 3 399
  • 文/潘曉璐 我一進(jìn)店門锄奢,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人冤议,你說(shuō)我怎么就攤上這事斟薇。” “怎么了恕酸?”我有些...
    開(kāi)封第一講書人閱讀 169,589評(píng)論 0 363
  • 文/不壞的土叔 我叫張陵堪滨,是天一觀的道長(zhǎng)。 經(jīng)常有香客問(wèn)我蕊温,道長(zhǎng)袱箱,這世上最難降的妖魔是什么? 我笑而不...
    開(kāi)封第一講書人閱讀 60,188評(píng)論 1 300
  • 正文 為了忘掉前任义矛,我火速辦了婚禮发笔,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘凉翻。我一直安慰自己了讨,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 69,185評(píng)論 6 398
  • 文/花漫 我一把揭開(kāi)白布制轰。 她就那樣靜靜地躺著前计,像睡著了一般。 火紅的嫁衣襯著肌膚如雪垃杖。 梳的紋絲不亂的頭發(fā)上男杈,一...
    開(kāi)封第一講書人閱讀 52,785評(píng)論 1 314
  • 那天,我揣著相機(jī)與錄音调俘,去河邊找鬼伶棒。 笑死旺垒,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的肤无。 我是一名探鬼主播先蒋,決...
    沈念sama閱讀 41,220評(píng)論 3 423
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼舅锄!你這毒婦竟也來(lái)了鞭达?” 一聲冷哼從身側(cè)響起,我...
    開(kāi)封第一講書人閱讀 40,167評(píng)論 0 277
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤皇忿,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后坦仍,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體鳍烁,經(jīng)...
    沈念sama閱讀 46,698評(píng)論 1 320
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,767評(píng)論 3 343
  • 正文 我和宋清朗相戀三年繁扎,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了幔荒。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,912評(píng)論 1 353
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡梳玫,死狀恐怖爹梁,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情提澎,我是刑警寧澤姚垃,帶...
    沈念sama閱讀 36,572評(píng)論 5 351
  • 正文 年R本政府宣布,位于F島的核電站盼忌,受9級(jí)特大地震影響积糯,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜谦纱,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 42,254評(píng)論 3 336
  • 文/蒙蒙 一看成、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧跨嘉,春花似錦川慌、人聲如沸。這莊子的主人今日做“春日...
    開(kāi)封第一講書人閱讀 32,746評(píng)論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至跳纳,卻和暖如春忍饰,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背寺庄。 一陣腳步聲響...
    開(kāi)封第一講書人閱讀 33,859評(píng)論 1 274
  • 我被黑心中介騙來(lái)泰國(guó)打工艾蓝, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留力崇,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 49,359評(píng)論 3 379
  • 正文 我出身青樓赢织,卻偏偏與公主長(zhǎng)得像亮靴,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子于置,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,922評(píng)論 2 361

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