fiftyone.mobile.detection

Class IndirectDataset

java.lang.Object

fiftyone.mobile.detection.Dataset

fiftyone.mobile.detection.IndirectDataset

All Implemented Interfaces:

Closeable, AutoCloseable

Direct Known Subclasses:

Dataset

public class IndirectDataset
extends Dataset

A data set which includes a pool of data readers that are used to fetch data from the source when the data set is used to retrieve data not already in memory. It also provides for caching of values.

Class provides extra methods to assess status of readers and to evaluate the caches.

Field Summary

Fields

Modifier and Type	Field and Description
Pool	pool A pool of data readers.
protected SourceBase	source Data source to be used with the pool.

Fields inherited from class fiftyone.mobile.detection.Dataset

age, components, copyright, copyrightOffset, csvBufferLength, deviceCombinations, export, FindProfilesInitialiseValueProfiles, format, formatOffset, highestCharacter, jsonBufferLength, lastModified, lowestCharacter, maps, maximumRank, maxSignatures, maxSignaturesClosest, maxUserAgentLength, maxValues, minUserAgentCount, minUserAgentLength, mode, nameOffset, nextUpdate, nodeRankedSignatureIndexes, nodes, profileOffsets, profiles, properties, published, rankedSignatureIndexes, rootNodes, signatureNodeOffsets, signatureNodesCount, signatureProfilesCount, signatures, strings, tag, values, version, versionEnum, xmlBufferLength

Constructor Summary

Constructors

Constructor and Description
IndirectDataset(byte[] data, Modes mode) Creates a dataset object with a pool of readers used to retrieve data from the data file represented as an array of bytes.
IndirectDataset(String fileName, Date lastModified, Modes mode, boolean isTempFile) Creates a dataset object with a pool of readers used to retrieve data from the data file.

Method Summary

Modifier and Type	Method and Description
void	close() Dispose of the dataset and the pool of readers.
ICache	getCache(DatasetBuilder.CacheType cacheType) Returns a cache to allow examination of its performance
int	getReadersCreated()
int	getReadersQueued()
void	resetCache() Resets the caches for the data set.
void	setCacheMap(Map<DatasetBuilder.CacheType,ICache> cacheMap) Sets the caches to use in this dataset

Methods inherited from class fiftyone.mobile.detection.Dataset

findProfile, findProfiles, findProfiles, get, getAge, getBrowsers, getComponent, getComponents, getCopyright, getCrawlers, getDisposed, getFormat, getHardware, getHttpHeaders, getJavaScriptProperties, getMaps, getMaximumRank, getMinUserAgentLength, getName, getNodeCacheSwitches, getNodeRankedSignatureIndexes, getNodes, getNodesCount, getPercentageNodeCacheMisses, getPercentageProfilesCacheMisses, getPercentageRankedSignatureCacheMisses, getPercentageSignatureCacheMisses, getPercentageStringsCacheMisses, getPercentageValuesCacheMisses, getProfiles, getProfilesCacheSwitches, getProfilesCount, getProperties, getPropertyByName, getPropertyValueOverrideProperties, getRankedSignatureCacheSwitches, getRankedSignatureIndexes, getSignatureCacheSwitches, getSignatureNodeOffsets, getSignatures, getSoftware, getStringsCacheSwitches, getValues, getValuesCacheSwitches, init, initComponents, initNodes, initProfiles, initProperties, initSignatures, initValues

Methods inherited from class java.lang.Object

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

Field Detail

pool

public final Pool pool

A pool of data readers.

source

protected final SourceBase source

Data source to be used with the pool.

Constructor Detail

IndirectDataset

public IndirectDataset(String fileName,
                       Date lastModified,
                       Modes mode,
                       boolean isTempFile)
                throws IOException

Creates a dataset object with a pool of readers used to retrieve data from the data file. Only useful in stram mode.

Parameters:

lastModified - Date and time the source data was last modified.

fileName - Valid path to the uncompressed data set file.

mode - Mode The mode of operation the data set will be using.

isTempFile - True if the file should be deleted when the source is disposed

Throws:

IOException - if there was a problem accessing data file.

IndirectDataset

public IndirectDataset(byte[] data,
                       Modes mode)
                throws IOException

Creates a dataset object with a pool of readers used to retrieve data from the data file represented as an array of bytes. Only useful in stram mode.

Parameters:

data - array of bytes to read from.

mode - The mode of operation the data set will be using.

Throws:

IOException - if there was a problem accessing data file.

Method Detail

close

public void close()
           throws IOException

Dispose of the dataset and the pool of readers.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class Dataset

Throws:

IOException - if there was a problem accessing data file.

getReadersCreated

public int getReadersCreated()

Returns:

The number of readers that have been created in the pool that connects the data set to the data source.

getReadersQueued

public int getReadersQueued()

Returns:

The number of readers in the queue ready to be used.

resetCache

public void resetCache()

Resets the caches for the data set. This is a "best efforts" operation that may not be supported by all underlying cache implementations.

Overrides:

resetCache in class Dataset

getCache

public ICache getCache(DatasetBuilder.CacheType cacheType)

Returns a cache to allow examination of its performance

Parameters:

cacheType - the type of cache

Returns:

a cache or null if no cache in operation

setCacheMap

public void setCacheMap(Map<DatasetBuilder.CacheType,ICache> cacheMap)

Sets the caches to use in this dataset

Parameters:

cacheMap - a Map of caches to use