org.castor.xml
Interface JavaNaming

All Known Implementing Classes:

JavaNamingImpl, JavaNamingNGImpl

public interface JavaNaming

JavaNaming is a service which collects all methods that are related to create (modify) Java names. E.g. convert from XML name to Java name, get a Java member name or such. These rules can be exchanged by a different implementation to get a different naming style for e.g. JAXB.

Version:

$Id: JavaNaming.java 7390 2008-01-25 15:59:42Z jgrueneis $

Author:

Joachim Grueneis

Field Summary

static char	FIELD_UNDERSCORE_PREFIX The underscore field prefix.
static String	METHOD_PREFIX_ADD Add methods start with: add.
static String	METHOD_PREFIX_CREATE Create methods start with: create.
static String	METHOD_PREFIX_GET Get methods start with: get.
static String	METHOD_PREFIX_IS Is methods start with: is.
static String	METHOD_PREFIX_SET Set methods start with: set.

Method Summary

String	extractFieldNameFromField(Field field) Extracts the field name part from the Field.
String	extractFieldNameFromMethod(Method method) Extracts the filed name part from the methods name.
String	getAddMethodNameForField(String fieldName) Generates the name of an add method for the given field name.
String	getClassName(Class clazz) Gets the class name without package part.
String	getCreateMethodNameForField(String fieldName) Generates the name of a create method for the given field name.
String	getGetMethodNameForField(String fieldName) Generates the name of a get method for the given field name.
String	getIsMethodNameForField(String fieldName) Generates the name of an is method for the given field name.
String	getPackageName(String className) Gets the package name of the given class name.
String	getQualifiedFileName(String fileName, String packageName) Qualifies the given fileName with the given packageName and returns the resulting file path.
String	getSetMethodNameForField(String fieldName) Generates the name of a set method for the given field name.
boolean	isAddMethod(Method method) Checks if the given method is an add method.
boolean	isCreateMethod(Method method) Checks if the given method is a create method.
boolean	isGetMethod(Method method) Checks if the given method is a get method.
boolean	isIsMethod(Method method) Checks if the given method is an is method.
boolean	isKeyword(String name) Returns true if the given String is a Java keyword which will cause a problem when used as a variable name.
boolean	isSetMethod(Method method) Checks if the given method is a set method.
boolean	isValidJavaIdentifier(String string) Returns true if the given String matches the production of a valid Java identifier.
boolean	isValidPackageName(String packageName) Checks if the given package name is valid or not.
String	packageToPath(String packageName) Converts the given Package name to it's corresponding Path.
String	toJavaClassName(String name) Cuts away a leading namespace prefix (if there is one in place).
String	toJavaMemberName(String name) Appends a leading '_' and converts the given name to a java name.
String	toJavaMemberName(String name, boolean useKeywordSubstitutions) Appends a leading '_' and converts the given name to a java name.

Field Detail

METHOD_PREFIX_ADD

static final String METHOD_PREFIX_ADD

Add methods start with: add.

See Also:

Constant Field Values

METHOD_PREFIX_GET

static final String METHOD_PREFIX_GET

Get methods start with: get.

See Also:

Constant Field Values

METHOD_PREFIX_IS

static final String METHOD_PREFIX_IS

Is methods start with: is.

See Also:

Constant Field Values

METHOD_PREFIX_SET

static final String METHOD_PREFIX_SET

Set methods start with: set.

See Also:

Constant Field Values

METHOD_PREFIX_CREATE

static final String METHOD_PREFIX_CREATE

Create methods start with: create.

See Also:

Constant Field Values

FIELD_UNDERSCORE_PREFIX

static final char FIELD_UNDERSCORE_PREFIX

The underscore field prefix.

See Also:

Constant Field Values

Method Detail

isKeyword

boolean isKeyword(String name)

Returns true if the given String is a Java keyword which will cause a problem when used as a variable name.

Parameters:

name - The name to check.

Returns:

true if it is a keyword.

isValidJavaIdentifier

boolean isValidJavaIdentifier(String string)

Returns true if the given String matches the production of a valid Java identifier.

Parameters:

string - The String to check the production of.

Returns:

true if the given String matches the production of a valid Java name, otherwise false.

toJavaClassName

String toJavaClassName(String name)

Cuts away a leading namespace prefix (if there is one in place).

Parameters:

name - The XML name to convert to a Java name.

Returns:

A name which follows Java naming conventions.

toJavaMemberName

String toJavaMemberName(String name)

Appends a leading '_' and converts the given name to a java name.

Parameters:

name - the XML name to convert.

Returns:

A Java member name starting with a leading '_'.

toJavaMemberName

String toJavaMemberName(String name,
                        boolean useKeywordSubstitutions)

Appends a leading '_' and converts the given name to a java name.

Parameters:

name - The XML name to convert.

useKeywordSubstitutions - Set to true to turn on keyword substitution.

Returns:

A Java member name starting with a leading '_'.

isValidPackageName

boolean isValidPackageName(String packageName)

Checks if the given package name is valid or not. Empty package names are considered valid!

Parameters:

packageName - Name of package as String with periods.

Returns:

true if package name is valid.

packageToPath

String packageToPath(String packageName)

Converts the given Package name to it's corresponding Path. The path will be a relative path.

Parameters:

packageName - The package name to convert.

Returns:

A String containing the resulting patch.

getQualifiedFileName

String getQualifiedFileName(String fileName,
                            String packageName)

Qualifies the given fileName with the given packageName and returns the resulting file path.
If packageName is null or a zero-length String, this method will return fileName.

Parameters:

fileName - The file name to be qualified.

packageName - The package name to be used for qualifying.

Returns:

The qualified file path.

getClassName

String getClassName(Class clazz)

Gets the class name without package part.

Parameters:

clazz - The class to retrieve the name from

Returns:

the class name without package part or null

getPackageName

String getPackageName(String className)

Gets the package name of the given class name.

Parameters:

className - The class name to retrieve the package name from.

Returns:

The package name or the empty String if className is null or does not contain a package.

extractFieldNameFromMethod

String extractFieldNameFromMethod(Method method)

Extracts the filed name part from the methods name. Mostly it cuts away the method prefix.

Parameters:

method - The Method to process.

Returns:

The extracted field name.

extractFieldNameFromField

String extractFieldNameFromField(Field field)

Extracts the field name part from the Field. Mostly it cuts away prefixes like '_'.

Parameters:

field - the Field to process

Returns:

The extracted field name.

isSetMethod

boolean isSetMethod(Method method)

Checks if the given method is a set method.

Parameters:

method - The Method to check

Returns:

true if it is a set method

isCreateMethod

boolean isCreateMethod(Method method)

Checks if the given method is a create method.

Parameters:

method - The Method to check.

Returns:

true if it is a create method.

isGetMethod

boolean isGetMethod(Method method)

Checks if the given method is a get method.

Parameters:

method - The Method to check.

Returns:

true if it is a get method.

isIsMethod

boolean isIsMethod(Method method)

Checks if the given method is an is method.

Parameters:

method - The Method to check.

Returns:

true if it is an is method.

isAddMethod

boolean isAddMethod(Method method)

Checks if the given method is an add method.

Parameters:

method - The Method to check.

Returns:

true if it is an add method.

getAddMethodNameForField

String getAddMethodNameForField(String fieldName)

Generates the name of an add method for the given field name.

Parameters:

fieldName - The field name to generate a method name for.

Returns:

The generated add method name.

getSetMethodNameForField

String getSetMethodNameForField(String fieldName)

Generates the name of a set method for the given field name.

Parameters:

fieldName - The field name to generate a method name for.

Returns:

The generated set method name.

getGetMethodNameForField

String getGetMethodNameForField(String fieldName)

Generates the name of a get method for the given field name.

Parameters:

fieldName - The field name to generate a method name for.

Returns:

The generated get method name.

getIsMethodNameForField

String getIsMethodNameForField(String fieldName)

Generates the name of an is method for the given field name.

Parameters:

fieldName - The field name to generate a method name for.

Returns:

The generated is method name.

getCreateMethodNameForField

String getCreateMethodNameForField(String fieldName)

Generates the name of a create method for the given field name.

Parameters:

fieldName - The field name to generate a method name for.

Returns:

The generated create method name.