SOAPEngine

Este cliente SOAP genérico permite que você acesse serviços da web usando seu aplicativo iOS, aplicativo Mac OS X e aplicativo Apple TV.

Com este Framework você pode criar aplicativos para iPhone, iPad, Mac OS X e Apple TV que suportam protocolo de cliente SOAP. Este framework é capaz de executar métodos em serviços web remotos com protocolo padrão SOAP.

Características

Suporta esquema XML de 2001 (v1.1) e 2003 (v1.2).
Matriz de suporte, matriz de estruturas, dicionário e conjuntos.
Suporte para objetos definidos pelo usuário com serialização de tipos de dados complexos e matriz de tipos de dados complexos, até mesmo estruturas multiníveis incorporadas.
Suporta serviços ASMX, serviços WCF (SVC) e agora também definições WSDL.
Suporta autenticação básica, Digest e NTLM, WS-Security, certificado do lado do cliente e cabeçalho de segurança personalizado.
Suporta conta social iOS para enviar token OAuth2.0 na solicitação.
AES256 ou 3DES criptografa/descriptografa dados sem segurança SSL.
Um exemplo de serviço e como usá-lo está incluído no código-fonte.

Requisitos para iOS

iOS 8.0 e posterior
Xcode 8.0 ou posterior
Estrutura de segurança
Estrutura de contas
Fundação.framework
UIKit.framework
libxml2.dylib

Requisitos para Mac OS X

OS X 10.9 e posterior
Xcode 8.0 ou posterior
Estrutura de segurança
Estrutura de contas
Fundação.framework
AppKit.framework
Cocoa.framework
libxml2.dylib

Requisitos para Apple TV

iOS 9.0 e posterior
Xcode 8.0 ou posterior
Estrutura de segurança
Fundação.framework
UIKit.framework
libxml2.dylib

Limitações

para serviços WCF, suporta apenas ligações http básicas (basicHttpBinding).
em objetos de imagem não suportados no Mac OS X, você pode usar o NSData.

Problemas conhecidos

Swift 4 : a biblioteca está atualmente escrita em Objective-C e quando você importa a biblioteca swift você obterá erros de compilação como este The use of Swift 3 @objc inference in Swift 4 mode is deprecated .
Para silêncio, este aviso é necessário definir Swift 3 @objc Inference para o valor padrão nas configurações de compilação do destino. mas não é tudo ; as classes usadas para criar solicitações devem ser declaradas com @objcMembers e NSObject , ex.:
```
 class MyClass { ... }

 let param = MyClass ( )
 // ...
 // ...
 let soap = SOAPEngine ( )
 soap . setValue ( param , forKey : " myKey " )
 // ...
 // ...
```
a declaração de MyClass deve se tornar:
```
 @ objcMembers class MyClass : NSObject { ... } 
```

Segurança para Xcode 8.x ou posterior

A partir do novo Xcode 8 é necessária uma configuração adicional para os apps, caso esta configuração não exista você verá uma mensagem de log como esta:

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 isso, adicione algumas chaves em info.plist, as etapas são:

Abra o arquivo info.plist do seu projeto.
Adicione uma chave chamada NSAppTransportSecurity como dicionário.
Adicione uma subchave chamada NSAllowsArbitraryLoads como Boolean e defina seu valor como YES como na imagem a seguir.

NSAppTransportSegurança

link de referência: http://stackoverflow.com/a/32631185/4069848

Como usar

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

com programação em bloco :

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

com notificações :

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

Solicitação síncrona :

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

configurações para autenticação SOAP :

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

configurações para token Social OAuth2.0 :

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

Dados de criptografia/descriptografia sem SSL/HTTPS:

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

Parâmetros com 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 " ] )

ele cria uma solicitação como esta:

Genesis 1 ">

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

Otimizações

Primeiramente, se você notar uma lentidão na resposta da solicitação, tente alterar o valor da propriedade chamada actionNamespaceSlash . Após, ao utilizar o método chamado requestWSDL são executados três passos:

recuperar o WSDL com uma solicitação http
processamento para identificar o soapAction
chama o método com uma solicitação http solicitação http

isso não está otimizado, é muito lento; em vez disso, você pode usar a otimização abaixo:

recuperando manualmente o SOAPAction diretamente do WSDL (uma vez com seu navegador favorito).
use o método denominado requestURL em vez de requestWSDL sem extensão WSDL.