org.jboss.dna.common.text
Class Inflector

java.lang.Object
  org.jboss.dna.common.text.Inflector

public class Inflector
extends java.lang.Object

Transforms words to singular, plural, humanized (human readable), underscore, camel case, or ordinal form.

Author:

Randall Hauch

Constructor Summary

Inflector()

Method Summary

void	addIrregular(java.lang.String singular, java.lang.String plural)
void	addPluralize(java.lang.String rule, java.lang.String replacement)
void	addSingularize(java.lang.String rule, java.lang.String replacement)
void	addUncountable(java.lang.String... words)
java.lang.String	camelCase(java.lang.String lowerCaseAndUnderscoredWord, boolean uppercaseFirstLetter, char... delimiterChars) By default, this method converts strings to UpperCamelCase.
java.lang.String	capitalize(java.lang.String words) Returns a copy of the input with the first character converted to uppercase and the remainder to lowercase.
void	clear() Completely remove all rules within this inflector.
Inflector	clone()
static Inflector	getInstance()
java.util.Set<java.lang.String>	getUncountables() Get the set of words that are not processed by the Inflector.
java.lang.String	humanize(java.lang.String lowerCaseAndUnderscoredWords, java.lang.String... removableTokens) Capitalizes the first word and turns underscores into spaces and strips trailing "_id" and any supplied removable tokens.
boolean	isUncountable(java.lang.String word) Determine whether the supplied word is considered uncountable by the pluralize and singularize methods.
java.lang.String	lowerCamelCase(java.lang.String lowerCaseAndUnderscoredWord, char... delimiterChars) Converts strings to lowerCamelCase.
java.lang.String	ordinalize(int number) Turns a non-negative number into an ordinal string used to denote the position in an ordered sequence, such as 1st, 2nd, 3rd, 4th.
java.lang.String	pluralize(java.lang.Object word) Returns the plural form of the word in the string.
java.lang.String	pluralize(java.lang.Object word, int count)
java.lang.String	singularize(java.lang.Object word) Returns the singular form of the word in the string.
java.lang.String	titleCase(java.lang.String words, java.lang.String... removableTokens) Capitalizes all the words and replaces some characters in the string to create a nicer looking title.
java.lang.String	underscore(java.lang.String camelCaseWord, char... delimiterChars) Makes an underscored form from the expression in the string (the reverse of the camelCase method.
java.lang.String	upperCamelCase(java.lang.String lowerCaseAndUnderscoredWord, char... delimiterChars) Converts strings to UpperCamelCase.

Methods inherited from class java.lang.Object

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

Constructor Detail

Inflector

public Inflector()

Method Detail

getInstance

public static final Inflector getInstance()

clone

public Inflector clone()

Overrides:

clone in class java.lang.Object

pluralize

public java.lang.String pluralize(java.lang.Object word)

Returns the plural form of the word in the string.

Examples:

   inflector.pluralize("post")               #=> "posts"
   inflector.pluralize("octopus")            #=> "octopi"
   inflector.pluralize("sheep")              #=> "sheep"
   inflector.pluralize("words")              #=> "words"
   inflector.pluralize("the blue mailman")   #=> "the blue mailmen"
   inflector.pluralize("CamelOctopus")       #=> "CamelOctopi"
 

Note that if the Object.toString() is called on the supplied object, so this method works for non-strings, too.

Parameters:

word - the word that is to be pluralized.

Returns:

the pluralized form of the word, or the word itself if it could not be pluralized

See Also:

singularize(Object)

pluralize

public java.lang.String pluralize(java.lang.Object word,
                                  int count)

singularize

public java.lang.String singularize(java.lang.Object word)

Returns the singular form of the word in the string.

Examples:

   inflector.singularize("posts")             #=> "post"
   inflector.singularize("octopi")            #=> "octopus"
   inflector.singularize("sheep")             #=> "sheep"
   inflector.singularize("words")             #=> "word"
   inflector.singularize("the blue mailmen")  #=> "the blue mailman"
   inflector.singularize("CamelOctopi")       #=> "CamelOctopus"
 

Note that if the Object.toString() is called on the supplied object, so this method works for non-strings, too.

Parameters:

word - the word that is to be pluralized.

Returns:

the pluralized form of the word, or the word itself if it could not be pluralized

See Also:

pluralize(Object)

lowerCamelCase

public java.lang.String lowerCamelCase(java.lang.String lowerCaseAndUnderscoredWord,
                                       char... delimiterChars)

Converts strings to lowerCamelCase. This method will also use any extra delimiter characters to identify word boundaries.

Examples:

   inflector.lowerCamelCase("active_record")       #=> "activeRecord"
   inflector.lowerCamelCase("first_name")          #=> "firstName"
   inflector.lowerCamelCase("name")                #=> "name"
   inflector.lowerCamelCase("the-first_name",'-')  #=> "theFirstName"
 

Parameters:

lowerCaseAndUnderscoredWord - the word that is to be converted to camel case

delimiterChars - optional characters that are used to delimit word boundaries

Returns:

the lower camel case version of the word

See Also:

underscore(String, char[]), camelCase(String, boolean, char[]), upperCamelCase(String, char[])

upperCamelCase

public java.lang.String upperCamelCase(java.lang.String lowerCaseAndUnderscoredWord,
                                       char... delimiterChars)

Converts strings to UpperCamelCase. This method will also use any extra delimiter characters to identify word boundaries.

Examples:

   inflector.upperCamelCase("active_record")       #=> "SctiveRecord"
   inflector.upperCamelCase("first_name")          #=> "FirstName"
   inflector.upperCamelCase("name")                #=> "Name"
   inflector.lowerCamelCase("the-first_name",'-')  #=> "TheFirstName"
 

Parameters:

lowerCaseAndUnderscoredWord - the word that is to be converted to camel case

delimiterChars - optional characters that are used to delimit word boundaries

Returns:

the upper camel case version of the word

See Also:

underscore(String, char[]), camelCase(String, boolean, char[]), lowerCamelCase(String, char[])

camelCase

public java.lang.String camelCase(java.lang.String lowerCaseAndUnderscoredWord,
                                  boolean uppercaseFirstLetter,
                                  char... delimiterChars)

By default, this method converts strings to UpperCamelCase. If the uppercaseFirstLetter argument to false, then this method produces lowerCamelCase. This method will also use any extra delimiter characters to identify word boundaries.

Examples:

   inflector.camelCase("active_record",false)    #=> "activeRecord"
   inflector.camelCase("active_record",true)     #=> "ActiveRecord"
   inflector.camelCase("first_name",false)       #=> "firstName"
   inflector.camelCase("first_name",true)        #=> "FirstName"
   inflector.camelCase("name",false)             #=> "name"
   inflector.camelCase("name",true)              #=> "Name"
 

Parameters:

lowerCaseAndUnderscoredWord - the word that is to be converted to camel case

uppercaseFirstLetter - true if the first character is to be uppercased, or false if the first character is to be lowercased

delimiterChars - optional characters that are used to delimit word boundaries

Returns:

the camel case version of the word

See Also:

underscore(String, char[]), upperCamelCase(String, char[]), lowerCamelCase(String, char[])

underscore

public java.lang.String underscore(java.lang.String camelCaseWord,
                                   char... delimiterChars)

Makes an underscored form from the expression in the string (the reverse of the camelCase method. Also changes any characters that match the supplied delimiters into underscore.

Examples:

   inflector.underscore("activeRecord")     #=> "active_record"
   inflector.underscore("ActiveRecord")     #=> "active_record"
   inflector.underscore("firstName")        #=> "first_name"
   inflector.underscore("FirstName")        #=> "first_name"
   inflector.underscore("name")             #=> "name"
   inflector.underscore("The.firstName")    #=> "the_first_name"
 

Parameters:

camelCaseWord - the camel-cased word that is to be converted;

delimiterChars - optional characters that are used to delimit word boundaries (beyond capitalization)

Returns:

a lower-cased version of the input, with separate words delimited by the underscore character.

capitalize

public java.lang.String capitalize(java.lang.String words)

Returns a copy of the input with the first character converted to uppercase and the remainder to lowercase.

Parameters:

words - the word to be capitalized

Returns:

the string with the first character capitalized and the remaining characters lowercased

humanize

public java.lang.String humanize(java.lang.String lowerCaseAndUnderscoredWords,
                                 java.lang.String... removableTokens)

Capitalizes the first word and turns underscores into spaces and strips trailing "_id" and any supplied removable tokens. Like titleCase(String, String[]), this is meant for creating pretty output.

Examples:

   inflector.humanize("employee_salary")       #=> "Employee salary"
   inflector.humanize("author_id")             #=> "Author"
 

Parameters:

lowerCaseAndUnderscoredWords - the input to be humanized

removableTokens - optional array of tokens that are to be removed

Returns:

the humanized string

See Also:

titleCase(String, String[])

titleCase

public java.lang.String titleCase(java.lang.String words,
                                  java.lang.String... removableTokens)

Capitalizes all the words and replaces some characters in the string to create a nicer looking title. Underscores are changed to spaces, a trailing "_id" is removed, and any of the supplied tokens are removed. Like humanize(String, String[]), this is meant for creating pretty output.

Examples:

   inflector.titleCase("man from the boondocks")       #=> "Man From The Boondocks"
   inflector.titleCase("x-men: the last stand")        #=> "X Men: The Last Stand"
 

Parameters:

words - the input to be turned into title case

removableTokens - optional array of tokens that are to be removed

Returns:

the title-case version of the supplied words

ordinalize

public java.lang.String ordinalize(int number)

Turns a non-negative number into an ordinal string used to denote the position in an ordered sequence, such as 1st, 2nd, 3rd, 4th.

Parameters:

number - the non-negative number

Returns:

the string with the number and ordinal suffix

isUncountable

public boolean isUncountable(java.lang.String word)

Determine whether the supplied word is considered uncountable by the pluralize and singularize methods.

Parameters:

word - the word

Returns:

true if the plural and singular forms of the word are the same

getUncountables

public java.util.Set<java.lang.String> getUncountables()

Get the set of words that are not processed by the Inflector. The resulting map is directly modifiable.

Returns:

the set of uncountable words

addPluralize

public void addPluralize(java.lang.String rule,
                         java.lang.String replacement)

addSingularize

public void addSingularize(java.lang.String rule,
                           java.lang.String replacement)

addIrregular

public void addIrregular(java.lang.String singular,
                         java.lang.String plural)

addUncountable

public void addUncountable(java.lang.String... words)

clear

public void clear()

Completely remove all rules within this inflector.