Interface Addressbook

  • All Superinterfaces:
    java.rmi.Remote
    All Known Subinterfaces:
    AddressbookService
    All Known Implementing Classes:
    AddressbookHibiscusImpl, AddressbookServiceImpl

    public interface Addressbook
    extends java.rmi.Remote
    Interface fuer ein einzelnes Adressbuch. Alle Klassen, die dieses Interface implementieren, werden automatisch von Hibiscus erkannt. Alle Implementierungen muessen einen parameterlosen Konstruktor besitzen (Bean-Spezifikation), um via Reflection instanziiert werden zu koennen.
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      Address contains​(Address address)
      Prueft, ob im Adressbuch eine Adresse mit diesen Eigenschaften enthalten ist.
      java.util.List findAddresses​(java.lang.String text)
      Sucht nach Adressen und liefert die gefundenen zurueck.
      java.lang.String getName()
      Liefert einen sprechenden Namen fuer das Adressbuch.
    • Method Detail

      • getName

        java.lang.String getName()
                          throws java.rmi.RemoteException
        Liefert einen sprechenden Namen fuer das Adressbuch.
        Returns:
        Name des Adressbuches.
        Throws:
        java.rmi.RemoteException
      • findAddresses

        java.util.List findAddresses​(java.lang.String text)
                              throws java.rmi.RemoteException
        Sucht nach Adressen und liefert die gefundenen zurueck. Es ist der jeweiligen Implementierung des Adressbuches ueberlassen, in welchen Feldern/Attributen der Adressdaten sie nach dem uebergebenen Text sucht. Wird kein Text uebergeben, kann das Adressbuch selbst entscheiden, ob es alle Adressen zurueckliefert oder gar keine.
        Parameters:
        text - der Suchtext.
        Returns:
        Liste der gefundenen Adressen. Die Objekte der Liste muessen vom Typ Address sein. Die Funktion darf auch null zurueckliefern, wenn keine Adressen gefunden wurden.
        Throws:
        java.rmi.RemoteException
        See Also:
        findAddresses(String)
      • contains

        Address contains​(Address address)
                  throws java.rmi.RemoteException
        Prueft, ob im Adressbuch eine Adresse mit diesen Eigenschaften enthalten ist.
        Parameters:
        address - die gesuchte Adresse.
        Returns:
        die Adresse mit den gleichen Eigenschaften aus dem Adressbuch oder null.
        Throws:
        java.rmi.RemoteException