/**
* La classe Persona descrive una persona e ha istanze della forma
* (nome,cognome).
*
* Date due persone p1 e p2 diciamo che:
*
* -
* p1 è uguale a p2
* se e solo se
* p1 e p2
* hanno lo stesso nome e cognome.
*
* -
*p1 precede p2
* (p1 < p2)
* se e solo se
* p1 precede p2 nell'ordine alfabetico.
* Ad esempio:
*
* (Mario,Bianchi) < (Antonio,Rossi) (Giovanni,Bianchi) < (Mario,Bianchi)
*
*
*
* La classe Persona implementa l'interfaccia
* Comparable<Persona>.
* Questo significa che deve possedere un metodo
*
* public int compareTo(Persona p)
*
* tale che, dati due oggetti p1 e p2
* di tipo Persona, la chiamata
*
* p1.compareTo(p2)
*
* restituisce un numero negativo se p1 < p2,
* un numero positivo se p2 < p1,
* 0 se p1 è uguale a p2.
*
*NOTA
*
* La classe String implementa l'interfaccia
* Comparable<String>,
* quindi dispone di un metodo compareTo per confrontare due stringhe
*(vedere la documentazione).
*
* Quando si implementa il metodo compareTo della classe Persona,
* per fare il confronto fra nome e cognome delle persone
* va utilizzato il metodo compareTo della classe String.
*
*/
public class Persona implements Comparable {
// CAMPI
private String nome; // nome
private String cognome; // cognome
// COSTRUTTORI
/**
* Costruisce una persona
* avente nome e cognome specificati dagli argomenti.
*/
public Persona(String nome, String cognome) {
this.nome = nome;
this.cognome = cognome;
}
// METODI
/**
* Restituisce il nome della persona.
* @return Il nome della persona che esegue il metodo.
*/
public String getNome() {
return this.nome;
}
/**
* Restituisce il cognome della persona.
* @return Il cognome della persona che esegue il metodo.
*/
public String getCognome() {
return this.cognome;
}
/**
* Restituisce una stringa che descrive la persona.
* @return Stringa che descrive la persona che esegue il metodo.
*/
// riscrive metodo toString della classe Object
public String toString(){
return nome + " " + cognome;
}
/**
* Controlla se la persona che esegue il metodo
* è uguale a quella specificata dall'argomento.
*
* @return true se la persona che esegue il metodo
* è uguale a quella specificato dall'argomento,
* false altrimenti.
*/
public boolean equals(Persona p) {
return nome.equals(p.nome) && cognome.equals(p.cognome);
}
// riscrive il metodo equals della classe Object
/**
* Controlla se l'oggetto o specificato
* dall'argomento è una persona
* e la persona che esegue il metodo è uguale a o.
*
* @return true se la persona che esegue il metodo
* è uguale a quella specificata dall'argomento,
* false altrimenti.
*/
public boolean equals(Object o) {
if (o instanceof Persona){
Persona p = (Persona) o;
return this.equals(p); // chiama metodo equals(Persona) definito sopra
}
else return false;
}
/**
* Implementa il metodo compareTo dell'interfaccia
* Comparable<Persona> confrontando le persone
* in base all'ordine alfabetico.
*
*
* @return un numero negativo se la persona che esegue il metodo precede
* (nell'ordine alfabetico) la persona
* p specificata dall'argomento, 0 se le due persone sono uguali,
* un numero positivo se p precede la persona che esegue il metodo.
*/
public int compareTo(Persona p){
/* Prima si confronta this.cognome e p.cognome.
Se i cognomi sono uguali, occorre confrontare il nome. */
int cognomeCmp = this.cognome.compareTo(p.cognome);
return ( cognomeCmp != 0 ) ? cognomeCmp : (this.nome).compareTo(p.nome) ;
/* EQUIVALE A
if (cognomeCmp != 0 )
return cognomeCmp;
else // cognomi uguali
return (this.nome).compareTo(p.nome);
*/
}
}// end class