org.apache.abdera.model
Interface Categories

All Superinterfaces:
Base, Cloneable, Element, ExtensibleElement, Iterable<Element>

public interface Categories
extends ExtensibleElement

The Atom Publishing Protocol introduces the notion of a "Category Document" and the app:categories element. These are used to provide a listing of atom:category elements that may be used with the members of an Atom Publishing Protocol collection.


Method Summary
 Categories addCategory(Category category)
          Add an atom:category to the listing
 Category addCategory(String term)
          Create and add an atom:category to the listing
 Category addCategory(String scheme, String term, String label)
          Create an add an atom:category to the listing
 boolean contains(String term)
          Returns true if this app:categories listing contains a category with the specified term
 boolean contains(String term, String scheme)
          Returns true if this app:categories listing contains a category with the specified term and scheme
 List<Category> getCategories()
          Lists the complete set of categories
 List<Category> getCategories(String scheme)
          Lists the complete set of categories that use the specified scheme
 List<Category> getCategoriesWithScheme()
          Returns a copy of the complete set of categories with the scheme attribute set
 List<Category> getCategoriesWithScheme(String scheme)
          Returns a copy of the complete set of categories with the scheme attribute set as specified in 7.2.1.
 IRI getHref()
          When contained within an app:collection element, the app:categories element can have an href attribute whose value MUST point to an Atompub Categories Document.
 IRI getResolvedHref()
          Returns the value of the href attribute resolved against the in-scope Base URI
 IRI getScheme()
          The app:categories element may specify a default scheme attribute for listed atom:category elements that do not have their own scheme attribute.
 boolean isFixed()
          If an app:categories element is marked as fixed, then the set of atom:category elements is considered to be a closed set.
 boolean isOutOfLine()
          Returns true if the href attribute is set
 Categories setFixed(boolean fixed)
          Sets whether or not this is a fixed listing of categories.
 Categories setHref(String href)
          Sets the value of the href attribute.
 Categories setScheme(String scheme)
          Sets the default scheme for this listing of categories
 
Methods inherited from interface org.apache.abdera.model.ExtensibleElement
addExtension, addExtension, addExtension, addExtension, addExtension, addSimpleExtension, addSimpleExtension, getExtension, getExtension, getExtensions, getExtensions, getExtensions, getSimpleExtension, getSimpleExtension
 
Methods inherited from interface org.apache.abdera.model.Element
declareNS, discard, getAttributes, getAttributeValue, getAttributeValue, getBaseUri, getDocument, getElements, getExtensionAttributes, getFirstChild, getFirstChild, getLanguage, getLanguageTag, getLocale, getMustPreserveWhitespace, getNamespaces, getNextSibling, getNextSibling, getParentElement, getPreviousSibling, getPreviousSibling, getQName, getResolvedBaseUri, getText, removeAttribute, removeAttribute, setAttributeValue, setAttributeValue, setBaseUri, setBaseUri, setLanguage, setMustPreserveWhitespace, setParentElement, setText, setText
 
Methods inherited from interface org.apache.abdera.model.Base
addComment, clone, complete, getDefaultWriterOptions, getFactory, writeTo, writeTo, writeTo, writeTo, writeTo, writeTo, writeTo, writeTo, writeTo, writeTo, writeTo, writeTo
 
Methods inherited from interface java.lang.Iterable
iterator
 

Method Detail

getHref

IRI getHref()
When contained within an app:collection element, the app:categories element can have an href attribute whose value MUST point to an Atompub Categories Document.

Returns:
The href attribute value

getResolvedHref

IRI getResolvedHref()
Returns the value of the href attribute resolved against the in-scope Base URI

Returns:
The fully resolved href attribute value

setHref

Categories setHref(String href)
Sets the value of the href attribute.

Parameters:
href - The location of an Atompub Categories Document

isFixed

boolean isFixed()
If an app:categories element is marked as fixed, then the set of atom:category elements is considered to be a closed set. That is, Atom Publishing Protocol clients SHOULD only use the atom:category elements listed. The default is false (fixed="no")

Returns:
True if the categories listing is fixed

setFixed

Categories setFixed(boolean fixed)
Sets whether or not this is a fixed listing of categories. If set to false, the fixed attribute will be removed from the app:categories element.

Parameters:
fixed - True if the app:categories listing is fixed

getScheme

IRI getScheme()
The app:categories element may specify a default scheme attribute for listed atom:category elements that do not have their own scheme attribute.

Returns:
The scheme IRI

setScheme

Categories setScheme(String scheme)
Sets the default scheme for this listing of categories

Parameters:
scheme - The default scheme used for this listing of categories

getCategories

List<Category> getCategories()
Lists the complete set of categories

Returns:
This app:categories listing of atom:category elements

getCategories

List<Category> getCategories(String scheme)
Lists the complete set of categories that use the specified scheme

Parameters:
scheme - The IRI of an atom:category scheme
Returns:
A listing of atom:category elements that use the specified scheme

getCategoriesWithScheme

List<Category> getCategoriesWithScheme()
Returns a copy of the complete set of categories with the scheme attribute set

Returns:
A listing of atom:category elements using the default scheme specified by the app:categories scheme attribute

getCategoriesWithScheme

List<Category> getCategoriesWithScheme(String scheme)
Returns a copy of the complete set of categories with the scheme attribute set as specified in 7.2.1. (child categories that do not have a scheme attribute inherit the scheme attribute of the parent)

Parameters:
scheme - A scheme IRI
Returns:
A listing of atom:category elements

addCategory

Categories addCategory(Category category)
Add an atom:category to the listing

Parameters:
category - The atom:category to add to the listing

addCategory

Category addCategory(String term)
Create and add an atom:category to the listing

Parameters:
term - The string term
Returns:
The newly created atom:category

addCategory

Category addCategory(String scheme,
                     String term,
                     String label)
Create an add an atom:category to the listing

Parameters:
scheme - The scheme IRI for the newly created category
term - The string term
label - The human readable label for the category
Returns:
The newly created atom:category

contains

boolean contains(String term)
Returns true if this app:categories listing contains a category with the specified term

Parameters:
term - The term to look for
Returns:
True if the term is found

contains

boolean contains(String term,
                 String scheme)
Returns true if this app:categories listing contains a category with the specified term and scheme

Parameters:
term - The term to look for
scheme - The IRI scheme
Returns:
True if the term and scheme are found

isOutOfLine

boolean isOutOfLine()
Returns true if the href attribute is set



Copyright © 2006-2010 Apache Software Foundation. All Rights Reserved.