org.jomc.tools

Class JomcTool

java.lang.Object

org.jomc.tools.JomcTool

Direct Known Subclasses:

ClassFileProcessor, ResourceFileProcessor, SourceFileProcessor

public class JomcTool
extends Object

Base tool class.

Version:

$JOMC: JomcTool.java 5043 2015-05-27 07:03:39Z schulte $

Author:

Christian Schulte

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JomcTool.Listener Listener interface.

Constructor Summary

Constructors

Constructor and Description
JomcTool() Creates a new JomcTool instance.
JomcTool(JomcTool tool) Creates a new JomcTool instance taking a JomcTool instance to initialize the new instance with.

Method Summary

Methods

Modifier and Type	Method and Description
String	getBooleanString(Boolean b) Formats a Boolean to a string.
String	getCsvString(String str) Formats a string to a CSV string.
static Level	getDefaultLogLevel() Gets the default log level events are logged at.
String	getDefaultTemplateEncoding() Gets the default encoding used for reading templates.
static String	getDefaultTemplateProfile() Deprecated. The static modifier of this method and support to setup the default template profile using a system property will be removed in version 2.0.
String	getDisplayLanguage(String language) Gets the display language of a given language code.
String	getHtmlString(String str) Formats a string to a HTML string with HTML entities.
List<String>	getImplementedJavaTypeNames(Implementation implementation, boolean qualified) Deprecated. As of JOMC 1.4, please use method Modules.getImplementedJavaTypeNames(java.lang.String). This method will be removed in JOMC 2.0.
String	getIndentation() Gets the indentation string of the instance.
String	getIndentation(int level) Gets an indentation string for a given indentation level.
String	getInputEncoding() Gets the encoding to use for reading files.
String	getIsoDate(Calendar calendar) Formats a calendar instance to a string.
String	getIsoDateTime(Calendar calendar) Formats a calendar instance to a string.
String	getIsoTime(Calendar calendar) Formats a calendar instance to a string.
String	getJavaClasspathLocation(Implementation implementation) Deprecated. As of JOMC 1.4, please use method Implementation.getJavaTypeName(). This method will be removed in JOMC 2.0.
String	getJavaClasspathLocation(Specification specification) Deprecated. As of JOMC 1.4, please use method Specification.getJavaTypeName(). This method will be removed in JOMC 2.0.
String	getJavaClasspathLocation(String str, boolean absolute) Deprecated. As of JOMC 1.4, please use JavaTypeName.getQualifiedName(). This method will be removed in JOMC 2.0.
String	getJavaConstantName(String str) Deprecated. As of JOMC 1.4, please use method toJavaConstantName(java.lang.String). This method will be removed in JOMC 2.0.
String	getJavadocComment(Text text, int indentationLevel, String linePrefix) Deprecated. As of JOMC 1.4, please use method Text.getJavadocComment(java.lang.String, java.lang.String). This method will be removed in JOMC 2.0.
String	getJavadocComment(Texts texts, int indentationLevel, String linePrefix) Deprecated. As of JOMC 1.4, please use method Text.getJavadocComment(java.lang.String, java.lang.String). This method will be removed in JOMC 2.0.
String	getJavaFieldName(Dependency dependency) Deprecated. As of JOMC 1.4, please use method Dependency.getJavaVariableName(). This method will be removed in JOMC 2.0.
String	getJavaFieldName(Message message) Deprecated. As of JOMC 1.4, please use method Message.getJavaVariableName(). This method will be removed in JOMC 2.0.
String	getJavaFieldName(Property property) Deprecated. As of JOMC 1.4, please use method Property.getJavaVariableName(). This method will be removed in JOMC 2.0.
String	getJavaFieldName(String str) Deprecated. As of JOMC 1.4, please use method toJavaVariableName(java.lang.String). This method will be removed in JOMC 2.0.
String	getJavaGetterMethodName(Dependency dependency) Deprecated. As of JOMC 1.4, please use method Dependency.getJavaGetterMethodName(). This method will be removed in JOMC 2.0.
String	getJavaGetterMethodName(Message message) Deprecated. As of JOMC 1.4, please use method Message.getJavaGetterMethodName(). This method will be removed in JOMC 2.0.
String	getJavaGetterMethodName(Property property) Deprecated. As of JOMC 1.4, please use method Property.getJavaGetterMethodName(). This method will be removed in JOMC 2.0.
String	getJavaIdentifier(String str, boolean capitalize) Deprecated. As of JOMC 1.4, please use method toJavaVariableName(java.lang.String). This method will be removed in JOMC 2.0.
List<String>	getJavaInterfaceNames(Implementation implementation, boolean qualified) Deprecated. As of JOMC 1.2, replaced by method getImplementedJavaTypeNames(org.jomc.model.Implementation, boolean). This method will be removed in version 2.0.
String	getJavaMethodParameterName(Argument argument) Deprecated. As of JOMC 1.4, please use method Argument.getJavaVariableName(). This method will be removed in JOMC 2.0.
String	getJavaMethodParameterName(Dependency dependency) Deprecated. As of JOMC 1.4, please use method Dependency.getJavaVariableName(). This method will be removed in JOMC 2.0.
String	getJavaMethodParameterName(Message message) Deprecated. As of JOMC 1.4, please use method Message.getJavaVariableName(). This method will be removed in JOMC 2.0.
String	getJavaMethodParameterName(Property property) Deprecated. As of JOMC 1.4, please use method Property.getJavaVariableName(). This method will be removed in JOMC 2.0.
String	getJavaMethodParameterName(String str) Deprecated. As of JOMC 1.4, please use method toJavaVariableName(java.lang.String). This method will be removed in JOMC 2.0.
String	getJavaModifierName(Implementation implementation, Dependency dependency) Deprecated. As of JOMC 1.4, please use method Modules.getDependencyJavaModifierName(java.lang.String, java.lang.String). This method will be removed in JOMC 2.0.
String	getJavaModifierName(Implementation implementation, Message message) Deprecated. As of JOMC 1.4, please use method Modules.getMessageJavaModifierName(java.lang.String, java.lang.String). This method will be removed in JOMC 2.0.
String	getJavaModifierName(Implementation implementation, Property property) Deprecated. As of JOMC 1.4, please use method Modules.getPropertyJavaModifierName(java.lang.String, java.lang.String). This method will be removed in JOMC 2.0.
String	getJavaPackageName(Implementation implementation) Deprecated. As of JOMC 1.4, please use method Implementation.getJavaTypeName(). This method will be removed in JOMC 2.0.
String	getJavaPackageName(Specification specification) Deprecated. As of JOMC 1.4, please use method Specification.getJavaTypeName(). This method will be removed in JOMC 2.0.
String	getJavaPackageName(SpecificationReference reference) Deprecated. As of JOMC 1.4, please use method Specification.getJavaTypeName(). This method will be removed in JOMC 2.0.
String	getJavaScriptString(String str) Formats a string to a JavaScript string applying JavaScript string rules.
String	getJavaSetterMethodName(Dependency dependency) Deprecated. As of JOMC 1.4, please use method Dependency.getJavaSetterMethodName(). This method will be removed in JOMC 2.0.
String	getJavaSetterMethodName(Message message) Deprecated. As of JOMC 1.4, please use method Message.getJavaSetterMethodName(). This method will be removed in JOMC 2.0.
String	getJavaSetterMethodName(Property property) Deprecated. As of JOMC 1.4, please use method Property.getJavaSetterMethodName(). This method will be removed in JOMC 2.0.
String	getJavaString(String str) Formats a string to a Java string with unicode escapes.
String	getJavaTypeName(Argument argument) Deprecated. As of JOMC 1.4, please use method Argument.getJavaTypeName(). This method will be removed in JOMC 2.0.
String	getJavaTypeName(Dependency dependency) Deprecated. As of JOMC 1.4, please use method Modules.getDependencyJavaTypeName(java.lang.String, java.lang.String). This method will be removed in JOMC 2.0.
String	getJavaTypeName(Implementation implementation, boolean qualified) Deprecated. As of JOMC 1.4, please use method Implementation.getJavaTypeName(). This method will be removed in JOMC 2.0.
String	getJavaTypeName(Property property, boolean boxify) Deprecated. As of JOMC 1.4, please use method Property.getJavaTypeName(). This method will be removed in JOMC 2.0.
String	getJavaTypeName(Specification specification, boolean qualified) Deprecated. As of JOMC 1.4, please use method Specification.getJavaTypeName(). This method will be removed in JOMC 2.0.
String	getJavaTypeName(SpecificationReference reference, boolean qualified) Deprecated. As of JOMC 1.4, please use method Specification.getJavaTypeName(). This method will be removed in JOMC 2.0.
String	getLineSeparator() Gets the line separator of the instance.
List<JomcTool.Listener>	getListeners() Gets the list of registered listeners.
Locale	getLocale() Gets the locale of the instance.
Level	getLogLevel() Gets the log level of the instance.
String	getLongDate(Calendar calendar) Formats a calendar instance to a string.
String	getLongDateTime(Calendar calendar) Formats a calendar instance to a string.
String	getLongTime(Calendar calendar) Formats a calendar instance to a string.
String	getMediumDate(Calendar calendar) Formats a calendar instance to a string.
String	getMediumDateTime(Calendar calendar) Formats a calendar instance to a string.
String	getMediumTime(Calendar calendar) Formats a calendar instance to a string.
Model	getModel() Gets the model of the instance.
Modules	getModules() Gets the modules of the model of the instance.
String	getOutputEncoding() Gets the encoding to use for writing files.
String	getParentTemplateProfile(String tp) Gets the parent template profile of a given template profile.
String	getShortDate(Calendar calendar) Formats a calendar instance to a string.
String	getShortDateTime(Calendar calendar) Formats a calendar instance to a string.
String	getShortTime(Calendar calendar) Formats a calendar instance to a string.
String	getSqlString(String str) Formats a string to a SQL string.
String	getTemplateEncoding() Deprecated. As of JOMC 1.3, replaced by method getDefaultTemplateEncoding(). This method will be removed in JOMC 2.0.
String	getTemplateEncoding(String tp) Gets the template encoding of a given template profile.
URL	getTemplateLocation() Gets the location to search for templates in addition to searching the class path.
Map<String,Object>	getTemplateParameters() Gets the template parameters of the instance.
String	getTemplateProfile() Gets the template profile of the instance.
VelocityContext	getVelocityContext() Gets a new velocity context used for merging templates.
VelocityEngine	getVelocityEngine() Gets the VelocityEngine of the instance.
Template	getVelocityTemplate(String templateName) Gets a velocity template for a given name.
String	getXmlString(String str) Formats a string to a XML string with XML entities.
String	getYears(Calendar start, Calendar end) Gets a string describing the range of years for given calendars.
boolean	isJavaDefaultPackage(Implementation implementation) Deprecated. As of JOMC 1.4, please use method Implementation.getJavaTypeName(). This method will be removed in JOMC 2.0.
boolean	isJavaDefaultPackage(Specification specification) Deprecated. As of JOMC 1.4, please use method Specification.getJavaTypeName(). This method will be removed in JOMC 2.0.
boolean	isJavaPrimitiveType(Property property) Deprecated. As of JOMC 1.4, please use method Property.getJavaTypeName(). This method will be removed in JOMC 2.0.
boolean	isLoggable(Level level) Checks if a message at a given level is provided to the listeners of the instance.
void	log(Level level, String message, Throwable throwable) Notifies registered listeners.
static void	setDefaultLogLevel(Level value) Sets the default log level events are logged at.
void	setDefaultTemplateEncoding(String value) Sets the default encoding to use for reading templates.
static void	setDefaultTemplateProfile(String value) Deprecated. The static modifier of this method will be removed in version 2.0.
void	setIndentation(String value) Sets the indentation string of the instance.
void	setInputEncoding(String value) Sets the encoding to use for reading files.
void	setLineSeparator(String value) Sets the line separator of the instance.
void	setLocale(Locale value) Sets the locale of the instance.
void	setLogLevel(Level value) Sets the log level of the instance.
void	setModel(Model value) Sets the model of the instance.
void	setOutputEncoding(String value) Sets the encoding to use for writing files.
void	setTemplateEncoding(String value) Deprecated. As of JOMC 1.3, replaced by method setDefaultTemplateEncoding(java.lang.String). This method will be removed in JOMC 2.0.
void	setTemplateLocation(URL value) Sets the location to search for templates in addition to searching the class path.
void	setTemplateProfile(String value) Sets the template profile of the instance.
void	setVelocityEngine(VelocityEngine value) Sets the VelocityEngine of the instance.
JavaIdentifier	toJavaConstantName(String str) Compiles a string to a Java constant name.
JavaIdentifier	toJavaMethodName(String str) Compiles a string to a Java method name.
JavaIdentifier	toJavaVariableName(String str) Compiles a string to a Java variable name.

