Package org.alfresco.repo.content.transform

Class TikaPoweredContentTransformer

java.lang.Object

org.alfresco.repo.content.transform.ContentTransformerHelper

org.alfresco.repo.content.transform.AbstractContentTransformerLimits

org.alfresco.repo.content.transform.AbstractContentTransformer2

org.alfresco.repo.content.transform.AbstractRemoteContentTransformer

org.alfresco.repo.content.transform.TikaPoweredContentTransformer

All Implemented Interfaces:

ContentWorker, ContentTransformer, org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanNameAware

Direct Known Subclasses:

ArchiveContentTransformer, MailContentTransformer, PdfBoxContentTransformer, PoiContentTransformer, PoiHssfContentTransformer, PoiOOXMLContentTransformer, TextMiningContentTransformer, TikaAutoContentTransformer, TikaSpringConfiguredContentTransformer

@Deprecated
public abstract class TikaPoweredContentTransformer
extends AbstractRemoteContentTransformer

Deprecated.

The transformations code is being moved out of the codebase and replaced by the new async RenditionService2 or other external libraries.

Provides helpful services for ContentTransformer implementations which are powered by Apache Tika. To use Tika to transform some content into Text, Html or XML, create an implementation of this / use the Auto Detect transformer. For now, all transformers are registered as regular, rather than explicit transformations. This should allow you to register your own explicit transformers and have them nicely take priority.

Author:

Nick Burch

Field Summary

Fields

Modifier and Type	Field	Description
protected org.apache.tika.extractor.DocumentSelector	documentSelector	Deprecated.
protected static String	LINE_BREAK	Deprecated. Windows carriage return line feed pair.
protected List<String>	sourceMimeTypes	Deprecated.
static String	WRONG_FORMAT_MESSAGE_ID	Deprecated.

Fields inherited from class org.alfresco.repo.content.transform.AbstractContentTransformerLimits

transformerDebug

Fields inherited from class org.alfresco.repo.content.transform.ContentTransformerHelper

transformerConfig

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	TikaPoweredContentTransformer(String[] sourceMimeTypes)	Deprecated.
protected	TikaPoweredContentTransformer(List<String> sourceMimeTypes)	Deprecated.

Method Summary

Modifier and Type	Method	Description
protected org.apache.tika.parser.ParseContext	buildParseContext(org.apache.tika.metadata.Metadata metadata, String targetMimeType, TransformationOptions options)	Deprecated. By default returns a ParseContent that does not recurse
String	getComments(boolean available)	Deprecated. Overridden to supply a comment or String of commented out transformation properties that specify any (hard coded or implied) supported transformations.
protected ContentHandler	getContentHandler(String targetMimeType, Writer output)	Deprecated. Returns an appropriate Tika ContentHandler for the requested content type.
protected org.apache.tika.extractor.DocumentSelector	getDocumentSelector(org.apache.tika.metadata.Metadata metadata, String targetMimeType, TransformationOptions options)	Deprecated. Gets the document selector, used for determining whether to parse embedded resources, null by default so parse all.
protected org.apache.commons.logging.Log	getLogger()	Deprecated.
protected abstract org.apache.tika.parser.Parser	getParser()	Deprecated. Returns the correct Tika Parser to process the document.
protected abstract String	getTransform()	Deprecated.
boolean	isTransformableMimetype(String sourceMimetype, String targetMimetype, TransformationOptions options)	Deprecated. Can we do the requested transformation via Tika? We support transforming to HTML, XML or Text
void	setDocumentSelector(org.apache.tika.extractor.DocumentSelector documentSelector)	Deprecated. Sets the document selector, used for determining whether to parse embedded resources.
void	transformLocal(org.alfresco.service.cmr.repository.ContentReader reader, org.alfresco.service.cmr.repository.ContentWriter writer, TransformationOptions options)	Deprecated.
protected void	transformRemote(RemoteTransformerClient remoteTransformerClient, org.alfresco.service.cmr.repository.ContentReader reader, org.alfresco.service.cmr.repository.ContentWriter writer, TransformationOptions options, String sourceMimetype, String targetMimetype, String sourceExtension, String targetExtension, String targetEncoding)	Deprecated.

Methods inherited from class org.alfresco.repo.content.transform.AbstractRemoteContentTransformer

afterPropertiesSet, isAvailable, isTransformable, register, setAvailable, setRemoteTransformerClient, transformInternal

Methods inherited from class org.alfresco.repo.content.transform.AbstractContentTransformer2

checkTransformable, getExecutorService, getRetryTransformOnDifferentMimeType, getStrictMimeTypeCheck, getTransformationTime, getTransformationTime, isTransformationLimitedInternally, recordError, recordTime, recordTime, setAdditionalThreadTimout, setExecutorService, setRegisterTransformer, setRegistry, setRetryTransformOnDifferentMimeType, setStrictMimeTypeCheck, setUseTimeoutThread, toString, transform, transform, transform

Methods inherited from class org.alfresco.repo.content.transform.AbstractContentTransformerLimits

getLimits, getLimits, getLimits, getMaxPages, getMaxSourceSizeKBytes, getMaxSourceSizeKBytes, getPageLimit, getReadLimitKBytes, getReadLimitTimeMs, getTimeoutMs, isPageLimitSupported, isTransformable, isTransformableSize, setLimits, setMaxPages, setMaxSourceSizeKBytes, setMimetypeLimits, setPageLimit, setPageLimitsSupported, setReaderLimits, setReadLimitKBytes, setReadLimitTimeMs, setTimeoutMs, setTransformerDebug

