griffon.util

Class GriffonNameUtils

java.lang.Object

griffon.util.GriffonNameUtils

public class GriffonNameUtils
extends java.lang.Object

Contains utility methods for converting between different name types, for example from class names -> property names and vice-versa. The key aspect of this class is that it has no dependencies outside the JDK!

Method Summary

Modifier and Type	Method and Description
static java.lang.String	capitalize(java.lang.String str) Capitalizes a String (makes the first char uppercase) taking care of blank strings and single character strings.
static java.lang.String	getClassName(java.lang.String logicalName, java.lang.String trailingName) Returns the class name for the given logical name and trailing name.
static java.lang.String	getClassNameForLowerCaseHyphenSeparatedName(java.lang.String name) Converts foo-bar into FooBar.
static java.lang.String	getClassNameRepresentation(java.lang.String name) Returns the class name representation of the given name
static java.lang.String	getGetterName(java.lang.String propertyName) Calculate the name for a getter method to retrieve the specified property
static java.lang.String	getHyphenatedName(java.lang.Class<?> clazz) Retrieves the hyphenated name representation of the supplied class.
static java.lang.String	getHyphenatedName(java.lang.String name) Retrieves the hyphenated name representation of the given class name.
static java.lang.String	getLogicalName(java.lang.Class<?> clazz, java.lang.String trailingName) Retrieves the logical class name of a Griffon artifact given the Griffon class and a specified trailing name
static java.lang.String	getLogicalName(java.lang.String name, java.lang.String trailingName) Retrieves the logical name of the class without the trailing name
static java.lang.String	getLogicalPropertyName(java.lang.String className, java.lang.String trailingName)
static java.lang.String	getNaturalName(java.lang.String name) Converts a property name into its natural language equivalent eg ('firstName' becomes 'First Name')
static java.lang.String	getPropertyName(java.lang.Class<?> clazz) Shorter version of getPropertyNameRepresentation
static java.lang.String	getPropertyName(java.lang.String name) Shorter version of getPropertyNameRepresentation
static java.lang.String	getPropertyNameForLowerCaseHyphenSeparatedName(java.lang.String name) Converts foo-bar into fooBar
static java.lang.String	getPropertyNameRepresentation(java.lang.Class<?> targetClass) Returns the property name equivalent for the specified class
static java.lang.String	getPropertyNameRepresentation(java.lang.String name) Returns the property name representation of the given name
static java.lang.String	getSetterName(java.lang.String propertyName) Retrieves the name of a setter for the specified property name
static java.lang.String	getShortName(java.lang.Class<?> targetClass) Returns the class name without the package prefix
static java.lang.String	getShortName(java.lang.String className) Returns the class name without the package prefix
static boolean	isBlank(java.lang.String str) Determines whether a given string is null, empty, or only contains whitespace.
static boolean	isKeyword(java.lang.String str) Finds out if the given String is a Java/Groovy keyword.
static boolean	isNotBlank(java.lang.String str) Determines whether a given string is not null, empty, or only contains whitespace.
static java.lang.String	join(java.lang.Iterable<?> self, java.lang.String separator) Concatenates the toString() representation of each item in this Iterable, with the given String as a separator between each item.
static java.lang.String	quote(java.lang.String str) Applies single or double quotes to a string if it contains whitespace characters
static java.lang.String	requireNonBlank(java.lang.String str) Checks that the specified String is not blank.
static java.lang.String	requireNonBlank(java.lang.String str, java.lang.String message) Checks that the specified String is not blank and throws a customized IllegalArgumentException if it is.
static java.lang.String	uncapitalize(java.lang.String str) Uncapitalizes a String (makes the first char lowercase) taking care of blank strings and single character strings.
static java.lang.String	unquote(java.lang.String str) Removes single or double quotes from a String

Methods inherited from class java.lang.Object

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

Method Detail

isKeyword

public static boolean isKeyword(java.lang.String str)

Finds out if the given String is a Java/Groovy keyword.

Parameters:

str - The String to test

Returns:

true if the given String is a keyword, false otherwise

capitalize

public static java.lang.String capitalize(java.lang.String str)

Capitalizes a String (makes the first char uppercase) taking care of blank strings and single character strings.

Parameters:

str - The String to be capitalized

Returns:

Capitalized version of the target string if it is not blank

uncapitalize

public static java.lang.String uncapitalize(java.lang.String str)

Uncapitalizes a String (makes the first char lowercase) taking care of blank strings and single character strings.

Parameters:

str - The String to be uncapitalized

Returns:

Uncapitalized version of the target string if it is not blank

getSetterName

public static java.lang.String getSetterName(java.lang.String propertyName)

Retrieves the name of a setter for the specified property name

Parameters:

propertyName - The property name

Returns:

The setter equivalent

getGetterName

public static java.lang.String getGetterName(java.lang.String propertyName)

Calculate the name for a getter method to retrieve the specified property

Parameters:

propertyName - The property name

Returns:

The name for the getter method for this property, if it were to exist, i.e. getConstraints

getClassName

public static java.lang.String getClassName(java.lang.String logicalName,
                                            java.lang.String trailingName)

Returns the class name for the given logical name and trailing name. For example "person" and "Controller" would evaluate to "PersonController"

Parameters:

logicalName - The logical name

trailingName - The trailing name

Returns:

The class name

getClassNameRepresentation

public static java.lang.String getClassNameRepresentation(java.lang.String name)

Returns the class name representation of the given name

Parameters:

name - The name to convert

Returns:

The property name representation

getClassNameForLowerCaseHyphenSeparatedName

public static java.lang.String getClassNameForLowerCaseHyphenSeparatedName(java.lang.String name)

