除了 REST,iOS 也可能需要呼叫傳統的 SOAP Web Service。SOAP 透過 HTTP 傳送一段 XML 封包,並依 WSDL 描述的格式來往溝通。以下用一個查詢地區時間的公開服務為例,走一遍完整流程。
打開服務的 WSDL 網址,左邊會看到同名的方法(如 LocalTimeByZipCode)。點進去可以看到 Overview、Input/Output Parameters,甚至用 Test Form 輸入 zipcode(如 12345)在線測試,確認服務可用。再點 Message Layout,會看到 SOAP、HTTP GET、HTTP POST 三種呼叫方式,這裡我們聚焦在 SOAP。
SOAP 段落上方是「請求要送出的封包」,下方是「正常回應的封包」。請求範例如下:
POST /webservices/LocalTime.asmx HTTP/1.1
SOAPAction: https://www.ripedev.com/LocalTimeByZipCode
Content-Type: text/xml; charset=utf-8
<?xml version="1.0" encoding="utf-16"?>
<soap:Envelope xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="https://www.w3.org/2001/XMLSchema"
xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<LocalTimeByZipCode xmlns="https://www.ripedev.com/">
<ZipCode>string</ZipCode>
</LocalTimeByZipCode>
</soap:Body>
</soap:Envelope>
要點:SOAP 中 Header 與 Fault 可有可無,但 Body 與 Envelope 一定要。
建立 Xcode 專案,放一個按鈕與一個 textView 顯示結果。按鈕事件如下:
- (void)startRequestToWsdl2:(id)sender {
NSString *soapMessage = [NSString stringWithFormat:
@"<?xml version=\"1.0\" encoding=\"utf-8\"?>\n"
"<soap:Envelope xmlns:xsi=\"https://www.w3.org/2001/XMLSchema-instance\" "
"xmlns:xsd=\"https://www.w3.org/2001/XMLSchema\" "
"xmlns:soap=\"https://schemas.xmlsoap.org/soap/envelope/\">\n"
"<soap:Body>\n"
"<LocalTimeByZipCode xmlns=\"https://www.ripedev.com/\">"
"<ZipCode>12345</ZipCode>\n"
"</LocalTimeByZipCode>\n"
"</soap:Body>\n"
"</soap:Envelope>\n"];
NSString *address = @"https://www.ripedevelopment.com/webservices/LocalTime.asmx";
NSURL *url = [NSURL URLWithString:address];
NSMutableURLRequest *theRequest = [NSMutableURLRequest requestWithURL:url];
[theRequest addValue:@"text/xml; charset=utf-8" forHTTPHeaderField:@"Content-Type"];
NSString *msgLength = [NSString stringWithFormat:@"%d", [soapMessage length]];
[theRequest addValue:msgLength forHTTPHeaderField:@"Content-Length"];
[theRequest addValue:@"https://www.ripedev.com/LocalTimeByZipCode" forHTTPHeaderField:@"SOAPAction"];
[theRequest setHTTPMethod:@"POST"];
[theRequest setHTTPBody:[soapMessage dataUsingEncoding:NSUTF8StringEncoding]];
NSURLConnection *theConnection = [[NSURLConnection alloc] initWithRequest:theRequest delegate:self];
if (theConnection) {
webData = [[NSMutableData data] retain];
}
}
幾個關鍵:Content-Type 必須是 text/xml,Content-Length 一定要有,SOAPAction 的內容則來自 WSDL 中紅字標示之處。
- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data {
[webData appendData:data];
}
- (void)connectionDidFinishLoading:(NSURLConnection *)connection {
NSString *theXML = [[NSString alloc] initWithBytes:[webData mutableBytes]
length:[webData length]
encoding:NSUTF8StringEncoding];
if (xmlParser) { [xmlParser release]; }
xmlParser = [[NSXMLParser alloc] initWithData:webData];
[xmlParser setDelegate:self];
[xmlParser setShouldResolveExternalEntities:YES];
[xmlParser parse];
}
解析時,我們只關心回應中的 LocalTimeByZipCodeResult 這個節點:
- (void)parser:(NSXMLParser *)parser didStartElement:(NSString *)elementName
namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName
attributes:(NSDictionary *)attributeDict {
if ([elementName isEqualToString:@"LocalTimeByZipCodeResult"]) {
if (!soapResults) soapResults = [[NSMutableString alloc] init];
recordResults = YES;
}
}
- (void)parser:(NSXMLParser *)parser foundCharacters:(NSString *)string {
if (recordResults) [soapResults appendString:string];
}
- (void)parser:(NSXMLParser *)parser didEndElement:(NSString *)elementName
namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName {
if ([elementName isEqualToString:@"LocalTimeByZipCodeResult"]) {
recordResults = NO;
NSLog(@"結果時區 = %@", soapResults);
[soapResults release];
soapResults = nil;
}
}
回應封包中,我們要找的內容就包在 <LocalTimeByZipCodeResult> 裡,這也正是解析時比對該節點名稱的原因。
最後提醒:上面為了示範,是直接同步取資料;在真實環境中,應該改用非同步或背景執行緒來發送請求,以免阻塞主執行緒、影響 UI 反應。此外,SOAP/XML 的解析在現代 iOS 開發中已較少見,多數服務已改用 JSON;若確實需要處理大量 XML,也可考慮改用更高效能的解析庫(如 KissXML)取代 NSXMLParser。