PSEntry
A PSEntry
запись в объекте канала. Объекты записи получены от связанного объекта канала.
Большинство атрибутов для записи определяется спецификациями Atom 1.0 и RSS 2.0. Любые атрибуты, определенные теми спецификациями (или нестандартные расширения), которые исходно не поддерживаются PSEntry, могут быть получены от объектов записи XMLRepresentation
свойство.
Некоторые PSEntry
атрибуты являются определенными для локальной копии записи, такой как isRead
и receivedDate
.
Так как значения RSS и атрибутов Atom получены на данные, полученные от сервера, они могут отсутствовать или неправильные. Если у Вас есть возможность, используйте атрибуты, сгенерированные платформой Подписки Публикации, поскольку это более надежно. Например, использование updatedDate
для нахождения измененных записей с, определенное время будет ненадежно. Использовать receivedDate
вместо этого. Не рекомендуется разделить на подклассы PSEntry
.
Оператор импорта
Не применимый
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Возвращает массив дополнительных элементов XML, которые являются за пределами стандартов Atom или RSS.
Параметры
nameSpace
Дополнительные элементы XML Вы хотите получить. Передача
nil
получить все дополнительные элементы XML, независимо от их пространства имен.Возвращаемое значение
Массив, содержащий дополнительные элементы XML, требуют. Удостоверьтесь, что передали пространство имен и не префикс пространства имен для
nameSpace
параметр. Например, для получения элементов Подкаста iTunes использоватьextensionXMLElementsUsingNamespace:@"http://www.itunes.com/dtds/podcast-1.0.dtd"
, нетextensionXMLElementsUsingNamespace:@"itunes"
.Этот метод пытается связаться с процессом PubSubAgent и заставляет агент запускаться, если это уже не работает. Если с PubSubAgent нельзя связаться, исключение будет выдано с именем
PSException
. Для предотвращения проблем Вы должны всегда подготавливаться поймать исключение, выданное этим методом.Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Необработанная запись XML. (только для чтения)
Объявление
Objective C
@property(readonly) NSXMLElement *XMLRepresentation
Обсуждение
Необработанный XML анализируется в дерево DOM, и <запись>, или <статья> элемент возвращается.
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Строка для отображения как заголовок записи. (только для чтения)
Объявление
Objective C
@property(readonly) NSString *titleForDisplay
Обсуждение
Если нет никакой сводки, это свойство возвращается до первых 100 символов сводки записи или содержания.
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Заголовок записи. (только для чтения)
Объявление
Objective C
@property(readonly, retain) NSString *title
Обсуждение
Соответствует элементу и в Atom и в RSS.
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Строка, содержащая сводку записи. (только для чтения)
Объявление
Objective C
@property(readonly, retain) PSContent *summary
Обсуждение
Соответствует <сводному> элементу в Atom. Нет никакого эквивалентного RSS.
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Информация об авторском праве записи. (только для чтения)
Объявление
Objective C
@property(readonly, retain) NSString *rights
Обсуждение
Соответствует <права> элементу в Atom. Нет никакого эквивалентного RSS.
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Булево значение, указывающее, читается ли запись.
Объявление
Objective C
@property(getter=isRead, setter=setRead:) BOOL read
Обсуждение
Читайте состояние статьи совместно используется среди всех приложений с помощью платформы Подписки Публикации. По умолчанию, этот метод возвраты
NO
false
.Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.6 и позже.
Осуждаемый в OS X v10.9.
-
Дата, когда запись была обновлена в локальной Базе данных подписчика Публикации. (только для чтения)
Объявление
Objective C
@property(readonly, retain) NSDate *localDateUpdated
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Дата, когда запись создавалась в локальной Базе данных подписчика Публикации. (только для чтения)
Объявление
Objective C
@property(readonly, retain) NSDate *localDateCreated
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Строка, однозначно определяющая запись. (только для чтения)
Объявление
Objective C
@property(readonly, retain) NSString *identifier
Обсуждение
Этот идентификатор может использоваться в качестве ключа для отображения между
PSEntry
объекты и собственные объекты модели данных Вашего приложения. Этот идентификатор сгенерирован внутренне платформой Подписки Публикации путем объединения идентификатора канала с 'самым уникальным' атрибутом записи. Вы не должны делать предположения о его формате или размере, поскольку они могут измениться. (Несмотря на то, что Atom определяет обязательное <ID> элемент, это не может использоваться с этой целью, так как RSS, эквивалентный (<гуид>), является дополнительным. Таким образом Подписка Публикации использует свой собственный механизм для однозначного определения записей. Клиенты могут вручную проанализироватьXMLRepresentation
вывод, если им нужен Atom <ID> элемент или RSS <гуид> элемент.)Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Булево значение, указывающее, отмечается ли запись.
Объявление
Objective C
@property(getter=isFlagged, setter=setFlagged:) BOOL flagged
Обсуждение
Отмеченное состояние статьи совместно используется среди всех приложений с помощью платформы Подписки Публикации. По умолчанию, этот метод возвраты
NO
false
.Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.6 и позже.
Осуждаемый в OS X v10.9.
-
Канал получатель принадлежит. (только для чтения)
Объявление
Objective C
@property(readonly) PSFeed *feed
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Массив объектов корпуса корпусов записи. (только для чтения)
Объявление
Objective C
@property(readonly, retain) NSArray *enclosures
Обсуждение
Корпуса соответствуют элементу в Atom и <корпус> элемент в RSS. Порядок объектов корпуса возвратился, не определено.}
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Дата, что была в последний раз изменена запись. (только для чтения)
Объявление
Objective C
@property(readonly, retain) NSDate *dateUpdated
Обсуждение
Возвращаемое значение соответствует <обновленным> элементам в Atom. Нет никакого эквивалентного RSS. Для получения локальной даты и времени, что последнее обновление было получено машиной пользователя используйте
localDateUpdated
метод.Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Дата, что была опубликована запись. (только для чтения)
Объявление
Objective C
@property(readonly, retain) NSDate *datePublished
Обсуждение
Возвращаемое значение соответствует <опубликованному> элементу в Atom и <pubDate> элементу в RSS.
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Гарантируемый не -
nil
дата записи, подходящей для отображения или сортировки. (только для чтения)Объявление
Objective C
@property(readonly, retain) NSDate *dateForDisplay
Обсуждение
Это возвращает запись
datePublished
при наличии, иначеdateUpdated
; если ни один не появляется в канале, он возвращаетсяlocalDateCreated
. Используйте этот метод при необходимости в гарантируемом не -nil
дата, как в сортировке или отображении в столбце таблицы.Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Дата, что создавалась запись. (только для чтения)
Объявление
Objective C
@property(readonly, retain) NSDate *dateCreated
Обсуждение
Дата соответствует <dc:created> элементу в Дублинском Ядре (http://dublincore .org/). Нет никакого Atom, ни эквивалентного RSS. Когда это существует, эта дата назначена или программным обеспечением блоггинга автора или сервером и сохранена в канале. Это может быть ранее, чем
datePublished
если запись не была сразу опубликована, будучи записанным. Для получения локальной даты и времени, когда запись была получена машиной пользователя используйтеlocateDateCreated
метод вместо этого.Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Булево значение, указывающее, появляется ли запись все еще в ее канале. (только для чтения)
Объявление
Objective C
@property(readonly, getter=isCurrent) BOOL current
Обсуждение
Как правило, канал содержит 10-15 записей за один раз, поэтому поскольку новая запись добавляется, самая старая запись «уменьшается». Если свойство возвращается нет, запись 'упала с нижней части' канала, но находится все еще в Базе данных PubSub.
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Массив объектов автора, содержащий факторы записи. (только для чтения)
Объявление
Objective C
@property(readonly, retain) NSArray *contributors
Обсуждение
Соответствует <фактор> элементу в Atom. Нет никакого эквивалентного RSS.
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Содержание записи. (только для чтения)
Объявление
Objective C
@property(readonly, retain) PSContent *content
Обсуждение
Соответствует <содержание> элементу в Atom и <описанию> в RSS.
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Базовый URL для разрешения относительных ссылок. (только для чтения)
Объявление
Objective C
@property(readonly, retain) NSURL *baseURL
Обсуждение
Возвращенный URL соответствует атрибуту xml:base на Atom <запись> элемент или RSS <элемент> элемент. Подписка публикации разрешает, что все проанализировали URLs для абсолюта. Однако это не возможно для URLs, встроенного в содержании или сводке записи. Если клиент принимает решение вывести на экран содержание в HTML-форме, базовый URL должен быть установлен для относительного URLs работать. Примечание: Atom технически позволяет атрибуту xml:base появляться как атрибут <содержание> или <сводные> элементы. На практике это редко происходит. Клиент может принять решение проанализировать эти атрибуты xml:base вручную через
XMLRepresentation
.Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Авторы записи как строка. (только для чтения)
Объявление
Objective C
@property(readonly) NSString *authorsForDisplay
Обсуждение
Если существуют многократные авторы, они разграничены запятой.
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Массив объектов автора, представляющих авторов записи. (только для чтения)
Объявление
Objective C
@property(readonly, retain) NSArray *authors
Обсуждение
Авторы соответствуют <автор> элементу в Atom и RSS. Этот метод в настоящее время только поддерживает единственного автора, первого.
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
URL к альтернативной версии ресурса записи. (только для чтения)
Объявление
Objective C
@property(readonly, retain) NSURL *alternateURL
Обсуждение
Традиционно, альтернативный URL соответствует версии HTML записи. URL анализируется от элемента в Atom и <hd_link posstarget = «элемент в RSS. Этот URL часто вызывают постоянной ссылкой».> элемент в RSS. Этот URL часто вызывают постоянной ссылкой.}
Оператор импорта
Objective C
@import PubSub;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.