atg.endeca.index

Interface Indexable

All Known Implementing Classes:

EndecaIndexingOutputConfig, PerApplicationExporter, RepositoryTypeHierarchyExporter, SchemaExporter, ScriptIndexable

public interface Indexable

A basic interface for things that support baseline/bulk and partial/incremental indexing. These are typically called by the SimpleIndexingAdmin via an IndexingTask.

Created: November 23 2011

See Also:

SimpleIndexingAdmin, IndexingTask

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CLASS_VERSION Class version string

Method Summary

Modifier and Type	Method and Description
default boolean	alwaysFlushRecordStore()
default boolean	cancel(IndexingTask pTask) Cancel the currently in-process performBulkLoad or processQueuedIncrementalUpdates.
boolean	cancel(IndexingTask pTask, boolean pBaseline) Deprecated.
java.util.Set<java.lang.String>	getIndexingOutputConfigPaths() Return the set of IndexingOutputConfigs associated with this Indexable.
boolean	isForceToBaseline() The method is called before starting partial indexing job for all Indexable to allow forcing the job to baseline indexing.
default boolean	isForceToBaselineFullExport(IndexingJob pJob) This method is called before starting a partial or baseline indexing job for all Indexable to allow forcing the job to full export.
default boolean	isNeededForBaseline() Whether this Indexable is needed for an baseline update.
default boolean	isNeededForBaselineFullExport() Whether this Indexable is needed for a full export.
boolean	isNeededForIncremental() Whether this Indexable is needed for an incremental update.
boolean	isSupportsStatusCounts() Whether this object supports returning/updating status counts.
boolean	mayNeedCleanup() Whether this task may need cleanup.
default atg.repository.search.indexing.BulkLoaderResults	performBaselineFullExportUpdate(IndexingTask pTask) Do a full/bulk load plus run the baseline update script on Guided Search side.
atg.repository.search.indexing.BulkLoaderResults	performBaselineUpdate(IndexingTask pTask) Perform a baseline update.
atg.repository.search.indexing.LoaderResults	performPartialUpdate(IndexingTask pTask) Do an incremental load (that is, process any Queued incremental updates.
default void	persistInitialState(java.util.Map<java.lang.String,java.lang.Object> pBaselineState, java.util.Map<java.lang.String,java.lang.Object> pFullUdpateState)
void	postIndexingCleanup(IndexingTask pTask, boolean pSuccess, atg.repository.search.indexing.LoaderResults pResults) Perform any post indexing cleanup.
default boolean	usePartialExportForBaselines() This method is called before running a baseline update to determine whether a bulk or incremental export should be performed.

Field Detail

CLASS_VERSION

static final java.lang.String CLASS_VERSION

Class version string

See Also:

Constant Field Values

Method Detail

performBaselineFullExportUpdate

default atg.repository.search.indexing.BulkLoaderResults performBaselineFullExportUpdate(IndexingTask pTask)
                                                                                  throws IndexingException

Do a full/bulk load plus run the baseline update script on Guided Search side. Note that the any results property but "successful" may not be filled except by IndexingOutputConfigs.

This is called "performBulkLoad" rather than "bulkLoad" so that MultiConfigLoader could implement it.

Parameters:

pTask - the indexing task invoking the update. May be null if called via another means.

Throws:

IndexingException

performBaselineUpdate

atg.repository.search.indexing.BulkLoaderResults performBaselineUpdate(IndexingTask pTask)
                                                                throws IndexingException

Perform a baseline update. Whether a bulk load or incremental load of data from ATG is executed depends on isUsePartialExportForBaselines(). Always though the baseline update script will be run on Guided Search side. Note that the any results property but "successful" may not be filled except by IndexingOutputConfigs.

Parameters:

pTask - the indexing task invoking the update. May be null if called via another means.

Throws:

IndexingException

performPartialUpdate

atg.repository.search.indexing.LoaderResults performPartialUpdate(IndexingTask pTask)
                                                           throws IndexingException

Do an incremental load (that is, process any Queued incremental updates. Note that the any results property but "successful" may not be filled except by IndexingOutputConfigs.

Parameters:

pTask - the indexing task invoking the update. May be null if called via another means.

Throws:

IndexingException

isNeededForIncremental

boolean isNeededForIncremental()

Whether this Indexable is needed for an incremental update.

Returns:

true if this Indexable should be invoked for an incremental update, false if this Indexable should not be involved at an incremental update.

isNeededForBaseline

default boolean isNeededForBaseline()

Whether this Indexable is needed for an baseline update.

Returns:

true if this Indexable should be invoked for an baseline update, false if this Indexable should not be involved at an baseline update.

isNeededForBaselineFullExport

default boolean isNeededForBaselineFullExport()

Whether this Indexable is needed for a full export.

Returns:

true if this Indexable should be invoked for an full update, false if this Indexable should not be involved at an full export.

postIndexingCleanup

void postIndexingCleanup(IndexingTask pTask,
                         boolean pSuccess,
                         atg.repository.search.indexing.LoaderResults pResults)
                  throws IndexingException

Perform any post indexing cleanup.

Parameters:

pSuccess - true if we are cleaning up from a successful index, false otherwise.

pTask - the current indexing task, if any.

pSuccess - whether the indexing job has been successful up until now.

pResults - the loader results (if any) returns from performBaselineUpdate and performPartialUpdate.

Throws:

IndexingException

mayNeedCleanup

boolean mayNeedCleanup()

Whether this task may need cleanup. If true is returned, postIndexingCleanup will be called at some point after performPartialUpdate or performBaselineUpdate.

cancel

@Deprecated
boolean cancel(IndexingTask pTask,
                           boolean pBaseline)
                    throws IndexingException

Deprecated.

Cancel the currently in-process performBulkLoad or processQueuedIncrementalUpdates. Quick running indexables may not support cancel.

Parameters:

pBaseline - true if this is a baseline/full index, false if this is an incremental/partial index.

Returns:

true if current task was found to cancel, false otherwise.

Throws:

IndexingException

cancel

default boolean cancel(IndexingTask pTask)
                throws IndexingException

Cancel the currently in-process performBulkLoad or processQueuedIncrementalUpdates. Quick running indexables may not support cancel.

Returns:

true if current task was found to cancel, false otherwise.

Throws:

IndexingException

isSupportsStatusCounts

boolean isSupportsStatusCounts()

Whether this object supports returning/updating status counts. This is mostly so the admin will not display meaningless "0" even though work may be progressing.

getIndexingOutputConfigPaths

java.util.Set<java.lang.String> getIndexingOutputConfigPaths()

Return the set of IndexingOutputConfigs associated with this Indexable. May return an empty set, but should always return non-null.

isForceToBaseline

boolean isForceToBaseline()

The method is called before starting partial indexing job for all Indexable to allow forcing the job to baseline indexing.

Returns:

true if the job should be forced to baseline.

isForceToBaselineFullExport

default boolean isForceToBaselineFullExport(IndexingJob pJob)

This method is called before starting a partial or baseline indexing job for all Indexable to allow forcing the job to full export.

Returns:

true if the job should be forced to full export.

usePartialExportForBaselines

default boolean usePartialExportForBaselines()

This method is called before running a baseline update to determine whether a bulk or incremental export should be performed.

Returns:

usePartialExportForBaselines if true an incremental export will be performed, if false a bulk export will be performed.

persistInitialState

default void persistInitialState(java.util.Map<java.lang.String,java.lang.Object> pBaselineState,
                                 java.util.Map<java.lang.String,java.lang.Object> pFullUdpateState)

alwaysFlushRecordStore

default boolean alwaysFlushRecordStore()