ome.formats.importer

Class ImportConfig

java.lang.Object

ome.formats.importer.ImportConfig

public class ImportConfig
extends Object

Utility class which configures the Import.

Since:

Beta4.1

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ImportConfig.AnnotationListValue
static class	ImportConfig.BoolValue
static class	ImportConfig.DoubleArrayValue
static class	ImportConfig.FileValue
static class	ImportConfig.IntValue
static class	ImportConfig.LongValue
static class	ImportConfig.PassValue
static class	ImportConfig.StrValue
static class	ImportConfig.Value<T> Container which thread-safely makes a generic configuration value available, without requiring getters and setters.
static class	ImportConfig.VersionInfo Keys for fileset version information entries.

Field Summary

Fields

Modifier and Type	Field and Description
ImportConfig.StrValue	agent
ImportConfig.AnnotationListValue	annotations
ImportConfig.BoolValue	autoClose
ImportConfig.StrValue	checksumAlgorithm
ImportConfig.BoolValue	checkUpgrade
ImportConfig.BoolValue	contOnError
ImportConfig.BoolValue	debug
static String	DEFAULT_QABASEURL
ImportConfig.BoolValue	doThumbnails
ImportConfig.StrValue	email
ImportConfig.BoolValue	encryptedConnection
ImportConfig.LongValue	group
ImportConfig.StrValue	hostname
ImportConfig.BoolValue	noStatsInfo
ImportConfig.IntValue	numOfDirectories
ImportConfig.StrValue	password
ImportConfig.IntValue	port
ImportConfig.StrValue	qaBaseURL
static String	READERS_KEY Lookup key for System.getProperty(String).
ImportConfig.StrValue	readersPath
ImportConfig.LongValue	savedDataset
ImportConfig.FileValue	savedDirectory
ImportConfig.LongValue	savedProject
ImportConfig.LongValue	savedScreen
ImportConfig.BoolValue	sendFiles
ImportConfig.BoolValue	sendLogFile
ImportConfig.BoolValue	sendReport
static String	SERVER_NAME_SEPARATOR Delimiter used to encode multiple servers in one preferences value.
ImportConfig.StrValue	sessionKey
ImportConfig.StrValue	target
ImportConfig.StrValue	targetClass Deprecated.
ImportConfig.LongValue	targetId Deprecated.
ImportConfig.BoolValue	useCustomImageNaming
ImportConfig.BoolValue	useFullPath
ImportConfig.StrValue	username
ImportConfig.DoubleArrayValue	userPixels
ImportConfig.StrValue	userSpecifiedDescription
ImportConfig.StrValue	userSpecifiedName

Constructor Summary

Constructors

Constructor and Description
ImportConfig() Simplest constructor which use calls ImportConfig(File) with null.
ImportConfig(File configFile) Calls ImportConfig(Preferences, IniFileLoader, Properties) with user preferences, a local PreferenceContext, an IniFileLoader initialized with the given argument, and System.getProperties().
ImportConfig(Preferences prefs, IniFileLoader ini, Properties props) Complete constructor.

Method Summary

Modifier and Type	Method and Description
boolean	canLogin() Confirm all information for login is supplied
void	configureDebug(String levelString) Modifies the logging level of everything under the ome.formats, ome.services.blitz, ome.system and loci packages hierarchically.
OMEROMetadataStoreClient	createStore() Create and return a new OMEROMetadataStoreClient
void	fillVersionInfo(List<omero.model.NamedValue> versionInfo) Note useful version information that can be extracted from this system, as provenance that is useful for debugging.
String	getAppTitle()
String	getBioFormatsVersion()
boolean	getCustomImageNaming()
int	getDebugLevel()
String	getFeedbackUrl()
boolean	getForceFileArchiveOn()
String	getForumUrl()
String	getHomeUrl()
String	getIniVersionNumber()
String	getLogFile()
int	getNumOfDirectories()
String	getOmeroVersion()
boolean	getStaticDisableHistory()
ImportTarget	getTarget()
String	getTokenUrl()
Rectangle	getUIBounds()
String	getUploaderUrl()
boolean	getUseQuaqua()
boolean	getUserDisableHistory()
boolean	getUserFullPath()
String	getUserSettingsDirectory()
String	getVersionNumber()
boolean	isUpgradeNeeded() Check online to see if this is the current version
void	loadAll() Loads all the values for which it makes sense to have a preferences values.
void	loadGui() Loads gui specific values for which it makes sense to have a preferences values.
Map<String,String>	map()
protected <T> void	prompt(ImportConfig.Value<T> value, String prompt, boolean hide) Build prompt
void	requestFromUser() if can't log in request needed information
void	saveAll()
void	saveGui() Saves gui specific values for which it makes sense to have a preferences values.
void	setCustomImageNaming(boolean b)
void	setDebugLevel(int level)
void	setNumOfDirectories(int i)
void	setUIBounds(Rectangle bounds)
void	setUseQuaqua(boolean b)
void	setUserDisableHistory(boolean b)
void	setUserFullPath(boolean b)
void	setVersionNumber(String s)
protected List<ImportConfig.Value<?>>	values()

