net.sf.mmm.util.nls.base

Class AbstractResourceBundleCli

java.lang.Object

net.sf.mmm.util.component.base.AbstractLoggableObject

net.sf.mmm.util.cli.api.AbstractMain

net.sf.mmm.util.cli.api.AbstractVersionedMain

net.sf.mmm.util.nls.base.AbstractResourceBundleCli

Direct Known Subclasses:

ResourceBundleConverter, ResourceBundleSynchronizer

public abstract class AbstractResourceBundleCli
extends AbstractVersionedMain

The abstract base class for a CLI program to process NlsBundles or AbstractResourceBundles for localization maintenance.

Since:

7.3.0

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

See Also:

ResourceBundleSynchronizer

Field Summary

Fields

Modifier and Type	Field and Description
private List<Class<?>>	bundleClasses
private NlsBundleHelper	bundleHelper
private String	datePattern
protected static String	DEFAULT_BASE_PATH
private static String	DEFAULT_DATE_PATTERN
private static String	DEFAULT_ENCODING
private String	encoding
private String	newline
static String	OPTION_BUNDLE_CLASS The command-line option to set the bundle-class.
static String	OPTION_DATE_PATTERN The command-line option to set the date-pattern.
static String	OPTION_ENCODING The command-line option to set the encoding.
static String	OPTION_LOCALE The command-line option to set the locales.
static String	OPTION_PATH The command-line option to set the path.
private String	path
private ReflectionUtil	reflectionUtil
private NlsResourceBundleLocator	resourceBundleLocator

Fields inherited from class net.sf.mmm.util.cli.api.AbstractMain

EXIT_CODE_CONSTRAINT_VIOLATION, EXIT_CODE_ILLEGAL_SYNTAX, EXIT_CODE_OK, EXIT_CODE_UNEXPECTED

Constructor Summary

Constructors

Constructor and Description
AbstractResourceBundleCli() The constructor.

Method Summary

Modifier and Type	Method and Description
List<Class<?>>	getBundleClasses() This method gets the Class reflecting the ResourceBundle to synchronize.
NlsBundleHelper	getBundleHelper()
String	getDatePattern() This method gets the pattern used to format the date comment.
String	getEncoding() This method gets the encoding used to read and write the bundles.
abstract String[]	getLocales() This method gets the locales of the bundles that should be synchronized.
protected List<String>	getLocales(NlsBundleDescriptor bundle)
String	getNewline() This method sets the newline string used to terminate a line in the resource bundle.
String	getPath() This method gets the base-path where the bundles are written to.
ReflectionUtil	getReflectionUtil() This method gets the ReflectionUtil.
NlsResourceBundleLocator	getResourceBundleLocator() This method gets the NlsResourceBundleLocator.
protected abstract File	getTargetFile(NlsBundleDescriptor bundle, String locale)
protected File	getTargetFileMkdirs(NlsBundleDescriptor bundle, String locale)
private boolean	isProductive(Class<?> bundleClass) Determines if the given bundleClass is productive.
protected int	runDefaultMode() This method is called from AbstractVersionedMain.run(CliModeObject) if the program is executed in default mode.
void	setBundleClasses(List<Class<?>> bundleClasses) This method sets the bundle-classes.
void	setBundleHelper(NlsBundleHelper bundleHelper)
void	setDatePattern(String datePattern)
void	setEncoding(String encoding) This method sets the encoding.
void	setLocales(Locale... locales) This method sets the locales.
abstract void	setLocales(String[] locales) This method sets the locales.
void	setNewline(String newline)
void	setPath(String basePath) This method sets the base-path.
void	setReflectionUtil(ReflectionUtil reflectionUtil)
void	setResourceBundleLocator(NlsResourceBundleLocator resourceBundleFinder)
void	synchronize(NlsBundleDescriptor bundle) This method synchronizes (creates or updates) the localized bundles (properties).
protected abstract void	synchronize(NlsBundleDescriptor bundle, String locale, File targetFile, String date) Like synchronize(NlsBundleDescriptor) but for a single Locale.

Methods inherited from class net.sf.mmm.util.cli.api.AbstractVersionedMain

getVersion, run

Methods inherited from class net.sf.mmm.util.cli.api.AbstractMain

getIocContainer, getOutputSettings, getParserBuilder, getStandardError, getStandardOutput, getStreamUtil, handleError, printHelp, run, runAndExit, setStandardError, setStandardOutput, validate

Methods inherited from class net.sf.mmm.util.component.base.AbstractLoggableObject

getLogger

Methods inherited from class java.lang.Object

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

Field Detail

OPTION_DATE_PATTERN

public static final String OPTION_DATE_PATTERN

The command-line option to set the date-pattern.

See Also:

Constant Field Values

OPTION_ENCODING

public static final String OPTION_ENCODING

The command-line option to set the encoding.

See Also:

Constant Field Values

OPTION_PATH

public static final String OPTION_PATH

The command-line option to set the path.

See Also:

Constant Field Values

OPTION_BUNDLE_CLASS

public static final String OPTION_BUNDLE_CLASS

The command-line option to set the bundle-class.

See Also:

Constant Field Values

OPTION_LOCALE

public static final String OPTION_LOCALE

The command-line option to set the locales.

See Also:

Constant Field Values

DEFAULT_BASE_PATH

protected static final String DEFAULT_BASE_PATH

See Also:

getPath(), Constant Field Values

DEFAULT_ENCODING

private static final String DEFAULT_ENCODING

See Also:

Constant Field Values

DEFAULT_DATE_PATTERN

private static final String DEFAULT_DATE_PATTERN

See Also:

Constant Field Values

path

@CliOption(name="--path",
           aliases="-p",
           operand="DIR",
           usage="Write property-files to the base-path {operand} (Default is \"{default}\").")
private String path

encoding

@CliOption(name="--encoding",
           aliases="-e",
           operand="ENC",
           usage="Read and write property-files using the specified encoding {operand} (Default is {default}).")
private String encoding

newline

private String newline

datePattern

@CliOption(name="--date-pattern",
           aliases="-d",
           operand="PATTERN",
           usage="Use the specified date pattern {operand} for writing synchronization date to property-files (Default is \"{default}\").")
private String datePattern

bundleClasses

@CliOption(name="--bundle",
           aliases="-b",
           operand="CLASS",
           usage="The explicit list of bundle-classes for which the property-files should be created or updated. It has to be the fully qualified name of a subclass of AbstractResourceBundle. For all given locales the according property-file is created or updated. If this option is omitted the bundle-classes are resolved from all instances of META-INF/net.sf.mmm/nls-bundles on your classpath.")
private List<Class<?>> bundleClasses

resourceBundleLocator

private NlsResourceBundleLocator resourceBundleLocator

reflectionUtil

private ReflectionUtil reflectionUtil

bundleHelper

private NlsBundleHelper bundleHelper

Constructor Detail

AbstractResourceBundleCli

public AbstractResourceBundleCli()

The constructor.

Method Detail

getDatePattern

public String getDatePattern()

This method gets the pattern used to format the date comment.

Returns:

the date pattern.

See Also:

SimpleDateFormat

setDatePattern

public void setDatePattern(String datePattern)

Parameters:

datePattern - the datePattern to set

getLocales

public abstract String[] getLocales()

This method gets the locales of the bundles that should be synchronized. Examples for locales (entries of the returned array) are "", "en", or "en_GB".

Returns:

the locales to create/update.

setLocales

public abstract void setLocales(String[] locales)

This method sets the locales.

Parameters:

locales - are the locales to set

setLocales

public void setLocales(Locale... locales)

This method sets the locales.

Parameters:

locales - are the locales to set

getPath

public String getPath()

This method gets the base-path where the bundles are written to. They will appear there under their appropriate classpath. The default is DEFAULT_BASE_PATH.