Methods inherited from class java.lang.Object

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

Constructor Detail

JomcTool

public JomcTool()

Creates a new JomcTool instance.

JomcTool

public JomcTool(JomcTool tool)
         throws IOException

Creates a new JomcTool instance taking a JomcTool instance to initialize the new instance with.

Parameters:

tool - The instance to initialize the new instance with.

Throws:

NullPointerException - if tool is null.

IOException - if copying tool fails.

Method Detail

getListeners

public List<JomcTool.Listener> getListeners()

Gets the list of registered listeners.

This accessor method returns a reference to the live list, not a snapshot. Therefore any modification you make to the returned list will be present inside the object. This is why there is no set method for the listeners property.

Returns:

The list of registered listeners.

See Also:

log(java.util.logging.Level, java.lang.String, java.lang.Throwable)

getDefaultLogLevel

public static Level getDefaultLogLevel()

Gets the default log level events are logged at.

The default log level is controlled by system property org.jomc.tools.JomcTool.defaultLogLevel holding the log level to log events at by default. If that property is not set, the WARNING default is returned.

Returns:

The log level events are logged at by default.

See Also:

getLogLevel(), Level.parse(java.lang.String)

setDefaultLogLevel

public static void setDefaultLogLevel(Level value)

Sets the default log level events are logged at.

