NSClassDescription

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

Важно отметить, что нет никаких описаний класса по умолчанию. Использовать NSClassDescription объекты в Вашем коде необходимо реализовать их для классов модели. Для всех конкретных подклассов необходимо обеспечить реализации для всех методов экземпляра NSClassDescription. (NSClassDescription обеспечивает только реализацию для методов класса, поддерживающих кэш зарегистрированных описаний класса.) Когда-то создаваемый, необходимо зарегистрировать описание класса в NSClassDescription метод registerClassDescription:forClass:.

Можно использовать NSString объекты в массивах, возвращенных методами, такими как attributeKeys и toManyRelationshipKeys к доступу — использующий кодирование значения ключа — свойства экземпляра класса, которому соответствует объект описания класса. Для больше об атрибутах и отношениях, посмотрите Фундаментальное Руководство по Какао. Для больше о кодировании значения ключа, посмотрите, что Значение ключа Кодирует Руководство по программированию.

NSScriptClassDescription, то, которое используется для отображения отношений между scriptable классами, является единственным конкретным подклассом NSClassDescription если как часть платформы Какао.

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

NSObject
NSClassDescription
NSScriptClassDescription

NSObject
NSClassDescription
NSScriptClassDescription

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

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

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Работа с описаниями класса


    
    init (forClass:)
    + classDescriptionForClass:

Возвращает описание класса для данного класса.

Объявление

Swift

init?(forClass aClass: AnyClass!) -> NSClassDescription

Objective C

+ (NSClassDescription *)classDescriptionForClass:(Class)aClass

Параметры


      aClass

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

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

Описание класса для aClass, или nil если не может быть найдено описание класса.

Обсуждение

Если описание класса для aClass не найден, метод отправляет NSClassDescriptionNeededForClassNotification от имени aClass, разрешение наблюдателю зарегистрировать описание класса. Метод тогда проверяет на описание класса снова. Возвраты nil если все еще не найдено описание класса.

Если у Вас есть экземпляр класса получателя, можно использовать NSObject метод экземпляра classDescription вместо этого.

Примечание:

На OS X v 10.6 и позже, этот метод (и в результате classDescription методы любого объекта), возвратится nil когда sdef содержит нет <class> элемент для класса Какао, но существует a <class> элемент определяется для суперкласса.

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

Эта ситуация может оказать серьезное влияние на Сценарии Какао, и нет никакого плана по изменению этого поведения.

Вместо того, чтобы использовать этот метод, необходимо использовать classDescriptionForClass: метод NSScriptClassDescription вместо этого.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

invalidateClassDescriptionCache () + invalidateClassDescriptionCache

Удаляет все NSClassDescription объекты от кэша.

Объявление

Swift

class func invalidateClassDescriptionCache()

Objective C

+ (void)invalidateClassDescriptionCache

Обсуждение

Необходимо редко должны быть вызвать этот метод. Используйте его каждый раз, когда зарегистрированное NSClassDescription объект мог бы быть заменен различной версией, такой как тогда, когда Вы загрузили нового провайдера NSClassDescription объекты, или когда Вы собираетесь удалить провайдера NSClassDescription объекты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    registerClassDescription (_: forClass:)
    + registerClassDescription:forClass:

Регистры NSClassDescription объект для поданного классифицирует NSClassDescription кэш.

Объявление

Swift

class func registerClassDescription(_ description: NSClassDescription, forClass aClass: AnyClass)

Objective C

+ (void)registerClassDescription:(NSClassDescription *)description forClass:(Class)aClass

Параметры

`description`	Описание класса для регистрации.
`aClass`	Класс, для которого можно зарегистрироваться `description`.

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Ключи атрибута

attributeKeys - attributeKeys

Переопределенный подклассами для возврата имен атрибутов экземпляров описанного класса.

Объявление

Swift

var attributeKeys: [AnyObject] { get }

Objective C

@property(readonly, copy) NSArray *attributeKeys

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

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

Обсуждение

Например, описание класса, описывающее Объекты видеоклипа, могло возвратить ключи атрибута title, dateReleased, и rating.

Если у Вас есть экземпляр класса, получатель описывает, можно использовать NSObject метод экземпляра attributeKeys вместо этого.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– toManyRelationshipKeys
– toOneRelationshipKeys

Ключи отношения

inverseForRelationshipKey (_:) - inverseForRelationshipKey:
Переопределенный подклассами для возврата имени обратной связи от отношения, указанного данным ключом.

Объявление

Swift

func inverseForRelationshipKey(_ relationshipKey: String) -> String?

Objective C

- (NSString *)inverseForRelationshipKey:(NSString *)relationshipKey

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

Имя обратной связи от отношения, указанного relationshipKey.
Обсуждение

Для данного ключа, определяющего имя отношения от класса получателя до другого класса, возвращает имя отношения от другого класса до класса получателя. Например, предположите, что классу Сотрудника назвали отношение department к классу Отдела и тому Отделу назвали отношение employees Сотруднику. Оператор:
[employee inverseForRelationshipKey:@"department"];
возвращает строку employees.

Если у Вас есть экземпляр класса, получатель описывает, можно использовать NSObject метод экземпляра inverseForRelationshipKey: вместо этого.
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Переопределенный подклассами для возврата ключей для к - много свойств отношения экземпляров описанного класса.

Объявление

Swift

var toManyRelationshipKeys: [AnyObject] { get }

Objective C

@property(readonly, copy) NSArray *toManyRelationshipKeys

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

Массив NSString объекты, содержащие имена к - много свойств отношения экземпляров описанного класса.

Обсуждение

К - много свойств отношения являются массивами объектов.

Если у Вас есть экземпляр класса, получатель описывает, можно использовать NSObject метод экземпляра toManyRelationshipKeys вместо этого.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– attributeKeys
– toOneRelationshipKeys
toOneRelationshipKeys - toOneRelationshipKeys

Переопределенный подклассами для возврата ключей для к - свойства отношения экземпляров описанного класса.

Объявление

Swift

var toOneRelationshipKeys: [AnyObject] { get }

Objective C

@property(readonly, copy) NSArray *toOneRelationshipKeys

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

Массив NSString объекты, содержащие имена к - свойства отношения экземпляров описанного класса.

Обсуждение

К - свойства отношения являются отдельными объектами.

Если у Вас есть экземпляр класса, получатель описывает, можно использовать NSObject метод экземпляра toOneRelationshipKeys вместо этого.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– attributeKeys
– toManyRelationshipKeys

Уведомления

NSClassDescriptionNeededForClassNotification NSClassDescriptionNeededForClassNotification

Отправленный classDescriptionForClass: когда описание класса не может быть найдено для класса.
После того, как уведомление обрабатывается, classDescriptionForClass: проверки на описание класса снова. Эта проверка позволяет наблюдателю регистрировать описания класса лениво. Даже если описание класса остается неопределенным, уведомление отправляется только один раз для любого данного класса.
Объект уведомления является объектом класса, на который требуют описание класса. Это уведомление не содержит a userInfo словарь.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

NSClassDescription

Работа с описаниями класса

Объявление

Параметры

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

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность

Объявление

Параметры

Обсуждение

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

Доступность

Ключи атрибута

Объявление

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

Обсуждение

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

Доступность

См. также

Ключи отношения

Объявление

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

Обсуждение

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

Доступность

Объявление

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

Обсуждение

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

Доступность

См. также

Объявление

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

Обсуждение

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

Доступность

См. также

Уведомления

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

Доступность