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
Существующий канал возражает для подписки на.
Возвращаемое значение
YES
true
на успехе;NO
false
если произошла непосредственная ошибка.Обсуждение
Объект канала может только принадлежать одному клиенту, поэтому если данный канал был уже добавлен к какому-либо другому клиенту, этот метод перестанет работать. Вместо этого создайте новый объект канала с тем же URL как существующий или использование
addFeedWithURL:
.Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
addFeedWithURL: - addFeedWithURL:
(OS X v10.9)Подписывает клиент на канал в данном URL.
Параметры
url
URL канала. Должен быть
HTTP
,HTTPS
, илиFEED
протокол.Возвращаемое значение
Подписанный канал, или
nil
если произошла ошибка.Обсуждение
Этот метод создает подписанный канал из данного URL. Если канал с этим URL уже подписан, этот метод возвращает объект канала из существующих данных в Базе данных PubSub.
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
entryWithIdentifier: - entryWithIdentifier:
(OS X v10.9)Возвращает запись с данным идентификатором.
Параметры
identifier
Уникальная строка связалась с записью.
Возвращаемое значение
Запись связалась с указанным идентификатором, или
nil
если идентификатор не находится в подписанном канале.Обсуждение
Идентификаторы записи являются персистентными, уникальными, и неизменными, таким образом, они обеспечивают путь к Вашему приложению для установления персистентной ссылки на запись. Этот метод считает только записи в подаче подписанными на этим клиентом.
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
feedWithIdentifier: - feedWithIdentifier:
(OS X v10.9)Возвращает канал с указанным идентификатором.
Параметры
identifier
Уникальная строка связалась с каналом.
Возвращаемое значение
Канал связался с указанным идентификатором, или
nil
если клиент не подписан на канал, связанный с этим идентификатором.Обсуждение
Идентификаторы канала являются персистентными, уникальными, и неизменными, таким образом, они обеспечивают путь к Вашему приложению для установления персистентной ссылки на канал. Этот метод считает только подачу подписанной на этим клиентом.
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
feedWithURL: - feedWithURL:
(OS X v10.9) -
removeFeed: - removeFeed:
(OS X v10.9)Отписывает клиент от канала.
Объявление
Objective C
- (BOOL)removeFeed:(PSFeed *)
feed
Параметры
feed
Канал, который будет удален.
Возвращаемое значение
YES
true
если отписан клиент;NO
false
если произошла ошибка.Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
sendChangesSinceDate: - sendChangesSinceDate:
(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.
-
allClientBundleIdentifiers + allClientBundleIdentifiers
(OS X v10.9)Возвращает список идентификаторов пакета для клиентов, зарегистрировавшихся в Агенте PubSub.
Объявление
Objective C
+ (NSArray *)allClientBundleIdentifiers
Возвращаемое значение
Массив строковых объектов, содержащих идентификаторы пакета клиентов, зарегистрировался в Агенте PubSub.
Обсуждение
Этот метод должен использоваться приложениями, хотящими проверить подписки другого приложения или конструкции ряд всей подписанной подачи. Однако результаты могут не быть завершены, потому что этот метод не возвращает идентификаторы пакета частных клиентов.
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
applicationClient + applicationClient
(OS X v10.9)Создает экземпляр по умолчанию для текущего приложения.
Объявление
Objective C
+ (PSClient *)applicationClient
Возвращаемое значение
Объект клиента для текущего приложения.
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
clientForBundleIdentifier: + clientForBundleIdentifier:
(OS X v10.9)Создает клиент для указанного идентификатора пакета.
Объявление
Objective C
+ (PSClient *)clientForBundleIdentifier:(NSString *)
bundleIdentifier
Параметры
bundleIdentifier
Идентификатор пакета клиента Вы хотите проверить.
Возвращаемое значение
Объект клиента для указанного идентификатора пакета.
Обсуждение
Этот метод должен использоваться приложениями, хотящими проверить подписки других приложений или комплектом приложений, хотящих использовать совместно используемый клиент подписки. Если необходимо создать клиент для текущего приложения, использовать
applicationClient
вместо этого.Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Идентификатор комплекта приложений связался с
PSClient
экземпляр.Объявление
Objective C
@property(readonly, retain) NSString *signature
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в 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.
-
Булево значение, указывающее, является ли клиентский экземпляр частным.
Объявление
Objective C
@property(getter=isPrivate, setter=setPrivate:) BOOL isPrivate
Обсуждение
Частное
PSClient
к экземпляру может получить доступ только порядок подачи заявки, идентификатор пакета которого соответствует подписьPSClient
.Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.6 и позже.
Осуждаемый в OS X v10.9.
-
Массив всей подачи подписался на клиентом.
Объявление
Objective C
@property(readonly) NSArray *feeds
Обсуждение
Упорядочивание подачи в массиве не определено.
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Делегат клиента.
Объявление
Objective C
@property(assign) id delegate
Обсуждение
Делегат должен реализовать
PSClientDelegate
неофициальный протокол.Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Дата и время связалась с новым уведомлением изменения канала, поставленным делегату получателя.
Объявление
Objective C
@property(readonly) NSDate *dateLastUpdated
Обсуждение
Если никакие уведомления не были отправлены в то время, когда этот метод вызвали, он возвращает дату и время, что создавался получатель. Поскольку подача и записи могут измениться, когда клиент не работает, сохраните значение от
dateLastUpdated
когда Ваше приложение выйдет, и передайте то значениеsendChangesSinceDate:
получать любые уведомления, которые вызвали бы, в то время как не работало Ваше приложение.Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.