Parameters:

value - The new default level events are logged at or null.

See Also:

getDefaultLogLevel()

getLogLevel

public final Level getLogLevel()

Gets the log level of the instance.

Returns:

The log level of the instance.

See Also:

getDefaultLogLevel(), setLogLevel(java.util.logging.Level), isLoggable(java.util.logging.Level)

setLogLevel

public final void setLogLevel(Level value)

Sets the log level of the instance.

Parameters:

value - The new log level of the instance or null.

See Also:

getLogLevel(), isLoggable(java.util.logging.Level)

isLoggable

public boolean isLoggable(Level level)

Checks if a message at a given level is provided to the listeners of the instance.

Parameters:

level - The level to test.

Returns:

true, if messages at level are provided to the listeners of the instance; false, if messages at level are not provided to the listeners of the instance.

Throws:

NullPointerException - if level is null.

See Also:

getLogLevel(), setLogLevel(java.util.logging.Level), log(java.util.logging.Level, java.lang.String, java.lang.Throwable)

getJavaPackageName

@Deprecated
public String getJavaPackageName(Specification specification)
                          throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Specification.getJavaTypeName(). This method will be removed in JOMC 2.0.

Gets the Java package name of a specification.

Parameters:

specification - The specification to get the Java package name of.

Returns:

The Java package name of specification or null, if the specification does not reference a type.

Throws:

NullPointerException - if specification is null.

ModelObjectException - if compiling the name of the referenced type to a JavaTypeName fails.

See Also:

Specification.getJavaTypeName(), JavaTypeName.getPackageName()

getJavaTypeName

@Deprecated
public String getJavaTypeName(Specification specification,
                                boolean qualified)
                       throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Specification.getJavaTypeName(). This method will be removed in JOMC 2.0.

Gets the Java type name of a specification.

Parameters:

specification - The specification to get the Java type name of.

qualified - true, to return the fully qualified type name (with package name prepended); false, to return the short type name (without package name prepended).

Returns:

The Java type name of the type referenced by the specification or null, if the specification does not reference a type.

Throws:

NullPointerException - if specification is null.

ModelObjectException - if compiling the name of the referenced type to a JavaTypeName fails.

See Also:

Specification.getJavaTypeName(), JavaTypeName.getName(boolean)

getJavaClasspathLocation

@Deprecated
public String getJavaClasspathLocation(Specification specification)
                                throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Specification.getJavaTypeName(). This method will be removed in JOMC 2.0.

Gets the Java class path location of a specification.

Parameters:

specification - The specification to return the Java class path location of.

Returns:

The Java class path location of specification or null, if the specification does not reference a type.

Throws:

NullPointerException - if specification is null.

ModelObjectException - if compiling the name of the referenced type to a JavaTypeName fails.

See Also:

Specification.getJavaTypeName(), JavaTypeName.getQualifiedName()

getJavaPackageName

@Deprecated
public String getJavaPackageName(SpecificationReference reference)
                          throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Specification.getJavaTypeName(). This method will be removed in JOMC 2.0.

Gets the Java package name of a specification reference.

Parameters:

reference - The specification reference to get the Java package name of.

Returns:

The Java package name of reference or null, if the referenced specification is not found or does not reference a type.

Throws:

NullPointerException - if reference is null.

ModelObjectException - if compiling the name of the referenced type to a JavaTypeName fails.

See Also:

Modules.getSpecification(java.lang.String), Specification.getJavaTypeName(), JavaTypeName.getPackageName()

getJavaTypeName

@Deprecated
public String getJavaTypeName(SpecificationReference reference,
                                boolean qualified)
                       throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Specification.getJavaTypeName(). This method will be removed in JOMC 2.0.

Gets the name of a Java type of a given specification reference.

Parameters:

reference - The specification reference to get a Java type name of.

qualified - true, to return the fully qualified type name (with package name prepended); false, to return the short type name (without package name prepended).

Returns:

The Java type name of reference or null, if the referenced specification is not found or does not reference a type.

Throws:

NullPointerException - if reference is null.

ModelObjectException - if compiling the name of the referenced type to a JavaTypeName fails.

See Also:

Modules.getSpecification(java.lang.String), Specification.getJavaTypeName(), JavaTypeName.getName(boolean)

getJavaPackageName

@Deprecated
public String getJavaPackageName(Implementation implementation)
                          throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Implementation.getJavaTypeName(). This method will be removed in JOMC 2.0.

Gets the Java package name of an implementation.

Parameters:

implementation - The implementation to get the Java package name of.

Returns:

The Java package name of implementation or null, if the implementation does not reference a type.

Throws:

NullPointerException - if implementation is null.

ModelObjectException - if compiling the name of the referenced type to a JavaTypeName fails.

See Also:

Implementation.getJavaTypeName(), JavaTypeName.getPackageName()

getJavaTypeName

@Deprecated
public String getJavaTypeName(Implementation implementation,
                                boolean qualified)
                       throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Implementation.getJavaTypeName(). This method will be removed in JOMC 2.0.

Gets the Java type name of an implementation.

Parameters:

implementation - The implementation to get the Java type name of.

qualified - true, to return the fully qualified type name (with package name prepended); false, to return the short type name (without package name prepended).

Returns:

The Java type name of the type referenced by the implementation or null, if the implementation does not reference a type.

Throws:

NullPointerException - if implementation is null.

ModelObjectException - if compiling the name of the referenced type to a JavaTypeName fails.

See Also:

Implementation.getJavaTypeName(), JavaTypeName.getName(boolean)

getJavaClasspathLocation

@Deprecated
public String getJavaClasspathLocation(Implementation implementation)
                                throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Implementation.getJavaTypeName(). This method will be removed in JOMC 2.0.

Gets the Java class path location of an implementation.

Parameters:

implementation - The implementation to return the Java class path location of.

Returns:

The Java class path location of implementation or null, if the implementation does not reference a type.

Throws:

NullPointerException - if implementation is null.

ModelObjectException - if compiling the name of the referenced type to a JavaTypeName fails.

See Also:

