Interface AddressbookService

  • All Superinterfaces:
    Addressbook, java.rmi.Remote, de.willuhn.datasource.Service
    All Known Implementing Classes:
    AddressbookServiceImpl

    public interface AddressbookService
    extends de.willuhn.datasource.Service, Addressbook
    Interface fuer den Adressbuch-Service. Hintergrund: Hibiscus soll einmal mehrere Adressbuecher unterstuetzen koennen. Mit diesem Service hier koennen nun die vorhandenen Adressbuecher abgefragt werden. Ein Adressbuch muss das Interface "rmi.Addressbook" implementieren, um automatisch erkannt zu werden. Der Adressbuch-Service implementiert selbst ebenfalls das Interface Addressbook. Hiermit ist es moeglich, alle Adressbuecher wie ein einziges abzufragen.
    • Method Detail

      • getAddressbooks

        Addressbook[] getAddressbooks()
                               throws java.rmi.RemoteException
        Liefert die Liste aller gefundenen Adressbuecher.
        Returns:
        Liste der Adressbuecher. Die Funktion liefert niemals null und auch nie ein leeres Array. Denn da AddressbookService selbst ebenfalls das Addressbook-Interface implementiert, wird mindestens dieses zurueckgeliefert. Allerdings wuerde es in diesem Fall keine Adressen finden, da ja keine tatsaechlichen "Backend"-Adressbuecher existieren. Zumindest das Hibiscus-eigene Adressbuch sollte aber immer enthalten sein.
        Throws:
        java.rmi.RemoteException
      • hasExternalAddressbooks

        boolean hasExternalAddressbooks()
                                 throws java.rmi.RemoteException
        Liefert true, wenn neben dem Hibiscus-eigenen Adressbuch noch weitere gefunden wurden. In diesem Fall koennte dem Benutzer z.Bsp. ein Auswahl-Dialog angezeigt werden, in dem er das gewuenschte Adressbuch auswaehlen kann.
        Returns:
        true, wenn weitere Adressbuecher existieren.
        Throws:
        java.rmi.RemoteException