org.apache.manifoldcf.crawler.interfaces

Interface IHistoryActivity

All Known Subinterfaces:

IProcessActivity, ISeedingActivity

All Known Implementing Classes:

SeedingActivity, WorkerThread.ProcessActivity

public interface IHistoryActivity

This interface abstracts from the activities that manage history information.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	_rcsid
static java.lang.String	BAD_URL Use this result code when you get URL value from repository and it is not valid.
static java.lang.String	EXCLUDED_CONTENT
static java.lang.String	EXCLUDED_DATE
static java.lang.String	EXCLUDED_LENGTH
static java.lang.String	EXCLUDED_MIMETYPE
static java.lang.String	EXCLUDED_URL
static java.lang.String	NULL_URL Use this result code when you get URL value from repository and it is null.

Method Summary

Modifier and Type	Method and Description
void	recordActivity(java.lang.Long startTime, java.lang.String activityType, java.lang.Long dataSize, java.lang.String entityIdentifier, java.lang.String resultCode, java.lang.String resultDescription, java.lang.String[] childIdentifiers) Record time-stamped information about the activity of the connector.

Field Detail

_rcsid

static final java.lang.String _rcsid

See Also:

Constant Field Values

EXCLUDED_URL

static final java.lang.String EXCLUDED_URL

See Also:

Constant Field Values

EXCLUDED_LENGTH

static final java.lang.String EXCLUDED_LENGTH

See Also:

Constant Field Values

EXCLUDED_MIMETYPE

static final java.lang.String EXCLUDED_MIMETYPE

See Also:

Constant Field Values

EXCLUDED_DATE

static final java.lang.String EXCLUDED_DATE

See Also:

Constant Field Values

EXCLUDED_CONTENT

static final java.lang.String EXCLUDED_CONTENT

See Also:

Constant Field Values

BAD_URL

static final java.lang.String BAD_URL

Use this result code when you get URL value from repository and it is not valid.

See Also:

Constant Field Values

NULL_URL

static final java.lang.String NULL_URL

Use this result code when you get URL value from repository and it is null.

See Also:

Constant Field Values

Method Detail

recordActivity

void recordActivity(java.lang.Long startTime,
                    java.lang.String activityType,
                    java.lang.Long dataSize,
                    java.lang.String entityIdentifier,
                    java.lang.String resultCode,
                    java.lang.String resultDescription,
                    java.lang.String[] childIdentifiers)
             throws ManifoldCFException

Record time-stamped information about the activity of the connector.

Parameters:

startTime - is either null or the time since the start of epoch in milliseconds (Jan 1, 1970). Every activity has an associated time; the startTime field records when the activity began. A null value indicates that the start time and the finishing time are the same.

activityType - is a string which is fully interpretable only in the context of the connector involved, which is used to categorize what kind of activity is being recorded. For example, a web connector might record a "fetch document" activity. Cannot be null.

dataSize - is the number of bytes of data involved in the activity, or null if not applicable.

entityIdentifier - is a (possibly long) string which identifies the object involved in the history record. The interpretation of this field will differ from connector to connector. May be null.

resultCode - contains a terse description of the result of the activity. The description is limited in size to 255 characters, and can be interpreted only in the context of the current connector. May be null.

resultDescription - is a (possibly long) human-readable string which adds detail, if required, to the result described in the resultCode field. This field is not meant to be queried on. May be null.

childIdentifiers - is a set of child entity identifiers associated with this activity. May be null.

Throws:

ManifoldCFException