Prepare For Output--Parse Full Name (including suffixes)

The following script proves useful in most cases when there is a need to separate a full name into first name, middle name, surname, and suffixes (if applicable). The suffixes include JR, SR, I, II, III, 3rd, IV, V, VI, VII. The script is also set up to work with names in the "LASTNAME, FIRSTNAME SUFFIX" format.

// Determines whether or not the string represents
// a suffix.
boolean isSuffix( String value )
{
session.log( "Determining whether or not this is a suffix: " + value );
value = value.toUpperCase();
returnVal = (
value.indexOf( "JR" )!=-1
||
value.indexOf( "SR" )!=-1
||
value.equals( "I" )
||
value.equals( "II" )
||
value.equals( "III" )
||
value.equals( "3RD" )
||
value.equals( "IV" )
||
value.equals( "V" )
||
value.equals( "VI" )
||
value.equals( "VII" )
);
session.log( "Suffix test returning: " + returnVal );
return returnVal;
}

fixName( String name )
{
name = name.replaceAll(",", "").trim();
return name;
}

name = dataRecord.get("NAME");
name = name.replaceAll(" ", " ");
name = name.replaceAll("\\.", "");
name = name.replaceAll(";", " ");
name = name.replaceAll("[ ]{2,}", " ").trim();
lastName = "";
firstName = "";
middleName = "";
suffix = "";

session.log( "@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@" );
session.log( "NAME: " + name );
session.log( "@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@" );

// Split on the space.
nameParts = name.split( " " );

// Send the parts to the log.
for( int i = 0; i < nameParts.length; i++ )
{
session.log( "Name part #" + i + ": " + nameParts[i] );
}

// If the first part has a comma we assume it's the last name.
if( nameParts.length > 1 && nameParts[0].indexOf( "," )!=-1 )
{
session.log( "The first name part has a comma." );

// If we have two elements we assume the order is
// last name, first name.
if( nameParts.length==2 )
{
lastName = fixName(nameParts[0]);
firstName = fixName(nameParts[1]);
}

// If we have three elements we assume the order is
// either last name, first name, middle name or
// last name, first name suffix.
else if( nameParts.length==3 )
{
if( !isSuffix( nameParts[2] ) )
{
lastName = fixName(nameParts[0]);
firstName = fixName(nameParts[1]);
middleName = fixName(nameParts[2]);
}
else
{
lastName = fixName(nameParts[0]);
firstName = fixName(nameParts[1]);
suffix = fixName(nameParts[2]);
}
}

else if( nameParts.length==4 )
{
// It will either be last name, first name middle name middle name or
// last name, first name middle name suffix.
if( !isSuffix( nameParts[3] ) )
{
lastName = fixName(nameParts[0]);
firstName = fixName(nameParts[1]);
middleName = fixName(nameParts[2]) + " " + fixName(nameParts[3]);
}
else
{
lastName = fixName(nameParts[0]);
firstName = fixName(nameParts[1]);
middleName = fixName(nameParts[2]);
suffix = fixName(nameParts[3]);
}
}
}
// If we have four parts and no comma it's either First Name Middle Name Middle Name Last Name or
// First Name Middle Name Last Name Suffix.
else if( nameParts.length==4 )
{
session.log( "The name has four elements." );

if( !isSuffix( nameParts[3] ) )
{
firstName = fixName(nameParts[0]);
middleName = fixName(nameParts[1]) + " " + fixName(nameParts[2]);
lastName = fixName(nameParts[3]);
}
else
{
firstName = fixName(nameParts[0]);
middleName = fixName(nameParts[1]);
lastName = fixName(nameParts[2]);
suffix = fixName(nameParts[3]);
}
}
// If we have three parts and no comma it's either First Name Middle Name Last Name or
// First Name Last Name Suffix.
else if( nameParts.length==3 )
{
session.log( "The name has three elements." );

if( !isSuffix( nameParts[2] ) )
{
firstName = fixName(nameParts[0]);
middleName = fixName(nameParts[1]);
lastName = fixName(nameParts[2]);
}
else
{
firstName = fixName(nameParts[0]);
lastName = fixName(nameParts[1]);
suffix = fixName(nameParts[2]);
}
}
// If the first part doesn't have a comma we assume the first
// name is given first.
else
{
// If we have only two parts we assume first name then last name.
if( nameParts.length==2 )
{
firstName = fixName(nameParts[0]);
middleName = "";
lastName = fixName(nameParts[1]);
}
}

session.log( "####################################################" );
session.log( "FIRST NAME: " + firstName );
session.log( "MIDDLE NAME: " + middleName );
session.log( "LAST NAME: " + lastName );
session.log( "SUFFIX: " + suffix );
session.log( "####################################################" );

dataRecord.put( "FNAME", firstName );
dataRecord.put( "MNAME", middleName );
dataRecord.put( "LNAME", lastName );
dataRecord.put( "SUFFIX", suffix );