Methods inherited from class java.lang.Object

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

Field Detail

SERVER_NAME_SEPARATOR

public static final String SERVER_NAME_SEPARATOR

Delimiter used to encode multiple servers in one preferences value.

See Also:

Constant Field Values

READERS_KEY

public static final String READERS_KEY

Lookup key for System.getProperty(String). Should be the path of a readers.txt file.

See Also:

Constant Field Values

agent

public final ImportConfig.StrValue agent

hostname

public final ImportConfig.StrValue hostname

username

public final ImportConfig.StrValue username

password

public final ImportConfig.StrValue password

port

public final ImportConfig.IntValue port

savedProject

public final ImportConfig.LongValue savedProject

savedDataset

public final ImportConfig.LongValue savedDataset

savedScreen

public final ImportConfig.LongValue savedScreen

sessionKey

public final ImportConfig.StrValue sessionKey

group

public final ImportConfig.LongValue group

doThumbnails

public final ImportConfig.BoolValue doThumbnails

noStatsInfo

public final ImportConfig.BoolValue noStatsInfo

email

public final ImportConfig.StrValue email

userSpecifiedName

public final ImportConfig.StrValue userSpecifiedName

userSpecifiedDescription

public final ImportConfig.StrValue userSpecifiedDescription

targetClass

@Deprecated
public final ImportConfig.StrValue targetClass

Deprecated.

targetId

@Deprecated
public final ImportConfig.LongValue targetId

Deprecated.

target

public final ImportConfig.StrValue target

debug

public final ImportConfig.BoolValue debug

contOnError

public final ImportConfig.BoolValue contOnError

sendReport

public final ImportConfig.BoolValue sendReport

sendFiles

public final ImportConfig.BoolValue sendFiles

sendLogFile

public final ImportConfig.BoolValue sendLogFile

qaBaseURL

public final ImportConfig.StrValue qaBaseURL

checkUpgrade

public final ImportConfig.BoolValue checkUpgrade

useCustomImageNaming

public final ImportConfig.BoolValue useCustomImageNaming

useFullPath

public final ImportConfig.BoolValue useFullPath

numOfDirectories

public final ImportConfig.IntValue numOfDirectories

savedDirectory

public final ImportConfig.FileValue savedDirectory

readersPath

public final ImportConfig.StrValue readersPath

checksumAlgorithm

public final ImportConfig.StrValue checksumAlgorithm

encryptedConnection

public final ImportConfig.BoolValue encryptedConnection

autoClose

public final ImportConfig.BoolValue autoClose

annotations

public final ImportConfig.AnnotationListValue annotations

userPixels

public final ImportConfig.DoubleArrayValue userPixels

DEFAULT_QABASEURL

public static final String DEFAULT_QABASEURL

See Also:

Constant Field Values

Constructor Detail

ImportConfig

public ImportConfig()

Simplest constructor which use calls ImportConfig(File) with null.

ImportConfig

public ImportConfig(File configFile)

Calls ImportConfig(Preferences, IniFileLoader, Properties) with user preferences, a local PreferenceContext, an IniFileLoader initialized with the given argument, and System.getProperties().

Parameters:

configFile - Can be null.

ImportConfig

public ImportConfig(Preferences prefs,
                    IniFileLoader ini,
                    Properties props)

Complete constructor. All values can be null.

Parameters:

prefs - user and system preference and configuration data

ini - loads importer.ini or other specified file

props - a Java properties object overriding other sources of preferences and configuration data

Method Detail

getBioFormatsVersion

public String getBioFormatsVersion()

getOmeroVersion

