org.dspace.app.itemimport

Class ItemImport

java.lang.Object

org.dspace.app.itemimport.ItemImport

public class ItemImport
extends Object

Import items into DSpace. The conventional use is upload files by copying them. DSpace writes the item's bitstreams into its assetstore. Metadata is also loaded to the DSpace database.

A second use assumes the bitstream files already exist in a storage resource accessible to DSpace. In this case the bitstreams are 'registered'. That is, the metadata is loaded to the DSpace database and DSpace is given the location of the file which is subsumed into DSpace.

The distinction is controlled by the format of lines in the 'contents' file. See comments in processContentsFile() below.

Modified by David Little, UCSD Libraries 12/21/04 to allow the registration of files (bitstreams) into DSpace.

Constructor Summary

Constructors

Constructor and Description
ItemImport()

Method Summary

Methods

Modifier and Type	Method and Description
void	addItems(Context c, Collection[] mycollections, String sourceDir, String mapFile, boolean template)
void	addItemsAtomic(Context c, Collection[] mycollections, String sourceDir, String mapFile, boolean template)
static void	cleanupZipTemp()
void	deleteBatchUpload(Context c, String uploadId)
static void	emailErrorMessage(EPerson eperson, String error) Since the BTE batch import is done in a new thread we are unable to communicate with calling method about success or failure.
static void	emailSuccessMessage(Context context, EPerson eperson, String fileName) Since the BTE batch import is done in a new thread we are unable to communicate with calling method about success or failure.
static List<BatchUpload>	getImportsAvailable(EPerson eperson)
static String	getImportUploadableDirectory(int ePersonID)
static String	getTempWorkDir()
static File	getTempWorkDirFile()
static void	main(String[] argv)
static void	processUIImport(String filepath, Collection owningCollection, String[] otherCollections, String resumeDir, String inputType, Context context) Given a local file or public URL to a zip file that has the Simple Archive Format, this method imports the contents to DSpace
static String	unzip(File zipfile)
static String	unzip(File zipfile, String destDir)
static String	unzip(String sourcedir, String zipfilename)

Methods inherited from class java.lang.Object

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

Constructor Detail

ItemImport

public ItemImport()

Method Detail

main

public static void main(String[] argv)
                 throws Exception

Throws:

Exception

addItemsAtomic

public void addItemsAtomic(Context c,
                  Collection[] mycollections,
                  String sourceDir,
                  String mapFile,
                  boolean template)
                    throws Exception

Throws:

Exception

addItems

public void addItems(Context c,
            Collection[] mycollections,
            String sourceDir,
            String mapFile,
            boolean template)
              throws Exception

Throws:

Exception

unzip

public static String unzip(File zipfile)
                    throws IOException

Throws:

IOException

unzip

public static String unzip(File zipfile,
           String destDir)
                    throws IOException

Throws:

IOException

unzip

public static String unzip(String sourcedir,
           String zipfilename)
                    throws IOException

Throws:

IOException

processUIImport

public static void processUIImport(String filepath,
                   Collection owningCollection,
                   String[] otherCollections,
                   String resumeDir,
                   String inputType,
                   Context context)
                            throws Exception

Given a local file or public URL to a zip file that has the Simple Archive Format, this method imports the contents to DSpace

Parameters:

filepath - The filepath to local file or the public URL of the zip file

owningCollection - The owning collection the items will belong to

otherCollections - The collections the created items will be inserted to, apart from the owning one

resumeDir - In case of a resume request, the directory that containsthe old mapfile and data

inputType - The input type of the data (bibtex, csv, etc.), in case of local file

context - The context

Throws:

Exception

emailSuccessMessage

public static void emailSuccessMessage(Context context,
                       EPerson eperson,
                       String fileName)
                                throws javax.mail.MessagingException

Since the BTE batch import is done in a new thread we are unable to communicate with calling method about success or failure. We accomplish this communication with email instead. Send a success email once the batch import is complete

Parameters:

context - - the current Context

eperson - - eperson to send the email to

fileName - - the filepath to the mapfile created by the batch import

Throws:

javax.mail.MessagingException

emailErrorMessage

public static void emailErrorMessage(EPerson eperson,
                     String error)
                              throws javax.mail.MessagingException

Since the BTE batch import is done in a new thread we are unable to communicate with calling method about success or failure. We accomplis this communication with email instead. Send an error email if the batch import fails

Parameters:

eperson - - EPerson to send the error message to

error - - the error message

Throws:

javax.mail.MessagingException

getImportsAvailable

public static List<BatchUpload> getImportsAvailable(EPerson eperson)
                                             throws Exception

Throws:

Exception

getImportUploadableDirectory

public static String getImportUploadableDirectory(int ePersonID)
                                           throws Exception

Throws:

Exception

deleteBatchUpload

public void deleteBatchUpload(Context c,
                     String uploadId)
                       throws Exception

Throws:

Exception

getTempWorkDir

public static String getTempWorkDir()

getTempWorkDirFile

public static File getTempWorkDirFile()

cleanupZipTemp

public static void cleanupZipTemp()