Implementation.getJavaTypeName(), JavaTypeName.getQualifiedName()

getJavaInterfaceNames

@Deprecated
public List<String> getJavaInterfaceNames(Implementation implementation,
                                            boolean qualified)
                                   throws ModelObjectException

Deprecated. As of JOMC 1.2, replaced by method getImplementedJavaTypeNames(org.jomc.model.Implementation, boolean). This method will be removed in version 2.0.

Gets a list of names of all Java types an implementation implements.

Parameters:

implementation - The implementation to get names of all implemented Java types of.

qualified - true, to return the fully qualified type names (with package name prepended); false, to return the short type names (without package name prepended).

Returns:

An unmodifiable list of names of all Java types implemented by implementation.

Throws:

NullPointerException - if implementation is null.

ModelObjectException - if compiling the name of a referenced type to a JavaTypeName fails.

getImplementedJavaTypeNames

@Deprecated
public List<String> getImplementedJavaTypeNames(Implementation implementation,
                                                  boolean qualified)
                                         throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Modules.getImplementedJavaTypeNames(java.lang.String). This method will be removed in JOMC 2.0.

Gets a list of names of all Java types an implementation implements.

Parameters:

implementation - The implementation to get names of all implemented Java types of.

qualified - true, to return the fully qualified type names (with package name prepended); false, to return the short type names (without package name prepended).

Returns:

An unmodifiable list of names of all Java types implemented by implementation.

Throws:

NullPointerException - if implementation is null.

ModelObjectException - if compiling the name of the referenced type to a JavaTypeName fails.

Since:

1.2

getJavaTypeName

@Deprecated
public String getJavaTypeName(Argument argument)
                       throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Argument.getJavaTypeName(). This method will be removed in JOMC 2.0.

Gets the Java type name of an argument.

Parameters:

argument - The argument to get the Java type name of.

Returns:

The Java type name of the type referenced by the argument or null, if the argument does not reference a type.

Throws:

NullPointerException - if argument is null.

ModelObjectException - if compiling the name of the referenced type to a JavaTypeName fails.

See Also:

Argument.getJavaTypeName(), JavaTypeName.getName(boolean)

getJavaMethodParameterName

@Deprecated
public String getJavaMethodParameterName(Argument argument)
                                  throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Argument.getJavaVariableName(). This method will be removed in JOMC 2.0.

Gets a Java method parameter name of an argument.

Parameters:

argument - The argument to get the Java method parameter name of.

Returns:

The Java method parameter name of argument.

Throws:

NullPointerException - if argument is null.

ModelObjectException - if compiling the name of the argument to a JavaIdentifier fails.

Since:

1.2

See Also:

Argument.getJavaVariableName()

getJavaTypeName

@Deprecated
public String getJavaTypeName(Property property,
                                boolean boxify)
                       throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Property.getJavaTypeName(). This method will be removed in JOMC 2.0.

Gets the Java type name of a property.

Parameters:

property - The property to get the Java type name of.

boxify - true, to return the name of the Java wrapper class when the type is a Java primitive type; false, to return the exact binary name (unboxed name) of the Java type.

Returns:

The Java type name of the type referenced by the property or null, if the property does not reference a type.

Throws:

NullPointerException - if property is null.

ModelObjectException - if compiling the name of the referenced type to a JavaTypeName fails.

See Also:

Property.getJavaTypeName(), JavaTypeName.getBoxedName(), JavaTypeName.getName(boolean)

isJavaPrimitiveType

@Deprecated
public boolean isJavaPrimitiveType(Property property)
                            throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Property.getJavaTypeName(). This method will be removed in JOMC 2.0.

Gets a flag indicating the type of a given property is a Java primitive.

Parameters:

property - The property to query.

Returns:

true, if the Java type referenced by the property is primitive or false, if the property does not reference a type or if the Java type referenced by the property is not primitive.

Throws:

NullPointerException - if property is null.

ModelObjectException - if compiling the name of the referenced type to a JavaTypeName fails.

See Also:

Property.getJavaTypeName(), JavaTypeName.isPrimitive()

getJavaGetterMethodName

@Deprecated
public String getJavaGetterMethodName(Property property)
                               throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Property.getJavaGetterMethodName(). This method will be removed in JOMC 2.0.

Gets the name of a Java getter method of a given property.

Parameters:

property - The property to get a Java getter method name of.

Returns:

The Java getter method name of property.

Throws:

NullPointerException - if property is null.

ModelObjectException - if compiling the name of the property to a JavaIdentifier fails.

See Also:

Property.getJavaGetterMethodName()

getJavaSetterMethodName

@Deprecated
public String getJavaSetterMethodName(Property property)
                               throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Property.getJavaSetterMethodName(). This method will be removed in JOMC 2.0.

Gets the name of a Java setter method of a given property.

Parameters:

property - The property to get a Java setter method name of.

Returns:

The Java setter method name of property.

Throws:

NullPointerException - if property is null.

ModelObjectException - if compiling the name of the property to a JavaIdentifier fails.

Since:

1.2

See Also:

Property.getJavaSetterMethodName()

getJavaMethodParameterName

@Deprecated
public String getJavaMethodParameterName(Property property)
                                  throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Property.getJavaVariableName(). This method will be removed in JOMC 2.0.

Gets a Java method parameter name of a property.

Parameters:

property - The property to get the Java method parameter name of.

Returns:

The Java method parameter name of property.

Throws:

NullPointerException - if property is null.

ModelObjectException - if copmiling the name of the property to a JavaIdentifier fails.

Since:

1.2

See Also:

Property.getJavaVariableName()

getJavaFieldName

@Deprecated
public String getJavaFieldName(Property property)
                        throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Property.getJavaVariableName(). This method will be removed in JOMC 2.0.

Gets a Java field name of a property.

Parameters:

property - The property to get the Java field name of.

Returns:

The Java field name of property.

Throws:

NullPointerException - if property is null.

ModelObjectException - if compiling the name of the property to a JavaIdentifier fails.

Since:

1.3

See Also:

Property.getJavaVariableName()

getJavaTypeName

@Deprecated
public String getJavaTypeName(Dependency dependency)
                       throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Modules.getDependencyJavaTypeName(java.lang.String, java.lang.String). This method will be removed in JOMC 2.0.

Gets the name of a Java type of a given dependency.

Parameters:

dependency - The dependency to get a dependency Java type name of.

Returns:

The Java type name of the dependency or null, if the referenced specification is not found or does not reference a type.

Throws:

NullPointerException - if dependency is null.

ModelObjectException - if compiling the name of the referenced type to a JavaTypeName fails.

getJavaGetterMethodName

@Deprecated
public String getJavaGetterMethodName(Dependency dependency)
                               throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Dependency.getJavaGetterMethodName(). This method will be removed in JOMC 2.0.

