Package com.atlassian.confluence.content.render.xhtml.view.excerpt

Class DefaultExcerpter

java.lang.Object

com.atlassian.confluence.content.render.xhtml.view.excerpt.DefaultExcerpter

All Implemented Interfaces:

Excerpter

public class DefaultExcerpter
extends Object
implements Excerpter

Field Summary

Fields

Modifier and Type	Field	Description
static final Set<String>	DEFAULT_EXCLUDE_SET
static final int	DEFAULT_MAX_BLOCKS_FOR_EXCERPT
static final String	EXCERPT_MACRO_NAME

Constructor Summary

Constructors

Constructor

Description

DefaultExcerpter(XMLOutputFactory xmlFragmentOutputFactory, XmlEventReaderFactory xmlEventReaderFactory, HtmlToXmlConverter htmlToXmlConverter, SettingsManager settingsManager, Renderer viewRenderer, Unmarshaller<EmbeddedImage> embeddedImageUnmarshaller, FragmentTransformer fragmentTransformer, AttachmentResourceIdentifierResolver attachmentResolver, DataSourceFactory datasourceFactory, ThumbnailManager thumbnailManager, MacroDefinitionTransformer macroDefinitionTransformer, ExcerptHelper excerptHelper, I18NBeanFactory i18NBeanFactory, LocaleManager localeManager)

Method Summary

Modifier and Type	Method	Description
String	createExcerpt(Content content)	Creates an excerpt block from the provided content object without any tags excluded, using an implementation specific number of blocks.
String	createExcerpt(ContentEntityObject contentEntity, String outputType)	Creates an excerpt of the contentEntityObject without any tags excluded including an implementation specific number of blocking
String	createExcerpt(ContentEntityObject contentEntity, String outputType, ExcerptConfig config)	Creates an excerpt of the contentEntityObject excluding any html tags that are in the exclude set.
String	createExcerpt(ContentEntityObject contentEntity, String outputType, Set<String> excludeSet, int maxBlocksForExcerpt)	Deprecated. since 5.9.
String	createExcerpt(String contentHtml, ExcerptConfig config)
List<DataSource>	extractImageSrc(ContentEntityObject ceo, int maxImages)
List<DataSource>	extractImageSrc(ContentEntityObject ceo, int maxImages, boolean alwaysUseThumbnails)
List<String>	extractImageSrc(String contentHtml, int maxImages)
List<URI>	extractImageThumbnailUris(ContentEntityObject contentEntity, int maxUris)	Returns the URIs of thumbnails for each of the images attached to the specified content entity.
protected List<XMLEvent>	filterEmptyAndExcludedEvents(XMLEventReader reader, Set<String> excludeSet)
String	getExcerpt(ContentEntityObject content)	Returns the already created excerpts of content.
String	getExcerptSummary(ContentEntityObject content)	Returns the summary of an already created excerpt of content.
String	getText(String content)	Returns the text from a fragment of XHTML content.
String	renderContent(ContentEntityObject contentEntity, String outputType)	Deprecated.

Methods inherited from class java.lang.Object

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

Field Details

DEFAULT_EXCLUDE_SET

public static final Set<String> DEFAULT_EXCLUDE_SET

DEFAULT_MAX_BLOCKS_FOR_EXCERPT

public static final int DEFAULT_MAX_BLOCKS_FOR_EXCERPT

See Also:

• Constant Field Values

EXCERPT_MACRO_NAME

public static final String EXCERPT_MACRO_NAME

See Also:

• Constant Field Values

Constructor Details

DefaultExcerpter

public DefaultExcerpter(XMLOutputFactory xmlFragmentOutputFactory,
 XmlEventReaderFactory xmlEventReaderFactory,
 HtmlToXmlConverter htmlToXmlConverter,
 SettingsManager settingsManager,
 Renderer viewRenderer,
 Unmarshaller<EmbeddedImage> embeddedImageUnmarshaller,
 FragmentTransformer fragmentTransformer,
 AttachmentResourceIdentifierResolver attachmentResolver,
 DataSourceFactory datasourceFactory,
 ThumbnailManager thumbnailManager,
 MacroDefinitionTransformer macroDefinitionTransformer,
 ExcerptHelper excerptHelper,
 I18NBeanFactory i18NBeanFactory,
 LocaleManager localeManager)

Since:

7.6

Method Details

createExcerpt

public String createExcerpt(Content content)
                     throws Exception

Description copied from interface: Excerpter

Creates an excerpt block from the provided content object without any tags excluded, using an implementation specific number of blocks. This uses the EXPORT_VIEW content representation, and as such this should be already expanded

Specified by:

createExcerpt in interface Excerpter

Parameters:

content - - the content entity object to create an excerpt of

Returns:

Throws:

Exception - - if an excerpt cannot be created for this content object

createExcerpt

public String createExcerpt(ContentEntityObject contentEntity,
 String outputType)
                     throws Exception

Description copied from interface: Excerpter

Creates an excerpt of the contentEntityObject without any tags excluded including an implementation specific number of blocking

Specified by:

createExcerpt in interface Excerpter

Parameters:

contentEntity - - contentEntityObject to create an excerpt of

outputType - - the output type in which to render the content, @see RenderContextOutputType

Returns:

a html excerpt of the content entity object

Throws:

Exception - - if an excerpt could not be created for this ContentEntityObject

createExcerpt

@Deprecated
public String createExcerpt(ContentEntityObject contentEntity,
 String outputType,
 Set<String> excludeSet,
 int maxBlocksForExcerpt)
                     throws Exception

Deprecated.

since 5.9. Use createExcerpt(ContentEntityObject contentEntity, String outputType, ExcerptConfig config)

Throws:

Exception

createExcerpt

public String createExcerpt(ContentEntityObject contentEntity,
 String outputType,
 ExcerptConfig config)
                     throws XMLStreamException

Description copied from interface: Excerpter

Creates an excerpt of the contentEntityObject excluding any html tags that are in the exclude set.

The number of blocks with content to be included in the excerpt is specified with the maxBlocksForExcerpt parameter. A block with content is any element with a

Specified by:

createExcerpt in interface Excerpter

Parameters:

contentEntity - - contentEntityObject to create an excerpt of

outputType - - the output type in which to render the content, @see RenderContextOutputType

config - - a parameter object that allows the content of the excerpt to be customized. @see ExcerptConfig

Returns:

a html excerpt of the content entity object

Throws:

XMLStreamException

renderContent

@Deprecated
public String renderContent(ContentEntityObject contentEntity,
 String outputType)

Deprecated.

createExcerpt

public String createExcerpt(String contentHtml,
 ExcerptConfig config)
                     throws XMLStreamException

Throws:

XMLStreamException

extractImageSrc

public List<DataSource> extractImageSrc(ContentEntityObject ceo,
 int maxImages)
                                 throws XMLStreamException,
XhtmlException

Specified by:

extractImageSrc in interface Excerpter

Throws:

XMLStreamException

XhtmlException

extractImageSrc

public List<DataSource> extractImageSrc(ContentEntityObject ceo,
 int maxImages,
 boolean alwaysUseThumbnails)
                                 throws XMLStreamException,
XhtmlException

Specified by:

extractImageSrc in interface Excerpter

Throws:

XMLStreamException

XhtmlException

extractImageSrc

public List<String> extractImageSrc(String contentHtml,
 int maxImages)
                             throws XMLStreamException

Specified by:

extractImageSrc in interface Excerpter

Throws:

XMLStreamException

filterEmptyAndExcludedEvents

protected List<XMLEvent> filterEmptyAndExcludedEvents(XMLEventReader reader,
 Set<String> excludeSet)

extractImageThumbnailUris

public List<URI> extractImageThumbnailUris(ContentEntityObject contentEntity,
 int maxUris)
                                    throws XhtmlException

Description copied from interface: Excerpter

Returns the URIs of thumbnails for each of the images attached to the specified content entity.

URIs are returned in order that the images appear in the document. Obviously only URIs for thumbnailable images will be returned.

Specified by:

extractImageThumbnailUris in interface Excerpter

Parameters:

contentEntity - the content entity

maxUris - the maximum URI's to return

Returns:

ordered list of thumbnails URIs

Throws:

XhtmlException - if there is an error parsing the contents for image references.

getExcerpt

public String getExcerpt(ContentEntityObject content)

Description copied from interface: Excerpter

Returns the already created excerpts of content.

Specified by:

getExcerpt in interface Excerpter

Returns:

the excerpt

getExcerptSummary

public String getExcerptSummary(ContentEntityObject content)

Description copied from interface: Excerpter

Returns the summary of an already created excerpt of content.

Specified by:

getExcerptSummary in interface Excerpter

Returns:

the excerpt summary

getText

public String getText(String content)

Description copied from interface: Excerpter

Returns the text from a fragment of XHTML content.

Specified by:

getText in interface Excerpter

Returns:

the text