com.atlassian.confluence.content.render.xhtml.view.excerpt
Interface Excerpter

All Known Implementing Classes:
DefaultExcerpter

public interface Excerpter


Method Summary
 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 contentEntityObject, 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.
 List<DataSource> extractImageSrc(ContentEntityObject ceo, int numImages)
           
 List<DataSource> extractImageSrc(ContentEntityObject ceo, int numImages, boolean useThumbnails)
           
 List<String> extractImageSrc(String contentHtml, int numImages)
           
 List<URI> extractImageThumbnailUris(ContentEntityObject contentEntity, int maxUris)
          Returns the URIs of thumbnails for each of the images attached to the specified content entity.
 

Method Detail

createExcerpt

String createExcerpt(Content content)
                     throws Exception
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

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

String createExcerpt(ContentEntityObject contentEntityObject,
                     String outputType)
                     throws Exception
Creates an excerpt of the contentEntityObject without any tags excluded including an implementation specific number of blocking

Parameters:
contentEntityObject - - 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

String createExcerpt(ContentEntityObject contentEntity,
                     String outputType,
                     ExcerptConfig config)
                     throws XMLStreamException,
                            com.atlassian.plugin.web.renderer.RendererException
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

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:
Exception - - if an excerpt could not be created for this ContentEntityObject
XMLStreamException
com.atlassian.plugin.web.renderer.RendererException

extractImageSrc

List<String> extractImageSrc(String contentHtml,
                             int numImages)
                             throws XMLStreamException
Throws:
XMLStreamException

extractImageThumbnailUris

List<URI> extractImageThumbnailUris(ContentEntityObject contentEntity,
                                    int maxUris)
                                    throws XhtmlException
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.

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.

extractImageSrc

List<DataSource> extractImageSrc(ContentEntityObject ceo,
                                 int numImages)
                                 throws XMLStreamException,
                                        XhtmlException
Throws:
XMLStreamException
XhtmlException

extractImageSrc

List<DataSource> extractImageSrc(ContentEntityObject ceo,
                                 int numImages,
                                 boolean useThumbnails)
                                 throws XMLStreamException,
                                        XhtmlException
Throws:
XMLStreamException
XhtmlException


Copyright © 2003–2015 Atlassian. All rights reserved.