Gets the name of a Java getter method of a given dependency.

Parameters:

dependency - The dependency to get a Java getter method name of.

Returns:

The Java getter method name of dependency.

Throws:

NullPointerException - if dependency is null.

ModelObjectException - if compiling the name of the dependency to a JavaIdentifier fails.

See Also:

Dependency.getJavaGetterMethodName()

getJavaSetterMethodName

@Deprecated
public String getJavaSetterMethodName(Dependency dependency)
                               throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Dependency.getJavaSetterMethodName(). This method will be removed in JOMC 2.0.

Gets the name of a Java setter method of a given dependency.

Parameters:

dependency - The dependency to get a Java setter method name of.

Returns:

The Java setter method name of dependency.

Throws:

NullPointerException - if dependency is null.

ModelObjectException - if compiling the name of the dependency to a JavaIdentifier fails.

Since:

1.2

See Also:

Dependency.getJavaSetterMethodName()

getJavaMethodParameterName

@Deprecated
public String getJavaMethodParameterName(Dependency dependency)
                                  throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Dependency.getJavaVariableName(). This method will be removed in JOMC 2.0.

Gets a Java method parameter name of a dependency.

Parameters:

dependency - The dependency to get the Java method parameter name of.

Returns:

The Java method parameter name of dependency.

Throws:

NullPointerException - if dependency is null.

ModelObjectException - if compiling the name of the dependency to a JavaIdentifier fails.

Since:

1.2

See Also:

Dependency.getJavaVariableName()

getJavaFieldName

@Deprecated
public String getJavaFieldName(Dependency dependency)
                        throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Dependency.getJavaVariableName(). This method will be removed in JOMC 2.0.

Gets a Java field name of a dependency.

Parameters:

dependency - The dependency to get the Java field name of.

Returns:

The Java field name of dependency.

Throws:

NullPointerException - if dependency is null.

ModelObjectException - if compiling the name of the dependency to a JavaIdentifier fails.

Since:

1.3

See Also:

Dependency.getJavaVariableName()

getJavaGetterMethodName

@Deprecated
public String getJavaGetterMethodName(Message message)
                               throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Message.getJavaGetterMethodName(). This method will be removed in JOMC 2.0.

Gets the name of a Java getter method of a given message.

Parameters:

message - The message to get a Java getter method name of.

Returns:

The Java getter method name of message.

Throws:

NullPointerException - if message is null.

ModelObjectException - if compiling the name of the message to a JavaIdentifier fails.

See Also:

Message.getJavaGetterMethodName()

getJavaSetterMethodName

@Deprecated
public String getJavaSetterMethodName(Message message)
                               throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Message.getJavaSetterMethodName(). This method will be removed in JOMC 2.0.

Gets the name of a Java setter method of a given message.

Parameters:

message - The message to get a Java setter method name of.

Returns:

The Java setter method name of message.

Throws:

NullPointerException - if message is null.

ModelObjectException - if compiling the name of the message to a JavaIdentifier fails.

Since:

1.2

See Also:

Message.getJavaSetterMethodName()

getJavaMethodParameterName

@Deprecated
public String getJavaMethodParameterName(Message message)
                                  throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Message.getJavaVariableName(). This method will be removed in JOMC 2.0.

Gets a Java method parameter name of a message.

Parameters:

message - The message to get the Java method parameter name of.

Returns:

The Java method parameter name of message.

Throws:

NullPointerException - if message is null.

ModelObjectException - if compiling the name of the message to a JavaIdentifier fails.

Since:

1.2

See Also:

Message.getJavaVariableName()

getJavaFieldName

@Deprecated
public String getJavaFieldName(Message message)
                        throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Message.getJavaVariableName(). This method will be removed in JOMC 2.0.

Gets a Java field name of a message.

Parameters:

message - The message to get the Java field name of.

Returns:

The Java field name of message.

Throws:

NullPointerException - if message is null.

ModelObjectException - if compiling the name of the message to a JavaIdentifier fails.

Since:

1.3

See Also:

Message.getJavaVariableName()

getJavaModifierName

@Deprecated
public String getJavaModifierName(Implementation implementation,
                                    Dependency dependency)

Deprecated. As of JOMC 1.4, please use method Modules.getDependencyJavaModifierName(java.lang.String, java.lang.String). This method will be removed in JOMC 2.0.

Gets the Java modifier name of a dependency of a given implementation.

Parameters:

implementation - The implementation declaring the dependency to get a Java modifier name of.

dependency - The dependency to get a Java modifier name of.

Returns:

The Java modifier name of dependency of implementation.

Throws:

NullPointerException - if implementation or dependency is null.

getJavaModifierName

@Deprecated
public String getJavaModifierName(Implementation implementation,
                                    Message message)

Deprecated. As of JOMC 1.4, please use method Modules.getMessageJavaModifierName(java.lang.String, java.lang.String). This method will be removed in JOMC 2.0.

Gets the Java modifier name of a message of a given implementation.

Parameters:

implementation - The implementation declaring the message to get a Java modifier name of.

message - The message to get a Java modifier name of.

Returns:

The Java modifier name of message of implementation.

Throws:

NullPointerException - if implementation or message is null.

getJavaModifierName

@Deprecated
public String getJavaModifierName(Implementation implementation,
                                    Property property)

Deprecated. As of JOMC 1.4, please use method Modules.getPropertyJavaModifierName(java.lang.String, java.lang.String). This method will be removed in JOMC 2.0.

Gets the Java modifier name of a property of a given implementation.

Parameters:

implementation - The implementation declaring the property to get a Java modifier name of.

property - The property to get a Java modifier name of.

Returns:

The Java modifier name of property of implementation.

Throws:

NullPointerException - if implementation or property is null.

getJavadocComment

@Deprecated
public String getJavadocComment(Text text,
                                  int indentationLevel,
                                  String linePrefix)
                         throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Text.getJavadocComment(java.lang.String, java.lang.String). This method will be removed in JOMC 2.0.

Formats a text to a Javadoc comment.

Parameters:

text - The text to format to a Javadoc comment.

indentationLevel - The indentation level of the comment.

linePrefix - The text to prepend lines with.

Returns:

text formatted to a Javadoc comment.

Throws:

NullPointerException - if text or linePrefix is null.

IllegalArgumentException - if indentationLevel is negative.

ModelObjectException - if compiling the type of the text to a MimeType fails.

getJavadocComment

@Deprecated
public String getJavadocComment(Texts texts,
                                  int indentationLevel,
                                  String linePrefix)
                         throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Text.getJavadocComment(java.lang.String, java.lang.String). This method will be removed in JOMC 2.0.

Formats a text from a list of texts to a Javadoc comment.

Parameters:

texts - The list of texts to format to a Javadoc comment.

