您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

[iOS] 網路編程:以 SOAP 呼叫 WSDL Web Service

編輯:iOS 開發綜合

除了 REST,iOS 也可能需要呼叫傳統的 SOAP Web Service。SOAP 透過 HTTP 傳送一段 XML 封包,並依 WSDL 描述的格式來往溝通。以下用一個查詢地區時間的公開服務為例,走一遍完整流程。

一、看懂 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 中紅字標示之處。

三、接收資料並解析 XML

- (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。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved