DBWeb
Class EnglishName

java.lang.Object
  |
  +--DBWeb.EnglishName

public class EnglishName

extends java.lang.Object

Supports creation, parsing and output of names in the English formats. Names are considered to contain a single first name, any number of middle names, possibly a series of last name prefixes (such as "de la"), and possibly a suffix. Constructors give any of the following means of creating the name: -- A string from which the name is parsed -- Last, First -- Last, First, Middles -- Last, First, Middles, Suffix -- Last, First, Middles, Suffix, vons -- a resultSet from a SQL query

Field Summary

static java.lang.String[]	colNames
static java.lang.String[]	suffixes

Constructor Summary

EnglishName()
With no arguments, we create a null EnglishName.

EnglishName(java.util.Hashtable h)

EnglishName(java.sql.ResultSet rs)
The constructor that allows us to create an EnglishName from a database access ResultSet requires some conventions that are encoded in settable class (static) variables.

EnglishName(java.lang.String s)

EnglishName(java.lang.String lastname, java.lang.String firstname)

EnglishName(java.lang.String lastname, java.lang.String firstname, java.lang.String middlenames)

EnglishName(java.lang.String lastname, java.lang.String firstname, java.lang.String middlenames, java.lang.String suffixname)

EnglishName(java.lang.String lastname, java.lang.String firstname, java.lang.String middlenames, java.lang.String suffixname, java.lang.String vonnames)

Method Summary

java.lang.String	getFirst()
java.lang.String	getFNF()
java.lang.String	getLast() Bean properties of this class:
java.lang.String	getMiddles()
java.lang.String	getName()
java.lang.String	getSuffix()
java.lang.String	getVons()
void	setFirst(java.lang.String firstname)
void	setLast(java.lang.String lastname)
void	setMiddles(java.lang.String middlenames)
void	setName(java.lang.String s)
void	setSuffix(java.lang.String suffixname)
void	setVons(java.lang.String vonnames)
java.lang.String	toFNF() Returns the first-name-first version of a name
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

suffixes

public static java.lang.String[] suffixes

colNames

public static java.lang.String[] colNames

Constructor Detail

EnglishName

public EnglishName()

With no arguments, we create a null EnglishName. Its content must then be set by various setxxx methods.

EnglishName

public EnglishName(java.lang.String lastname,
                   java.lang.String firstname,
                   java.lang.String middlenames,
                   java.lang.String suffixname,
                   java.lang.String vonnames)

Parameters:

lastname - is the person's last (family) name

firstname - is the first name

middlenames - is a String of middle names, separated by spaces

suffixname - is the suffix, if any

vonnames - is a String of vons, separated by spaces

EnglishName

public EnglishName(java.lang.String s)
            throws java.lang.Exception

Parameters:

s - A string that gives the name either as First Middle Middle de Last, Jr. or de Last, First Middle Middle, Jr.

EnglishName

public EnglishName(java.lang.String lastname,
                   java.lang.String firstname)

EnglishName

public EnglishName(java.lang.String lastname,
                   java.lang.String firstname,
                   java.lang.String middlenames)

EnglishName

public EnglishName(java.lang.String lastname,
                   java.lang.String firstname,
                   java.lang.String middlenames,
                   java.lang.String suffixname)

EnglishName

public EnglishName(java.sql.ResultSet rs)
            throws java.sql.SQLException

The constructor that allows us to create an EnglishName from a database access ResultSet requires some conventions that are encoded in settable class (static) variables. colNames holds an array of Strings that name the successive keys in a ResultSet that hold the last, first, middles, suffix and vons components of a name. These will be passed to rs.getString() to extact the corresponding column values as Strings.

EnglishName

public EnglishName(java.util.Hashtable h)

Method Detail

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

toFNF

public java.lang.String toFNF()

Returns the first-name-first version of a name

getLast

public java.lang.String getLast()

Bean properties of this class:

getFirst

public java.lang.String getFirst()

getMiddles

public java.lang.String getMiddles()

getSuffix

public java.lang.String getSuffix()

getVons

public java.lang.String getVons()

getName

public java.lang.String getName()

getFNF

public java.lang.String getFNF()

setLast

public void setLast(java.lang.String lastname)

setFirst

public void setFirst(java.lang.String firstname)

setMiddles

public void setMiddles(java.lang.String middlenames)

setSuffix

public void setSuffix(java.lang.String suffixname)

setVons

public void setVons(java.lang.String vonnames)

setName

public void setName(java.lang.String s)
             throws java.lang.Exception

Parameters:

s - String that holds the name, in one of the following two forms, as defined by BibTeX: 1. First Middle Middle von Last, Jr. 2. von Last, First Middle Middle, Jr. In the first-name-first format, there can be at most one comma, which must precede a single acceptable suffix. In the last-name-first format, there must be at least one comma; the second is present only if there is a suffix. Thus, there can be at most two commas in a name.

java.lang.Exception