dk.netarkivet.common.distribute.arcrepository
Class TrivialArcRepositoryClient

java.lang.Object
  extended by dk.netarkivet.common.distribute.arcrepository.TrivialArcRepositoryClient
All Implemented Interfaces:
ArcRepositoryClient, HarvesterArcRepositoryClient, PreservationArcRepositoryClient, ViewerArcRepositoryClient

public class TrivialArcRepositoryClient
extends java.lang.Object
implements ArcRepositoryClient

A minimal implementation of ArcRepositoryClient that just has one local directory that it keeps its files in, no checking no nothing.


Constructor Summary
TrivialArcRepositoryClient()
           
 
Method Summary
 BatchStatus batch(FileBatchJob job, java.lang.String locationName)
          Runs a batch batch job on each file in the ArcRepository.
 void close()
          Call on shutdown to release external resources.
 BitarchiveRecord get(java.lang.String arcfile, long index)
          Gets a single ARC record out of the ArcRepository.
 void getFile(java.lang.String arcfilename, Location location, java.io.File toFile)
          Retrieves a file from an ArcRepository and places it in a local file.
 java.io.File removeAndGetFile(java.lang.String fileName, java.lang.String bitarchiveName, java.lang.String checksum, java.lang.String credentials)
          Remove a file from one part of the ArcRepository, retrieveing a copy for security purposes.
 void store(java.io.File file)
          Store the given file in the ArcRepository.
 void updateAdminChecksum(java.lang.String filename, java.lang.String checksum)
          Updates the checksum kept in the ArcRepository for a given file.
 void updateAdminData(java.lang.String fileName, java.lang.String bitarchiveName, BitArchiveStoreState newval)
          Updates the administrative data in the ArcRepository for a given file and location.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

TrivialArcRepositoryClient

public TrivialArcRepositoryClient()
Method Detail

close

public void close()
Call on shutdown to release external resources.

Specified by:
close in interface ArcRepositoryClient
Specified by:
close in interface HarvesterArcRepositoryClient
Specified by:
close in interface PreservationArcRepositoryClient
Specified by:
close in interface ViewerArcRepositoryClient

store

public void store(java.io.File file)
           throws IOFailure,
                  ArgumentNotValid
Store the given file in the ArcRepository. After storing, the file is deleted.

Specified by:
store in interface ArcRepositoryClient
Specified by:
store in interface HarvesterArcRepositoryClient
Specified by:
store in interface PreservationArcRepositoryClient
Parameters:
file - A file to be stored. Must exist.
Throws:
IOFailure - thrown if store is unsuccessful, or failed to clean up files after the store operation.
ArgumentNotValid - if file parameter is null or file is not an existing file.

get

public BitarchiveRecord get(java.lang.String arcfile,
                            long index)
                     throws ArgumentNotValid
Gets a single ARC record out of the ArcRepository.

Specified by:
get in interface ArcRepositoryClient
Specified by:
get in interface PreservationArcRepositoryClient
Specified by:
get in interface ViewerArcRepositoryClient
Parameters:
arcfile - The name of a file containing the desired record.
index - The offset of the desired record in the file
Returns:
a BitarchiveRecord-object, or null if request times out or object is not found.
Throws:
IOFailure - If the get operation failed.
ArgumentNotValid - if the given arcfile is null or empty string, or the given index is negative.

getFile

public void getFile(java.lang.String arcfilename,
                    Location location,
                    java.io.File toFile)
Retrieves a file from an ArcRepository and places it in a local file.

Specified by:
getFile in interface ArcRepositoryClient
Specified by:
getFile in interface PreservationArcRepositoryClient
Specified by:
getFile in interface ViewerArcRepositoryClient
Parameters:
arcfilename - Name of the arcfile to retrieve.
location - The bitarchive to retrieve the data from.
toFile - Filename of a place where the file fetched can be put.
Throws:
IOFailure - if there are problems getting a reply or the file could not be found.

batch

public BatchStatus batch(FileBatchJob job,
                         java.lang.String locationName)
Runs a batch batch job on each file in the ArcRepository.

Specified by:
batch in interface ArcRepositoryClient
Specified by:
batch in interface PreservationArcRepositoryClient
Specified by:
batch in interface ViewerArcRepositoryClient
Parameters:
job - An object that implements the FileBatchJob interface. The initialize() method will be called before processing and the finish() method will be called afterwards. The process() method will be called with each File entry.
locationName - The archive to execute the job on.
Returns:
The status of the batch job after it ended.

updateAdminData

public void updateAdminData(java.lang.String fileName,
                            java.lang.String bitarchiveName,
                            BitArchiveStoreState newval)
Updates the administrative data in the ArcRepository for a given file and location.

Specified by:
updateAdminData in interface ArcRepositoryClient
Specified by:
updateAdminData in interface PreservationArcRepositoryClient
Parameters:
fileName - The name of a file stored in the ArcRepository.
bitarchiveName - The name of the location that the administrative data for fileName is wrong for.
newval - What the administrative data will be updated to.

updateAdminChecksum

public void updateAdminChecksum(java.lang.String filename,
                                java.lang.String checksum)
Updates the checksum kept in the ArcRepository for a given file. It is the responsibility of the ArcRepository implementation to ensure that this checksum matches that of the underlying files.

Specified by:
updateAdminChecksum in interface ArcRepositoryClient
Specified by:
updateAdminChecksum in interface PreservationArcRepositoryClient
Parameters:
filename - The name of a file stored in the ArcRepository.
checksum - The new checksum.

removeAndGetFile

public java.io.File removeAndGetFile(java.lang.String fileName,
                                     java.lang.String bitarchiveName,
                                     java.lang.String checksum,
                                     java.lang.String credentials)
Remove a file from one part of the ArcRepository, retrieveing a copy for security purposes. This is typically used when repairing a file that has been corrupted.

Specified by:
removeAndGetFile in interface ArcRepositoryClient
Specified by:
removeAndGetFile in interface PreservationArcRepositoryClient
Parameters:
fileName - The name of the file to remove.
bitarchiveName - The location from which to remove the file.
checksum - The checksum of the file to be removed.
credentials - A string that shows that the user is allowed to perform this operation.
Returns:
A local copy of the file removed.