SLRequest

SLRequest объект инкапсулирует свойства Запроса HTTP, предоставляя удобный шаблон Вам для подачи с запросами. Вы отправляете запрос к службе социальной сети, чтобы выполнить некоторую работу от имени пользователя или получить информацию о пользователе.

Запросы HTTP имеют эти общие компоненты: метод Запроса HTTP (GET, POST, PUT или DELETE), URL, идентифицирующий работу для выполнения, ряд параметров запроса и дополнительной многослойной организации POST, содержащей дополнительные данные. Значения для этих свойств зависят от запроса, который Вы отправляете и целевой поставщик услуг. Обратитесь к документации каждого поддерживаемого сайта социальной сети для возможных значений. Ссылки к документации предоставлены в Таблице 1.

Используйте requestForServiceType:requestMethod:URL:parameters: метод для инициализации недавно создаваемый SLRequest передача объектов требуемые значения свойств. Используйте addMultipartData:withName:type: дополнительно указать многослойную организацию POST. После создания запроса используйте performRequestWithHandler: метод для отправления запроса, указывая обработчик для вызова, когда сделан запрос.

Если у Вас уже есть передающий механизм, можно использовать preparedURLRequest метод для создания запроса, что Вы отправляете использование NSURLConnection объект. Если запрос требует авторизации пользователя, установите account свойство к ACAccount объект.

**Табличные 1** сайты документации частного лица социального обеспечения
Facebook	https://developers.facebook.com/docs/
Sina Weibo	http://open .weibo.com/wiki/
Twitter	https://dev.twitter.com/docs
LinkedIn	https://developer.linkedin.com/rest

Наследование

NSObject
SLRequest

NSObject
SLRequest

Соответствует

AnyObject
CVarArgType
Equatable
Hashable
NSObjectProtocol
Печатаемый
NSObject

Оператор импорта

Swift

import Social

Objective C

@import Social;

Доступность

Доступный в OS X v10.8 и позже.

Инициализация запросов


    
    init (forServiceType:requestMethod:URL:parameters:)
    + requestForServiceType:requestMethod:URL:parameters:

Инициализирует недавно создаваемый объект запроса с указанными свойствами.

Объявление

Swift

init!(forServiceType serviceType: String!, requestMethod requestMethod: SLRequestMethod, URL url: NSURL!, parameters parameters: [NSObject : AnyObject]!) -> SLRequest

Objective C

+ (SLRequest *)requestForServiceType:(NSString *)serviceType requestMethod:(SLRequestMethod)requestMethod URL:(NSURL *)url parameters:(NSDictionary *)parameters

Параметры

`serviceType`	Тип службы социальной сети. Для возможных значений посмотрите Константы Типа Службы.
`requestMethod`	Метод для использования для этого Запроса HTTP. Для возможных значений посмотрите SLRequestMethod.
`url`	Целевой URL для этого Запроса HTTP. Значения и форматирующий для URL зависят от целевой службы и документируются поставщиком услуг. Для ссылок к документации для поддерживаемых служб посмотрите Таблицу 1.
`parameters`	Параметры для этого Запроса HTTP. Значения и форматирование зависят от целевой службы и документируются поставщиком услуг. Для ссылок к документации для поддерживаемых служб посмотрите Таблицу 1.

Возвращаемое значение

Недавно инициализированный объект запроса.

Обсуждение

Используйте этот метод для инициализации SLRequest. Значение и форматирование каждого параметра зависят от целевой службы.

Оператор импорта

Objective C

@import Social;

Swift

import Social

Доступность

Доступный в OS X v10.8 и позже.

Доступ к свойствам

учетная запись учетная запись Свойство

Сведения об аккаунте раньше аутентифицировали запрос.

Объявление

Swift

var account: ACAccount!

Objective C

@property(retain, nonatomic) ACAccount *account

Обсуждение

Учетная запись используется, чтобы подписать запрос со службами OAuth1 или добавить маркер доступа для служб OAuth2. Путем соединения учетной записи с запросом необходимые маркеры добавляются автоматически. Значение по умолчанию nil.

Оператор импорта

Objective C

@import Social;

Swift

import Social

Доступность

Доступный в OS X v10.8 и позже.
requestMethod requestMethod Свойство

Метод для использования для этого запроса. (только для чтения)

Объявление

Swift

var requestMethod: SLRequestMethod { get }

Objective C

@property(readonly, nonatomic) SLRequestMethod requestMethod

Обсуждение

Используйте это свойство для поиска метода Запроса HTTP, установленного в requestForServiceType:requestMethod:URL:parameters:. Возможные значения описаны в SLRequestMethod.

