สบู่เครื่องยนต์

ไคลเอนต์ SOAP ทั่วไปนี้ช่วยให้คุณเข้าถึงบริการเว็บโดยใช้แอพ iOS, แอพ Mac OS X และแอพ Apple TV

ด้วยเฟรมเวิร์กนี้ คุณสามารถสร้างแอพ iPhone, iPad, Mac OS X และ Apple TV ที่รองรับ SOAP Client Protocol เฟรมเวิร์กนี้สามารถดำเนินการวิธีการบริการเว็บระยะไกลด้วยโปรโตคอลมาตรฐาน SOAP

คุณสมบัติ

รองรับสคีมา XML ทั้ง 2001 (v1.1) และ 2003 (v1.2)
รองรับอาร์เรย์ อาร์เรย์ของโครงสร้าง พจนานุกรม และเซ็ต
รองรับออบเจ็กต์ที่ผู้ใช้กำหนดด้วยการซีเรียลไลซ์ประเภทข้อมูลที่ซับซ้อนและอาร์เรย์ของประเภทข้อมูลที่ซับซ้อน แม้แต่โครงสร้างหลายระดับที่ฝังไว้
รองรับบริการ ASMX, บริการ WCF (SVC) และตอนนี้ยังมีคำจำกัดความ WSDL ด้วย
รองรับการตรวจสอบสิทธิ์ Basic, Digest และ NTLM, WS-Security, Client side Certificate และส่วนหัวการรักษาความปลอดภัยแบบกำหนดเอง
รองรับบัญชีโซเชียล iOS เพื่อส่งโทเค็น OAuth2.0 ตามคำขอ
AES256 หรือ 3DES เข้ารหัส/ถอดรหัสข้อมูลโดยไม่มีการรักษาความปลอดภัย SSL
ตัวอย่างของบริการและวิธีการใช้งานรวมอยู่ในซอร์สโค้ด

ข้อกำหนดสำหรับ iOS

iOS 8.0 และใหม่กว่า
Xcode 8.0 หรือใหม่กว่า
ความปลอดภัย.เฟรมเวิร์ก
บัญชี.กรอบงาน
มูลนิธิ.กรอบ
UIKit.framework
libxml2.dylib

ข้อกำหนดสำหรับ Mac OS X

OS X 10.9 และใหม่กว่า
Xcode 8.0 หรือใหม่กว่า
ความปลอดภัย.เฟรมเวิร์ก
บัญชี.กรอบงาน
มูลนิธิ.กรอบ
AppKit.framework
โกโก้.เฟรมเวิร์ค
libxml2.dylib

ข้อกำหนดสำหรับ Apple TV

iOS 9.0 และใหม่กว่า
Xcode 8.0 หรือใหม่กว่า
ความปลอดภัย.เฟรมเวิร์ก
มูลนิธิ.กรอบ
UIKit.framework
libxml2.dylib

ข้อจำกัด

สำหรับบริการ WCF รองรับเฉพาะการเชื่อมโยง http พื้นฐาน (basicHttpBinding)
ในออบเจ็กต์รูปภาพที่ไม่รองรับ Mac OS X คุณสามารถใช้ NSData แทนได้

ปัญหาที่ทราบ

Swift 4 : ขณะนี้ไลบรารีถูกเขียนใน Objective-C และเมื่อคุณนำเข้าไลบรารี Swift คุณจะได้รับข้อผิดพลาดในการสร้างเช่นนี้ The use of Swift 3 @objc inference in Swift 4 mode is deprecated
สำหรับการเงียบคำเตือนนี้จำเป็นต้องตั้งค่า Swift 3 @objc Inference เป็นค่าเริ่มต้นในการตั้งค่า Build ของเป้าหมาย แต่ไม่ใช่ทั้งหมด ; คลาสที่ใช้ในการสร้างคำขอจะต้องประกาศด้วย @objcMembers และ NSObject เช่น:
```
 class MyClass { ... }

 let param = MyClass ( )
 // ...
 // ...
 let soap = SOAPEngine ( )
 soap . setValue ( param , forKey : " myKey " )
 // ...
 // ...
```
การประกาศของ MyClass จะต้องเป็น:
```
 @ objcMembers class MyClass : NSObject { ... } 
```

ความปลอดภัยสำหรับ Xcode 8.x หรือใหม่กว่า

จำเป็นต้องมีการตั้งค่าเพิ่มเติมสำหรับแอปจาก Xcode 8 ใหม่ หากไม่มีการตั้งค่านี้ คุณจะเห็นข้อความบันทึกดังนี้:

