motor SOAP

Este cliente SOAP genérico le permite acceder a servicios web utilizando su aplicación iOS, la aplicación Mac OS X y la aplicación Apple TV.

Con este Framework puedes crear aplicaciones para iPhone, iPad, Mac OS X y Apple TV que admitan el protocolo de cliente SOAP. Este marco puede ejecutar métodos en servicios web remotos con el protocolo estándar SOAP.

Características

Admite esquemas XML 2001 (v1.1) y 2003 (v1.2).
Admite matriz, matriz de estructuras, diccionario y conjuntos.
Soporte para objetos definidos por el usuario con serialización de tipos de datos complejos y matriz de tipos de datos complejos, incluso estructuras multinivel integradas.
Admite servicios ASMX, servicios WCF (SVC) y ahora también las definiciones WSDL.
Admite autenticación básica, implícita y NTLM, seguridad WS, certificado del lado del cliente y encabezado de seguridad personalizado.
Admite cuenta social de iOS para enviar token OAuth2.0 en la solicitud.
AES256 o 3DES cifrar/descifrar datos sin seguridad SSL.
En el código fuente se incluye un ejemplo de servicio y cómo utilizarlo.

Requisitos para iOS

iOS 8.0 y posterior
Xcode 8.0 o posterior
Marco.de.seguridad
Marco de cuentas
Fundación.marco
UIKit.marco
libxml2.dylib

Requisitos para Mac OS X

OS X 10.9 y posterior
Xcode 8.0 o posterior
Marco.de.seguridad
Marco de cuentas
Fundación.marco
AppKit.marco
Marco.de.cacao
libxml2.dylib

Requisitos para Apple TV

iOS 9.0 y posterior
Xcode 8.0 o posterior
Marco.de.seguridad
Fundación.marco
UIKit.marco
libxml2.dylib

Limitaciones

para servicios WCF, solo admite enlaces http básicos (basicHttpBinding).
en objetos de imagen no compatibles con Mac OS X, en su lugar puede utilizar NSData.

Problemas conocidos

Swift 4 : la biblioteca está actualmente escrita en Objective-C y cuando importe la biblioteca Swift obtendrá errores de compilación como este. The use of Swift 3 @objc inference in Swift 4 mode is deprecated .
Para que esta advertencia sea silenciosa, es necesario establecer Swift 3 @objc Inference en el valor predeterminado en la configuración de compilación del objetivo. pero no es todo ; las clases utilizadas para crear solicitudes deben declararse con @objcMembers y NSObject , por ejemplo:
```
 class MyClass { ... }

 let param = MyClass ( )
 // ...
 // ...
 let soap = SOAPEngine ( )
 soap . setValue ( param , forKey : " myKey " )
 // ...
 // ...
```
la declaración de MyClass debe ser:
```
 @ objcMembers class MyClass : NSObject { ... } 
```

Seguridad para Xcode 8.x o posterior

A partir del nuevo Xcode 8 se requiere una configuración adicional para las aplicaciones, si esta configuración no existe verá un mensaje de registro como este:

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.

Para resolver esto, agregue algunas claves en info.plist, los pasos son:

Abra el archivo info.plist de su proyecto.
Agregue una clave llamada NSAppTransportSecurity como diccionario.
Agregue una subclave llamada NSAllowsArbitraryLoads como booleana y establezca su valor en SÍ como en la siguiente imagen.

NSAppTransporteSeguridad

enlace de referencia: http://stackoverflow.com/a/32631185/4069848

como usar

con los delegados :

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

con programación de bloques :

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

con notificaciones :

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

Solicitud sincrónica :

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

configuración para la autenticación SOAP :

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

configuración para el token Social OAuth2.0 :

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

Datos de cifrado/descifrado sin SSL/HTTPS:

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

Parámetros con atributos :

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

construye una solicitud como esta:

Genesis 1 ">

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

Optimizaciones

En primer lugar, si nota una ralentización en la respuesta de la solicitud, intente cambiar el valor de la propiedad denominada actionNamespaceSlash . Después, cuando se utiliza el método denominado requestWSDL se realizan tres pasos:

recuperar el WSDL con una solicitud http
procesamiento para identificar la acción del jabón
llama al método con una solicitud http solicitud http

Esto no está optimizado, es muy lento; en su lugar, puede utilizar la siguiente optimización:

recuperando manualmente SOAPAction directamente desde WSDL (una vez con su navegador favorito).
utilice el método denominado requestURL en lugar de requestWSDL sin extensión WSDL.