Converts foo-bar into FooBar. Empty and null strings are returned as-is.

Parameters:

name - The lower case hyphen separated name

Returns:

The class name equivalent.

getLogicalName

public static java.lang.String getLogicalName(java.lang.Class<?> clazz,
                                              java.lang.String trailingName)

Retrieves the logical class name of a Griffon artifact given the Griffon class and a specified trailing name

Parameters:

clazz - The class

trailingName - The trailing name such as "Controller" or "TagLib"

Returns:

The logical class name

getLogicalName

public static java.lang.String getLogicalName(java.lang.String name,
                                              java.lang.String trailingName)

Retrieves the logical name of the class without the trailing name

Parameters:

name - The name of the class

trailingName - The trailing name

Returns:

The logical name

getLogicalPropertyName

public static java.lang.String getLogicalPropertyName(java.lang.String className,
                                                      java.lang.String trailingName)

getPropertyName

public static java.lang.String getPropertyName(java.lang.String name)

Shorter version of getPropertyNameRepresentation

Parameters:

name - The name to convert

Returns:

The property name version

getPropertyName

public static java.lang.String getPropertyName(java.lang.Class<?> clazz)

Shorter version of getPropertyNameRepresentation

Parameters:

clazz - The clazz to convert

Returns:

The property name version

getPropertyNameRepresentation

public static java.lang.String getPropertyNameRepresentation(java.lang.Class<?> targetClass)

Returns the property name equivalent for the specified class

Parameters:

targetClass - The class to get the property name for

Returns:

A property name representation of the class name (eg. MyClass becomes myClass)

getPropertyNameRepresentation

public static java.lang.String getPropertyNameRepresentation(java.lang.String name)

Returns the property name representation of the given name

Parameters:

name - The name to convert

Returns:

The property name representation

getPropertyNameForLowerCaseHyphenSeparatedName

public static java.lang.String getPropertyNameForLowerCaseHyphenSeparatedName(java.lang.String name)

Converts foo-bar into fooBar

Parameters:

name - The lower case hyphen separated name

Returns:

The property name equivalent

getShortName

public static java.lang.String getShortName(java.lang.Class<?> targetClass)

Returns the class name without the package prefix

Parameters:

targetClass - The class to get a short name for

Returns:

The short name of the class

getShortName

public static java.lang.String getShortName(java.lang.String className)

Returns the class name without the package prefix

Parameters:

className - The class name to get a short name for

Returns:

The short name of the class

getNaturalName

public static java.lang.String getNaturalName(java.lang.String name)

Converts a property name into its natural language equivalent eg ('firstName' becomes 'First Name')

Parameters:

name - The property name to convert

Returns:

The converted property name

isBlank

public static boolean isBlank(java.lang.String str)

Determines whether a given string is null, empty, or only contains whitespace. If it contains anything other than whitespace then the string is not considered to be blank and the method returns false.

Parameters:

str - The string to test.

Returns:

true if the string is null, or blank.

isNotBlank

public static boolean isNotBlank(java.lang.String str)

Determines whether a given string is not null, empty, or only contains whitespace. If it contains anything other than whitespace then the string is not considered to be blank and the method returns true.

Parameters:

str - The string to test.

Returns:

true if the string is not null, nor blank.

requireNonBlank

public static java.lang.String requireNonBlank(java.lang.String str)

Checks that the specified String is not blank. This method is designed primarily for doing parameter validation in methods and constructors, as demonstrated below:

 public Foo(String str) {
     this.str = GriffonNameUtils.requireNonBlank(str);
 }
 

Parameters:

str - the String to check for blank

Returns:

str if not blank

Throws:

java.lang.IllegalArgumentException - if str is blank

requireNonBlank

public static java.lang.String requireNonBlank(java.lang.String str,
                                               java.lang.String message)

Checks that the specified String is not blank and throws a customized IllegalArgumentException if it is. This method is designed primarily for doing parameter validation in methods and constructors with multiple parameters, as demonstrated below:

 public Foo(String str) {
     this.str = GriffonNameUtils.requireNonBlank(str, "str must not be null");
 }
 

Parameters:

str - the String to check for blank

message - detail message to be used in the event that a IllegalArgumentException is thrown

Returns:

str if not blank

Throws:

java.lang.IllegalArgumentException - if str is blank

getHyphenatedName

public static java.lang.String getHyphenatedName(java.lang.Class<?> clazz)

Retrieves the hyphenated name representation of the supplied class. For example MyFunkyGriffonThingy would be my-funky-griffon-thingy.

Parameters:

clazz - The class to convert

Returns:

The hyphenated name representation

getHyphenatedName

public static java.lang.String getHyphenatedName(java.lang.String name)

Retrieves the hyphenated name representation of the given class name. For example MyFunkyGriffonThingy would be my-funky-griffon-thingy.

Parameters:

name - The class name to convert.

Returns:

The hyphenated name representation.

join

@Nonnull
public static java.lang.String join(@Nonnull
                                             java.lang.Iterable<?> self,
                                             @Nullable
                                             java.lang.String separator)

Concatenates the toString() representation of each item in this Iterable, with the given String as a separator between each item.

Parameters:

self - an Iterable of objects

separator - a String separator

Returns:

the joined String

quote

public static java.lang.String quote(java.lang.String str)

Applies single or double quotes to a string if it contains whitespace characters

Parameters:

str - the String to be surrounded by quotes

Returns:

a copy of the original String, surrounded by quotes

unquote

public static java.lang.String unquote(java.lang.String str)

Removes single or double quotes from a String

Parameters:

str - the String from which quotes will be removed

Returns:

the unquoted String