App Transport Security has blocked a cleartext HTTP (http://) resource load since it is insecure. Temporary exceptions can be configured via your app's Info.plist file.

หากต้องการแก้ไขปัญหานี้ ให้เพิ่มคีย์สองสามอันใน info.plist โดยมีขั้นตอนดังนี้:

เปิดไฟล์ info.plist ของโครงการของคุณ
เพิ่มคีย์ที่เรียกว่า NSAppTransportSecurity เป็นพจนานุกรม
เพิ่มคีย์ย่อยที่เรียกว่า NSAllowsArbitraryLoads เป็น Boolean และตั้งค่าเป็น YES เหมือนกับรูปภาพต่อไปนี้

NSAppTransport ความปลอดภัย

ลิงค์อ้างอิง: http://stackoverflow.com/a/32631185/4069848

วิธีใช้

กับ ผู้แทน :

import SOAPEngine64

class ViewController : UIViewController , SOAPEngineDelegate {

	var soap : SOAPEngine = SOAPENgine ( )

	override func viewDidLoad ( ) {
		soap . delegate = self
		soap . actionNamespaceSlash = true
		soap . setValue ( " Genesis " , forKey : " BookName " )
		soap . setIntegerValue ( 1 , forKey : " chapter " )

		// standard soap service (.asmx)
		soap . requestURL ( " http://www.prioregroup.com/services/americanbible.asmx " ,
	    		soapAction : " http://www.prioregroup.com/GetVerses " )
	}

	func soapEngine ( _ soapEngine : SOAPEngine ! , didFinishLoadingWith dict : [ AnyHashable : Any ] ! , data : Data ! ) 
	{
		let dict = soapEngine . dictionaryValue ( )
		print ( dict )
	}
}

ด้วย การเขียนโปรแกรมแบบบล็อก :

Void in let book:NSDictionary = dict! as NSDictionary let verses = book["BibleBookChapterVerse"] as! NSArray print(verses) }) { (error: Error?) -> Void in print(error!) } } }">

import SOAPEngine64

class ViewController : UIViewController {

	var soap : SOAPEngine = SOAPENgine ( )

	override func viewDidLoad ( ) {
		super . viewDidLoad ( )
		soap . actionNamespaceSlash = true
		soap . setValue ( " Genesis " , forKey : " BookName " )
        	soap . setIntegerValue ( 1 , forKey : " chapter " )
        
        	soap . requestURL ( " http://www.prioregroup.com/services/americanbible.asmx " ,
	    		    soapAction : " http://www.prioregroup.com/GetVerses " ,
		completeWithDictionary : { ( statusCode : Int ? , dict : [ AnyHashable : Any ] ? ) -> Void in
                            
			let book : NSDictionary = dict! as NSDictionary
			let verses = book [ " BibleBookChapterVerse " ] as! NSArray
			print ( verses )

		} ) { ( error : Error ? ) -> Void in
			print ( error! )
		}
	}
}

ด้วย การแจ้งเตือน :

import SOAPEngine64

class ViewController : UIViewController {

	var soap : SOAPEngine = SOAPENgine ( )

	override func viewDidLoad ( ) {
		super . viewDidLoad ( )

		NotificationCenter . default . addObserver ( self , 
			selector : #selector ( soapEngineDidFinishLoading ( _ : ) ) , 
			name : NSNotification . Name . SOAPEngineDidFinishLoading , 
			object : nil )

		soap . actionNamespaceSlash = true
		soap . setValue ( " Genesis " , forKey : " BookName " )
		soap . setIntegerValue ( 1 , forKey : " chapter " )

		// standard soap service (.asmx)
		soap . requestURL ( " http://www.prioregroup.com/services/americanbible.asmx " ,
	    	soapAction : " http://www.prioregroup.com/GetVerses " )
	}

	@ objc func soapEngineDidFinishLoading ( _ notification : NSNotification ) {
		let engine = notification . object as? SOAPEngine
		let dict = engine ( )
		print ( dict )
	}
}

คำขอ แบบซิงโครนัส :

import SOAPEngine64

class ViewController : UIViewController {

	var soap : SOAPEngine = SOAPENgine ( )

	override func viewDidLoad ( ) {
		super . viewDidLoad ( )
		soap . actionNamespaceSlash = true
		soap . setValue ( " Genesis " , forKey : " BookName " )
		soap . setIntegerValue ( 1 , forKey : " chapter " )

		// standard soap service (.asmx)
		do {
			let result = try soap . syncRequestURL ( " http://www.prioregroup.com/services/americanbible.asmx " , 
						 soapAction : " http://www.prioregroup.com/GetVerses " )
			print ( result )
		}
		catch {
			print ( error )
		}	
	}
}

การตั้งค่าสำหรับ SOAP Authentication :

soap . authorizationMethod = . AUTH_BASICAUTH; // basic auth
soap . username = " my-username " ;
soap . password = " my-password " ;

การตั้งค่าสำหรับโทเค็น Social OAuth2.0 :

// token authorization
soap . authorizationMethod = . AUTH_SOCIAL;
soap . apiKey = " 1234567890 " ; // your apikey https://dev.twitter.com/
soap . socialName = ACAccountTypeIdentifierTwitter; // import Accounts

ข้อมูล การเข้ารหัส/ถอดรหัส ที่ไม่มี SSL/HTTPS :

soap . encryptionType = . _ENCRYPT_AES256; // or SOAP_ENCRYPT_3DES
soap . encryptionPassword = " my-password " ;

Params พร้อม คุณสมบัติ :

// book
var book = [ " name " : " Genesis " ] as! NSMutableDictionary
var attr = [ " order " : " asc " ]
// chapter
var child = soap . dictionary ( forKey : " chapter " , value : " 1 " , attributes : attr )
book . addEntries ( from : child! )
// book attributes
soap . setValue ( book , forKey : " Book " , attributes : [ " rack " : " 2 " ] )

มันสร้างคำขอเช่นนี้:

Genesis 1 ">

< Book rack = " 2 " >
	< name >Genesisname >
	< chapter order = " asc " >1chapter >
Book >

การเพิ่มประสิทธิภาพ

ก่อนอื่น หากคุณสังเกตเห็นว่าการตอบสนองคำขอช้าลง ให้ลองเปลี่ยนค่าของคุณสมบัติชื่อ actionNamespaceSlash หลังจากนั้น เมื่อใช้วิธีการชื่อ requestWSDL จะดำเนินการสามขั้นตอน: