為了以寫程式方式處理自定義應用程式中的標籤或擴展AEM標籤,本文檔介紹了
與
有關標籤的相關資訊:
執行 標籤框架 允AEM許使用JCR API管理標籤和標籤內容。 TagManager
確保標籤在 cq:tags
字串陣列屬性不重複,它將刪除 TagID
指向非現有標籤和更新 TagID
用於移動或合併的標籤。 TagManager
使用JCR觀察偵聽器來還原任何不正確的更改。 主類位於 com.day.cq.ta 包:
JcrTagManagerFactory
— 返回基於JCR的 TagManager
。 它是Tagging API的參考實現。TagManager
— 允許按路徑和名稱解析和建立標籤。Tag
— 定義標籤對象。檢索 TagManager
實例,您需要一個JCR Session
打給 getTagManager(Session)
:
@Reference
JcrTagManagerFactory jcrTagManagerFactory;
TagManager tagManager = jcrTagManagerFactory.getTagManager(session);
在典型的Sling上下文中,您還可以適應 TagManager
從 ResourceResolver
:
TagManager tagManager = resourceResolver.adaptTo(TagManager.class);
A Tag
可以通過 TagManager
,通過解析現有標籤或建立新標籤:
Tag tag = tagManager.resolve("my/tag"); // for existing tags
Tag tag = tagManager.createTag("my/tag"); // for new tags
用於基於JCR的實現,該 Tags
到JCR Nodes
你可以直接用斯林 adaptTo
機制。 /content/cq:tags/default/my/tag
):
Tag tag = resource.adaptTo(Tag.class);
當標籤只能被轉換時 從 資源(不是節點),可以轉換標籤 至 節點和資源:
Node node = tag.adaptTo(Node.class);
Resource node = tag.adaptTo(Resource.class);
直接從 Node
至 Tag
不可能,因為 Node
沒有實施Sling Adaptable.adaptTo(Class)
的雙曲餘切值。
// Getting the tags of a Resource:
Tag[] tags = tagManager.getTags(resource);
// Setting tags to a Resource:
tagManager.setTags(resource, tags);
// Searching for the Resource objects that are tagged with the tag object:
Iterator<Resource> it = tag.find();
// Retrieving the usage count of the tag object:
long count = tag.getCount();
// Searching for the Resource objects that are tagged with the tagID String:
RangeIterator<Resource> it = tagManager.find(tagID);
有效 RangeIterator
要使用:
com.day.cq.commons.RangeIterator
tagManager.deleteTag(tag);
可以使用複製服務(Replicator
),因為標籤屬於類型 nt:hierarchyNode
:
replicator.replicate(session, replicationActionType, tagPath);
標籤垃圾回收器是一種後台服務,用於清除隱藏且未使用的標籤。 隱藏標籤和未使用標籤為下面的標籤 /content/cq:tags
有 cq:movedTo
屬性,且未在內容節點上使用。 他們的數為零。 通過使用此延遲刪除過程,內容節點(即 cq:tags
屬性)不必作為移動或合併操作的一部分進行更新。 中的引用 cq:tags
屬性在 cq:tags
屬性將更新,例如通過頁面屬性對話框。
預設情況下,標籤垃圾收集器每天運行一次。 可以在以下位置配置此項:
http://<host>:<port>/system/console/configMgr/com.day.cq.tagging.impl.TagGarbageCollector
搜索標籤和標籤清單工作如下:
TagID
搜索具有該屬性的標籤 cq:movedTo
設定為 TagID
然後穿過 cq:movedTo
TagID
scq:movedTo
屬性。標籤 title
可以用不同的語言定義。 然後,將語言敏感屬性添加到標籤節點。 此屬性的格式 jcr:title.<locale>
,例如 jcr:title.fr
翻譯成法文。 <locale>
必須是ISO區域設定字串並使用下划線(_
)而不是連字元/短划線(-
),例如: de_ch
。
例如, 動物 標籤已添加到 產品 頁,該值 stockphotography:animals
添加到屬性 cq:tags
的 /content/wknd/en/products/jcr:content
。 從標籤節點引用轉換。
伺服器端API已本地化 title
— 相關方法:
com.day.cq.tagging.Tag
getLocalizedTitle(Locale locale)
getLocalizedTitlePaths()
getLocalizedTitles()
getTitle(Locale locale)
getTitlePath(Locale locale)
com.day.cq.tagging.TagManager
canCreateTagByTitle(String tagTitlePath, Locale locale)
createTagByTitle(String tagTitlePath, Locale locale)
resolveByTitle(String tagTitlePath, Locale locale)
在中AEM,語言可以從頁面語言或用戶語言獲得。
對於標籤,本地化取決於上下文作為標籤 titles
可以以頁面語言、用戶語言或任何其他語言顯示。
以下過程介紹如何向 標籤編輯 對話框:
languages
的 /content/cq:tags
。fi_fi
,表示芬蘭語言環境並保存更改。芬蘭語現在可在頁面屬性的標籤對話框中使用, 編輯標籤 編輯標籤時 標籤 控制台。
新語言需要是公認的語AEM言之一,即它需要作為下面的節點提供 /libs/wcm/core/resources/languages
。