萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> iOS 開發

iOS SOAP 客戶端開發實戰:手動構建請求、NSXMLParser 解析響應

SOAP 協議核心流程

  1. 客戶端構造符合 SOAP 1.1/1.2 規範的 XML 請求信封
  2. HTTP POST 發送至服務端點,Header 包含 Content-Type: text/xml; charset=utf-8、SOAPAction
  3. 服務端解析、調用業務邏輯、返回 SOAP 響應 XML
  4. 客戶端解析響應,提取業務數據,更新 UI

完整實現代碼

1. 界面佈局

IBOutlet 連接:UITextField *nameInput、UILabel *greeting、IBAction buttonClick:

2. 發送 SOAP 請求

- (void)getOffsetUTCTimeSOAP {
    // 1. 構造 SOAP 信封
    NSString *soapMessage = [NSString stringWithFormat:
        @""
        @""
        @""
        @""
        @"%@"
        @""
        @""
        @"", nameInput.text];
    
    NSLog(@"Request:\n%@", soapMessage);
    
    // 2. 構造請求
    NSURL *url = [NSURL URLWithString:@"https://www.nanonull.com/TimeService/TimeService.asmx"];
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
    [request setHTTPMethod:@"POST"];
    [request setValue:@"text/xml; charset=utf-8" forHTTPHeaderField:@"Content-Type"];
    [request setValue:@"https://www.Nanonull.com/TimeService/GetOffsetUTCTime" forHTTPHeaderField:@"SOAPAction"];
    [request setValue:[NSString stringWithFormat:@"%lu", (unsigned long)[soapMessage length]] forHTTPHeaderField:@"Content-Length"];
    [request setHTTPBody:[soapMessage dataUsingEncoding:NSUTF8StringEncoding]];
    
    // 3. 異步連接
    NSURLConnection *conn = [[NSURLConnection alloc] initWithRequest:request delegate:self];
    if (conn) {
        _webData = [NSMutableData data]; // 接收緩衝
    } else {
        NSLog(@"❌ 連接創建失敗");
    }
}

3. NSURLConnectionDataDelegate 接收響應


- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response {
    [_webData setLength:0]; // 重置緩衝
}

- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data {
    [_webData appendData:data];
}

- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error {
    NSLog(@"❌ 網絡錯誤:%@", error.localizedDescription);
    [connection release];
    [_webData release];
}

- (void)connectionDidFinishLoading:(NSURLConnection *)connection {
    NSString *xmlString = [[NSString alloc] initWithData:_webData encoding:NSUTF8StringEncoding];
    NSLog(@"Response XML:\n%@", xmlString);
    
    // 4. XML 解析
    _xmlParser = [[NSXMLParser alloc] initWithData:_webData];
    _xmlParser.delegate = self;
    [_xmlParser setShouldResolveExternalEntities:YES];
    [_xmlParser parse];
    
    [connection release];
}

4. NSXMLParserDelegate 解析業務數據


- (void)parser:(NSXMLParser *)parser didStartElement:(NSString *)elementName
  namespaceURI:(NSString *)namespaceURI qualifiedName:(NSString *)qName
    attributes:(NSDictionary *)attributeDict {
    if ([elementName isEqualToString:@"GetOffsetUTCTimeResult"]) {
        _recordResults = YES;
        _soapResults = [NSMutableString string];
    }
}

- (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:@"GetOffsetUTCTimeResult"]) {
        _recordResults = NO;
        self.greeting.text = _soapResults; // 更新 UI
        NSLog(@"✅ 解析結果:%@", _soapResults);
    }
}

現代替代方案

方案優點缺點
AFNetworking / Alamofire + XMLMapper / SWXMLHash鏈式 API、自動解析、錯誤處理、單元測試友好引入依賴
SOAPEngine / SWSOAPEngineWSDL 自動生成代碼、強類型模型、複雜類型支援學習曲線、體積較大
手動 NSURLSession + XMLParser零依賴、完全可控、適合極簡項目樣板代碼多、易出錯

建議:新項目優先考慮 REST/JSON + Codable;必須對接 SOAP 服務時,引入 SOAPEngine 由 WSDL 自動生成模型與請求代碼,避免手寫 XML。

copyright © 萬盛學電腦網 all rights reserved