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.
-
addFeedWithURL: - addFeedWithURL:(OS X v10.9)Подписывает клиент на канал в данном URL.
Параметры
urlURL канала. Должен быть
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Канал, который будет удален.
Возвращаемое значение
YEStrueесли отписан клиент;NOfalseесли произошла ошибка.Оператор импорта
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.