Methods inherited from class org.alfresco.repo.content.transform.ContentTransformerHelper

deprecatedSetter, equals, getBeanName, getCommentsOnlySupports, getExtensionOrAny, getMimetype, getMimetypeService, getName, getSimpleName, hashCode, isExplicitTransformation, isSupportedTransformation, onlySupports, setBeanName, setExplicitTransformations, setMimetypeService, setSupportedTransformations, setTransformerConfig, setUnsupportedTransformations

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.alfresco.repo.content.transform.ContentTransformer

getName, isExplicitTransformation

Field Detail

sourceMimeTypes

protected List<String> sourceMimeTypes

Deprecated.

documentSelector

protected org.apache.tika.extractor.DocumentSelector documentSelector

Deprecated.

LINE_BREAK

protected static final String LINE_BREAK

Deprecated.

Windows carriage return line feed pair.

See Also:

Constant Field Values

WRONG_FORMAT_MESSAGE_ID

public static final String WRONG_FORMAT_MESSAGE_ID

Deprecated.

See Also:

Constant Field Values

Constructor Detail

TikaPoweredContentTransformer

protected TikaPoweredContentTransformer(List<String> sourceMimeTypes)

Deprecated.

TikaPoweredContentTransformer

protected TikaPoweredContentTransformer(String[] sourceMimeTypes)

Deprecated.

Method Detail

getLogger

protected org.apache.commons.logging.Log getLogger()

Deprecated.

Specified by:

getLogger in class AbstractRemoteContentTransformer

getParser

protected abstract org.apache.tika.parser.Parser getParser()

Deprecated.

Returns the correct Tika Parser to process the document. If you don't know which you want, use TikaAutoContentTransformer which makes use of the Tika auto-detection.

isTransformableMimetype

public boolean isTransformableMimetype(String sourceMimetype,
                                       String targetMimetype,
                                       TransformationOptions options)

Deprecated.

Can we do the requested transformation via Tika? We support transforming to HTML, XML or Text

Specified by:

isTransformableMimetype in interface ContentTransformer

Overrides:

isTransformableMimetype in class AbstractContentTransformerLimits

Parameters:

sourceMimetype - the source mimetype

targetMimetype - the target mimetype

options - the transformation options

Returns:

boolean true if this content transformer can satify the mimetypes, false otherwise

getComments

public String getComments(boolean available)

Deprecated.

Description copied from class: ContentTransformerHelper

Overridden to supply a comment or String of commented out transformation properties that specify any (hard coded or implied) supported transformations. Used when providing a list of properties to an administrators who may be setting other transformation properties, via JMX. Consider overriding if {link AbstractContentTransformerLimits.isTransformableMimetype(String, String, TransformationOptions) or ContentTransformerWorker.isTransformable(String, String, TransformationOptions) have been overridden. See ContentTransformerHelper.getCommentsOnlySupports(List, List, boolean) which may be used to help construct a comment.

Specified by:

getComments in interface ContentTransformer

Overrides:

getComments in class ContentTransformerHelper

Parameters:

available - indicates if the transformer has been registered and is available to be selected. false indicates that the transformer is only available as a component of a complex transformer.

Returns:

one line per property. The simple transformer name is returned by default as a comment.

getContentHandler

protected ContentHandler getContentHandler(String targetMimeType,
                                           Writer output)
                                    throws TransformerConfigurationException

Deprecated.

Returns an appropriate Tika ContentHandler for the requested content type. Normally you'll let this work as default, but if you need fine-grained control of how the Tika events become text then override and supply your own.

Throws:

TransformerConfigurationException

setDocumentSelector

public void setDocumentSelector(org.apache.tika.extractor.DocumentSelector documentSelector)

Deprecated.

Sets the document selector, used for determining whether to parse embedded resources.

Parameters:

documentSelector - DocumentSelector

getDocumentSelector

protected org.apache.tika.extractor.DocumentSelector getDocumentSelector(org.apache.tika.metadata.Metadata metadata,
                                                                         String targetMimeType,
                                                                         TransformationOptions options)

Deprecated.

Gets the document selector, used for determining whether to parse embedded resources, null by default so parse all.

Parameters:

metadata - Metadata

targetMimeType - String

options - TransformationOptions

Returns:

the document selector

buildParseContext

protected org.apache.tika.parser.ParseContext buildParseContext(org.apache.tika.metadata.Metadata metadata,
                                                                String targetMimeType,
                                                                TransformationOptions options)

Deprecated.

By default returns a ParseContent that does not recurse

transformLocal

public void transformLocal(org.alfresco.service.cmr.repository.ContentReader reader,
                           org.alfresco.service.cmr.repository.ContentWriter writer,
                           TransformationOptions options)
                    throws Exception

Deprecated.

Specified by:

transformLocal in class AbstractRemoteContentTransformer

Throws:

Exception

transformRemote

protected void transformRemote(RemoteTransformerClient remoteTransformerClient,
                               org.alfresco.service.cmr.repository.ContentReader reader,
                               org.alfresco.service.cmr.repository.ContentWriter writer,
                               TransformationOptions options,
                               String sourceMimetype,
                               String targetMimetype,
                               String sourceExtension,
                               String targetExtension,
                               String targetEncoding)
                        throws Exception

Deprecated.

Specified by:

transformRemote in class AbstractRemoteContentTransformer

Throws:

Exception

getTransform

protected abstract String getTransform()

Deprecated.