/**
   * Verifica la possibilità di recuperare i dati di un utente dal database disponendo di una
   * stringa che può comparire come sottostringa del nome, del cognome oppure del nome utente. In
   * particolare, il test assicura che il risultato sia uguale alle attese (in base a come è stato
   * configurato il mock di GetUserDataUtil), e verifica inoltre il corretto utilizzo dei mock. In
   * particolare, verifica che sia eseguita ESATTAMENTE la query impostata nella variabile 'query' e
   * che la UtilFactory sia utilizzata per procurarsi la corretta istanza di GetUtil.
   *
   * @author Diego Beraldin
   * @version 2.0
   */
  @Test
  public void testGetUserDataGeneric() {
    String mail = "*****@*****.**";
    String name = "paperino";
    String surname = "de paperoni";
    String query =
        "from UserData as u where u.mail like '%"
            + mail
            + "%' or u.name like '%"
            + name
            + "%' or u.surname like '%"
            + surname
            + "%'";
    // configura il comportamento dei mock
    when(getter.execute(query)).thenReturn(list);

    // invoca il metodo da testare
    List<IUserData> result = tester.getUserDatas(mail, name, surname);

    // verifica l'output
    assertNotNull(result);
    assertEquals(list, result);

    // verifica il corretto utilizzo dei mock
    verify(factory).getUserDataUtil(manager);
    verify(getter).execute(query);
  }
  /**
   * Verifica il comportamento della classe nel momento in cui è richiesto di recuperare tutti i
   * messaggi della segreteria di un determinato utente ma avviene un errore nel sistema di
   * persistenza dei dati e il sottotipo di {@GetUtil} che effettua l'operazione di SELECT, invece
   * di una collezione di transfer object, restituisce un riferimento nullo. Il test verifica che in
   * questo caso anche la chiamata di metodo getGroup restituisca un riferimento nullo.
   *
   * @author Diego Beraldin
   * @version 2.0
   */
  @Test
  public void testGetMessagesNoCollection() {
    // query da eseguire
    String query = "from Message as m where m.receiver.id = " + userId;
    // impedisce il recupero della collezione
    when(getter.execute(query)).thenReturn(null);

    // invoca il metodo da testare
    List<IMessage> result = tester.getMessages(user);
    assertNull(result);

    // verifica il corretto utilizzo dei mock
    verify(getter).execute(query);
    verifyZeroInteractions(list);
  }
  /**
   * Verifica il comportamento della classe nel momento in cui è richiesto di recuperare la lista di
   * gruppi della rubrica che hanno come proprietario un determinato utente. In particolare, il test
   * verifica che nel caso in cui la collezione di gruppi sia vuota il valore ritornato sia
   * effettivamente <code>null</code> e che sia effettivamente invocato il metodo execute passando
   * la query HQL corretta per interrogare il database.
   *
   * @author Diego Beraldin
   * @version 2.0
   */
  @Test
  public void testGetGroupIUserDataEmpty() {
    // query che deve essere eseguita
    String query = "from Group as g where g.owner.id = " + userId;
    // comportamento dei mock
    when(list.isEmpty()).thenReturn(true);
    when(getter.execute(query)).thenReturn(list);

    // invoca il metodo da testare
    List<IGroup> result = tester.getGroup(user);
    assertNull(result);

    // verifica il corretto utilizzo dei mock
    verify(getter).execute(query);
    verify(list).isEmpty();
  }
  /**
   * Verifica il comportamento della classe nel momento in cui è richiesto di recuperare dal sistema
   * di persistenza una lista di messaggi della segreteria a partire da un utente che non ha alcun
   * messaggio nella propria segreteria telefonica. In particolare, il test verifica che il
   * risultato dell'invocazione del metodo sia, come desiderato <code>null</code>. Si controlla
   * inoltre che il metodo execute di {@link GetUtil} sia richiamato passando come parametro
   * esattamente la stringa HQL necessaria al recupero dei dati.
   *
   * @author Diego Beraldin
   * @version 2.0
   */
  @Test
  public void testGetMessagesEmpty() {
    // query da eseguire
    String query = "from Message as m where m.receiver.id = " + userId;
    // comportamento dei mock
    when(getter.execute(query)).thenReturn(list);
    when(list.isEmpty()).thenReturn(true);

    // invoca il metodo da testare
    List<IMessage> result = tester.getMessages(user);
    assertNull(result);

    // verifica il corretto utilizzo dei mock
    verify(getter).execute(query);
    verify(list).isEmpty();
  }
  /**
   * Verifica il comportamento della classe nel momento in cui è richiesto di recuperare un gruppo
   * della rubrica sulla base del proprietario di quest'ultimo ma avviene un errore nel sistema di
   * persistenza dei dati e il sottotipo di {@GetUtil} che effettua l'operazione di SELECT, invece
   * di una collezione di transfer object, restituisce un riferimento nullo. Il test verifica che in
   * questo caso anche la chiamata di metodo getGroup restituisca un riferimento nullo.
   *
   * @author Diego Beraldin
   * @version 2.0
   */
  @Test
  public void testGetGroupIUserDataNoCollection() {
    // query che deve essere eseguita
    String query = "from Group as g where g.owner.id = " + userId;
    // impedisce il recupero della collezione
    when(getter.execute(query)).thenReturn(null);

    // invoca il metodo da testare
    List<IGroup> result = tester.getGroup(user);

    // verifica il risultato ottenuto
    assertNull(result);

    // verifica il corretto utilizzo dei mock
    verify(getter).execute(query);
    verifyZeroInteractions(list);
  }
  /**
   * Verifica il comportamento della classe nel momento in cui è richiesto di recuperare un
   * messaggio della segreteria sulla base del numero identificativo di quest'ultimo ma avviene un
   * errore nel sistema di persistenza dei dati e il sottotipo di {@GetUtil} che effettua
   * l'operazione di SELECT, invece di una collezione di transfer object, restituisce un riferimento
   * nullo. Il test verifica che in questo caso anche la chiamata di metodo getGroup restituisca un
   * riferimento nullo.
   *
   * @author Diego Beraldin
   * @version 2.0
   */
  @Test
  public void testGetMessageNoCollection() {
    // identificativo di prova
    Long id = 1L;
    // query che deve essere eseguita
    String query = "from Message as m where m.id = " + "'" + id + "'";
    // impedisce il recupero della lista
    when(getter.execute(query)).thenReturn(null);

    // invoca il metodo da testare
    IMessage result = tester.getMessage(id);

    // verifica l'output
    assertNull(result);

    // verifica il corretto utilizzo dei mock
    verify(getter).execute(query);
    verifyZeroInteractions(list);
  }
  /**
   * Verifica il comportamento della classe nel momento in cui è richiesto di recuperare un gruppo
   * della rubrica sulla base del numero identificativo di quest'ultimo ma avviene un errore nel
   * sistema di persistenza dei dati e il sottotipo di {@GetUtil} che effettua l'operazione di
   * SELECT, invece di una collezione di transfer object, restituisce un riferimento nullo. Il test
   * verifica che in questo caso anche la chiamata di metodo getGroup restituisca un riferimento
   * nullo.
   *
   * @author Diego Beraldin
   * @version 2.0
   */
  @Test
  public void testGetGroupLongNoCollection() {
    // id del gruppo
    Long groupId = 1L;
    // query che deve essere eseguita
    String query = "from Group as g where g.id = " + "'" + groupId + "'";
    // impedisce il recupero della collezione
    when(getter.execute(query)).thenReturn(null);

    // invoca il metodo da testare
    IGroup result = tester.getGroup(groupId);

    // verifica il risultato ottenuto
    assertNull(result);

    // verifica il corretto utilizzo dei mock
    verify(getter).execute(query);
    verifyZeroInteractions(list);
  }
  /**
   * Verifica il comportamento della classe nel momento in cui è richiesto di recuperare una
   * chiamata sulla base del numero identificativo di quest'ultimo ma avviene un errore nel sistema
   * di persistenza dei dati e il sottotipo di {@GetUtil} che effettua l'operazione di SELECT,
   * invece di una collezione di transfer object, restituisce un riferimento nullo. Il test verifica
   * che in questo caso anche la chiamata di metodo getGroup restituisca un riferimento nullo.
   *
   * @author Diego Beraldin
   * @version 2.0
   */
  @Test
  public void testGetCallNoCollection() {
    // identificativo di prova
    Long id = 1L;
    // query che deve essere eseguita
    String query = "from Call as c where c.id = " + id;
    // impedisce il recupero della collezione
    when(getter.execute(query)).thenReturn(null);

    // invoca il metodo da testare
    ICall result = tester.getCall(id);

    // verifica il risultato ottenuto
    assertNull(result);

    // verifica il corretto utilizzo dei mock
    verify(factory).getCallUtil(manager);
    verify(getter).execute(query);
    verifyZeroInteractions(list);
  }
  /**
   * Verifica il comportamento della classe nel momento in cui è richiesto di recuperare uno degli
   * utenti del sistema sulla base dell'indirizzo email impostato in fase di registrazione ma
   * avviene un errore nel sistema di persistenza dei dati e il sottotipo di {@GetUtil} che effettua
   * l'operazione di SELECT, invece di una collezione di transfer object, restituisce un riferimento
   * nullo. Il test verifica che in questo caso anche la chiamata di metodo getGroup restituisca un
   * riferimento nullo.
   *
   * @author Diego Beraldin
   * @version 2.0
   */
  @Test
  public void testGetUserDataByEmailNoCollection() {
    // indirizzo email di prova
    String mail = "ThisIsNotAnEmailAddress";
    // query che deve essere eseguita
    String query = "from UserData as u where u.mail = " + "'" + mail + "'";
    // configura il comportamento dei mock
    when(getter.execute(query)).thenReturn(null);

    // invoca il metodo da testare
    IUserData result = tester.getUserData(mail);

    // verifica il risultato ottenuto
    assertNull(result);

    // verifica il corretto utilizzo dei mock
    verify(factory).getUserDataUtil(manager);
    verify(getter).execute(query);
    verifyZeroInteractions(list);
  }
  /**
   * Verifica la possibilità di recuperare una chiamata dal database disponendo del relativo numero
   * identificativo. In particolare, il test assicura che il risultato sia uguale alle attese (in
   * base a come è stato configurato il mock di GetUserDataUtil), e verifica inoltre il corretto
   * utilizzo dei mock. In particolare, verifica che sia eseguita ESATTAMENTE la query impostata
   * nella variabile 'query' e il fatto che dalla collezione di oggetti ritornata dalla execute del
   * GetUtil sia estratto il primo elemento e che non sia MAI invocato get con argomenti superiori
   * allo zero, che la lista sia scorsa solo se non è vuota e che la UtilFactory sia utilizzata per
   * procurarsi la corretta istanza di GetUtil.
   *
   * @author Diego Beraldin
   * @version 2.0
   */
  @Test
  public void testGetCall() {
    Long id = 1L;
    String query = "from Call as c where c.id = " + id;
    // configura il comportamento dei mock
    when(list.get(0)).thenReturn(call);
    when(getter.execute(query)).thenReturn(list);

    // invoca il metodo da testare
    ICall result = tester.getCall(id);

    // verifica l'output
    assertNotNull(result);
    assertEquals(call, result);

    // verifica il corretto utilizzo dei mock
    verify(factory).getCallUtil(manager);
    verify(getter).execute(query);
    verify(list).isEmpty();
    verify(list).get(0);
  }
  /**
   * Verifica il comportamento della classe nel momento in cui è richiesto di recuperare dal sistema
   * di persistenza un messaggio della segreteria a partire da un campo numerico identificativo che
   * non corrisponde ad alcuno dei messaggi presenti. In particolare, il test verifica che il
   * risultato dell'invocazione del metodo sia, come desiderato <code>null</code> e che non siano
   * effettuate operazioni di estrazione dalla lista restituita dal metodo execute del {@link
   * GetUtil} dal momento che quest'ultima è vuota. si controlla inoltre che quest'ultimo metodo sia
   * richiamato passando come parametro esattamente la stringa HQL necessaria al recupero dei dati.
   *
   * @author Diego Beraldin
   * @version 2.0
   */
  @Test
  public void testGetMessageEmpty() {
    // identificativo di prova
    Long id = 1L;
    // query che deve essere eseguita
    String query = "from Message as m where m.id = " + "'" + id + "'";
    // comportamento dei mock
    when(list.isEmpty()).thenReturn(true);
    when(getter.execute(query)).thenReturn(list);

    // invoca il metodo da testare
    IMessage result = tester.getMessage(id);

    // verifica l'output
    assertNull(result);

    // verifica il corretto utilizzo dei mock
    verify(getter).execute(query);
    verify(list).isEmpty();
    verify(list, never()).get(anyInt());
  }
  /**
   * Verifica il comportamento della classe nel momento in cui è richiesto di recuperare dal sistema
   * di persistenza un gruppo a partire da un campo numerico identificativo che non corrisponde ad
   * alcuno dei gruppi presenti nel sistema. In particolare, il test verifica che il risultato
   * dell'invocazione del metodo sia, come desiderato <code>null</code> e che non siano effettuate
   * operazioni di estrazione dalla lista restituita dal metodo execute del {@link GetUtil} dal
   * momento che quest'ultima è vuota. si controlla inoltre che quest'ultimo metodo sia richiamato
   * passando come parametro esattamente la stringa HQL necessaria al recupero dei dati.
   *
   * @author Diego Beraldin
   * @version 2.0
   */
  @Test
  public void testGetGroupLongEmpty() {
    // id del gruppo
    Long groupId = 1L;
    // query che deve essere eseguita
    String query = "from Group as g where g.id = " + "'" + groupId + "'";
    // comportamento dei mock
    when(list.isEmpty()).thenReturn(true);
    when(getter.execute(query)).thenReturn(list);

    // invoca il metodo da testare
    IGroup result = tester.getGroup(groupId);

    // verifica il risultato ottenuto
    assertNull(result);

    // verifica il corretto utilizzo dei mock
    verify(getter).execute(query);
    verify(list, never()).get(anyInt());
    verify(list).isEmpty();
  }
  /**
   * Verifica il comportamento della classe nel momento in cui si tenta di recuperare una chiamata
   * con un id inesistente (cioè la query restituisce un insieme vuoto). Il test assicura che in
   * questo caso la collezione restituita sia, come atteso, il riferimento nullo. Inoltre il test
   * verifica il corretto utilizzo dei mock, cioè che sia utilizzata la classe factory per ottenere
   * il GetUtil corretto, che il metodo execute di quest'ultimo sia invocato ESATTAMENTE con la
   * stringa impostata nella variabile query, che si controlli se la collezione restituita è vuota
   * e, dal momento che appare come tale, che non sia MAI invocato il metodo get su quest'ultima con
   * un parametro intero.
   *
   * @author Diego Beraldin
   * @version 2.0
   */
  @Test
  public void testGetCallEmpty() {
    // identificativo di prova
    Long id = 1L;
    // query che deve essere eseguita
    String query = "from Call as c where c.id = " + id;
    // configura il comportamento dei mock
    when(list.isEmpty()).thenReturn(true);
    when(getter.execute(query)).thenReturn(list);

    // invoca il metodo da testare
    ICall result = tester.getCall(id);

    // verifica il risultato ottenuto
    assertNull(result);

    // verifica il corretto utilizzo dei mock
    verify(factory).getCallUtil(manager);
    verify(getter).execute(query);
    verify(list).isEmpty();
    verify(list, never()).get(anyInt());
  }
  /**
   * Verifica la possibilità di recuperare i dati di un utente dal database disponendo del relativo
   * numero identificativo. In particolare, il test assicura che il risultato sia uguale alle attese
   * (in base a come è stato configurato il mock di GetUserDataUtil), e verifica inoltre il corretto
   * utilizzo dei mock. In particolare, verifica che sia eseguita ESATTAMENTE la query impostata
   * nella variabile 'query' e il fatto che dalla collezione di oggetti ritornata dalla execute del
   * GetUtil sia estratto il primo elemento e che non sia MAI invocato get con argomenti superiori
   * allo zero, che la lista sia scorsa solo se non è vuota e che la UtilFactory sia utilizzata per
   * procurarsi la corretta istanza di GetUtil.
   *
   * @author Diego Beraldin
   * @version 2.0
   */
  @Test
  public void testGetUserDataById() {
    // identificativo di prova
    Long id = 1L;
    // query che deve essere eseguita
    String query = "from UserData as u where u.id = " + id;
    // configura il comportamento dei mock
    when(list.get(0)).thenReturn(user);
    when(getter.execute(query)).thenReturn(list);

    // invoca il metodo da testare
    IUserData result = tester.getUserData(id);

    // verifica il risultato ottenuto
    assertNotNull(result);
    assertEquals(user, result);

    // verifica il corretto utilizzo dei mock
    verify(factory).getUserDataUtil(manager);
    verify(getter).execute(query);
    verify(list).isEmpty();
    verify(list).get(0);
  }