Class AddressBook

java.lang.Object
  java.util.AbstractCollection
      java.util.AbstractList
          java.util.Vector
              AddressBook

All Implemented Interfaces:

java.lang.Cloneable, java.util.Collection, java.util.List, java.util.RandomAccess, java.io.Serializable

public class AddressBook

extends java.util.Vector

implements java.io.Serializable

An object of this class maintains the collection of Person objects that constitute an address book

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.Vector

capacityIncrement, elementCount, elementData

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

AddressBook()
Constructor - create a new, empty address book

Method Summary

void	addPerson(java.lang.String firstName, java.lang.String lastName, java.lang.String address, java.lang.String city, java.lang.String state, java.lang.String zip, java.lang.String phone) Add a new Person to the collection
boolean	getChangedSinceLastSave() Find out whether this address book has been changed since last open / save
java.io.File	getFile() Get the File this address book was most recently read from or saved to
java.lang.String	getFullNameOfPerson(int index) Provide the full name of a person
java.lang.String[]	getOtherPersonInformation(int index) Provide the rest of the current information about a person
java.lang.String	getTitle() Get the title of this address book - based on the most recently used file
void	printAll() Print the collection of persons in order.
void	removePerson(int index) Remove a specific person from the collection
void	setChangedSinceLastSave(boolean changedSinceLastSave) Record a change in the saved status of this address book
void	setFile(java.io.File file) Set the File this address book was most recently read from or saved to
void	sortByName() Sort the collection by name
void	sortByZip() Sort the collection by ZIP
void	updatePerson(int index, java.lang.String address, java.lang.String city, java.lang.String state, java.lang.String zip, java.lang.String phone) Update stored information about a person

Methods inherited from class java.util.Vector

add, add, addAll, addAll, addElement, capacity, clear, clone, contains, containsAll, copyInto, elementAt, elements, ensureCapacity, equals, firstElement, get, hashCode, indexOf, indexOf, insertElementAt, isEmpty, lastElement, lastIndexOf, lastIndexOf, remove, remove, removeAll, removeAllElements, removeElement, removeElementAt, removeRange, retainAll, set, setElementAt, setSize, size, subList, toArray, toArray, toString, trimToSize

Methods inherited from class java.util.AbstractList

iterator, listIterator, listIterator

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.List

iterator, listIterator, listIterator

Constructor Detail

AddressBook

public AddressBook()

Constructor - create a new, empty address book

Method Detail

addPerson

public void addPerson(java.lang.String firstName,
                      java.lang.String lastName,
                      java.lang.String address,
                      java.lang.String city,
                      java.lang.String state,
                      java.lang.String zip,
                      java.lang.String phone)

Add a new Person to the collection

Parameters:

firstName - the person's first name

lastName - the person's last name

address - the person's address

city - the person's city

state - the person's state

zip - the person's zip

phone - the person's phone

getFullNameOfPerson

public java.lang.String getFullNameOfPerson(int index)

Provide the full name of a person

Parameters:

index - the position of the desired person

Returns:

the person's full name, in a form suitable for displaying or printing

getOtherPersonInformation

public java.lang.String[] getOtherPersonInformation(int index)

Provide the rest of the current information about a person

Parameters:

index - the position of the desired person

Returns:

an array of Strings, each containing one piece of stored information about this person. The person's name is _not_ included, since this is not changeable.

updatePerson

public void updatePerson(int index,
                         java.lang.String address,
                         java.lang.String city,
                         java.lang.String state,
                         java.lang.String zip,
                         java.lang.String phone)

Update stored information about a person

Parameters:

index - the position of the desired person

address - the person's new address

city - the person's new city

state - the person's new state

zip - the person's new zip

phone - the person's new phone

removePerson

public void removePerson(int index)

Remove a specific person from the collection

Parameters:

index - the position of the desired person

sortByName

public void sortByName()

Sort the collection by name

sortByZip

public void sortByZip()

Sort the collection by ZIP

printAll

public void printAll()

Print the collection of persons in order.

getFile

public java.io.File getFile()

Get the File this address book was most recently read from or saved to

Returns:

the most recent File - if any - null if none

getTitle

public java.lang.String getTitle()

Get the title of this address book - based on the most recently used file

Returns:

the title of this address book - "Untitled" if none

setFile

public void setFile(java.io.File file)

Set the File this address book was most recently read from or saved to

Parameters:

file - the file just used to read or save this object

getChangedSinceLastSave

public boolean getChangedSinceLastSave()

Find out whether this address book has been changed since last open / save

Returns:

true if this address book has been changed since the last open / save; false if not

setChangedSinceLastSave

public void setChangedSinceLastSave(boolean changedSinceLastSave)

Record a change in the saved status of this address book

Parameters:

changedSinceLastSave - the new status