indentationLevel - The indentation level of the comment.

linePrefix - The text to prepend lines with.

Returns:

The text corresponding to the locale of the instance from the list of texts formatted to a Javadoc comment.

Throws:

NullPointerException - if texts or linePrefix is null.

IllegalArgumentException - if indentationLevel is negative.

ModelObjectException - if compiling a referenced type to a MimeType fails.

Since:

1.2

See Also:

getLocale()

getJavaString

public String getJavaString(String str)

Formats a string to a Java string with unicode escapes.

Parameters:

str - The string to format to a Java string or null.

Returns:

str formatted to a Java string or null.

See Also:

StringEscapeUtils.escapeJava(java.lang.String)

getJavaClasspathLocation

@Deprecated
public String getJavaClasspathLocation(String str,
                                         boolean absolute)

Deprecated. As of JOMC 1.4, please use JavaTypeName.getQualifiedName(). This method will be removed in JOMC 2.0.

Formats a string to a Java class path location.

Parameters:

str - The string to format or null.

absolute - true to return an absolute class path location; false to return a relative class path location.

Returns:

str formatted to a Java class path location.

Since:

1.3

getJavaIdentifier

@Deprecated
public String getJavaIdentifier(String str,
                                  boolean capitalize)

Deprecated. As of JOMC 1.4, please use method toJavaVariableName(java.lang.String). This method will be removed in JOMC 2.0.

Formats a string to a Java identifier.

Parameters:

str - The string to format or null.

capitalize - true, to return an identifier with the first character upper cased; false, to return an identifier with the first character lower cased.

Returns:

str formatted to a Java identifier or null.

Since:

1.2

getJavaMethodParameterName

@Deprecated
public String getJavaMethodParameterName(String str)

Deprecated. As of JOMC 1.4, please use method toJavaVariableName(java.lang.String). This method will be removed in JOMC 2.0.

Formats a string to a Java method parameter name.

Parameters:

str - The string to format or null.

Returns:

str formatted to a Java method parameter name or null.

Since:

1.3

getJavaFieldName

@Deprecated
public String getJavaFieldName(String str)

Deprecated. As of JOMC 1.4, please use method toJavaVariableName(java.lang.String). This method will be removed in JOMC 2.0.

Formats a string to a Java field name.

Parameters:

str - The string to format or null.

Returns:

str formatted to a Java field name or null.

Since:

1.3

getJavaConstantName

@Deprecated
public String getJavaConstantName(String str)

Deprecated. As of JOMC 1.4, please use method toJavaConstantName(java.lang.String). This method will be removed in JOMC 2.0.

Formats a string to a Java constant name.

Parameters:

str - The string to format or null.

Returns:

str formatted to a Java constant name or null.

Since:

1.3

toJavaConstantName

public JavaIdentifier toJavaConstantName(String str)
                                  throws ParseException

Compiles a string to a Java constant name.

Parameters:

str - The string to compile or null.

Returns:

str compiled to a JavaIdentifier or null, if str is null.

Throws:

ParseException - if compiling str to a JavaIdentifier fails.

Since:

1.3

See Also:

JavaIdentifier.normalize(java.lang.String, org.jomc.model.JavaIdentifier.NormalizationMode), JavaIdentifier.NormalizationMode.CONSTANT_NAME_CONVENTION

toJavaMethodName

public JavaIdentifier toJavaMethodName(String str)
                                throws ParseException

Compiles a string to a Java method name.

Parameters:

str - The string to compile or null.

Returns:

str compiled to a JavaIdentifier or null, if str is null.

Throws:

ParseException - if compiling str to a JavaIdentifier fails.

Since:

1.4

See Also:

JavaIdentifier.normalize(java.lang.String, org.jomc.model.JavaIdentifier.NormalizationMode), JavaIdentifier.NormalizationMode.METHOD_NAME_CONVENTION

toJavaVariableName

public JavaIdentifier toJavaVariableName(String str)
                                  throws ParseException

Compiles a string to a Java variable name.

Parameters:

str - The string to compile or null.

Returns:

str compiled to a JavaIdentifier or null, if str is null.

Throws:

ParseException - if compiling str to a JavaIdentifier fails.

Since:

1.4

See Also:

JavaIdentifier.normalize(java.lang.String, org.jomc.model.JavaIdentifier.NormalizationMode), JavaIdentifier.NormalizationMode.VARIABLE_NAME_CONVENTION

isJavaDefaultPackage

@Deprecated
public boolean isJavaDefaultPackage(Specification specification)
                             throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Specification.getJavaTypeName(). This method will be removed in JOMC 2.0.

Gets a flag indicating the type referenced by a given specification is located in an unnamed Java package.

Parameters:

specification - The specification to query.

Returns:

true, if the type referenced by specification is located in an unnamed Java package; false, if the specification does not reference a type or if the referenced type is not located in an unnamed Java package.

Throws:

NullPointerException - if specification is null.

ModelObjectException - if compiling the name of the referenced type to a JavaTypeName fails.

See Also:

Specification.getJavaTypeName(), JavaTypeName.isUnnamedPackage()

isJavaDefaultPackage

@Deprecated
public boolean isJavaDefaultPackage(Implementation implementation)
                             throws ModelObjectException

Deprecated. As of JOMC 1.4, please use method Implementation.getJavaTypeName(). This method will be removed in JOMC 2.0.

Gets a flag indicating the type referenced by a given implementation is located in an unnamed Java package.

Parameters:

implementation - The implementation to query.

Returns:

true, if the type referenced by implementation is located in an unnamed Java package; false, if the implementation does not reference a type or if the referenced type is not located in an unnamed Java package.

Throws:

NullPointerException - if implementation is null.

ModelObjectException - if compiling the name of the referenced type to a JavaTypeName fails.

See Also:

Implementation.getJavaTypeName(), JavaTypeName.isUnnamedPackage()

getHtmlString

public String getHtmlString(String str)

Formats a string to a HTML string with HTML entities.

Parameters:

str - The string to format to a HTML string with HTML entities or null.

Returns:

str formatted to a HTML string with HTML entities or null.

Since:

1.2

getXmlString

public String getXmlString(String str)

Formats a string to a XML string with XML entities.

Parameters:

str - The string to format to a XML string with XML entities or null.

Returns:

str formatted to a XML string with XML entities or null.

Since:

1.2

See Also:

StringEscapeUtils.escapeXml(java.lang.String)

getJavaScriptString

public String getJavaScriptString(String str)

Formats a string to a JavaScript string applying JavaScript string rules.

Parameters:

str - The string to format to a JavaScript string by applying JavaScript string rules or null.

Returns:

str formatted to a JavaScript string with JavaScript string rules applied or null.

Since:

1.2

See Also:

StringEscapeUtils.escapeJavaScript(java.lang.String)

