專案若需要對接企業既有的 SOAP 服務,iOS 端有兩條路可走:一是用工具把 WSDL 轉成 Objective-C 類別,二是自己組 SOAP 信封再解析 XML。以下分別說明。
步驟 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 而定。
不想引入額外工具時,可以自己組出 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 取代,新專案請改用後者。