INSTALL JAVA-Anweisung

INSTALL JAVA
[ NEW | UPDATE ]
[ JAR jar-name ]
FROM { FILE filename | expression }
[ AS USER user-name ]

Schlüsselwort-Klauseln NEW und UPDATE Wenn Sie NEW angeben, muss die referenzierte Java-Klasse oder JAR-Datei neue Klassen enthalten statt Aktualisierungen für bereits installierte Klassen bzw. JAR-Dateien. Ein Fehler tritt auf, wenn eine Klasse oder JAR-Datei mit demselben Namen in der Datenbank bereits vorhanden ist und NEW verwendet wird.
Wenn Sie UPDATE angeben, darf die referenzierte Datei Ersetzungen für Java-Klassen oder JAR-Dateien enthalten, die in der angegebenen Datenbank bereits installiert sind.

Wenn nichts angegeben wird, ist der Standardwert NEW.
JAR-Klausel Wenn dies angegeben wird, muss filename eine JAR-Datei bezeichnen. JAR-Dateien haben in der Regel die Erweiterungen .jar oder .zip.
Installierte JAR- und ZIP-Dateien können komprimiert oder unkomprimiert sein. Aufgrund von Unterschieden in den Komprimierungsschemata wird empfohlen, JAR-Dateien, die Textressourcen enthalten, mit deaktivierter Komprimierung zu erstellen.

Wenn die JAR-Klausel angegeben ist, wird die JAR-Datei als JAR-Datei gespeichert, nachdem die darin enthaltenen Klassen installiert wurden. Diese JAR-Datei ist für alle diese Klassen die zugeordnete JAR-Datei. Die in einer Datenbank mit der JAR-Klausel installierten JAR-Dateien werden als gespeicherte JAR-Dateien der Datenbank bezeichnet.

Der jar-name ist ein Zeichenfolgenwert mit einer Länge von bis zu 255 Byte. Der jar-name wird verwendet, um die gespeicherte JAR-Datei in nachfolgenden Anweisungen (INSTALL JAVA UPDATE und REMOVE JAVA) zu identifizieren.
FROM FILE-Klausel Gibt den Speicherort der zu installierenden Java-Klasse oder JAR-Datei an.
Zu den für filename unterstützten Formaten gehören voll qualifizierte Dateinamen wie c:\\libs\\jarname.jar und /usr/u/libs/jarname.jar sowie relative Dateinamen (relativ zum aktuellen Arbeitsverzeichnis des Datenbankservers). Wenn der CLASSPATH des Datenbankservers den Pfad zu der betreffenden Klasse oder JAR-Datei enthält, muss der Pfad nicht in den Dateinamen einbezogen werden.

Der filename muss eine Klasse, eine JAR-Datei oder eine ZIP-Datei identifizieren.
FROM-Klausel Ausdrücke müssen in einen Binärtyp ausgewertet werden, dessen Wert eine gültige Klasse oder JAR-Datei enthält.
AS USER-Klausel Gibt den Eigentümer des Objekts an.

Die Klassendefinition für jede Klasse wird von der VM jeder Verbindung geladen, wenn diese Klasse zum ersten Mal benutzt wird. Wenn Sie eine Klasse installieren, wird die VM auf Ihrer Verbindung implizit neu gestartet. Deshalb haben Sie sofort Zugriff auf die neue Klasse. Da die VM neu gestartet wird, gehen alle Werte in statischen Java-Variablen verloren und SQL-Variablen mit Java-Klassentypen werden gelöscht.

Für andere Verbindungen wird die neue Klasse das nächste Mal geladen, wenn eine VM zum ersten Mal auf die Klasse zugreift. Wenn die Klasse bereits von einer VM geladen wurde, erkennt die Verbindung die neue Klasse erst, wenn die VM für diese Verbindung neu gestartet wird.

Alle installierten Klassen können auf jede Art von jedem Benutzer referenziert werden.

Diese Anweisung wird unter Windows Mobile nicht unterstützt.

Sie müssen das MANAGE ANY EXTERNAL OBJECT-Systemprivileg haben.

SQL/2008 Erweiterung des Herstellers.

In diesem Beispiel wird eine fiktive Java-Klasse namens Demo installiert, indem Dateiname und Speicherort der Klasse angegeben werden.

INSTALL JAVA NEW
FROM FILE 'D:\\JavaClass\\Demo.class';

In diesem Beispiel werden alle in einer fiktiven ZIP-Datei enthaltenen Klassen installiert und innerhalb der Datenbank dem JAR-Dateinamen "Widgets" zugeordnet. Nach der Installation wird der Speicherort der ZIP-Datei nicht gespeichert und Klassen müssen mit dem voll qualifizierten Klassennamen (Paket- und Klassenname) referenziert werden.

INSTALL JAVA
JAR 'Widgets'
FROM FILE 'C:\\Jars\\Widget.zip';

INSTALL JAVA-Anweisung

Syntax

Parameter

Bemerkungen

Privilegien

Siehe auch

Standards und Kompatibilität

Beispiel