com.atlassian.confluence.util
Class ExcerptHelper

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

public class ExcerptHelper
extends Object

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


Constructor Summary
ExcerptHelper()
           
 
Method Summary
 String getExcerpt(ContentEntityObject contentEntityObject)
          Returns the body of an excerpt macro (including any xhtml tags).
 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, String macroName)
          Gets the first MacroDefinition in the supplied (@code contentEntityObject}.
 String getText(String content)
          Returns the text from a fragment of XHTML content.
 String getTextSummary(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)
           
 
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 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 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,
                                          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 String getText(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 String getTextSummary(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)


Copyright © 2003-2011 Atlassian. All Rights Reserved.