com.screenscraper.util.internal.services.depthtracker

Class TestDepthTrackerClient

java.lang.Object

com.screenscraper.util.internal.services.depthtracker.TestDepthTrackerClient

All Implemented Interfaces:

DepthTracker

public class TestDepthTrackerClient
extends java.lang.Object
implements DepthTracker

Implementation of the DepthTracker that allows everything to pass. Basically this is used for testing, or when the scrape was initially setup for multi-threading by depth but was changed to single threaded. This implementation does nothing and doesn't actually track depths

Version:

1.0

Constructor Summary

Constructors

Constructor and Description
TestDepthTrackerClient()

Method Summary

Modifier and Type	Method and Description
void	close() Closes this client
void	close(boolean resetAllCategories) Closes this client and resets all categories on the site IFF this is the last thread scraping the site and this scrape wasn't stopped early
void	close(boolean resetAllCategories, boolean fullReset) Closes this client and resets all categories on the site IFF this is the last thread scraping the site and this scrape wasn't stopped early
boolean	enterCategory(java.lang.String categoryName)
boolean	enterCategory(java.lang.String categoryName, boolean isBaseCategory)
boolean	enterCategory(java.lang.String categoryName, int numRecords)
boolean	enterCategory(java.lang.String categoryName, int numRecords, boolean isBaseCategory)
void	exitCategory()
void	exitCategory(int numRecords, RunState endState)
void	exitCategory(RunState endState)
APIConnection	getApiConnection() Returns the connection to the API that this client uses.
Category	getCategory(java.lang.String name) Gets a category by name, assuming the category is a child of whatever we are currently in
java.lang.Long	getCurrentCategoryId() Returns the ID of the category we are currently in
java.util.Date	getCurrentCategoryInitialEntryDate() Returns the initial entry time for the current category, or null if there are no categories (or the first entry date is unknown)
java.util.Date	getCurrentCategoryLastEntryTimeForSuccessfulExit() Returns the last entry time when this category was entered and a thread successfully exited it.
java.util.Date	getCurrentCategoryPreviousEntryDate() Returns the last entry time for the current category (prior to the current entry), or null if there are no categories (or the category had never been entered prior to this entry)
java.util.List<java.lang.String>	getCurrentStack() Returns the currently tracked stack of elements, as a list
java.util.Date	getOldestSuccessfulEntryExitEncountered()
long	getSiteId() Returns the id of the site that the client is dealing with.
long	getThreadId() Returns the id of the thread that the client is running under.
boolean	runInCategory(java.lang.String categoryName, java.lang.Runnable runOnEntry) Enters the category (if possible) and runs the runnable

Methods inherited from class java.lang.Object

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

Constructor Detail

TestDepthTrackerClient

public TestDepthTrackerClient()

Method Detail

getCurrentStack

@NotNull
public java.util.List<java.lang.String> getCurrentStack()

Description copied from interface: DepthTracker

Returns the currently tracked stack of elements, as a list

Specified by:

getCurrentStack in interface DepthTracker

Returns:

The currently tracked stack of elements, as a list

getCurrentCategoryId

@NotNull
public java.lang.Long getCurrentCategoryId()

Description copied from interface: DepthTracker

Returns the ID of the category we are currently in

Specified by:

getCurrentCategoryId in interface DepthTracker

Returns:

The id of the category we are currently in

runInCategory

public boolean runInCategory(java.lang.String categoryName,
                             @NotNull
                             java.lang.Runnable runOnEntry)

Description copied from interface: DepthTracker

Enters the category (if possible) and runs the runnable

Specified by:

runInCategory in interface DepthTracker

Parameters:

categoryName - The name of the category to enter

runOnEntry - Something to run if entry was successful

Returns:

True if the category was successfully entered, the runnable was executed, and the category was exited

getCurrentCategoryLastEntryTimeForSuccessfulExit

@Nullable
public java.util.Date getCurrentCategoryLastEntryTimeForSuccessfulExit()

Description copied from interface: DepthTracker

Returns the last entry time when this category was entered and a thread successfully exited it.

Specified by:

getCurrentCategoryLastEntryTimeForSuccessfulExit in interface DepthTracker

Returns:

The last entry time when this category was entered and a thread successfully exited it.

