NSURLProtocolClient

NSURLProtocolClient протокол обеспечивает интерфейс, используемый NSURLProtocol подклассы для передачи с загрузочной системой URL. Приложение никогда не должно иметь потребности реализовать этот протокол.

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

Не применимый

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

NSObjectProtocol
NSObject

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.2 с установленным Safari 1.0.
Доступный в OS X v10.2.7 и позже.

Методы протокола


    
    URLProtocol (_: cachedResponseIsValid:)
    - URLProtocol:cachedResponseIsValid:

Требуемый

Отправленный, чтобы указать к загрузочной системе URL, что кэшируемый ответ допустим. (требуемый)

Объявление

Swift

func URLProtocol(_ `protocol`: NSURLProtocol, cachedResponseIsValid cachedResponse: NSCachedURLResponse)

Objective C

- (void)URLProtocol:(NSURLProtocol *)protocol cachedResponseIsValid:(NSCachedURLResponse *)cachedResponse

Параметры

`protocol`	Объект протокола URL отправка сообщения.
`cachedResponse`	Кэшируемый ответ, законность которого передается.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.2 с установленным Safari 1.0.

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


    
    URLProtocol (_: didCancelAuthenticationChallenge:)
    - URLProtocol:didCancelAuthenticationChallenge:

Требуемый

Отправленный, чтобы указать к загрузочной системе URL, что был отменен запрос аутентификации. (требуемый)

Объявление

Swift

func URLProtocol(_ `protocol`: NSURLProtocol, didCancelAuthenticationChallenge challenge: NSURLAuthenticationChallenge)

Objective C

- (void)URLProtocol:(NSURLProtocol *)protocol didCancelAuthenticationChallenge:(NSURLAuthenticationChallenge *)challenge

Параметры

`protocol`	Объект протокола URL отправка сообщения.
`challenge`	Отмененный запрос аутентификации.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.2 с установленным Safari 1.0.

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


    
    URLProtocol (_: didFailWithError:)
    - URLProtocol:didFailWithError:

Требуемый

Отправленный, когда запрос загрузки перестал работать вследствие ошибки. (требуемый)

Объявление

Swift

func URLProtocol(_ `protocol`: NSURLProtocol, didFailWithError error: NSError)

Objective C

- (void)URLProtocol:(NSURLProtocol *)protocol didFailWithError:(NSError *)error

Параметры

`protocol`	Объект протокола URL отправка сообщения.
`error`	Ошибка, вызвавшая отказ запроса загрузки.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.2 с установленным Safari 1.0.

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

URLProtocol (_: didLoadData:) - URLProtocol:didLoadData: Требуемый

NSURLProtocol разделяет экземпляр на подклассы, protocol, отправляет это сообщение в [protocol client] поскольку это загружается data. (требуемый)

Объявление

Swift

func URLProtocol(_ `protocol`: NSURLProtocol, didLoadData data: NSData)

Objective C

- (void)URLProtocol:(NSURLProtocol *)protocol didLoadData:(NSData *)data

Обсуждение

Объект данных должен содержать только новые данные, загруженные начиная с предыдущего вызова этого метода.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.2 с установленным Safari 1.0.
Доступный в OS X v10.2.7 и позже.


    
    URLProtocol (_: didReceiveAuthenticationChallenge:)
    - URLProtocol:didReceiveAuthenticationChallenge:

Требуемый

Отправленный, чтобы указать к загрузочной системе URL, что был получен запрос аутентификации. (требуемый)

Объявление

Swift

func URLProtocol(_ `protocol`: NSURLProtocol, didReceiveAuthenticationChallenge challenge: NSURLAuthenticationChallenge)

Objective C

- (void)URLProtocol:(NSURLProtocol *)protocol didReceiveAuthenticationChallenge:(NSURLAuthenticationChallenge *)challenge

Параметры

`protocol`	Объект протокола URL отправка сообщения.
`challenge`	Полученный запрос аутентификации.

Обсуждение

Клиент протокола гарантирует, что это ответит на запрос на том же потоке который названный этим методом. Клиент может добавить учетные данные по умолчанию к проблеме, которую они выпускают делегату соединения, если protocol не обеспечивал тот.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.2 с установленным Safari 1.0.

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


    
    URLProtocol (_: didReceiveResponse:cacheStoragePolicy:)
    - URLProtocol:didReceiveResponse:cacheStoragePolicy:

Требуемый

Отправленный, чтобы указать к загрузочной системе URL, что реализация протокола создала объект ответа для запроса. (требуемый)

Объявление

Swift

func URLProtocol(_ `protocol`: NSURLProtocol, didReceiveResponse response: NSURLResponse, cacheStoragePolicy policy: NSURLCacheStoragePolicy)

Objective C

- (void)URLProtocol:(NSURLProtocol *)protocol didReceiveResponse:(NSURLResponse *)response cacheStoragePolicy:(NSURLCacheStoragePolicy)policy

Параметры

`protocol`	Объект протокола URL отправка сообщения.
`response`	Недавно доступный объект ответа.
`policy`	Правило хранения кэша для ответа.

Обсуждение

Реализация должна использовать предоставленное правило хранения кэша, чтобы определить, сохранить ли ответ в кэше.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.2 с установленным Safari 1.0.

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


    
    URLProtocol (_: wasRedirectedToRequest:redirectResponse:)
    - URLProtocol:wasRedirectedToRequest:redirectResponse:

Требуемый

Отправленный, чтобы указать к загрузочной системе URL, что была перенаправлена реализация протокола. (требуемый)

Объявление

Swift

func URLProtocol(_ `protocol`: NSURLProtocol, wasRedirectedToRequest request: NSURLRequest, redirectResponse redirectResponse: NSURLResponse)

Objective C

- (void)URLProtocol:(NSURLProtocol *)protocol wasRedirectedToRequest:(NSURLRequest *)request redirectResponse:(NSURLResponse *)redirectResponse

Параметры

`protocol`	Объект протокола URL отправка сообщения.
`request`	Новый запрос, к которому был перенаправлен исходный запрос.
`redirectResponse`	Ответ от исходного запроса, вызвавшего перенаправление.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.2 с установленным Safari 1.0.

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

URLProtocolDidFinishLoading (_:) - URLProtocolDidFinishLoading: Требуемый

Отправленный, чтобы указать к загрузочной системе URL, что реализация протокола закончила загружаться. (требуемый)

Объявление

Swift

func URLProtocolDidFinishLoading(_ `protocol`: NSURLProtocol)

Objective C

- (void)URLProtocolDidFinishLoading:(NSURLProtocol *)protocol

Параметры

protocol

Объект протокола URL отправка сообщения.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.2 с установленным Safari 1.0.
Доступный в OS X v10.2.7 и позже.