ome.formats.importer.cli

Class CommandLineImporter

java.lang.Object

ome.formats.importer.cli.CommandLineImporter

public class CommandLineImporter
extends Object

The base entry point for the CLI version of the OMERO importer.

Author:

Chris Allan , Josh Moore josh at glencoesoftware.com

Field Summary

Fields

Modifier and Type	Field and Description
ImportConfig	config Configuration used by all components
static int	DEFAULT_WAIT
List<FileExclusion>	exclusions FileExclusion mechanisms for skipping candidates
ErrorHandler	handler ErrorHandler which is also responsible for uploading files
ImportLibrary	library Base importer library, this is what we actually use to import.
FileTransfer	transfer FileTransfer mechanism to be used for uploading

Constructor Summary

Constructors

Constructor and Description
CommandLineImporter(ImportConfig config, String[] paths, boolean getUsedFiles) Legacy constructor which uses a UploadFileTransfer.
CommandLineImporter(ImportConfig config, String[] paths, boolean getUsedFiles, FileTransfer transfer, int minutesToWait) Legacy constructor without any file exclusions.
CommandLineImporter(ImportConfig config, String[] paths, boolean getUsedFiles, FileTransfer transfer, List<FileExclusion> exclusions, int minutesToWait) Main entry class for the application.

Method Summary

Methods

Modifier and Type	Method and Description
static void	advUsage() Prints advanced usage to STDERR and exits with return code 1.
void	cleanup() Cleans up after a successful or unsuccessful image import.
static int	closeCompleted(ImportConfig config) Look for all ImportProcessPrx in the current session and close them if they return a non-null Response (i.e. they are done).
static void	main(String[] args) Command line application entry point which parses CLI arguments and passes them into the importer.
static void	setArgument(Map<String,Boolean> map, String key) Set a conflicting argument and return the usage if the key is already set
int	start()
static void	usage() Prints usage to STDERR and exits with return code 1.
static int	waitCompleted(ImportConfig config) Look for all ImportProcessPrx in the current session and close them if they return a non-null Response (i.e. they are done).

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_WAIT

public static final int DEFAULT_WAIT

See Also:

Constant Field Values

config

public final ImportConfig config

Configuration used by all components

transfer

public final FileTransfer transfer

FileTransfer mechanism to be used for uploading

exclusions

public final List<FileExclusion> exclusions

FileExclusion mechanisms for skipping candidates

library

public final ImportLibrary library

Base importer library, this is what we actually use to import.

handler

public final ErrorHandler handler

ErrorHandler which is also responsible for uploading files

Constructor Detail

CommandLineImporter

public CommandLineImporter(ImportConfig config,
                   String[] paths,
                   boolean getUsedFiles)
                    throws Exception

Legacy constructor which uses a UploadFileTransfer.

Throws:

Exception

CommandLineImporter

public CommandLineImporter(ImportConfig config,
                   String[] paths,
                   boolean getUsedFiles,
                   FileTransfer transfer,
                   int minutesToWait)
                    throws Exception

Legacy constructor without any file exclusions.

Throws:

Exception

CommandLineImporter

public CommandLineImporter(ImportConfig config,
                   String[] paths,
                   boolean getUsedFiles,
                   FileTransfer transfer,
                   List<FileExclusion> exclusions,
                   int minutesToWait)
                    throws Exception

Main entry class for the application.

Throws:

Exception

Method Detail

closeCompleted

public static int closeCompleted(ImportConfig config)
                          throws Exception

Look for all ImportProcessPrx in the current session and close them if they return a non-null Response (i.e. they are done).

Throws:

Exception

waitCompleted

public static int waitCompleted(ImportConfig config)
                         throws Exception

Look for all ImportProcessPrx in the current session and close them if they return a non-null Response (i.e. they are done).

Throws:

Exception

start

public int start()

cleanup

public void cleanup()

Cleans up after a successful or unsuccessful image import. This method only does the minimum required cleanup, so that it can be called during shutdown.

usage

public static void usage()

Prints usage to STDERR and exits with return code 1.

advUsage

public static void advUsage()

Prints advanced usage to STDERR and exits with return code 1.

main

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

Command line application entry point which parses CLI arguments and passes them into the importer. Return codes for import are:

• 0 on success
• 1 on argument parsing failure
• 2 on exception during import

Return codes for the "-f" option (getUsedFiles) are:

• 0 on success, even if errors exist in the files
• 1 only if an exception propagates up the stack

Parameters:

args - Command line arguments.

Throws:

Exception

setArgument

public static void setArgument(Map<String,Boolean> map,
               String key)

Set a conflicting argument and return the usage if the key is already set

Parameters:

map - map of conflicting properties

key - configuration property to be set