Class AbstractPlugin

  • All Implemented Interfaces:
    Plugin

    public abstract class AbstractPlugin
    extends java.lang.Object
    implements Plugin
    Abstrakte Basis-Klasse aller Plugins. Jedes Plugin muss diese Klasse erweitern, damit es beim Start von Jameica erkannt wird.
    Author:
    willuhn
    • Constructor Summary

      Constructors 
      Constructor Description
      AbstractPlugin()  
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      Manifest getManifest()
      Liefert das Manifest des Plugins.
      PluginResources getResources()
      Liefert ein Objekt mit Resourcen, auf die das Plugin zugreifen kann.
      void init()
      Diese Funktion wird beim Start der Anwendung ausgefuehrt.
      void install()
      Diese Funktion wird beim Start der Anwendung aufgerufen, wenn das Plugin zum ersten mal gestartet wird.
      void shutDown()
      Diese Funktion wird beim Beenden der Anwendung ausgefuehrt.
      void uninstall​(boolean deleteUserData)
      Wird aufgerufen, wenn das Plugin ueber Datei->Einstellungen->Plugins deinstalliert wird.
      void update​(Version oldVersion)
      Diese Funktion wird beim Start der Anwendung genau dann aufgerufen, wenn das Plugin bereits erfolgreich installiert wurde, jedoch jetzt in einer anderen Version vorliegt als die vorherige.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • AbstractPlugin

        public AbstractPlugin()
    • Method Detail

      • init

        public void init()
                  throws de.willuhn.util.ApplicationException
        Description copied from interface: Plugin
        Diese Funktion wird beim Start der Anwendung ausgefuehrt. Hier kann die Plugin- Implementierung also diverse Dinge durchfuehren, die es beim Start gern automatisch durchgefuehrt haben moechte. Nur wenn die Funktion fehlerfrei durchlaeuft, wird das Plugin aktiviert. Andernfalls wird der Text der geworfenen Exception dem Benutzer auf der Start-Seite von Jameica angezeigt. Von daher empfiehlt es sich, verstaendliche Formulierungen fuer ggf aufgetretene Fehler zu verwenden. Hinweis: Diese Funktion wird von Jameica vor dem Initialisieren der Services aufgerufen.
        Specified by:
        init in interface Plugin
        Throws:
        de.willuhn.util.ApplicationException - muss geworfen werden, wenn das Plugin nicht aktiviert werden soll.
        See Also:
        Plugin.init()
      • install

        public void install()
                     throws de.willuhn.util.ApplicationException
        Description copied from interface: Plugin
        Diese Funktion wird beim Start der Anwendung aufgerufen, wenn das Plugin zum ersten mal gestartet wird. Die install() Funktion wird solange bei jedem Start aufgerufen, bis sie fehlerfrei durchlaeuft. Andernfalls wird der Text der geworfenen Exception dem Benutzer auf der Start-Seite von Jameica angezeigt. Von daher empfiehlt es sich, verstaendliche Formulierungen fuer ggf aufgetretene Fehler zu verwenden. Hinweis: Diese Funktion wird von Jameica vor dem Initialisieren der Services aufgerufen.
        Specified by:
        install in interface Plugin
        Throws:
        de.willuhn.util.ApplicationException - muss geworfen werden, wenn die Installation fehlschlug und das Plugin nicht aktiviert werden soll.
        See Also:
        Plugin.install()
      • update

        public void update​(Version oldVersion)
                    throws de.willuhn.util.ApplicationException
        Description copied from interface: Plugin
        Diese Funktion wird beim Start der Anwendung genau dann aufgerufen, wenn das Plugin bereits erfolgreich installiert wurde, jedoch jetzt in einer anderen Version vorliegt als die vorherige. Sie wird solange bei jedem Start aufgerufen, bis sie fehlerfrei durchlaeuft. Andernfalls wird der Text der geworfenen Exception dem Benutzer auf der Start-Seite von Jameica angezeigt. Von daher empfiehlt es sich, verstaendliche Formulierungen fuer ggf aufgetretene Fehler zu verwenden. Hinweis: Diese Funktion wird von Jameica vor dem Initialisieren der Services aufgerufen.
        Specified by:
        update in interface Plugin
        Parameters:
        oldVersion - Version, die vorher installiert war.
        Throws:
        de.willuhn.util.ApplicationException - muss geworfen werden, wenn das Update fehlschlug und das Plugin nicht aktiviert werden soll.
        See Also:
        Plugin.update(de.willuhn.jameica.plugin.Version)
      • shutDown

        public void shutDown()
        Description copied from interface: Plugin
        Diese Funktion wird beim Beenden der Anwendung ausgefuehrt.
        Specified by:
        shutDown in interface Plugin
        See Also:
        Plugin.shutDown()
      • uninstall

        public void uninstall​(boolean deleteUserData)
                       throws de.willuhn.util.ApplicationException
        Description copied from interface: Plugin
        Wird aufgerufen, wenn das Plugin ueber Datei->Einstellungen->Plugins deinstalliert wird. Hier kann das Plugin bei Bedarf eigene Aufraeum-Arbeiten durchfuehren. VOR dem Aufruf dieser Funktion wird "shutDown" aufgerufen. Falls dort also z.Bsp. Datenbankverbindungen geschlossen wurden, dann stehen diese hier nicht mehr zur Verfuegung.
        Specified by:
        uninstall in interface Plugin
        Parameters:
        deleteUserData - true, wenn der User bei der Deinstallation angegeben hat, dass auch die Benutzer-Daten des Plugins geloescht werden sollen.
        Throws:
        de.willuhn.util.ApplicationException - kann geworfen werden, um die Deinstallation abzubrechen.
        See Also:
        Plugin.uninstall(boolean)