com.atlassian.confluence.content
Class ContentEntityAdapterParent

java.lang.Object
  extended by com.atlassian.confluence.content.ContentEntityAdapterParent
All Implemented Interfaces:
ContentEntityAdapter
Direct Known Subclasses:
MailContentEntityAdapter

public class ContentEntityAdapterParent
extends java.lang.Object
implements ContentEntityAdapter

Default implementation of ContentEntityAdapter. Plugins should extend this class instead of implementing the interface directly so as not to be broken by changes to the interface.


Constructor Summary
ContentEntityAdapterParent()
           
 
Method Summary
 com.atlassian.fugue.Option<java.lang.String> getAttachmentsUrlPath(CustomContentEntityObject pluginContentEntityObject)
          Return the URL path to view the list of attachments on the content
 com.atlassian.fugue.Option<java.lang.String> getAttachmentUrlPath(CustomContentEntityObject pluginContentEntityObject, Attachment attachment)
          Return the URL path to view the a particular attachment of the content
 BodyType getDefaultBodyType(CustomContentEntityObject pluginContentEntityObject)
          Get the default type for BodyContent objects attached to this content.
 com.atlassian.fugue.Option<java.lang.String> getDisplayTitle(CustomContentEntityObject pluginContentEntityObject)
          Gets the display-friendly title for the content.
 com.atlassian.fugue.Option<java.lang.String> getExcerpt(CustomContentEntityObject pluginContentEntityObject)
          Get a text-only summary of the content that is suitable for use in activity streams, search results and other places where a short placeholder for the content is necessary.
 com.atlassian.fugue.Option<java.lang.String> getNameForComparison(CustomContentEntityObject pluginContentEntityObject)
          Return the sorting-friendly title for the content, if the content is to be sorted in alphabetical order.
 com.atlassian.fugue.Option<java.lang.String> getUrlPath(CustomContentEntityObject pluginContentEntityObject)
          Gets the URL string (relative to the Confluence application context) at which this content can be viewed.
 boolean isAllowedParent(CustomContentEntityObject child, CustomContentEntityObject parent)
          Determine if a particular content is an acceptable parent for this content.
 boolean isIndexable(CustomContentEntityObject pluginContentEntityObject, boolean isDefaultIndexable)
          Determine if a particular content should be indexed.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ContentEntityAdapterParent

public ContentEntityAdapterParent()
Method Detail

getUrlPath

public com.atlassian.fugue.Option<java.lang.String> getUrlPath(CustomContentEntityObject pluginContentEntityObject)
Description copied from interface: ContentEntityAdapter
Gets the URL string (relative to the Confluence application context) at which this content can be viewed.

Specified by:
getUrlPath in interface ContentEntityAdapter
Parameters:
pluginContentEntityObject - the content to be viewed
Returns:
the relative URL path to that content, or none to use to the default

getDisplayTitle

public com.atlassian.fugue.Option<java.lang.String> getDisplayTitle(CustomContentEntityObject pluginContentEntityObject)
Description copied from interface: ContentEntityAdapter
Gets the display-friendly title for the content. For example, a Comment does not have a title of its own, but where the UI needs to display the title of a comment, it uses "Re: Title Of Page Being Commented On".

Specified by:
getDisplayTitle in interface ContentEntityAdapter
Parameters:
pluginContentEntityObject - the content to calculate the display title for
Returns:
the display title of that content, or none to use to the default

getNameForComparison

public com.atlassian.fugue.Option<java.lang.String> getNameForComparison(CustomContentEntityObject pluginContentEntityObject)
Description copied from interface: ContentEntityAdapter
Return the sorting-friendly title for the content, if the content is to be sorted in alphabetical order.

Specified by:
getNameForComparison in interface ContentEntityAdapter
Parameters:
pluginContentEntityObject - the content to calculate the sorting title for
Returns:
the sorting title of that content, or none to use to the default

getAttachmentsUrlPath

public com.atlassian.fugue.Option<java.lang.String> getAttachmentsUrlPath(CustomContentEntityObject pluginContentEntityObject)
Description copied from interface: ContentEntityAdapter
Return the URL path to view the list of attachments on the content

Specified by:
getAttachmentsUrlPath in interface ContentEntityAdapter
Parameters:
pluginContentEntityObject - the content to view attachments for
Returns:
the URL path to view attachments on the content, or none to use to the default

getAttachmentUrlPath

public com.atlassian.fugue.Option<java.lang.String> getAttachmentUrlPath(CustomContentEntityObject pluginContentEntityObject,
                                                                         Attachment attachment)
Description copied from interface: ContentEntityAdapter
Return the URL path to view the a particular attachment of the content

Specified by:
getAttachmentUrlPath in interface ContentEntityAdapter
Parameters:
pluginContentEntityObject - the content to view attachments for
attachment - the attachment to link to
Returns:
the URL path to view attachments on the content, or none to use to the default

getDefaultBodyType

public BodyType getDefaultBodyType(CustomContentEntityObject pluginContentEntityObject)
Description copied from interface: ContentEntityAdapter
Get the default type for BodyContent objects attached to this content.

Specified by:
getDefaultBodyType in interface ContentEntityAdapter
Parameters:
pluginContentEntityObject - the content to get the body type of
Returns:
the default BodyType for that content

getExcerpt

public com.atlassian.fugue.Option<java.lang.String> getExcerpt(CustomContentEntityObject pluginContentEntityObject)
Description copied from interface: ContentEntityAdapter
Get a text-only summary of the content that is suitable for use in activity streams, search results and other places where a short placeholder for the content is necessary. The default implementation takes the first 255 characters of the content's main body with most markup characters removed.

Specified by:
getExcerpt in interface ContentEntityAdapter
Parameters:
pluginContentEntityObject - the content to excerpt
Returns:
the excerpt for that content, or none to use the default

isAllowedParent

public boolean isAllowedParent(CustomContentEntityObject child,
                               CustomContentEntityObject parent)
Description copied from interface: ContentEntityAdapter
Determine if a particular content is an acceptable parent for this content. The content object will ensure that there are no loops in the parent/child chain, and that the parent is in the same space as the child, so implementations do not need to check that.

Specified by:
isAllowedParent in interface ContentEntityAdapter

isIndexable

public boolean isIndexable(CustomContentEntityObject pluginContentEntityObject,
                           boolean isDefaultIndexable)
Description copied from interface: ContentEntityAdapter
Determine if a particular content should be indexed. The isDefaultIndexable parameter will contain the value of super.isIndexable(), so the plugin may choose to follow or override the standard reasons not to index SpaceContentEntityObject (trashed content, content that is not in a space, content that is an old version are all not indexed by default)

Specified by:
isIndexable in interface ContentEntityAdapter
Parameters:
pluginContentEntityObject - the entity to check
isDefaultIndexable - if the entity would be indexed absent of this check.


Copyright © 2003-2013 Atlassian. All Rights Reserved.