NSURLHandle

NSURLHandle объявляет программируемый интерфейс для объекта, что доступы и управляют данными ресурсов, обозначенными NSURL объект. Сингл NSURLHandle может обслужить многократный эквивалент NSURL объекты, но только если этот URLs отображается на тот же ресурс.

Какао обеспечивает частные конкретные подклассы для обработки HTTP и схем URL файла. Если бы Вы хотите реализовать поддержку дополнительных схем URL, Вы сделали бы так путем создания подкласса NSURLHandle. Можно использовать NSURL и NSURLHandle загружать с Ftp-сайтов без разделения на подклассы.

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

NSObject
NSURLHandle

NSObject
NSURLHandle

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

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

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Построение NSURLHandles

cachedHandleForURL: + cachedHandleForURL: (OS X v10.4) и позже

Возвращает дескриптор URL из кэша, обслужившего указанный URL или другой идентичный URL.

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

+ (NSURLHandle *)cachedHandleForURL:(NSURL *)aURL

Параметры

aURL

URL, кэшируемый дескриптор URL которого желаем.

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

URL обрабатывает от обслужившего кэша aURL или другой идентичный URL. Возвраты nil если нет такого дескриптора.

Обсуждение

Подклассы NSURLHandle должен переопределить этот метод.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.


    
    initWithURL:cached:
    - initWithURL:cached:

(OS X v10.4) и позже

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

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

- (id)initWithURL:(NSURL *)aURL cached:(BOOL)willCache

Параметры

`aURL`	URL для нового дескриптора.
`willCache`	`YEStrue` если дескриптор URL должен кэшировать свои данные и реагировать на запросы от эквивалентного URLs для кэшированных данных, `NOfalse` иначе.

Обсуждение

Подклассы NSURLHandle должен переопределить этот метод.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.

Управление подклассами

URLHandleClassForURL: + URLHandleClassForURL: (OS X v10.4) и позже

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

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

+ (Class)URLHandleClassForURL:(NSURL *)aURL

Параметры

aURL

Рассматриваемый URL.

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

Класс дескриптора URL, который будет использоваться для aURL.

Обсуждение

Подклассы NSURLHandle должен быть зарегистрирован через registerURLHandleClass: метод. Подкласс определяется путем выяснения у списка зарегистрированных подклассов если это canInitWithURL:; первый класс для ответа YEStrue выбран.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.
canInitWithURL: + canInitWithURL: (OS X v10.4) и позже

Возвраты, может ли дескриптор URL быть инициализирован с данным URL.

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

+ (BOOL)canInitWithURL:(NSURL *)aURL

Параметры

aURL

Рассматриваемый URL.

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

YEStrue если дескриптор URL может быть инициализирован с aURL, NOfalse иначе.

Обсуждение

Подклассы NSURLHandle должен переопределить этот метод для идентификации, который URLs они могут обслужить.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.
registerURLHandleClass: + registerURLHandleClass: (OS X v10.4) и позже

Регистрирует подкласс NSURLHandle как доступный подкласс для обработки URLs

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

+ (void)registerURLHandleClass:(Class)aURLHandleSubclass

Параметры

aURLHandleSubclass

Новый подкласс для регистрации как доступный подкласс.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.

Управление клиентами

addClient: - addClient: (OS X v10.4) и позже

Добавляет клиент дескриптора URL.

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

- (void)addClient:(id<NSURLHandleClient>)client

Параметры

client

Объект, соответствующий NSURLHandleClient протокол.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.
removeClient: - removeClient: (OS X v10.4) и позже

Удаляет client как NSURLHandleClient из получателя.

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

- (void)removeClient:(id<NSURLHandleClient>)client

Параметры

client

Объект, соответствующий NSURLHandleClient протокол.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.

Установка и получение свойств ресурса

propertyForKey: - propertyForKey: (OS X v10.4) и позже

Возвращает свойство для указанного ключа.

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

- (id)propertyForKey:(NSString *)propertyKey

Параметры

propertyKey

Ключ желаемого свойства.

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

Значение связалось с propertyKey. Возвраты nil если нет такого ключа.

Обсуждение

Подклассы NSURLHandle должны переопределить этот метод.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.

См. также

– writeProperty:forKey:
– propertyForKeyIfAvailable:
propertyForKeyIfAvailable: - propertyForKeyIfAvailable: (OS X v10.4) и позже

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

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

- (id)propertyForKeyIfAvailable:(NSString *)propertyKey

Параметры

propertyKey

Ключ желаемого свойства.

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

Значение связалось с propertyKey. Возвраты nil если клиент должен был бы выполнить работу для выборки свойства, если бы нет такого ключа или.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.


    
    writeProperty:forKey:
    - writeProperty:forKey:

(OS X v10.4) и позже

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

Оператор осуждения

Объявление

Objective C

- (BOOL)writeProperty:(id)propertyValue forKey:(NSString *)propertyKey

Параметры

`propertyValue`	Новое значение для свойства.
`propertyKey`	Ключ желаемого свойства.

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

YEStrue если модификация была успешна, NOfalse иначе.

Обсуждение

Должен быть переопределен подклассами.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.

См. также

– propertyForKey:

Загрузка данных ресурсов

availableResourceData - availableResourceData (OS X v10.4) и позже

Сразу возвращает данные в настоящее время доступного ресурса, которыми управляет дескриптор URL.

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

- (NSData *)availableResourceData

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

Данные в настоящее время доступного ресурса, которыми управляет дескриптор URL. Возвраты nil если предыдущая попытка загрузить данные перестала работать.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.


    
    backgroundLoadDidFailWithReason:
    - backgroundLoadDidFailWithReason:

(OS X v10.4) и позже

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

