votorola.a.diff.harvest

Class StateTable

java.lang.Object

StateTable

@Warning(value="non-Api")
@ThreadSafe
public final class StateTable
extends Object

Database table to store harvester state for PipermailHarvester only atm. This is not part of the public API (yet).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	StateTable.Type

Constructor Summary

Constructors

Constructor and Description
StateTable(Database db) Table which saves harvested urls for HarvestRunner.

Method Summary

Methods

Modifier and Type	Method and Description
(package private) void	create() Creates this table in the database.
(package private) void	drop() Drops this table from the database.
boolean	exists() Returns true if this table exists in the database; false otherwise.
void	finish(String archiveUrl, Marker start, Marker end) Remove all temporary markers in finished range and mark start marker as finished.
Marker	getNewest(String archiveUrl) Get newest marker of any type for a forum.
Marker	getNewest(String archiveUrl, StateTable.Type type) Get either permanent or temporary marker, the newest known marker.
boolean	put(String archiveUrl, Marker marker) Put a temporary marker.
int	removeArchive(String archiveUrl) Remove all states of an archive.
void	update(String archiveUrl) Recalculate the PERM marker by setting the newest FIN marked Marker, which is not newer than any temporary marker to PERM and deleting all older markers.

Methods inherited from class java.lang.Object

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

Constructor Detail

StateTable

@Warning(value="non-Api")
public StateTable(Database db)

Table which saves harvested urls for HarvestRunner.

Parameters:

db -

Method Detail

create

void create()
      throws SQLException

Creates this table in the database.

Throws:

SQLException

drop

void drop()
    throws SQLException

Drops this table from the database.

Throws:

SQLException

exists

public boolean exists()
               throws SQLException

Returns true if this table exists in the database; false otherwise.

Returns:

whether database already exists or not.

Throws:

SQLException

getNewest

public Marker getNewest(String archiveUrl)
                 throws SQLException

Get newest marker of any type for a forum. If there is none, a dummy value with empty string and date from beginning at unix time is used.

Parameters:

archiveUrl -

Throws:

SQLException

getNewest

public Marker getNewest(String archiveUrl,
               StateTable.Type type)
                 throws SQLException

Get either permanent or temporary marker, the newest known marker.

Parameters:

archiveUrl -

type -

Returns:

newest marker of type

Throws:

SQLException

put

public boolean put(String archiveUrl,
          Marker marker)
            throws SQLException

Put a temporary marker.

Throws:

SQLException

finish

public void finish(String archiveUrl,
          Marker start,
          Marker end)
            throws SQLException

Remove all temporary markers in finished range and mark start marker as finished. The end marker is not removed and its type is not changed. It can still be temporary.

Parameters:

archiveUrl -

start -

end -

Throws:

SQLException

update

public void update(String archiveUrl)
            throws SQLException

Recalculate the PERM marker by setting the newest FIN marked Marker, which is not newer than any temporary marker to PERM and deleting all older markers.

Parameters:

archiveUrl -

Throws:

SQLException

removeArchive

public int removeArchive(String archiveUrl)
                  throws SQLException

Remove all states of an archive.

Parameters:

archiveUrl -

Returns:

number of removed entries

Throws:

SQLException