com.atlassian.confluence.util
Class ExcerptHelper

java.lang.Object
  com.atlassian.confluence.util.ExcerptHelper

public class ExcerptHelper
extends java.lang.Object

Defines common functions that obtain excerpts of content (e.g. 'page children' and 'content by label' macros).

Constructor Summary

ExcerptHelper()

Method Summary

java.lang.String	getExcerpt(ContentEntityObject contentEntityObject) Returns the body of an excerpt macro (including any xhtml tags).
java.lang.String	getExcerptSummary(ContentEntityObject contentEntityObject) Returns the first line of an excerpt macro as plain text (all xhtml tags will be stripped)
MacroDefinition	getMacroDefinition(ContentEntityObject contentEntityObject, java.lang.String macroName) Gets the first MacroDefinition in the supplied (@code contentEntityObject}.
java.lang.String	getText(java.lang.String content) Returns the text from a fragment of XHTML content.
java.lang.String	getTextSummary(java.lang.String content, int minLength, int maxLength) Returns the text from the tag in the content (such as a heading or paragraph), unless its to short in which case text from the following tags are also included.
void	setContentTransformerFactory(ContentTransformerFactory contentTransformerFactory)
void	setHtmlParagraphStripper(HTMLParagraphStripper htmlParagraphStripper)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ExcerptHelper

public ExcerptHelper()

Method Detail

getExcerpt

public java.lang.String getExcerpt(ContentEntityObject contentEntityObject)

Returns the body of an excerpt macro (including any xhtml tags).

Parameters:

contentEntityObject - that contains the excerpt macro.

Returns:

the body of an excerpt macro or "" if there was no excerpt macro.

getExcerptSummary

public java.lang.String getExcerptSummary(ContentEntityObject contentEntityObject)

Returns the first line of an excerpt macro as plain text (all xhtml tags will be stripped)

Parameters:

contentEntityObject - that contains the excerpt macro.

Returns:

the summary of an excerpt macro or "" if there was no excerpt macro.

getMacroDefinition

public MacroDefinition getMacroDefinition(ContentEntityObject contentEntityObject,
                                          java.lang.String macroName)

Gets the first MacroDefinition in the supplied (@code contentEntityObject}.

Parameters:

contentEntityObject - (normally a Page) in which to find the macro.

macroName - the name of the macro to find.

Returns:

the MacroDefinition or null if not found, or the content is not XHTML.

getText

public java.lang.String getText(java.lang.String content)

Returns the text from a fragment of XHTML content.

Parameters:

content - the XHTML content.

Returns:

a value that contains only text.

getTextSummary

public java.lang.String getTextSummary(java.lang.String content,
                                       int minLength,
                                       int maxLength)

Returns the text from the tag in the content (such as a heading or paragraph), unless its to short in which case text from the following tags are also included.

Parameters:

content - the XHTML content.

minLength - the minimum length (normally 1) character (if available).

maxLength - the maximum length (normally 100) characters.

Returns:

a value that contains only text.

setContentTransformerFactory

public void setContentTransformerFactory(ContentTransformerFactory contentTransformerFactory)

setHtmlParagraphStripper

public void setHtmlParagraphStripper(HTMLParagraphStripper htmlParagraphStripper)