Оператор осуждения

Объявление

Objective C

- (void)backgroundLoadDidFailWithReason:(NSString *)reason

Параметры


      reason

Сообщение о состоянии, указывающее, почему фоновая загрузка перестала работать.

Обсуждение

Этот метод предоставлен в основном для подклассов, хотящих принять некоторые меры перед проведением уведомления отказа клиенту URL. Этот метод должен вызвать superреализация перед возвратом.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.

beginLoadInBackground - beginLoadInBackground (OS X v10.4) и позже

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

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

- (void)beginLoadInBackground

Обсуждение

Этот метод предоставлен в основном для подклассов, хотящих использовать в своих интересах механизм создания отчетов отказа суперкласса.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.

См. также

– endLoadInBackground
– loadInBackground
cancelLoadInBackground - cancelLoadInBackground (OS X v10.4) и позже

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

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

- (void)cancelLoadInBackground

Обсуждение

Этот метод предоставлен в основном для подклассов, хотящих принять некоторые меры, прежде чем будет отменена фоновая загрузка. Этот метод должен вызвать superреализация перед возвратом.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.

См. также

– endLoadInBackground


    
    didLoadBytes:loadComplete:
    - didLoadBytes:loadComplete:

(OS X v10.4) и позже

Добавляет новые данные к данным ресурсов получателя.

Оператор осуждения

Объявление

Objective C

- (void)didLoadBytes:(NSData *)newBytes loadComplete:(BOOL)done

Параметры

`newBytes`	Недавно загруженные байты.
`done`	`YEStrue` если newBytes содержит последнюю часть данных для URL, `NOfalse` иначе.

Обсуждение

Необходимо вызвать этот метод при загрузке данных ресурсов в фоновом режиме.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.

См. также

– loadInBackground

endLoadInBackground - endLoadInBackground (OS X v10.4) и позже

Остановы любая фоновая загрузка.

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

- (void)endLoadInBackground

Обсуждение

Этим методом вызывают cancelLoadInBackground.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.

См. также

– beginLoadInBackground
– cancelLoadInBackground
– loadInBackground
expectedResourceDataSize - expectedResourceDataSize (OS X v10.4) и позже

Возвращает ожидаемую продолжительность данных ресурсов, если это предоставлено сервером.

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

- (long long)expectedResourceDataSize

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

Ожидаемый размер данных ресурсов, в байтах. Отрицательная величина, если длина неизвестна.

Обсуждение

Эта информация может быть запрошена, прежде чем все данные поступили.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.
Доступный в OS X v10.3 и позже.
failureReason - failureReason (OS X v10.4) и позже

Возвращает строку, описывающую причину отказавшая загрузка.

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

- (NSString *)failureReason

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

Строка, описывающая причину загрузка, перестала работать. Если загрузка не перестала работать, возвраты nil.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.
flushCachedData - flushCachedData (OS X v10.4) и позже

Сбросы любые кэшированные данные для URL, подаваемого этим дескриптором URL.

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

- (void)flushCachedData

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.
loadInBackground - loadInBackground (OS X v10.4) и позже

Загружает данные получателя в фоновом режиме.

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

- (void)loadInBackground

Обсуждение

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

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.

См. также

– beginLoadInBackground
loadInForeground - loadInForeground (OS X v10.4) и позже

Загружает данные получателя синхронно.

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

- (NSData *)loadInForeground

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

Загруженные данные.

Обсуждение

Вызванный resourceData. Подклассы NSURLHandle должны переопределить этот метод.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.
resourceData - resourceData (OS X v10.4) и позже

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

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

- (NSData *)resourceData

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

Данные ресурсов, которыми управляет получатель.

Обсуждение

Блоки до всех данных доступны.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.
состояние - состояние (OS X v10.4) и позже

Возвращает состояние получателя.

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

- (NSURLHandleStatus)status

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

Состояние получателя. Возможные статусы возврата описаны в Константах.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.

Запись данных ресурсов

writeData: - writeData: (OS X v10.4) и позже

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

Оператор осуждения

Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.

Объявление

Objective C

- (BOOL)writeData:(NSData *)data

Параметры

data

Данные для записи.

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

YEStrue в случае успеха, NOfalse иначе.

Обсуждение

Должен быть переопределен подклассами.

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

Objective C

@import Foundation;

Доступность

Осуждаемый в OS X v10.4 и позже.

Типы данных

NSURLHandleStatus NSURLHandleStatus
Эти после констант определяются NSURLHandle и возвращаются status.

Объявление

Swift

enum NSURLHandleStatus : UInt { case NotLoaded case LoadSucceeded case LoadInProgress case LoadFailed }

Objective C

typedef enum { NSURLHandleNotLoaded = 0, NSURLHandleLoadSucceeded, NSURLHandleLoadInProgress, NSURLHandleLoadFailed } NSURLHandleStatus;

Константы
- NotLoaded
  
  NSURLHandleNotLoaded
  
  Данные ресурсов не были загружены.
  Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.
  
  Доступный в OS X v10.0 и позже.
- LoadSucceeded
  
  NSURLHandleLoadSucceeded
  
  Данные ресурсов были успешно загружены.
  Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.
  
  Доступный в OS X v10.0 и позже.
- LoadInProgress
  
  NSURLHandleLoadInProgress
  
  Данные ресурсов находятся в процессе загрузки.
  Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.
  
  Доступный в OS X v10.0 и позже.
- LoadFailed
  
  NSURLHandleLoadFailed
  
  Данным ресурсов не удалось загрузиться.
  Использовать NSURLConnection или NSURLDownload вместо этого; см. Руководство по программированию Загрузочной системы URL.
  
  Доступный в OS X v10.0 и позже.
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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