getCurrentCategoryInitialEntryDate

@Nullable
public java.util.Date getCurrentCategoryInitialEntryDate()

Description copied from interface: DepthTracker

Returns the initial entry time for the current category, or null if there are no categories (or the first entry date is unknown)

Specified by:

getCurrentCategoryInitialEntryDate in interface DepthTracker

Returns:

The initial entry time for the current category, or null if there are no categories (or the first entry date is unknown)

getCurrentCategoryPreviousEntryDate

@Nullable
public java.util.Date getCurrentCategoryPreviousEntryDate()

Description copied from interface: DepthTracker

Returns the last entry time for the current category (prior to the current entry), or null if there are no categories (or the category had never been entered prior to this entry)

Specified by:

getCurrentCategoryPreviousEntryDate in interface DepthTracker

Returns:

The last entry time for the current category (prior to the current entry), or null if there are no categories (or the category had never been entered prior to this entry)

enterCategory

public boolean enterCategory(java.lang.String categoryName)

Specified by:

enterCategory in interface DepthTracker

enterCategory

public boolean enterCategory(java.lang.String categoryName,
                             int numRecords)

Specified by:

enterCategory in interface DepthTracker

enterCategory

public boolean enterCategory(java.lang.String categoryName,
                             boolean isBaseCategory)

Specified by:

enterCategory in interface DepthTracker

enterCategory

public boolean enterCategory(java.lang.String categoryName,
                             int numRecords,
                             boolean isBaseCategory)

Specified by:

enterCategory in interface DepthTracker

exitCategory

public void exitCategory()

Specified by:

exitCategory in interface DepthTracker

exitCategory

public void exitCategory(RunState endState)

Specified by:

exitCategory in interface DepthTracker

exitCategory

public void exitCategory(int numRecords,
                         RunState endState)

Specified by:

exitCategory in interface DepthTracker

getOldestSuccessfulEntryExitEncountered

@Nullable
public java.util.Date getOldestSuccessfulEntryExitEncountered()

Specified by:

getOldestSuccessfulEntryExitEncountered in interface DepthTracker

close

public void close()

Description copied from interface: DepthTracker

Closes this client

Specified by:

close in interface DepthTracker

close

public void close(boolean resetAllCategories)

Description copied from interface: DepthTracker

Closes this client and resets all categories on the site IFF this is the last thread scraping the site and this scrape wasn't stopped early

Specified by:

close in interface DepthTracker

Parameters:

resetAllCategories - True to reset this this is the last thread scraping the site and this scrape wasn't stopped early. If true is given but there is another thread OR this session was stopped early, it will still not reset the site

close

public void close(boolean resetAllCategories,
                  boolean fullReset)

Description copied from interface: DepthTracker

Closes this client and resets all categories on the site IFF this is the last thread scraping the site and this scrape wasn't stopped early

Specified by:

close in interface DepthTracker

Parameters:

resetAllCategories - True to reset this this is the last thread scraping the site and this scrape wasn't stopped early. If true is given but there is another thread OR this session was stopped early, it will still not reset the site

fullReset - True to reset all fields, false to reset only the status of the categories and site but leave the entry/exit dates

getCategory

@Nullable
public Category getCategory(java.lang.String name)

Description copied from interface: DepthTracker

Gets a category by name, assuming the category is a child of whatever we are currently in

Specified by:

getCategory in interface DepthTracker

Parameters:

name - The name of the category

Returns:

The category, or null if no such category was found

getApiConnection

@Nullable
public APIConnection getApiConnection()

Description copied from interface: DepthTracker

Returns the connection to the API that this client uses. This should only be used in rare cases, as the client will not be informed of anything you do manually with the connection

Specified by:

getApiConnection in interface DepthTracker

Returns:

The api connection used by the client

getSiteId

public long getSiteId()

Description copied from interface: DepthTracker

Returns the id of the site that the client is dealing with.

Specified by:

getSiteId in interface DepthTracker

Returns:

The id of the site the client is for

getThreadId

public long getThreadId()

Description copied from interface: DepthTracker

Returns the id of the thread that the client is running under.

Specified by:

getThreadId in interface DepthTracker

Returns:

The id of the thread that the client is running under