getSqlString

public String getSqlString(String str)

Formats a string to a SQL string.

Parameters:

str - The string to format to a SQL string or null.

Returns:

str formatted to a SQL string or null.

Since:

1.2

See Also:

StringEscapeUtils.escapeSql(java.lang.String)

getCsvString

public String getCsvString(String str)

Formats a string to a CSV string.

Parameters:

str - The string to format to a CSV string or null.

Returns:

str formatted to a CSV string or null.

Since:

1.2

See Also:

StringEscapeUtils.escapeCsv(java.lang.String)

getBooleanString

public String getBooleanString(Boolean b)

Formats a Boolean to a string.

Parameters:

b - The Boolean to format to a string or null.

Returns:

b formatted to a string.

Since:

1.2

See Also:

getLocale()

getDisplayLanguage

public String getDisplayLanguage(String language)

Gets the display language of a given language code.

Parameters:

language - The language code to get the display language of.

Returns:

The display language of language.

Throws:

NullPointerException - if language is null.

getShortDate

public String getShortDate(Calendar calendar)

Formats a calendar instance to a string.

Parameters:

calendar - The calendar to format to a string.

Returns:

The date of calendar formatted using a short format style pattern.

Throws:

NullPointerException - if calendar is null.

See Also:

DateFormat.SHORT

getMediumDate

public String getMediumDate(Calendar calendar)

Formats a calendar instance to a string.

Parameters:

calendar - The calendar to format to a string.

Returns:

The date of calendar formatted using a medium format style pattern.

Throws:

NullPointerException - if calendar is null.

Since:

1.2

See Also:

DateFormat.MEDIUM

getLongDate

public String getLongDate(Calendar calendar)

Formats a calendar instance to a string.

Parameters:

calendar - The calendar to format to a string.

Returns:

The date of calendar formatted using a long format style pattern.

Throws:

NullPointerException - if calendar is null.

See Also:

DateFormat.LONG

getIsoDate

public String getIsoDate(Calendar calendar)

Formats a calendar instance to a string.

Parameters:

calendar - The calendar to format to a string.

Returns:

The date of calendar formatted using an ISO-8601 format style.

Throws:

NullPointerException - if calendar is null.

Since:

1.2

See Also:

yyyy-DDD

getShortTime

public String getShortTime(Calendar calendar)

Formats a calendar instance to a string.

Parameters:

calendar - The calendar to format to a string.

Returns:

The time of calendar formatted using a short format style pattern.

Throws:

NullPointerException - if calendar is null.

See Also:

DateFormat.SHORT

getMediumTime

public String getMediumTime(Calendar calendar)

Formats a calendar instance to a string.

Parameters:

calendar - The calendar to format to a string.

Returns:

The time of calendar formatted using a medium format style pattern.

Throws:

NullPointerException - if calendar is null.

Since:

1.2

See Also:

DateFormat.MEDIUM

getLongTime

public String getLongTime(Calendar calendar)

Formats a calendar instance to a string.

Parameters:

calendar - The calendar to format to a string.

Returns:

The time of calendar formatted using a long format style pattern.

Throws:

NullPointerException - if calendar is null.

See Also:

DateFormat.LONG

getIsoTime

public String getIsoTime(Calendar calendar)

Formats a calendar instance to a string.

Parameters:

calendar - The calendar to format to a string.

Returns:

The time of calendar formatted using an ISO-8601 format style.

Throws:

NullPointerException - if calendar is null.

Since:

1.2

See Also:

HH:mm

getShortDateTime

public String getShortDateTime(Calendar calendar)

Formats a calendar instance to a string.

Parameters:

calendar - The calendar to format to a string.

Returns:

The date and time of calendar formatted using a short format style pattern.

Throws:

NullPointerException - if calendar is null.

See Also:

DateFormat.SHORT

getMediumDateTime

public String getMediumDateTime(Calendar calendar)

Formats a calendar instance to a string.

Parameters:

calendar - The calendar to format to a string.

Returns:

The date and time of calendar formatted using a medium format style pattern.

Throws:

NullPointerException - if calendar is null.

Since:

1.2

See Also:

DateFormat.MEDIUM

getLongDateTime

public String getLongDateTime(Calendar calendar)

Formats a calendar instance to a string.

Parameters:

calendar - The calendar to format to a string.

Returns:

The date and time of calendar formatted using a long format style pattern.

Throws:

NullPointerException - if calendar is null.

See Also:

DateFormat.LONG

getIsoDateTime

public String getIsoDateTime(Calendar calendar)

Formats a calendar instance to a string.

Parameters:

calendar - The calendar to format to a string.

Returns:

The date and time of calendar formatted using a ISO-8601 format style.

Throws:

NullPointerException - if calendar is null.

Since:

1.2

See Also:

yyyy-MM-dd'T'HH:mm:ssZ

getYears

public String getYears(Calendar start,
              Calendar end)

Gets a string describing the range of years for given calendars.

Parameters:

start - The start of the range.

end - The end of the range.

Returns:

Formatted range of the years of start and end (e.g. "start - end").

Throws:

NullPointerException - if start or end is null.

getModel

public final Model getModel()

Gets the model of the instance.

Returns:

The model of the instance.

See Also:

getModules(), setModel(org.jomc.modlet.Model)

setModel

public final void setModel(Model value)

Sets the model of the instance.

Parameters:

value - The new model of the instance or null.

See Also:

getModel()

getModules

public final Modules getModules()

Gets the modules of the model of the instance.

Returns:

The modules of the model of the instance or null, if no modules are found.

See Also:

getModel(), setModel(org.jomc.modlet.Model)

getVelocityEngine

public final VelocityEngine getVelocityEngine()
                                       throws IOException

Gets the VelocityEngine of the instance.

Returns:

The VelocityEngine of the instance.

Throws:

IOException - if initializing a new velocity engine fails.

See Also:

setVelocityEngine(org.apache.velocity.app.VelocityEngine)

setVelocityEngine

public final void setVelocityEngine(VelocityEngine value)

Sets the VelocityEngine of the instance.

Parameters:

value - The new VelocityEngine of the instance or null.

See Also:

getVelocityEngine()

getVelocityContext

public VelocityContext getVelocityContext()
                                   throws IOException

Gets a new velocity context used for merging templates.

Returns:

A new velocity context used for merging templates.

Throws:

IOException - if creating a new context instance fails.

See Also:

getTemplateParameters()

getTemplateParameters

public final Map<String,Object> getTemplateParameters()

Gets the template parameters of the instance.

This accessor method returns a reference to the live map, not a snapshot. Therefore any modification you make to the returned map will be present inside the object. This is why there is no set method for the template parameters property.

Returns:

The template parameters of the instance.

Since:

1.2

See Also:

getVelocityContext()

getTemplateLocation

