Package org.apache.tika.config.loader

Class ParserLoader

java.lang.Object

org.apache.tika.config.loader.AbstractSpiComponentLoader<Parser>

org.apache.tika.config.loader.ParserLoader

All Implemented Interfaces:

ComponentLoader<Parser>

public class ParserLoader
extends AbstractSpiComponentLoader<Parser>

Loader for parsers with support for:

• SPI fallback via "default-parser" marker with exclusions
• Mime type filtering decorations (_mime-include, _mime-exclude)
• EncodingDetector and Renderer dependency injection

Constructor Summary

Constructors

Constructor	Description
ParserLoader()

Method Summary

Modifier and Type	Method	Description
protected Parser	createDefaultComposite(Set<Class<? extends Parser>> exclusions, LoaderContext context)	Create the SPI-backed default composite with exclusions.
protected Parser	decorateDefaultComposite(Parser parser, com.fasterxml.jackson.databind.JsonNode configNode, LoaderContext context)	Decorate the default composite with additional behavior.
protected Parser	loadComponent(String name, com.fasterxml.jackson.databind.JsonNode configNode, LoaderContext context)	Load a single component from config.
protected Parser	postProcess(Parser parser, LoaderContext context)	Post-process a single component (e.g., inject dependencies).
protected Class<? extends Parser>	unwrapClass(Parser component)	Unwrap a component to get the underlying class for auto-exclusion purposes.
protected Parser	wrapInComposite(List<Parser> parsers, LoaderContext context)	Wrap a list of components in a composite.

Methods inherited from class org.apache.tika.config.loader.AbstractSpiComponentLoader

getComponentClass, getDefaultMarkerName, getSectionName, handleSpecialName, load, postProcessList

Methods inherited from class java.lang.Object

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

Constructor Details

ParserLoader

public ParserLoader()

Method Details

loadComponent

protected Parser loadComponent(String name,
 com.fasterxml.jackson.databind.JsonNode configNode,
 LoaderContext context)
                        throws TikaConfigException

Description copied from class: AbstractSpiComponentLoader

Load a single component from config. Subclasses can apply decorations (e.g., mime filtering for parsers).

Specified by:

loadComponent in class AbstractSpiComponentLoader<Parser>

Parameters:

name - the component name (friendly name or FQCN)

configNode - the JSON configuration for this component

context - the loader context

Returns:

the loaded component

Throws:

TikaConfigException - if loading fails

createDefaultComposite

protected Parser createDefaultComposite(Set<Class<? extends Parser>> exclusions,
 LoaderContext context)

Description copied from class: AbstractSpiComponentLoader

Create the SPI-backed default composite with exclusions. E.g., new DefaultParser(..., exclusions) or new DefaultDetector(..., exclusions)

Specified by:

createDefaultComposite in class AbstractSpiComponentLoader<Parser>

Parameters:

exclusions - classes to exclude from SPI loading

context - the loader context

Returns:

the default composite

decorateDefaultComposite

protected Parser decorateDefaultComposite(Parser parser,
 com.fasterxml.jackson.databind.JsonNode configNode,
 LoaderContext context)
                                   throws TikaConfigException

Description copied from class: AbstractSpiComponentLoader

Decorate the default composite with additional behavior. E.g., for parsers, apply mime filtering from _mime-include/_mime-exclude. Default: returns the composite unchanged.

Overrides:

decorateDefaultComposite in class AbstractSpiComponentLoader<Parser>

Parameters:

parser - the default composite

configNode - the JSON configuration for the default marker (may be null)

context - the loader context

Returns:

the decorated composite

Throws:

TikaConfigException - if decoration fails

wrapInComposite

protected Parser wrapInComposite(List<Parser> parsers,
 LoaderContext context)

Description copied from class: AbstractSpiComponentLoader

Wrap a list of components in a composite. E.g., new CompositeParser(registry, list) or new CompositeDetector(registry, list)

Specified by:

wrapInComposite in class AbstractSpiComponentLoader<Parser>

Parameters:

parsers - the list of components

context - the loader context

Returns:

the composite component

unwrapClass

protected Class<? extends Parser> unwrapClass(Parser component)

Description copied from class: AbstractSpiComponentLoader

Unwrap a component to get the underlying class for auto-exclusion purposes. When a component is wrapped in a decorator (e.g., ParserDecorator for mime filtering), we need to exclude the underlying class from SPI, not the decorator class. Subclasses can override this for type-specific unwrapping.

Overrides:

unwrapClass in class AbstractSpiComponentLoader<Parser>

postProcess

protected Parser postProcess(Parser parser,
 LoaderContext context)
                      throws TikaConfigException

Description copied from class: AbstractSpiComponentLoader

Post-process a single component (e.g., inject dependencies). Default: returns the component unchanged.

Overrides:

postProcess in class AbstractSpiComponentLoader<Parser>

Parameters:

parser - the component to post-process

context - the loader context

Returns:

the post-processed component

Throws:

TikaConfigException - if post-processing fails