Mesin SABUN

Klien SOAP generik ini memungkinkan Anda mengakses layanan web menggunakan aplikasi iOS, aplikasi Mac OS X, dan aplikasi Apple TV.

Dengan Framework ini Anda dapat membuat aplikasi iPhone, iPad, Mac OS X dan Apple TV yang mendukung SOAP Client Protocol. Framework ini mampu mengeksekusi metode pada layanan web jarak jauh dengan protokol standar SOAP.

Fitur

Mendukung skema XML 2001 (v1.1) dan 2003 (v1.2).
Mendukung array, array struct, kamus dan set.
Dukungan untuk objek yang ditentukan pengguna dengan serialisasi tipe data kompleks dan array tipe data kompleks, bahkan struktur bertingkat yang tertanam.
Mendukung Layanan ASMX, Layanan WCF (SVC) dan sekarang juga definisi WSDL.
Mendukung Otentikasi Dasar, Intisari dan NTLM, Keamanan WS, Sertifikat sisi klien, dan header keamanan khusus.
Mendukung Akun Sosial iOS untuk mengirim token OAuth2.0 berdasarkan permintaan.
AES256 atau 3DES Enkripsi/Dekripsi data tanpa keamanan SSL.
Contoh layanan dan cara menggunakannya disertakan dalam kode sumber.

Persyaratan untuk iOS

iOS 8.0 dan lebih baru
Xcode 8.0 atau lebih baru
Keamanan.kerangka kerja
Akun.kerangka kerja
Fondasi.kerangka kerja
UIKit.framework
libxml2.dylib

Persyaratan untuk Mac OS X

OS X 10.9 dan lebih baru
Xcode 8.0 atau lebih baru
Keamanan.kerangka kerja
Akun.kerangka kerja
Fondasi.kerangka kerja
AppKit.framework
Kakao.kerangka kerja
libxml2.dylib

Persyaratan untuk Apple TV

iOS 9.0 dan lebih baru
Xcode 8.0 atau lebih baru
Keamanan.kerangka kerja
Fondasi.kerangka kerja
UIKit.framework
libxml2.dylib

Keterbatasan

untuk layanan WCF, hanya mendukung pengikatan http dasar (basicHttpBinding).
di objek gambar Mac OS X yang tidak didukung, Anda dapat menggunakan file NSData.

Masalah yang diketahui

Swift 4 : perpustakaan saat ini ditulis dalam Objective-C dan ketika Anda mengimpor perpustakaan Swift Anda akan mendapatkan kesalahan pembuatan seperti ini. The use of Swift 3 @objc inference in Swift 4 mode is deprecated .
Untuk diam, peringatan ini perlu menyetel Swift 3 @objc Inference ke nilai default dalam pengaturan Build target. tapi itu belum semuanya ; kelas yang digunakan untuk membuat permintaan harus dideklarasikan dengan @objcMembers dan NSObject , misalnya:
```
 class MyClass { ... }

 let param = MyClass ( )
 // ...
 // ...
 let soap = SOAPEngine ( )
 soap . setValue ( param , forKey : " myKey " )
 // ...
 // ...
```
deklarasi MyClass harus menjadi :
```
 @ objcMembers class MyClass : NSObject { ... } 
```

Keamanan untuk Xcode 8.x atau lebih baru

Dari Xcode 8 baru diperlukan pengaturan tambahan untuk aplikasi, jika pengaturan ini tidak ada Anda akan melihat pesan log seperti ini:

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.

Untuk mengatasinya, tambahkan beberapa kunci di info.plist, langkah-langkahnya adalah:

Buka file info.plist proyek Anda.
Tambahkan Kunci yang disebut NSAppTransportSecurity sebagai Kamus.
Tambahkan Subkunci bernama NSAllowsArbitraryLoads sebagai Boolean dan atur nilainya menjadi YES seperti gambar berikut.

Keamanan Transportasi NSApp

tautan referensi: http://stackoverflow.com/a/32631185/4069848

Cara menggunakan

dengan Delegasi :

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 )
	}
}

dengan pemrograman Blok :

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! )
		}
	}
}

dengan Pemberitahuan :

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 )
	}
}

Permintaan sinkron :

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 )
		}	
	}
}

pengaturan untuk Otentikasi SOAP :

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

pengaturan untuk token OAuth2.0 Sosial :

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

Enkripsi/Dekripsi data tanpa SSL/HTTPS :

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

Param dengan Atribut :

// 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 " ] )

itu membangun permintaan seperti ini:

Genesis 1 ">

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

Pengoptimalan

Pertama-tama, jika Anda melihat adanya perlambatan dalam respons permintaan, coba ubah nilai properti bernama actionNamespaceSlash . Setelah itu, saat menggunakan metode bernama requestWSDL ada tiga langkah yang dilakukan:

mengambil WSDL dengan permintaan http
pemrosesan untuk mengidentifikasi sabunAction
memanggil metode dengan permintaan http permintaan http

ini tidak dioptimalkan, sangat lambat, sebagai gantinya Anda dapat menggunakan optimasi di bawah ini:

mengambil secara manual SOAPAction langsung dari WSDL (sekali dengan browser favorit Anda).
gunakan metode bernama requestURL alih-alih requestWSDL tanpa ekstensi WSDL.