Package org.wikidata.wdtk.dumpfiles.wmf

Class WmfOnlineStandardDumpFile

java.lang.Object

org.wikidata.wdtk.dumpfiles.wmf.WmfDumpFile

org.wikidata.wdtk.dumpfiles.wmf.WmfOnlineStandardDumpFile

All Implemented Interfaces:

MwDumpFile

public class WmfOnlineStandardDumpFile
extends WmfDumpFile

Class for representing dump files published by the Wikimedia Foundation in the main common location of all dump files. This excludes incremental daily dumps, which are found in another directory. The dump file and additional information about its status is online and web access is needed to fetch this data on demand.

Author:

Markus Kroetzsch

Nested Class Summary

Nested classes/interfaces inherited from interface org.wikidata.wdtk.dumpfiles.MwDumpFile

MwDumpFile.DateComparator

Field Summary

Fields inherited from class org.wikidata.wdtk.dumpfiles.wmf.WmfDumpFile

dateStamp, DUMP_SITE_BASE_URL, projectName

Constructor Summary

Constructors

Constructor	Description
WmfOnlineStandardDumpFile(java.lang.String dateStamp, java.lang.String projectName, org.wikidata.wdtk.util.WebResourceFetcher webResourceFetcher, org.wikidata.wdtk.util.DirectoryManager dumpfileDirectoryManager, DumpContentType dumpContentType)	Constructor.

Method Summary

Modifier and Type	Method	Description
protected boolean	fetchIsDone()	Finds out if the dump is ready.
DumpContentType	getDumpContentType()	Returns information about the content of the dump.
java.io.InputStream	getDumpFileStream()	Returns an input stream that provides access to the (uncompressed) text content of the dump file.
void	prepareDumpFile()	Prepares the dump file for access via MwDumpFile.getDumpFileStream() or MwDumpFile.getDumpFileReader().

Methods inherited from class java.lang.Object

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

Methods inherited from class org.wikidata.wdtk.dumpfiles.wmf.WmfDumpFile

getDateStamp, getDateStampFromDumpFileDirectoryName, getDumpFileCompressionType, getDumpFileDirectoryName, getDumpFileName, getDumpFilePostfix, getDumpFileReader, getDumpFileWebDirectory, getProjectName, isAvailable, isRevisionDumpFile, toString

Constructor Detail

WmfOnlineStandardDumpFile

public WmfOnlineStandardDumpFile(java.lang.String dateStamp,
                                 java.lang.String projectName,
                                 org.wikidata.wdtk.util.WebResourceFetcher webResourceFetcher,
                                 org.wikidata.wdtk.util.DirectoryManager dumpfileDirectoryManager,
                                 DumpContentType dumpContentType)

Constructor.

Parameters:

dateStamp - dump date in format YYYYMMDD

projectName - project name string

webResourceFetcher - object to use for accessing the web

dumpfileDirectoryManager - the directory manager for the directory where dumps should be downloaded to

dumpContentType - the type of dump this represents

Method Detail

getDumpContentType

public DumpContentType getDumpContentType()

Description copied from interface: MwDumpFile

Returns information about the content of the dump. Together with the project name and date stamp, this identifies the dump, and it is therefore always available.

Returns:

the content type of this dump

getDumpFileStream

public java.io.InputStream getDumpFileStream()
                                      throws java.io.IOException

Description copied from interface: MwDumpFile

Returns an input stream that provides access to the (uncompressed) text content of the dump file.

It is important to close the stream after use.

Returns:

an input stream to read the dump file

Throws:

java.io.IOException - if the dump file contents could not be accessed

prepareDumpFile

public void prepareDumpFile()
                     throws java.io.IOException

Description copied from interface: MwDumpFile

Prepares the dump file for access via MwDumpFile.getDumpFileStream() or MwDumpFile.getDumpFileReader(). In particular, this will download any remote files.

Throws:

java.io.IOException - if there was a problem preparing the files

fetchIsDone

protected boolean fetchIsDone()

Description copied from class: WmfDumpFile

Finds out if the dump is ready. For online dumps, this should return true if the file can be fetched from the Web. For local dumps, this should return true if the file is complete and not corrupted. For some types of dumps, there are ways of checking this easily (i.e., without reading the full file). If this is not possible, then the method should just return "true."

Specified by:

fetchIsDone in class WmfDumpFile

Returns:

true if the dump is done