本文解釋了如何創(chuàng)建秕岛、發(fā)送和接收HTTP請(qǐng)求和響應(yīng)醋旦。
創(chuàng)建一個(gè)CFHTTP請(qǐng)求
HTTP請(qǐng)求是一個(gè)消息，這個(gè)消息由遠(yuǎn)程服務(wù)器執(zhí)行的方法咒劲，操作的對(duì)象（URL）顷蟆，消息頭和消息體。方法通常是下面之一：GET, HEAD, PUT, POST, DELETE, TRACE, CONNECT 或OPTIONS腐魂。用CFHTTP創(chuàng)建一個(gè)HTTP請(qǐng)求分為四個(gè)步驟：
- 使用
CFHTTPMessageCreateRequest函數(shù)生成CFHTTP消息對(duì)象 - 使用
CFHTTPMessageSetBody函數(shù)設(shè)置消息體 - 使用
CFHTTPMessageSetHeaderFieldValue函數(shù)設(shè)置消息頭 - 通過調(diào)用
CFHTTPMessageCopySerializedMessage函數(shù)序列化消息
示例代碼類似列表3-1中的代碼帐偎。
列表3-1 創(chuàng)建一個(gè)HTTP請(qǐng)求
<pre><code>
CFStringRef bodyString = CFSTR(""); // Usually used for POST data
CFDataRef bodyData =
CFStringCreateExternalRepresentation
(kCFAllocatorDefault,bodyString,kCFStringEncodingUTF8, 0);
CFStringRef headerFieldName = CFSTR("X-My-Favorite-Field");
CFStringRef headerFieldValue = CFSTR("Dreams");
CFStringRef url = CFSTR("http://www.apple.com");
CFURLRef myURL = CFURLCreateWithString(kCFAllocatorDefault, url, NULL);
CFStringRef requestMethod = CFSTR("GET");
CFHTTPMessageRef myRequest =
CFHTTPMessageCreateRequest(kCFAllocatorDefault, requestMethod, myURL,
kCFHTTPVersion1_1);
CFDataRef bodyDataExt =
CFStringCreateExternalRepresentation(kCFAllocatorDefault,
bodyData, kCFStringEncodingUTF8, 0);
CFHTTPMessageSetBody(myRequest, bodyDataExt);
CFHTTPMessageSetHeaderFieldValue(myRequest,
headerFieldName, headerFieldValue);
CFDataRef mySerializedRequest =
CFHTTPMessageCopySerializedMessage(myRequest);
</pre></code>
在此示例代碼中，通過調(diào)用CFURLCreateWithString蛔屹，url 是首先轉(zhuǎn)換成一個(gè)CFURL對(duì)象削樊。然后調(diào)用CFHTTPMessageCreateRequest ，有四個(gè)參數(shù)：kCFAllocatorDefault 指定默認(rèn)系統(tǒng)內(nèi)存分配器用來(lái)創(chuàng)建消息應(yīng)用兔毒，requestMethod 指定方法嫉父，例如POST方法沛硅，myURL 用來(lái)指定URL，例如绕辖，http://www.apple.com摇肌，kCFHTTPVersion1_1指定消息HTTP版本是1.1.
CFHTTPMessageCreateRequest 返回的消息對(duì)象引用(myRequest)和消息體(bodyData)一起發(fā)送到CFHTTPMessageSetBody 。然后調(diào)用CFHTTPMessageSetHeaderFieldValue 使用相同消息對(duì)象引用仪际，頭(headerField)名稱和設(shè)置的值(value)围小。頭參數(shù)是個(gè)CFString對(duì)象，例如Content-Length,值參數(shù)是一個(gè)CFString對(duì)象例如1260.最后树碱，調(diào)用CFHTTPMessageCopySerializedMessage 序列化消息肯适，通過寫入流發(fā)送到接受者，例子詳見http://www.apple.com成榜。
注意：請(qǐng)求主體通常省略框舔。請(qǐng)求主體通常用于一個(gè)包含POST數(shù)據(jù)的POST請(qǐng)求。它也可以用于其他有關(guān)HTTP擴(kuò)展的請(qǐng)求類型赎婚，例如WebDAV刘绣。更多信息參見RFC 2616。
當(dāng)不再需要消息挣输，釋放消息對(duì)象并序列化消息纬凤。見列表3-2的示例代碼
列表3-2 釋放一個(gè)HTTP請(qǐng)求
<pre><code>
CFRelease(myRequest);
CFRelease(myURL);
CFRelease(url);
CFRelease(mySerializedRequest);
myRequest = NULL;
mySerializedRequest = NULL;
</pre></code>
創(chuàng)建一個(gè)CFHTTP響應(yīng)
創(chuàng)建一個(gè)HTTP響應(yīng)的步驟與創(chuàng)建一個(gè)HTTP請(qǐng)求的步驟幾乎完全相同。唯一的區(qū)別是撩嚼，調(diào)用函數(shù)CFHTTPMessageCreateResponse 停士，而不是CFHTTPMessageCreateRequest，兩者使用相同的參數(shù)
反序列化傳入的HTTP請(qǐng)求
反序列化一個(gè)傳入的HTTP請(qǐng)求完丽，使用CFHTTPMessageCreateEmpty 函數(shù)恋技，創(chuàng)建一個(gè)空消息，isRequest 參數(shù)設(shè)為TRUE 指定創(chuàng)建一個(gè)空的請(qǐng)求消息逻族。然后調(diào)用CFHTTPMessageAppendBytes函數(shù)將傳入的消息添加到空消息中蜻底。CFHTTPMessageAppendBytes反序列化消息并移除任何可能包含的控制信息。
繼續(xù)這樣做直到CFHTTPMessageIsHeaderComplete 函數(shù)返回TRUE瓷耙。如果你不檢查CFHTTPMessageIsHeaderComplete 是否返回TRUE朱躺，消息可能是不完整的或不可信的。列表3-3可以看到這兩個(gè)函數(shù)使用的例子搁痛。
列表3-3 反序列化消息
<pre><code>
CFHTTPMessageRef myMessage =
CFHTTPMessageCreateEmpty(kCFAllocatorDefault, TRUE);
if (!CFHTTPMessageAppendBytes(myMessage, &data, numBytes)) {
//Handle parsing error
}
</pre></code>
在示例中长搀，data 是添加的數(shù)據(jù)而numBytes 是的data 長(zhǎng)度。調(diào)用CFHTTPMessageIsHeaderComplete 驗(yàn)證附加消息的頭是完整的鸡典。
<pre><code>
if (CFHTTPMessageIsHeaderComplete(myMessage)) {
// Perform processing.
}
</pre></code>
消息反序列化后源请，你可以調(diào)用如下函數(shù)從消息中提取信息：
-
CFHTTPMessageCopyBody用來(lái)獲取消息主體 -
CFHTTPMessageCopyHeaderFieldValue用來(lái)獲取特定頭字段值 -
CFHTTPMessageCopyAllHeaderFields用來(lái)獲取所有消息頭字段 -
CFHTTPMessageCopyRequestURL用來(lái)獲取消息URL -
CFHTTPMessageCopyRequestMethod用來(lái)獲取消息請(qǐng)求方法
當(dāng)你不再需要該消息，釋放并恰當(dāng)?shù)奶幚硭?/p>
反序列化傳入的HTTP響應(yīng)
正如創(chuàng)建HTTP請(qǐng)求類似于創(chuàng)建HTTP響應(yīng)一樣，反序列化傳入的HTTP請(qǐng)求與反序列化傳入的HTTP響應(yīng)類似谁尸。唯一重要的區(qū)別是舅踪，當(dāng)調(diào)用CFHTTPMessageCreateEmpty，你必須給isRequest 參數(shù)傳入FALSE 來(lái)指定將要?jiǎng)?chuàng)建的消息是響應(yīng)消息良蛮。
使用讀取流序列化并發(fā)送HTTP請(qǐng)求
你可以使用CFReadStream對(duì)象來(lái)序列化和發(fā)送CFHTTP請(qǐng)求抽碌。當(dāng)你使用CFReadStream對(duì)象來(lái)發(fā)送一個(gè)CFHTTP請(qǐng)求時(shí)，打開流因?yàn)橄⒈仨氃谕徊街行蛄谢冒l(fā)送决瞳。使用CFReadStream 對(duì)象來(lái)發(fā)送CFHTTP請(qǐng)求货徙，使獲取請(qǐng)求的響應(yīng)更加容易，因?yàn)轫憫?yīng)作為流的屬性是可用的皮胡。
序列化并發(fā)送一個(gè)HTTP請(qǐng)求
使用CFReadStream 對(duì)象序列化并發(fā)送HTTP請(qǐng)求痴颊，首先創(chuàng)建一個(gè)CFHTTP請(qǐng)求并設(shè)置消息主體和頭，在創(chuàng)建CFHTTP請(qǐng)求（Creating a CFHTTP Request）中有描述屡贺。然后蠢棱，調(diào)用CFReadStreamCreateForHTTPRequest 函數(shù)創(chuàng)建一個(gè)CFReadStream 對(duì)象，傳遞你剛剛創(chuàng)建的請(qǐng)求甩栈。最后泻仙，通過CFReadStreamOpen打開讀取流。
當(dāng)調(diào)用CFReadStreamCreateForHTTPRequest 谤职，復(fù)制一份傳入的CFHTTP請(qǐng)求對(duì)象饰豺。因此亿鲜，如果有必要允蜈，你可以在調(diào)用CFReadStreamCreateForHTTPRequest 之后立即釋放CFHTTP請(qǐng)求對(duì)象。
因?yàn)楫?dāng)創(chuàng)建CFHTTP請(qǐng)求時(shí)蒿柳，讀取流打開一個(gè)套接字連接myUrl 參數(shù)指定的服務(wù)器饶套，兩者之間允許有些時(shí)間差。打開讀取流也會(huì)導(dǎo)致請(qǐng)求被序列化和發(fā)送垒探。
列表3-4是一個(gè)關(guān)于如何序列化和發(fā)送HTTP請(qǐng)求的例子
列表3-4 讀取流序列化HTTP請(qǐng)求
<pre><code>
CFStringRef url = CFSTR("http://www.apple.com");
CFURLRef myURL = CFURLCreateWithString(kCFAllocatorDefault, url, NULL);
CFStringRef requestMethod = CFSTR("GET");
CFHTTPMessageRef myRequest =
CFHTTPMessageCreateRequest(kCFAllocatorDefault,
requestMethod, myUrl, kCFHTTPVersion1_1);
CFHTTPMessageSetBody(myRequest, bodyData);
CFHTTPMessageSetHeaderFieldValue(myRequest, headerField, value);
CFReadStreamRef myReadStream =
CFReadStreamCreateForHTTPRequest(kCFAllocatorDefault, myRequest);
CFReadStreamOpen(myReadStream);
</pre></code>
檢查響應(yīng)
在你安排請(qǐng)求到運(yùn)行循環(huán)后妓蛮，你將最終會(huì)得到一個(gè)頭完成回調(diào)。在這一點(diǎn)上圾叼，你可以調(diào)用CFReadStreamCopyProperty 從讀取流獲取消息響應(yīng)蛤克。
<pre><code>
CFHTTPMessageRef myResponse =
(CFHTTPMessageRef)CFReadStreamCopyProperty(myReadStream,
kCFStreamPropertyHTTPResponseHeader);
</pre></code>
你可以通過調(diào)用CFHTTPMessageCopyResponseStatusLine函數(shù)，從消息響應(yīng)獲取完整狀態(tài)行：
<pre><code>
CFStringRef myStatusLine =
CFHTTPMessageCopyResponseStatusLine(myResponse);
</pre></code>
通過調(diào)用CFHTTPMessageGetResponseStatusCode函數(shù)獲取消息響應(yīng)的狀態(tài)碼：
<pre><code>
UInt32 myErrCode = CFHTTPMessageGetResponseStatusCode(myResponse);
</pre></code>
注意：如果你正在同步使用這個(gè)類（沒有安排到運(yùn)行循環(huán)）夷蚊，你必須在調(diào)用
CFReadStreamCopyProperty之前調(diào)用CFReadStreamRead 构挤，先讀取消息。CFReadStreamRead 調(diào)用一直阻塞直到數(shù)據(jù)可用（或連接失斕韫摹）筋现。不要在你的主應(yīng)用線程中使用。
處理身份驗(yàn)證錯(cuò)誤
如果CFHTTPMessageGetResponseStatusCode 函數(shù)返回的狀態(tài)碼是401（遠(yuǎn)程服務(wù)器需要身份驗(yàn)證信息）或407（代理服務(wù)器需要身份驗(yàn)證），你需要將身份驗(yàn)證信息附加到請(qǐng)求并重新發(fā)送矾飞。關(guān)于如何處理身份驗(yàn)證的信息一膨，請(qǐng)查看與需要身份驗(yàn)證HTTP服務(wù)器通信（ Communicating with Authenticating HTTP Servers）。
處理重定向錯(cuò)誤
當(dāng)CFReadStreamCreateForHTTPRequest 創(chuàng)建一個(gè)讀取流洒沦，默認(rèn)情況下流的自動(dòng)重定向是禁用的豹绪。如果請(qǐng)求發(fā)送的統(tǒng)一資源定位符或URL重定向到另一個(gè)URL，發(fā)送該請(qǐng)求將導(dǎo)致一個(gè)錯(cuò)誤申眼，狀態(tài)碼在300到307之間森篷。如果你接收到一個(gè)重定向錯(cuò)誤，你需要關(guān)閉流豺型，創(chuàng)建流仲智，啟用重定向并打開流。參見列表3-5.
列表3-5 重定向HTTP流
<pre><code>
CFReadStreamClose(myReadStream);
CFReadStreamRef myReadStream =
CFReadStreamCreateForHTTPRequest(kCFAllocatorDefault, myRequest);
if (CFReadStreamSetProperty(myReadStream,
kCFStreamPropertyHTTPShouldAutoredirect, kCFBooleanTrue) == false) {
// something went wrong, exit
}
CFReadStreamOpen(myReadStream);
</pre></code>
當(dāng)你創(chuàng)建一個(gè)讀取流姻氨，你可能想要啟用自動(dòng)重定向钓辆。
取消一個(gè)待定請(qǐng)求
一旦請(qǐng)求已經(jīng)發(fā)送，不能阻止遠(yuǎn)程服務(wù)器處理它肴焊。然而前联，你不再關(guān)心響應(yīng)數(shù)據(jù)，你可以關(guān)閉流娶眷。
重要：如果另一個(gè)線程正在等待某個(gè)線程的流的內(nèi)容似嗤，則不要關(guān)閉該流。如果你需要終止請(qǐng)求時(shí)届宠，你應(yīng)該使用非阻塞 I/O烁落，在使用流時(shí)防止阻塞（Preventing Blocking When Working with Streams）中有描述。確保在關(guān)閉流之前從你的運(yùn)行循環(huán)上移除流豌注。