public final URL getTemplateLocation()

Gets the location to search for templates in addition to searching the class path.

Returns:

The location to search for templates in addition to searching the class path or null.

Since:

1.2

See Also:

setTemplateLocation(java.net.URL)

setTemplateLocation

public final void setTemplateLocation(URL value)

Sets the location to search for templates in addition to searching the class path.

Parameters:

value - The new location to search for templates in addition to searching the class path or null.

Since:

1.2

See Also:

getTemplateLocation()

getTemplateEncoding

@Deprecated
public final String getTemplateEncoding()

Deprecated. As of JOMC 1.3, replaced by method getDefaultTemplateEncoding(). This method will be removed in JOMC 2.0.

Gets the encoding to use for reading templates.

Returns:

The encoding to use for reading templates.

See Also:

setTemplateEncoding(java.lang.String)

setTemplateEncoding

@Deprecated
public final void setTemplateEncoding(String value)

Deprecated. As of JOMC 1.3, replaced by method setDefaultTemplateEncoding(java.lang.String). This method will be removed in JOMC 2.0.

Sets the encoding to use for reading templates.

Parameters:

value - The new encoding to use for reading templates or null.

See Also:

getTemplateEncoding()

getDefaultTemplateEncoding

public final String getDefaultTemplateEncoding()

Gets the default encoding used for reading templates.

Returns:

The default encoding used for reading templates.

Since:

1.3

See Also:

setDefaultTemplateEncoding(java.lang.String)

setDefaultTemplateEncoding

public final void setDefaultTemplateEncoding(String value)

Sets the default encoding to use for reading templates.

Parameters:

value - The new default encoding to use for reading templates or null.

Since:

1.3

See Also:

getDefaultTemplateEncoding()

getTemplateEncoding

public final String getTemplateEncoding(String tp)

Gets the template encoding of a given template profile.

Parameters:

tp - The template profile to get the template encoding of.

Returns:

The template encoding of the template profile identified by tp or the default template encoding if no such encoding is defined.

Throws:

NullPointerException - if tp is null.

Since:

1.3

See Also:

getDefaultTemplateEncoding()

getInputEncoding

public final String getInputEncoding()

Gets the encoding to use for reading files.

Returns:

The encoding to use for reading files.

See Also:

setInputEncoding(java.lang.String)

setInputEncoding

public final void setInputEncoding(String value)

Sets the encoding to use for reading files.

Parameters:

value - The new encoding to use for reading files or null.

See Also:

getInputEncoding()

getOutputEncoding

public final String getOutputEncoding()

Gets the encoding to use for writing files.

Returns:

The encoding to use for writing files.

See Also:

setOutputEncoding(java.lang.String)

setOutputEncoding

public final void setOutputEncoding(String value)

Sets the encoding to use for writing files.

Parameters:

value - The encoding to use for writing files or null.

See Also:

getOutputEncoding()

getDefaultTemplateProfile

@Deprecated
public static String getDefaultTemplateProfile()

Deprecated. The static modifier of this method and support to setup the default template profile using a system property will be removed in version 2.0.

Gets the default template profile.

The default template profile is the implicit parent profile of any template profile not specifying a parent template profile.

Returns:

The default template profile.

See Also:

setDefaultTemplateProfile(java.lang.String)

setDefaultTemplateProfile

@Deprecated
public static void setDefaultTemplateProfile(String value)

Deprecated. The static modifier of this method will be removed in version 2.0.

Sets the default template profile.

Parameters:

value - The new default template profile or null.

See Also:

getDefaultTemplateProfile()

getTemplateProfile

public final String getTemplateProfile()

Gets the template profile of the instance.

Returns:

The template profile of the instance.

See Also:

getDefaultTemplateProfile(), setTemplateProfile(java.lang.String)

setTemplateProfile

public final void setTemplateProfile(String value)

Sets the template profile of the instance.

Parameters:

value - The new template profile of the instance or null.

See Also:

getTemplateProfile()

getParentTemplateProfile

public final String getParentTemplateProfile(String tp)

Gets the parent template profile of a given template profile.

Parameters:

tp - The template profile to get the parent template profile of.

Returns:

The parent template profile of the template profile identified by tp; the default template profile, if no such parent template profile is defined; null, if tp denotes the default template profile.

Throws:

NullPointerException - if tp is null.

Since:

1.3

See Also:

getDefaultTemplateProfile()

getIndentation

public final String getIndentation()

Gets the indentation string of the instance.

Returns:

The indentation string of the instance.

See Also:

setIndentation(java.lang.String)

getIndentation

public final String getIndentation(int level)

Gets an indentation string for a given indentation level.

Parameters:

level - The indentation level to get an indentation string for.

Returns:

The indentation string for level.

Throws:

IllegalArgumentException - if level is negative.

See Also:

getIndentation()

setIndentation

public final void setIndentation(String value)

Sets the indentation string of the instance.

Parameters:

value - The new indentation string of the instance or null.

See Also:

getIndentation()

getLineSeparator

public final String getLineSeparator()

Gets the line separator of the instance.

Returns:

The line separator of the instance.

See Also:

setLineSeparator(java.lang.String)

setLineSeparator

public final void setLineSeparator(String value)

Sets the line separator of the instance.

Parameters:

value - The new line separator of the instance or null.

See Also:

getLineSeparator()

getLocale

public final Locale getLocale()

Gets the locale of the instance.

Returns:

The locale of the instance.

Since:

1.2

See Also:

setLocale(java.util.Locale)

setLocale

public final void setLocale(Locale value)

Sets the locale of the instance.

Parameters:

value - The new locale of the instance or null.

Since:

1.2

See Also:

getLocale()

getVelocityTemplate

public Template getVelocityTemplate(String templateName)
                             throws FileNotFoundException,
                                    IOException

Gets a velocity template for a given name.

This method searches templates at the following locations recursively in the shown order stopping whenever a matching template is found.

1. org/jomc/tools/templates/profile/language/templateName
2. org/jomc/tools/templates/parent profile/language/templateName
3. org/jomc/tools/templates/profile/templateName
4. org/jomc/tools/templates/parent profile/language/templateName

Parameters:

templateName - The name of the template to get.

Returns:

The template matching templateName.

Throws:

NullPointerException - if templateName is null.

FileNotFoundException - if no such template is found.

IOException - if getting the template fails.

See Also:

getTemplateProfile(), getParentTemplateProfile(java.lang.String), getLocale(), getTemplateEncoding(java.lang.String), getVelocityEngine()

log

public void log(Level level,
       String message,
       Throwable throwable)

Notifies registered listeners.

Parameters:

level - The level of the event.

message - The message of the event or null.

throwable - The throwable of the event or null.

Throws:

NullPointerException - if level is null.

See Also:

getListeners(), isLoggable(java.util.logging.Level)