Оператор импорта

Objective C

@import Social;

Swift

import Social

Доступность

Доступный в OS X v10.8 и позже.
URL URL Свойство

Целевой URL для этого запроса. (только для чтения)

Объявление

Swift

var URL: NSURL! { get }

Objective C

@property(readonly, nonatomic) NSURL *URL

Обсуждение

Используйте это свойство для поиска URL Запроса HTTP, установленного в requestForServiceType:requestMethod:URL:parameters:. Возможные значения зависят от целевой службы и документируются поставщиком услуг. Для ссылок к документации для поддерживаемых служб посмотрите Таблицу 1.

Оператор импорта

Objective C

@import Social;

Swift

import Social

Доступность

Доступный в OS X v10.8 и позже.
параметры параметры Свойство

Параметры для этого запроса. (только для чтения)

Объявление

Swift

var parameters: [NSObject : AnyObject]! { get }

Objective C

@property(readonly, nonatomic) NSDictionary *parameters

Обсуждение

Используйте это свойство для поиска параметров запроса Запроса HTTP, установленного в requestForServiceType:requestMethod:URL:parameters:. Возможные значения зависят от целевой службы и документируются поставщиком услуг. Для ссылок к документации для поддерживаемых служб посмотрите Таблицу 1.

Оператор импорта

Objective C

@import Social;

Swift

import Social

Доступность

Доступный в OS X v10.8 и позже.

Отправление запросов


    
    performRequestWithHandler (_:)
    - performRequestWithHandler:

Выполняет асинхронный запрос и вызывает указанный обработчик, когда сделано.

Объявление

Swift

func performRequestWithHandler(_ handler: SLRequestHandler!)

Objective C

- (void)performRequestWithHandler:(SLRequestHandler)handler

Параметры


      handler

Обработчик для вызова, когда сделан запрос. Параметры для этого обработчика описаны в SLRequestHandler. Этот обработчик, как гарантируют, не вызовут ни на каком определенном потоке и не должен быть нолем.

Оператор импорта

Objective C

@import Social;

Swift

import Social

Доступность

Доступный в OS X v10.8 и позже.

preparedURLRequest () - preparedURLRequest

Возвращает авторизованный URL-запрос, который может быть отправлен с помощью NSURLConnection объект.

Объявление

Swift

func preparedURLRequest() -> NSURLRequest!

Objective C

- (NSURLRequest *)preparedURLRequest

Возвращаемое значение

Совместимое с OAuth NSURLRequest объект, позволяющий приложению действовать от имени пользователя при хранении пароля пользователя частным. NSURLRequest подписывается как OAuth1 по умолчанию или OAuth2 путем добавления надлежащего маркера на основе учетной записи пользователя.

Обсуждение

Используйте этот метод для изменения запроса перед отправкой. Путем установки учетной записи правильно, этот метод автоматически добавит любые необходимые маркеры.

Оператор импорта

Objective C

@import Social;

Swift

import Social

Доступность

Доступный в OS X v10.8 и позже.


    
    addMultipartData:withName:type:
    - addMultipartData:withName:type:

(OS X v10.8)

Указывает именованную многослойную организацию POST для этого запроса.

Объявление

Objective C

- (void)addMultipartData:(NSData *)data withName:(NSString *)name type:(NSString *)type

Параметры

`data`	Данные для многослойной организации POST, такой как изображение или текст.
`name`	Имя многослойной организации POST. Это - имя, которое ожидает определенное социальное обеспечение.
`type`	Тип многослойной организации POST. Это - тип контента MIME многослойных данных.

Обсуждение

Возможные значения параметров зависят от целевой службы. Эта информация, а также руководство на том, когда использовать многослойную организацию POST, документируется поставщиком услуг. Для ссылок к документации для поддерживаемых служб посмотрите Таблицу 1.

Оператор импорта

Objective C

@import Social;

Доступность

Доступный в OS X v10.8 и позже.

Осуждаемый в OS X v10.8.


    
    addMultipartData (_: withName:type:filename:)
    - addMultipartData:withName:type:filename:

Указывает именованную многослойную организацию POST для этого запроса.

Объявление

Swift

func addMultipartData(_ data: NSData!, withName name: String!, type type: String!, filename filename: String!)

Objective C

- (void)addMultipartData:(NSData *)data withName:(NSString *)name type:(NSString *)type filename:(NSString *)filename

Параметры

