de.uni_leipzig.asv.coocc

Class BinFileMultColRam

java.lang.Object

de.uni_leipzig.asv.coocc.BinFileMultColRam

All Implemented Interfaces:

BinFileMultCol

public class BinFileMultColRam
extends java.lang.Object
implements BinFileMultCol

This class gives access to collocations which is slower but less memory-intense. It loads up only the index file and operates on the file per random accesses.

Author:

Stefan Bordag

Constructor Summary

Constructors

Constructor and Description
BinFileMultColRam(java.lang.String fileName, int columns) Sole constructor.

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	existsFileDump(java.lang.String fileName) Tests, whether the required files for this class, given with the fileName exist and are not of null-length (like after a failed start of FilePreparer
java.util.List	getData(java.lang.Integer wordNr) For a given number returns the row
java.util.List	getData(java.lang.Integer number, int maxItems) Returns the data for the given number up to the given maximum.
java.util.List	getData(java.lang.Integer number, int myColumns, int maxItems) Returns the data for the given number up to the given maximum.
java.util.List	getData(java.lang.Integer number, int maxItems, int[] minCols, int[] maxCols) Returns the data for the given number up to the given maximum in a list.
java.util.List	getData(java.lang.Integer number, int myColumns, int maxItems, int[] minCols, int[] maxCols) Returns the data for the given number up to the given maximum.
java.util.Map	getDataAsMap(java.lang.Integer wordNr) Returns the data for the given number up to the given maximum in a map.
java.util.Map	getDataAsMap(java.lang.Integer number, int maxItems) Returns the data for the given number up to the given maximum in a map.
java.util.Map	getDataAsMap(java.lang.Integer number, int myColumns, int maxItems) Returns the data for the given number up to the given maximum.
java.util.Map	getDataAsMap(java.lang.Integer number, int maxItems, int[] minCols, int[] maxCols) Returns the data for the given number up to the given maximum in a map.
java.util.Map	getDataAsMap(java.lang.Integer number, int myColumns, int maxItems, int[] minCols, int[] maxCols) Returns the data for the given number up to the given maximum in a map.
java.util.List	getSingleColumn(java.lang.Integer number, int col) Column here is the column in the initial datafile, count begins with 1.
java.util.List	getSingleColumn(java.lang.Integer number, int maxItems, int col)
static void	main(java.lang.String[] args) With this main method it's possible to test a prepared file.

Methods inherited from class java.lang.Object

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

Constructor Detail

BinFileMultColRam

public BinFileMultColRam(java.lang.String fileName,
                 int columns)

Sole constructor. Reads the index after which it is ready to deliver data.

Parameters:

fileName -

columns - How many columns the original file had (must match exactly!)

Method Detail

existsFileDump

public static boolean existsFileDump(java.lang.String fileName)

Tests, whether the required files for this class, given with the fileName exist and are not of null-length (like after a failed start of FilePreparer

Parameters:

fileName - relative or absolute filename without index or data extensions

Returns:

getData

public java.util.List getData(java.lang.Integer wordNr)

For a given number returns the row

Specified by:

getData in interface BinFileMultCol

Parameters:

wordNr - Integer

Returns:

List::Integer[]

getData

public java.util.List getData(java.lang.Integer number,
                     int maxItems)

Returns the data for the given number up to the given maximum.

Specified by:

getData in interface BinFileMultCol

Parameters:

wordNr -

maxItems -

Returns:

getData

public java.util.List getData(java.lang.Integer number,
                     int myColumns,
                     int maxItems)

Returns the data for the given number up to the given maximum.

Specified by:

getData in interface BinFileMultCol

Parameters:

number - = the first column

myColumns - = how many columns to return

maxItems - = at max this count of items

Returns:

getData

public java.util.List getData(java.lang.Integer number,
                     int myColumns,
                     int maxItems,
                     int[] minCols,
                     int[] maxCols)

Returns the data for the given number up to the given maximum.

Specified by:

getData in interface BinFileMultCol

Parameters:

number - = the first column

myColumns - = how many columns to return

maxItems - = at max this count of items

minCols - = for each column each value minimum is specified here

maxCols - = for each column each value maximum is specified here

Returns:

getData

public java.util.List getData(java.lang.Integer number,
                     int maxItems,
                     int[] minCols,
                     int[] maxCols)

Returns the data for the given number up to the given maximum in a list.

Specified by:

getData in interface BinFileMultCol

Parameters:

wordNr - The number of the item of which to return the columns

maxItems - How many items to return at max

minCols - for each column the minimum allowed value (the whoe row will otherwise be omitted)

maxCols - for each column the maximum allowed value (the whoe row will otherwise be omitted)

Returns:

List::Integer[]

getDataAsMap

public java.util.Map getDataAsMap(java.lang.Integer wordNr)

Returns the data for the given number up to the given maximum in a map.

Specified by:

getDataAsMap in interface BinFileMultCol

Parameters:

wordNr - The number of the item of which to return the columns

Returns:

Map::Integer->Integer[]

getDataAsMap

public java.util.Map getDataAsMap(java.lang.Integer number,
                         int myColumns,
                         int maxItems)

Returns the data for the given number up to the given maximum.

Specified by:

getDataAsMap in interface BinFileMultCol

Parameters:

wordNr - The number of the item of which to return the columns

myColumns - How many columns to return

maxItems - How many items to return at max

Returns:

Map::Integer->Integer[]

getDataAsMap

public java.util.Map getDataAsMap(java.lang.Integer number,
                         int maxItems)

Returns the data for the given number up to the given maximum in a map.

Specified by:

getDataAsMap in interface BinFileMultCol

Parameters:

wordNr - The number of the item of which to return the columns

maxItems - How many items to return at max

Returns:

Map::Integer->Integer[]

getDataAsMap

public java.util.Map getDataAsMap(java.lang.Integer number,
                         int myColumns,
                         int maxItems,
                         int[] minCols,
                         int[] maxCols)

Returns the data for the given number up to the given maximum in a map.

Specified by:

getDataAsMap in interface BinFileMultCol

Parameters:

wordNr - The number of the item of which to return the columns

myColumns - How many columns to return

maxItems - How many items to return at max

minCols - for each column the minimum allowed value (the whoe row will otherwise be omitted)

maxCols - for each column the maximum allowed value (the whoe row will otherwise be omitted)

Returns:

Map::Integer->Integer[]

getDataAsMap

public java.util.Map getDataAsMap(java.lang.Integer number,
                         int maxItems,
                         int[] minCols,
                         int[] maxCols)

Returns the data for the given number up to the given maximum in a map.

Specified by:

getDataAsMap in interface BinFileMultCol

Parameters:

wordNr - The number of the item of which to return the columns

myColumns - How many columns to return

maxItems - How many items to return at max otherwise be omitted)

maxCols - for each column the maximum allowed value (the whoe row will otherwise be omitted)

Returns:

Map::Integer->Integer[]

getSingleColumn

public java.util.List getSingleColumn(java.lang.Integer number,
                             int col)

Column here is the column in the initial datafile, count begins with 1. Return the specified column completely.

Specified by:

getSingleColumn in interface BinFileMultCol

Parameters:

number -

col -

Returns:

List::Integer

getSingleColumn

public java.util.List getSingleColumn(java.lang.Integer number,
                             int maxItems,
                             int col)

Specified by:

getSingleColumn in interface BinFileMultCol

main

public static void main(java.lang.String[] args)

With this main method it's possible to test a prepared file. It will print some testcases. Takes two parameters, first is the filename, the second is the number of columns the has. The third is the number of columns to return.

Parameters:

args - String[]