public String getOmeroVersion()

fillVersionInfo

public void fillVersionInfo(List<omero.model.NamedValue> versionInfo)

Note useful version information that can be extracted from this system, as provenance that is useful for debugging.

Parameters:

versionInfo - the map into which version information is to be added

configureDebug

public void configureDebug(String levelString)

Modifies the logging level of everything under the ome.formats, ome.services.blitz, ome.system and loci packages hierarchically.

Parameters:

levelString - the level to set or, if null, then the initial debug level is used as before having been changed.

createStore

public OMEROMetadataStoreClient createStore()
                                     throws Exception

Create and return a new OMEROMetadataStoreClient

Returns:

a new OMEROMetadataStoreClient

Throws:

Exception - if the creation failed

isUpgradeNeeded

public boolean isUpgradeNeeded()

Check online to see if this is the current version

Returns:

if it is not the current version

canLogin

public boolean canLogin()

Confirm all information for login is supplied

Returns:

true if all is ok

getLogFile

public String getLogFile()

Returns:

ini log file

getHomeUrl

public String getHomeUrl()

Returns:

ini home URL

getForumUrl

public String getForumUrl()

Returns:

ini forum URL

getAppTitle

public String getAppTitle()

Returns:

ini application title

getForceFileArchiveOn

public boolean getForceFileArchiveOn()

Returns:

ini getForceFileArchiveOn

getStaticDisableHistory

public boolean getStaticDisableHistory()

Returns:

ini getStaticDisableHistory

getUserDisableHistory

public boolean getUserDisableHistory()

Returns:

ini getUserDisableHistory

setUserDisableHistory

public void setUserDisableHistory(boolean b)

Parameters:

b - - true if Quaqua should be used

getVersionNumber

public String getVersionNumber()

Returns:

ini version note

setVersionNumber

public void setVersionNumber(String s)

getIniVersionNumber

public String getIniVersionNumber()

Returns:

ini version number

getUserSettingsDirectory

public String getUserSettingsDirectory()

Returns:

ini user settings directory

getUseQuaqua

public boolean getUseQuaqua()

Returns:

ini option for if Qquaqua should be use for Macs

setUseQuaqua

public void setUseQuaqua(boolean b)

Parameters:

b - - true if Quaqua should be used

setDebugLevel

public void setDebugLevel(int level)

Parameters:

level - - default debug level

getDebugLevel

public int getDebugLevel()

Returns:

current debug level

getUIBounds

public Rectangle getUIBounds()

Returns:

UI bounds for application window

setUIBounds

public void setUIBounds(Rectangle bounds)

Parameters:

bounds - - set UI bounds for application window

getFeedbackUrl

public String getFeedbackUrl()

Returns:

feedback URL for QA system

getTokenUrl

public String getTokenUrl()

Returns:

token URL for QA system

getUploaderUrl

public String getUploaderUrl()

Returns:

upload URL for QA system

getUserFullPath

public boolean getUserFullPath()

Returns:

ini user full path

setUserFullPath

public void setUserFullPath(boolean b)

Parameters:

b - ini user full path

getCustomImageNaming

public boolean getCustomImageNaming()

Returns:

custom image naming

setCustomImageNaming

public void setCustomImageNaming(boolean b)

Parameters:

b - custom image naming

getNumOfDirectories

public int getNumOfDirectories()

Returns:

number of directories

setNumOfDirectories

public void setNumOfDirectories(int i)

Parameters:

i - number of directories

prompt

protected <T> void prompt(ImportConfig.Value<T> value,
                          String prompt,
                          boolean hide)

Build prompt

Type Parameters:

T - the kind of value contained by the "value" argument

Parameters:

value - the value

prompt - the prompt

hide - use *s for characters

requestFromUser

public void requestFromUser()

if can't log in request needed information

values

protected List<ImportConfig.Value<?>> values()

map

public Map<String,String> map()

loadGui

public void loadGui()

Loads gui specific values for which it makes sense to have a preferences values.

See Also:

saveAll()

saveGui

public void saveGui()

Saves gui specific values for which it makes sense to have a preferences values.

See Also:

saveAll()

loadAll

public void loadAll()

Loads all the values for which it makes sense to have a preferences values.

See Also:

saveAll()

saveAll

public void saveAll()

See Also:

loadAll()

getTarget

public ImportTarget getTarget()