Returns:

the basePath is the base path where the resource bundles are written to.

setPath

public void setPath(String basePath)

This method sets the base-path.

Parameters:

basePath - the basePath to set

getEncoding

public String getEncoding()

This method gets the encoding used to read and write the bundles. The default is UTF-8.

Returns:

the encoding.

setEncoding

public void setEncoding(String encoding)

This method sets the encoding.

Parameters:

encoding - the encoding to set

getNewline

public String getNewline()

This method sets the newline string used to terminate a line in the resource bundle. The default is LF (\n ).

Returns:

the newline

setNewline

public void setNewline(String newline)

Parameters:

newline - the newline to set

getBundleClasses

public List<Class<?>> getBundleClasses()

This method gets the Class reflecting the ResourceBundle to synchronize.

Returns:

the bundle-class.

setBundleClasses

public void setBundleClasses(List<Class<?>> bundleClasses)

This method sets the bundle-classes.

Parameters:

bundleClasses - is the List of bundle-classes to set

getResourceBundleLocator

public NlsResourceBundleLocator getResourceBundleLocator()

This method gets the NlsResourceBundleLocator.

Returns:

the NlsResourceBundleLocator.

setResourceBundleLocator

public void setResourceBundleLocator(NlsResourceBundleLocator resourceBundleFinder)

Parameters:

resourceBundleFinder - is the resourceBundleFinder to set

getReflectionUtil

public ReflectionUtil getReflectionUtil()

This method gets the ReflectionUtil.

Returns:

the ReflectionUtil.

setReflectionUtil

public void setReflectionUtil(ReflectionUtil reflectionUtil)

Parameters:

reflectionUtil - is the ReflectionUtil.

getBundleHelper

public NlsBundleHelper getBundleHelper()

Returns:

the NlsBundleHelper.

setBundleHelper

public void setBundleHelper(NlsBundleHelper bundleHelper)

Parameters:

bundleHelper - is the NlsBundleHelper.

synchronize

public void synchronize(NlsBundleDescriptor bundle)
                 throws IOException

This method synchronizes (creates or updates) the localized bundles (properties). If a bundle already exists, it will NOT just be overwritten but the missing keys are appended to the end of the file. If no keys are missing, the existing file remains untouched.

Parameters:

bundle - is the bundle instance as java object.

Throws:

IOException - if the operation failed with an input/output error.

getTargetFileMkdirs

protected File getTargetFileMkdirs(NlsBundleDescriptor bundle,
                                   String locale)

getTargetFile

protected abstract File getTargetFile(NlsBundleDescriptor bundle,
                                      String locale)

getLocales

protected List<String> getLocales(NlsBundleDescriptor bundle)

Parameters:

bundle - the NlsBundleDescriptor.

Returns:

the locales to process for the bundle.

synchronize

protected abstract void synchronize(NlsBundleDescriptor bundle,
                                    String locale,
                                    File targetFile,
                                    String date)
                             throws IOException

Like synchronize(NlsBundleDescriptor) but for a single Locale.

Parameters:

bundle - the bundle instance as java object.

locale - the locale to synchronize as string.

targetFile - the File to write to. May not yet exists but parent folder exists.

date - is the current date as string.

Throws:

IOException - if an I/O problem occurred.

runDefaultMode

protected int runDefaultMode()
                      throws Exception

Description copied from class: AbstractVersionedMain

This method is called from AbstractVersionedMain.run(CliModeObject) if the program is executed in default mode.

Specified by:

runDefaultMode in class AbstractVersionedMain

Returns:

the error-code or AbstractMain.EXIT_CODE_OK on success.

Throws:

Exception - in case of an unexpected error.

isProductive

private boolean isProductive(Class<?> bundleClass)

Determines if the given bundleClass is productive.

Parameters:

bundleClass - is the Class to test.

Returns:

true if productive, false otherwise.