`data`	Данные для многослойной организации POST, такой как изображение или текст.
`name`	Имя многослойной организации POST. Это - имя, которое ожидает определенное социальное обеспечение.
`type`	Тип многослойной организации POST. Это - тип контента MIME многослойных данных.
`filename`	Имя файла присоединения, которое Вы хотите к POST. Много социального обеспечения требуют имени файла для принятия определенных запросов POST, таких как загрузка изображения или видео. Если Ваши многослойные данные не требуют имени файла, передачи в `nil`.

Обсуждение

Оператор импорта

Objective C

@import Social;

Swift

import Social

Доступность

Доступный в OS X v10.8 и позже.

Типы данных


      
      SLRequestHandler
      SLRequestHandler

Обработчик обратного вызова для запроса.

Объявление

Swift

typealias SLRequestHandler = (NSData!, NSHTTPURLResponse!, NSError!) -> Void

Objective C

typedef void(^SLRequestHandler)(NSData *responseData, NSHTTPURLResponse *urlResponse, NSError *error);

Обсуждение

Параметры для этого обработчика:

`responseData`	Данные, возвращенные запросом. Формат этих данных зависит от целевой службы.
`urlResponse`	Ответ URL, возвращенный запросом, включающим Коды ответа HTTP.
`error`	Ошибочный идентификатор.

Возможные значения зависят от целевой службы и документируются поставщиком услуг. Для ссылок к документации для поддерживаемых служб посмотрите Таблицу 1.

Оператор импорта

Objective C

@import Social;

Swift

import Social

Доступность

Доступный в OS X v10.8 и позже.

Константы

Константы типа службы
Возможные значения для serviceType параметр.

Объявление

Swift

let SLServiceTypeFacebook: NSString! let SLServiceTypeTwitter: NSString! let SLServiceTypeSinaWeibo: NSString! let SLServiceTypeLinkedIn: NSString! let SLServiceTypeTencentWeibo: NSString!

Objective C

NSString *const SLServiceTypeFacebook; NSString *const SLServiceTypeTwitter; NSString *const SLServiceTypeSinaWeibo; NSString *const SLServiceTypeLinkedIn; NSString *const SLServiceTypeTencentWeibo;

Константы
- SLServiceTypeFacebook
  
  SLServiceTypeFacebook
  
  Строковая константа, идентифицирующая сайт социальной сети, Facebook.
  
  Доступный в OS X v10.8 и позже.
- SLServiceTypeTwitter
  
  SLServiceTypeTwitter
  
  Строковая константа, идентифицирующая сайт социальной сети, Twitter.
  
  Доступный в OS X v10.8 и позже.
- SLServiceTypeSinaWeibo
  
  SLServiceTypeSinaWeibo
  
  Строковая константа, идентифицирующая сайт социальной сети, Sina Weibo.
  
  Доступный в OS X v10.8 и позже.
- SLServiceTypeLinkedIn
  
  SLServiceTypeLinkedIn
  
  Строковая константа, идентифицирующая сайт социальной сети, LinkedIn.
  
  Доступный в OS X v10.9 и позже.
- SLServiceTypeTencentWeibo
  
  SLServiceTypeTencentWeibo
  
  Строковая константа, идентифицирующая сайт социальной сети, Tencent Weibo.
  
  Доступный в OS X v10.9 и позже.
SLRequestMethod
Указывает метод запроса, используемый в запросе.

Объявление

Swift

enum SLRequestMethod : Int { case GET case POST case DELETE case PUT }

Objective C

typedef NS_ENUM (NSInteger, SLRequestMethod ) { SLRequestMethodGET, SLRequestMethodPOST, SLRequestMethodDELETE, SLRequestMethodPUT; };

Константы
- GET
  
  SLRequestMethodGET
  
  Запрашивает информацию от указанного ресурса. Используйте запрос GET для выборки информации от указанного сервера, такого как символьные пределы или временная шкала пользователя.
  
  Доступный в OS X v10.8 и позже.
- POST
  
  SLRequestMethodPOST
  
  Представляет данные, которые будут обработаны. Используйте запрос POST для представления информации к указанному серверу, такому как обновление статуса или изображение.
  
  Доступный в OS X v10.8 и позже.
- DELETE
  
  SLRequestMethodDELETE
  
  Удаляет указанный ресурс.
  
  Доступный в OS X v10.8 и позже.
- PUT
  
  SLRequestMethodPUT
  
  Использует запрос PUT для представления данных.
  
  Доступный в OS X v10.9 и позже.
Обсуждение

Используйте эту константу для установки requestMethod свойство. Тип запроса для использования зависит от целевой службы. Для ссылок к документации для поддерживаемых служб посмотрите Таблицу 1.

Оператор импорта

Objective C

@import Social;

Swift

import Social

Доступность

Доступный в OS X v10.8 и позже.