Package org.castor.xml
Interface JavaNaming
- All Known Implementing Classes:
JavaNamingImpl
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
FieldsModifier and TypeFieldDescriptionstatic final charThe underscore field prefix.static final StringAdd methods start with: add.static final StringCreate methods start with: create.static final StringGet methods start with: get.static final StringIs methods start with: is.static final StringSet methods start with: set. -
Method Summary
Modifier and TypeMethodDescriptionextractFieldNameFromField(Field field) Extracts the field name part from the Field.extractFieldNameFromMethod(Method method) Extracts the filed name part from the methods name.getAddMethodNameForField(String fieldName) Generates the name of an add method for the given field name.getClassName(Class clazz) Gets the class name without package part.getCreateMethodNameForField(String fieldName) Generates the name of a create method for the given field name.getGetMethodNameForField(String fieldName) Generates the name of a get method for the given field name.getIsMethodNameForField(String fieldName) Generates the name of an is method for the given field name.getPackageName(String className) Gets the package name of the given class name.getQualifiedFileName(String fileName, String packageName) Qualifies the givenfileNamewith the givenpackageNameand returns the resulting file path.
IfpackageNameisnullor a zero-length String, this method will returnfileName.getSetMethodNameForField(String fieldName) Generates the name of a set method for the given field name.booleanisAddMethod(Method method) Checks if the given method is an add method.booleanisCreateMethod(Method method) Checks if the given method is a create method.booleanisGetMethod(Method method) Checks if the given method is a get method.booleanisIsMethod(Method method) Checks if the given method is an is method.booleanReturns true if the given String is a Java keyword which will cause a problem when used as a variable name.booleanisSetMethod(Method method) Checks if the given method is a set method.booleanisValidJavaIdentifier(String string) Returns true if the given String matches the production of a valid Java identifier.booleanisValidPackageName(String packageName) Checks if the given package name is valid or not.packageToPath(String packageName) Converts the given Package name to it's corresponding Path.toJavaClassName(String name) Cuts away a leading namespace prefix (if there is one in place).toJavaMemberName(String name) Appends a leading '_' and converts the given name to a java name.toJavaMemberName(String name, boolean useKeywordSubstitutions) Appends a leading '_' and converts the given name to a java name.
-
Field Details
-
METHOD_PREFIX_ADD
Add methods start with: add.- See Also:
-
METHOD_PREFIX_GET
Get methods start with: get.- See Also:
-
METHOD_PREFIX_IS
Is methods start with: is.- See Also:
-
METHOD_PREFIX_SET
Set methods start with: set.- See Also:
-
METHOD_PREFIX_CREATE
Create methods start with: create.- See Also:
-
FIELD_UNDERSCORE_PREFIX
static final char FIELD_UNDERSCORE_PREFIXThe underscore field prefix.- See Also:
-
-
Method Details
-
isKeyword
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
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
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
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
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
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
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
Qualifies the givenfileNamewith the givenpackageNameand returns the resulting file path.
IfpackageNameisnullor a zero-length String, this method will returnfileName.- Parameters:
fileName- The file name to be qualified.packageName- The package name to be used for qualifying.- Returns:
- The qualified file path.
-
getClassName
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
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
classNameisnullor does not contain a package.
-
extractFieldNameFromMethod
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
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
Checks if the given method is a set method.- Parameters:
method- The Method to check- Returns:
- true if it is a set method
-
isCreateMethod
Checks if the given method is a create method.- Parameters:
method- The Method to check.- Returns:
- true if it is a create method.
-
isGetMethod
Checks if the given method is a get method.- Parameters:
method- The Method to check.- Returns:
- true if it is a get method.
-
isIsMethod
Checks if the given method is an is method.- Parameters:
method- The Method to check.- Returns:
- true if it is an is method.
-
isAddMethod
Checks if the given method is an add method.- Parameters:
method- The Method to check.- Returns:
- true if it is an add method.
-
getAddMethodNameForField
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
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
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
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
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.
-