Загрузка SOAPEngine - Загрузка исходного кода SOAPEngine

SOAPEngine

Этот универсальный клиент SOAP позволяет вам получать доступ к веб-сервисам с помощью приложения iOS, приложения Mac OS X и приложения Apple TV.

С помощью этой платформы вы можете создавать приложения для iPhone, iPad, Mac OS X и Apple TV, поддерживающие клиентский протокол SOAP. Эта платформа способна выполнять методы удаленных веб-сервисов по стандартному протоколу SOAP.

Функции

Поддержка XML-схем 2001 (v1.1) и 2003 (v1.2).
Поддержка массива, массива структур, словаря и наборов.
Поддержка пользовательских объектов с сериализацией сложных типов данных и массивов сложных типов данных, даже встроенных многоуровневых структур.
Поддерживает службы ASMX, службы WCF (SVC), а теперь и определения WSDL.
Поддерживает базовую, дайджест- и NTLM-аутентификацию, WS-Security, сертификат на стороне клиента и настраиваемый заголовок безопасности.
Поддерживает социальную учетную запись iOS для отправки токена OAuth2.0 по запросу.
Шифрование/дешифрование данных AES256 или 3DES без защиты SSL.
Пример сервиса и способы его использования включены в исходный код.

Требования для iOS

iOS 8.0 и более поздние версии
Xcode 8.0 или новее
Security.framework
Аккаунты.framework
Foundation.framework
UIKit.framework
libxml2.dylib

Требования для Mac OS X

ОС X 10.9 и более поздние версии
Xcode 8.0 или новее
Security.framework
Аккаунты.framework
Foundation.framework
AppKit.framework
Какао.фреймворк
libxml2.dylib

Требования к Apple TV

iOS 9.0 и более поздние версии
Xcode 8.0 или новее
Security.framework
Foundation.framework
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 значение по умолчанию в настройках сборки цели. но это еще не все ; классы, используемые для создания запросов, должны быть объявлены с помощью @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 как логическое значение и установите для него значение YES, как показано на следующем рисунке.

NSAppTransportSecurity

ссылка: 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 )
	}
}

с блочным программированием :

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 :

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 " ;

Параметры с атрибутами :

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

он создает такой запрос:

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

Оптимизации

Прежде всего, если вы заметили замедление ответа на запрос, попробуйте изменить значение свойства с именем actionNamespaceSlash . После этого при использовании метода с именем requestWSDL выполняются три шага:

получить WSDL с помощью http-запроса
обработка для идентификации мылаAction
вызывает метод с помощью http-запроса http-запроса

это не оптимизировано, очень медленно, вместо этого вы можете использовать оптимизацию ниже:

получение SOAPAction вручную непосредственно из WSDL (один раз с помощью вашего любимого браузера).
используйте метод с именем requestURL вместо requestWSDL без расширения WSDL.