org.egothor.duplicity.file

Class AllSimilarUnitPairsFile

java.lang.Object

org.egothor.duplicity.file.DuplicityCheckingFile

org.egothor.duplicity.file.CommonSimilarUnitPairsFile

org.egothor.duplicity.file.MergeableSimilarUnitPairsFile

org.egothor.duplicity.file.AllSimilarUnitPairsFile

public class AllSimilarUnitPairsFile
extends MergeableSimilarUnitPairsFile

Represents the merge of "similar unit pairs" files for all permutations that is used in the duplicity checking algorithm. The file contains instances of UnitPair class. That means it contains pairs {first, second}, where first, second are identificators of units on which we check duplicity (can be document, paragraph or sentence). The file is sorted - the main criteria is first field, in case of tie second field. The file is used as temporary file, from which the JaccardCoeficientsFile is created. Currently, the file is never written to filesystem and is only an abstraction, because the JaccardCoeficientsFile is created directly when merging. The out field of the file is used for the created JaccardCoeficientsFile file.

The file should be used as follows.

1. First it should be created using constructor in a given location. You must specify whether this instance will produce regular JaccardCoeficientsFile or a temporary one (in temp directory).
2. It can be used to merge files corresponding to any permutations to produce JaccardCoeficientsFile, by a call to mergeToJaccardCoeficientsFile(java.util.ArrayList<org.egothor.duplicity.file.CommonSimilarUnitPairsFile>) method.

Author:

Kateřina Dufková

Constructor Summary

Constructors

Constructor and Description
AllSimilarUnitPairsFile(String location, boolean createTemp) Initialializes the file.

Method Summary

Modifier and Type	Method and Description
void	delete() Deletes the file from filesystem.
String	getFilename() Returns the filename corresponding to the JaccardCoeficientsFile to be created by this instance.
JaccardCoeficientsFile	mergeToJaccardCoeficientsFile(ArrayList<CommonSimilarUnitPairsFile> supfs) Merges given similar unit pairs files and produces the JaccardCoeficientsFile by aggregating the unit pairs.
String	toString()

Methods inherited from class org.egothor.duplicity.file.CommonSimilarUnitPairsFile

dump, getPermID, hasTheSameContent, remove

Methods inherited from class org.egothor.duplicity.file.DuplicityCheckingFile

getLocation, getOut, hasTheSameContent

Methods inherited from class java.lang.Object

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

Constructor Detail

AllSimilarUnitPairsFile

public AllSimilarUnitPairsFile(String location,
                               boolean createTemp)
                        throws IOException

Initialializes the file. Sets permID (to invalid value), location and createTemp fields. Whether a regular or temporary file will be created depends on the createTemp field. The filename is in form returned by getFilename() and will be searched in the location directory.

Parameters:

location - path and name of the directory where to create JaccardCoeficientsFile

createTemp - sign if the JaccardCoeficientsFile file should be created in temp directory, and the file should be rewritten if it already exists

Throws:

FileNotFoundException - if the file could not be created

IOException

Method Detail

mergeToJaccardCoeficientsFile

public JaccardCoeficientsFile mergeToJaccardCoeficientsFile(ArrayList<CommonSimilarUnitPairsFile> supfs)
                                                     throws IOException

Merges given similar unit pairs files and produces the JaccardCoeficientsFile by aggregating the unit pairs. The JaccardCoeficientsFile will be created on filesystem in the location specified when creating this AllSimilarUnitPairsFile instance. Whether a regular or temporary file will be created also depends on parameter createTemp specified on creation.

Parameters:

supfs - list of files to be merged. List can contain regular (SimilarUnitPairsFile) or temporary (SimilarUnitPairsTempFile)

Returns:

instance of JaccardCoeficientsFile written to filesystem

Throws:

IOException - on error while reading from this file, or creating result file, or writing to result file

delete

public void delete()

Description copied from class: DuplicityCheckingFile

Deletes the file from filesystem.

Overrides:

delete in class DuplicityCheckingFile

toString

public String toString()

Overrides:

toString in class CommonSimilarUnitPairsFile

Returns:

getFilename

public String getFilename()

Returns the filename corresponding to the JaccardCoeficientsFile to be created by this instance. The location field MUST be already set. The filename is created in the directory given in the location field and is in form Constants.JACCARD_COEFICIENTS_FILE_NAME.

Specified by:

getFilename in class DuplicityCheckingFile