SOAPEngine

Mit diesem generischen SOAP-Client können Sie über Ihre iOS-App, Mac OS X-App und Apple TV-App auf Webdienste zugreifen.

Mit diesem Framework können Sie iPhone-, iPad-, Mac OS X- und Apple TV-Apps erstellen, die das SOAP Client Protocol unterstützen. Dieses Framework ist in der Lage, Methoden bei Remote-Webdiensten mit dem SOAP-Standardprotokoll auszuführen.

Merkmale

Unterstützt sowohl das XML-Schema 2001 (v1.1) als auch 2003 (v1.2).
Unterstützt Array, Array von Strukturen, Wörterbuch und Mengen.
Unterstützung für benutzerdefinierte Objekte mit Serialisierung komplexer Datentypen und Arrays komplexer Datentypen, sogar eingebetteter mehrstufiger Strukturen.
Unterstützt ASMX Services, WCF Services (SVC) und jetzt auch die WSDL-Definitionen.
Unterstützt Basic-, Digest- und NTLM-Authentifizierung, WS-Sicherheit, clientseitiges Zertifikat und benutzerdefinierten Sicherheitsheader.
Unterstützt das iOS-Social-Konto zum Senden eines OAuth2.0-Tokens auf Anfrage.
AES256 oder 3DES verschlüsseln/entschlüsseln Sie Daten ohne SSL-Sicherheit.
Ein Beispiel für den Dienst und seine Verwendung ist im Quellcode enthalten.

Anforderungen für iOS

iOS 8.0 und höher
Xcode 8.0 oder höher
Sicherheitsrahmen
Accounts.framework
Foundation.framework
UIKit.framework
libxml2.dylib

Anforderungen für Mac OS X

OS X 10.9 und höher
Xcode 8.0 oder höher
Sicherheitsrahmen
Accounts.framework
Foundation.framework
AppKit.framework
Cocoa.framework
libxml2.dylib

Anforderungen für Apple TV

iOS 9.0 und höher
Xcode 8.0 oder höher
Sicherheitsrahmen
Foundation.framework
UIKit.framework
libxml2.dylib

Einschränkungen

Unterstützt für WCF-Dienste nur grundlegende HTTP-Bindungen (basicHttpBinding).
in Mac OS X nicht unterstützte Bildobjekte, stattdessen können Sie NSData verwenden.

Bekannte Probleme

Swift 4 : Die Bibliothek ist derzeit in Objective-C geschrieben und wenn Sie die Swift-Bibliothek importieren, erhalten Sie Build-Fehler wie diesen. The use of Swift 3 @objc inference in Swift 4 mode is deprecated .
Damit diese Warnung nicht angezeigt wird, muss Swift 3 @objc Inference in den Build-Einstellungen des Ziels auf den Standardwert gesetzt werden. aber es ist nicht alles ; Die zum Erstellen von Anforderungen verwendeten Klassen müssen mit @objcMembers und NSObject deklariert werden, z. B.:
```
 class MyClass { ... }

 let param = MyClass ( )
 // ...
 // ...
 let soap = SOAPEngine ( )
 soap . setValue ( param , forKey : " myKey " )
 // ...
 // ...
```
Die Deklaration von MyClass muss wie folgt lauten:
```
 @ objcMembers class MyClass : NSObject { ... } 
```

Sicherheit für Xcode 8.x oder höher

Ab dem neuen Xcode 8 ist eine zusätzliche Einstellung für die Apps erforderlich. Wenn diese Einstellung nicht vorhanden ist, wird eine Protokollmeldung wie diese angezeigt:

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.

Um dieses Problem zu beheben, fügen Sie einige Schlüssel in info.plist hinzu. Die Schritte sind:

Öffnen Sie die Datei info.plist Ihres Projekts.
Fügen Sie einen Schlüssel namens NSAppTransportSecurity als Wörterbuch hinzu.
Fügen Sie einen Unterschlüssel mit dem Namen NSAllowsArbitraryLoads als booleschen Wert hinzu und setzen Sie seinen Wert auf „JA“, wie in der folgenden Abbildung dargestellt.

NSAppTransportSecurity

Referenzlink: http://stackoverflow.com/a/32631185/4069848

Wie zu verwenden

mit Delegierten :

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

mit Blockprogrammierung :

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

mit Benachrichtigungen :

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

Synchrone Anfrage:

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

Einstellungen für die SOAP-Authentifizierung :

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

Einstellungen für Social OAuth2.0- Token:

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

Verschlüsselungs-/Entschlüsselungsdaten ohne SSL/HTTPS:

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

Parameter mit Attributen :

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

Es wird eine Anfrage wie diese erstellt:

Genesis 1 ">

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

Optimierungen

Wenn Sie eine Verlangsamung der Antwort auf die Anfrage feststellen, versuchen Sie zunächst, den Wert der Eigenschaft actionNamespaceSlash zu ändern. Anschließend werden bei Verwendung der Methode namens requestWSDL drei Schritte ausgeführt:

Rufen Sie die WSDL mit einer http-Anfrage ab
Verarbeitung zur Identifizierung der SoapAction
ruft die Methode mit einer http-Anfrage http-Anfrage auf

Dies ist nicht optimiert, sehr langsam. Stattdessen können Sie die folgende Optimierung verwenden:

Manuelles Abrufen der SOAPAction direkt aus der WSDL (einmal mit Ihrem Lieblingsbrowser).
Verwenden Sie die Methode „requestURL“ anstelle von „requestWSDL“ ohne WSDL-Erweiterung.