您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 教學 >> iOS 相關教學

iOS 呼叫 WebService(SOAP 介面)的兩種方式

編輯:iOS 相關教學

專案若需要對接企業既有的 SOAP 服務,iOS 端有兩條路可走:一是用工具把 WSDL 轉成 Objective-C 類別,二是自己組 SOAP 信封再解析 XML。以下分別說明。

方法一:用 WSDL2ObjC 把介面轉成 OC 類別

步驟 1:取得 WSDL

在瀏覽器(Safari 對 .asmx 支援不佳,建議用 Firefox)中開啟服務位址,例如 https://xxx.xxx.asmx,並在網址後面加上 ?wsdl,即 https://xxx.xxx.asmx?wsdl。

步驟 2:另存為 .wsdl 檔

把頁面另存下來,副檔名加上 .wsdl,例如 xxxxService.asmx.xml.wsdl。

步驟 3:轉換

用 WSDL2ObjC 工具把 wsdl 檔轉成 Objective-C 類別。

步驟 4:匯入專案並呼叫

把產生的所有檔案拖進專案即可使用。以下是一段實際的呼叫範例:

- (NSString *)skHkshListOfpagenow2:(NSInteger)aPagenow
                         pagesize:(NSInteger)aPagesize
{
    MURPXzshServiceSoapBinding *binding =
        [[MURPXzshServiceSoapBinding alloc]
         initWithAddress:[NSString stringWithFormat:@"%@%@", self.jjjj, XZSH_SERVICE]];  // 介面位址
    binding.logXMLInOut = YES;   // 可開啟 XML 日誌,方便除錯

    // 初始化介面中的方法參數物件
    MURPXzshService_HkshList *parm = [[MURPXzshService_HkshList alloc] init];
    parm.xxxx     = [umcid stringValue];   // 傳參數
    parm.pagenow  = [NSNumber numberWithInteger:aPagenow];
    parm.pagesize = [NSNumber numberWithInteger:aPagesize];

    // 呼叫遠端方法
    MURPXzshServiceSoapBindingResponse *resp = [binding HkshListUsingParameters:parm];

    // 取出回傳值
    for (id mine in resp.bodyParts) {
        if ([mine isKindOfClass:[MURPXzshService_HkshListResponse class]]) {
            NSString *resultStr = [mine HkshListResult];
            return resultStr;
        }
    }
    return nil;
}

提醒:上例中的服務名稱是 MURPXzshService、Soap 綁定類別是 MURPXzshServiceSoapBinding,被呼叫的方法則是 HkshList。實際名稱需依自己的 WSDL 而定。

方法二:手動發請求並解析 XML

不想引入額外工具時,可以自己組出 SOAP 信封,用 NSURLConnection 送出,再用系統內建的 NSXMLParser 解析回應。

- (void)viewDidAppear:(BOOL)animated
{
    [super viewDidAppear:animated];

    // 方法主體(SOAP Body 內容)
    NSString *webServiceBodyStr = [NSString stringWithFormat:
        @""
         "34192"
         "1"
         "20"
         ""];

    // 完整的 SOAP 信封
    NSString *webServiceStr = [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"
         "%@\n"
         "</soap:Body>\n"
         "</soap:Envelope>", webServiceBodyStr];

    NSString *SOAPActionStr =
        [NSString stringWithFormat:@"https://xxx.com/murpwebservice/%@", @"Jsjy_yjy"];

    NSURL *url = [NSURL URLWithString:@"https://xxxx/key/MurpjsjyService.asmx"];
    NSMutableURLRequest *theRequest = [NSMutableURLRequest requestWithURL:url];

    NSString *msgLength = [NSString stringWithFormat:@"%ld", (long)webServiceStr.length];
    [theRequest addValue:@"text/xml; charset=utf-8" forHTTPHeaderField:@"Content-type"];
    [theRequest addValue:SOAPActionStr forHTTPHeaderField:@"SOAPAction"];
    [theRequest addValue:msgLength forHTTPHeaderField:@"Content-Length"];
    [theRequest setHTTPMethod:@"POST"];
    [theRequest setHTTPBody:[webServiceStr dataUsingEncoding:NSUTF8StringEncoding]];

    NSURLConnection *theConn = [[NSURLConnection alloc] initWithRequest:theRequest delegate:self];
    if (theConn) {
        NSLog(@"連線已建立");
    } else {
        NSLog(@"連線建立失敗");
    }
}

#pragma mark - NSURLConnection 委派

- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response
{
}

- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data
{
    NSString *str = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
    NSLog(@"%@", str);   // 這裡就是 SOAP 回應的 XML 字串

    // 交給系統內建的解析器處理
    NSXMLParser *par = [[NSXMLParser alloc] initWithData:[str dataUsingEncoding:NSUTF8StringEncoding]];
    [par setDelegate:self];
    [par parse];
}

#pragma mark - NSXMLParser 委派

// step 1:準備開始解析文件
- (void)parserDidStartDocument:(NSXMLParser *)parser
{
}

// step 2:準備解析節點
- (void)parser:(NSXMLParser *)parser
didStartElement:(NSString *)elementName
  namespaceURI:(NSString *)namespaceURI
 qualifiedName:(NSString *)qName
    attributes:(NSDictionary *)attributeDict
{
    NSLog(@"%@", NSStringFromSelector(_cmd));
}

// step 3:取得首尾標籤之間的內容
- (void)parser:(NSXMLParser *)parser foundCharacters:(NSString *)string
{
    NSLog(@"%@", string);
}

// step 4:當前節點解析完畢
- (void)parser:(NSXMLParser *)parser
   didEndElement:(NSString *)elementName
    namespaceURI:(NSString *)namespaceURI
   qualifiedName:(NSString *)qName
{
    NSLog(@"%@", NSStringFromSelector(_cmd));
}

// step 5:解析結束
- (void)parserDidEndDocument:(NSXMLParser *)parser
{
}

// 取得 CDATA 區塊內容
- (void)parser:(NSXMLParser *)parser foundCDATA:(NSData *)CDATABlock
{
}

該選哪一種?

方法一的優勢是型別明確、呼叫端幾乎像呼叫本地方法,適合介面多、結構複雜的企業服務;缺點是多了一層工具產生的程式碼,除錯時較不直觀(因此強烈建議把 logXMLInOut 打開)。方法二完全沒有第三方依賴,適合介面單純或需要對 request 內容做高度控制的情況;缺點是 XML 解析得自己招呼,節點一多維護成本就上升。

另外兩點實務提醒:SOAP 服務多為 HTTP,在 iOS 9 之後預設啟用 ATS,記得為對應網域設定例外;而 NSURLConnection 已被 NSURLSession 取代,新專案請改用後者。

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