test3

Class CellPhone

java.lang.Object

test3.CellPhone

public class CellPhone
extends Object

A class that represents a cell phone. Every cell phone has a cell number. The cell phone and its cell number form a composition.

Every cell phone has a call log. The cell phone and its call log form a composition. A call log is a list of cell numbers that have been called using this cell phone. The order of contacts in the call log are from the oldest call to the most recent call.

Constructor Summary

Constructors

Constructor and Description
CellPhone() Initializes this cell phone to have a valid cell number.
CellPhone(CellNumber number) Initializes this cell phone given its cell number.
CellPhone(CellNumber number, List<CellNumber> callLog) Initializes this cell phone given a cell number and a call log.

Method Summary

Modifier and Type	Method and Description
void	dial(CellNumber number) Dial a cell number using this phone.
CellNumber	favorite() Returns the favorite cell number that has been called using this cell phone.
List<CellNumber>	getCallLog() Returns a shallow copy of call log for this phone.
CellNumber	getNumber() Returns a new copy of the cell number for this phone.
void	setNumber(CellNumber number) Sets the cell number of this phone to a new copy of the given cell number.
String	toString() Returns a string representation of this cell phone.

Methods inherited from class java.lang.Object

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

Constructor Detail

CellPhone

public CellPhone()

Initializes this cell phone to have a valid cell number. Do not duplicate the code in this constructor; it is here for testing purposes in case your constructors are not implemented correctly.

CellPhone

public CellPhone(CellNumber number)

Initializes this cell phone given its cell number. The call log for this cell phone is initialized as an empty list.

Parameters:

number - the cell number for this phone

Preconditions:

number != null

CellPhone

public CellPhone(CellNumber number,
                 List<CellNumber> callLog)

Initializes this cell phone given a cell number and a call log. This cell phone makes a deep copy of the call log. If the argument call log is null, then this cell phone is initialized to have an empty call log.

Parameters:

number - the number for this phone

callLog - the call log for this phone

Preconditions:

number != null

Method Detail

getNumber

public CellNumber getNumber()

Returns a new copy of the cell number for this phone.

Returns:

a new copy of the cell number for this phone

setNumber

public void setNumber(CellNumber number)

Sets the cell number of this phone to a new copy of the given cell number.

Parameters:

number - the new cell number for this phone

Preconditions:

number != null

getCallLog

public List<CellNumber> getCallLog()

Returns a shallow copy of call log for this phone.

Returns:

a shallow copy of the call log for this phone

favorite

public CellNumber favorite()

Returns the favorite cell number that has been called using this cell phone. The favorite number is the one that has been called the most number of times. For the sake of simplicity, you may assume that there is a unique favorite phone number (i.e., there is no other cell number that has been dialed as many times as the favorite).

Returns null if this cell phone has never dialed a cell number.

Hint: Use Collections.frequency to count the number of times each cell number appears in the call log, or use a Map.

Returns:

the favorite cell number that has been called using this cell phone

dial

public void dial(CellNumber number)

Dial a cell number using this phone. Causes the dialed number to be added to the end of the call log.

Parameters:

number - a cell number to dial

Throws:

IllegalArgumentException - if number == null

toString

public String toString()

Returns a string representation of this cell phone. The returned string is the phone number (as returned by the CellNumber version of toString).

Overrides:

toString in class Object

Returns:

a string representation of this cell phone