Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка класса PSClient

Опции
Развертывание Target:

На этой странице
Язык:

PSClient

A PSClient объект представляет клиент API, имеющего его собственный набор подачи. PSClient является магистралью платформы Подписки Публикации. Для подписки на подачу приложение должно использовать объект клиента. Можно тогда добавить подачу к Базе данных PubSub с addFeed: и addFeedWithURL: методы. Точно так же можно отписаться от канала с removeFeed: метод. Не рекомендуется разделить на подклассы PSClient.

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


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


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


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

Objective C

@import PubSub;

Доступность


Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
  • addFeed: - addFeed: (OS X v10.9)

    Подписывает клиент на данный канал.

    Объявление

    Objective C

    - (BOOL)addFeed:(PSFeed *)feed

    Параметры

    feed

    Существующий канал возражает для подписки на.

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

    YEStrue на успехе; NOfalse если произошла непосредственная ошибка.

    Обсуждение

    Объект канала может только принадлежать одному клиенту, поэтому если данный канал был уже добавлен к какому-либо другому клиенту, этот метод перестанет работать. Вместо этого создайте новый объект канала с тем же URL как существующий или использование addFeedWithURL:.

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

    Objective C

    @import PubSub;

    Доступность

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

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

  • Подписывает клиент на канал в данном URL.

    Объявление

    Objective C

    - (PSFeed *)addFeedWithURL:(NSURL *)url

    Параметры

    url

    URL канала. Должен быть HTTP, HTTPS, или FEED протокол.

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

    Подписанный канал, или nil если произошла ошибка.

    Обсуждение

    Этот метод создает подписанный канал из данного URL. Если канал с этим URL уже подписан, этот метод возвращает объект канала из существующих данных в Базе данных PubSub.

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

    Objective C

    @import PubSub;

    Доступность

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

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

  • Возвращает запись с данным идентификатором.

    Объявление

    Objective C

    - (PSEntry *)entryWithIdentifier:(NSString *)identifier

    Параметры

    identifier

    Уникальная строка связалась с записью.

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

    Запись связалась с указанным идентификатором, или nil если идентификатор не находится в подписанном канале.

    Обсуждение

    Идентификаторы записи являются персистентными, уникальными, и неизменными, таким образом, они обеспечивают путь к Вашему приложению для установления персистентной ссылки на запись. Этот метод считает только записи в подаче подписанными на этим клиентом.

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

    Objective C

    @import PubSub;

    Доступность

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

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

  • Возвращает канал с указанным идентификатором.

    Объявление

    Objective C

    - (PSFeed *)feedWithIdentifier:(NSString *)identifier

    Параметры

    identifier

    Уникальная строка связалась с каналом.

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

    Канал связался с указанным идентификатором, или nil если клиент не подписан на канал, связанный с этим идентификатором.

    Обсуждение

    Идентификаторы канала являются персистентными, уникальными, и неизменными, таким образом, они обеспечивают путь к Вашему приложению для установления персистентной ссылки на канал. Этот метод считает только подачу подписанной на этим клиентом.

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

    Objective C

    @import PubSub;

    Доступность

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

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

  • Возвращает подписанный канал с данным URL.

    Объявление

    Objective C

    - (PSFeed *)feedWithURL:(NSURL *)url

    Параметры

    url

    URL канала.

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

    Канал от данного URL.

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

    Objective C

    @import PubSub;

    Доступность

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

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

  • removeFeed: - removeFeed: (OS X v10.9)

    Отписывает клиент от канала.

    Объявление

    Objective C

    - (BOOL)removeFeed:(PSFeed *)feed

    Параметры

    feed

    Канал, который будет удален.

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

    YEStrue если отписан клиент; NOfalse если произошла ошибка.

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

    Objective C

    @import PubSub;

    Доступность

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

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

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

    Объявление

    Objective C

    - (void)sendChangesSinceDate:(NSDate *)dateLastUpdated

    Параметры

    dateLastUpdated

    Дата, после которой Вы хотите отправленные изменения.

    Обсуждение

    Некоторые клиенты могут принять решение связать свои данные с различными экземплярами Подписки Публикации. Когда клиент не работает, так как подача и статьи могут измениться dateLastUpdated и sendChangesSinceDate: необходимы для поддержания синхронизируемого состояния. Типичная дата, переданная этому методу, является значением, возвращенным dateLastUpdated метод как раз перед приложением завершен.

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

    Objective C

    @import PubSub;

    Доступность

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

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

  • Возвращает список идентификаторов пакета для клиентов, зарегистрировавшихся в Агенте PubSub.

    Объявление

    Objective C

    + (NSArray *)allClientBundleIdentifiers

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

    Массив строковых объектов, содержащих идентификаторы пакета клиентов, зарегистрировался в Агенте PubSub.

    Обсуждение

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

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

    Objective C

    @import PubSub;

    Доступность

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

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

  • Создает экземпляр по умолчанию для текущего приложения.

    Объявление

    Objective C

    + (PSClient *)applicationClient

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

    Объект клиента для текущего приложения.

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

    Objective C

    @import PubSub;

    Доступность

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

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

  • Создает клиент для указанного идентификатора пакета.

    Объявление

    Objective C

    + (PSClient *)clientForBundleIdentifier:(NSString *)bundleIdentifier

    Параметры

    bundleIdentifier

    Идентификатор пакета клиента Вы хотите проверить.

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

    Объект клиента для указанного идентификатора пакета.

    Обсуждение

    Этот метод должен использоваться приложениями, хотящими проверить подписки других приложений или комплектом приложений, хотящих использовать совместно используемый клиент подписки. Если необходимо создать клиент для текущего приложения, использовать applicationClient вместо этого.

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

    Objective C

    @import PubSub;

    Доступность

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

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

  • подпись подпись (OS X v10.9) Свойство

    Идентификатор комплекта приложений связался с PSClient экземпляр.

    Объявление

    Objective C

    @property(readonly, retain) NSString *signature

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

    Objective C

    @import PubSub;

    Доступность

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

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

  • настройки настройки (OS X v10.9) Свойство

    Настройки канала клиента.

    Объявление

    Objective C

    @property(retain) PSFeedSettings *settings

    Обсуждение

    Если настройки не были изменены, возвращает настройки по умолчанию.

    Это свойство пытается связаться с процессом PubSubAgent и заставляет агент запускаться, если это уже не работает. Если с PubSubAgent нельзя связаться, исключение будет выдано с именем PSException. Для предотвращения проблем Вы должны всегда подготавливаться поймать исключение, выданное этим свойством.

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

    Objective C

    @import PubSub;

    Доступность

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

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

  • isPrivate isPrivate (OS X v10.9) Свойство

    Булево значение, указывающее, является ли клиентский экземпляр частным.

    Объявление

    Objective C

    @property(getter=isPrivate, setter=setPrivate:) BOOL isPrivate

    Обсуждение

    Частное PSClient к экземпляру может получить доступ только порядок подачи заявки, идентификатор пакета которого соответствует подпись PSClient.

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

    Objective C

    @import PubSub;

    Доступность

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

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

  • подача подача (OS X v10.9) Свойство

    Массив всей подачи подписался на клиентом.

    Объявление

    Objective C

    @property(readonly) NSArray *feeds

    Обсуждение

    Упорядочивание подачи в массиве не определено.

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

    Objective C

    @import PubSub;

    Доступность

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

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

  • делегат делегат (OS X v10.9) Свойство

    Делегат клиента.

    Объявление

    Objective C

    @property(assign) id delegate

    Обсуждение

    Делегат должен реализовать PSClientDelegate неофициальный протокол.

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

    Objective C

    @import PubSub;

    Доступность

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

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

  • dateLastUpdated dateLastUpdated (OS X v10.9) Свойство

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

    Объявление

    Objective C

    @property(readonly) NSDate *dateLastUpdated

    Обсуждение

    Если никакие уведомления не были отправлены в то время, когда этот метод вызвали, он возвращает дату и время, что создавался получатель. Поскольку подача и записи могут измениться, когда клиент не работает, сохраните значение от dateLastUpdated когда Ваше приложение выйдет, и передайте то значение sendChangesSinceDate: получать любые уведомления, которые вызвали бы, в то время как не работало Ваше приложение.

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

    Objective C

    @import PubSub;

    Доступность

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

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