Bearbeiten von „Einbinden von Java-Applets in HTML-Dateien“

Damit ein Webbrowser Java-Applets zur Anzeige bringen und ausführen kann, gibt es derzeit zwei verschiedene HTML-Tags.

 Tipp: Mehr über [[Java Applets starten - ab Java 7 Update 51]]

=<span style="color:green;">Multi Browser Einbindung mit HTML 5 (Stand April 2014)</span>=
Aktuell (April 2014) gibt es ein kleines Durcheinander bei der Einbindung von Java Applets in Browsern. Die eine Partei (z.B. IE11 + Chrome) möchte gern ein <b><applet></b> Tag, die andere (z.B. Firefox und Opera) ein <b><object></b> Tag.<br>
Dieses Problem kann man mit Javascript und einer Browserweiche lösen.<br>
Es gibt aber auch eine statische Lösung in reinem HTML 5 die für den Aufruf eines signierten Applets wie folgt aussieht:
<pre><object classid="java:meinjava.class" codebase="../java" archive="meinjava.jar"
  codetype="application/x-java-applet" width="100" height="100">
    <param name="code" value="meinjava.class">
    <param name="permissions" value="all-permissions">
    <comment>
        <applet code="meinjava.class" codebase="../java" archive="meinjava.jar"
          type="application/x-java-applet;version=1.6"
          pluginspage="http://www.java.com/de/" width="100" height="100">
            <param name="code" value="meinjava.class">
            <param name="permissions" value="all-permissions">
        </applet>
    </comment>
</object></pre>
Dieser Code ist innerhalb von <b><body></b> zu verwenden, nicht innerhalb von <b><head></b> und der passende Doctype ist <b><!DOCTYPE HTML></b>.<br>
Und zwar verhält es sich so, dass die eine Partei (z.B. IE11 + Chrome) das <b><object></b> ignoriert und das <b><applet></b> ausführt. Die andere Parten ignoriert hingegen alles innerhalb von <b><comment></b> und führt das <b><object></b> Tag aus.

Zu den Parametern:<br>
<b>meinjava.jar</b> ist das signierte Java Applet<br>
<b>meinjava.class</b> ist das im JAR befindliche Java Programm<br>
<b>codebase="..."</b> wird angegeben, wenn sich das JAR nicht im Public Root Verzeichnis befindet sondern in einem Unterordner<br>
<b><param name="permissions" value="all-permissions"></b> muss in der value exakt mit der Angabe in der manifest.mf Datei im JAR übereinstimmen!<br>
<b>version=1.6</b> innerhalb des type Attributs bedeutet, dass das Applet ausgeführt wird, wenn lokal mindestens die angegebene JRE Version oder eine neuere installiert ist, wenn nicht soll der User zu der Seite geleitet werden, die im Parameter <b>pluginspage</b> angegeben ist<br>
Weitere Parameter über das <b><param></b> Tag können bei Bedarf ergänzt werden, sie müssen jeweils doppelt ergänzt werden, und zwar einmal oben für den <b><object></b> Abschnitt und einmal in der Mitte für den <applet> Abschnitt.<br>
<br>
Es gibt zu dem Thema diverse Seiten in den Oracle Docs aber in keiner sind alle Informationen richtig im Sinne des Verhaltens der aktuellen Browser. Auf jeder Seite ist ein bisschen richtig/aktuell und das Endergebnis ist hier zusammengetragen. Insbesondere die Angaben zum Thema <b><object></b> bzw. <b><embed></b> und Internet Explorer kann man komplett vergessen. Der IE zeigt bei <b><embed></b> lediglich Fehlermeldungen in der Konsole, führt aber garnichts aus. Aus diesem Grund werden hier nicht alle möglichen Oracle Docs verlinkt.<br>
Wer dennoch gern dort lesen möchte findet den Einstieg hier: [http://www.oracle.com/technetwork/java/javase/documentation/index.html Java SE Documentation]

=<span style="color:green;">Das Object-Tag</span>=
Das Object-Tag zur Einbindung von Multimedia-Elementen in Webseiten wurde mit HTML 4.0 bzw. XHTML 1.0 in den Standard übernommen und löst nun das Applet-Tag ab. '''Das Applet-Tag gilt als veraltet und sollte nicht mehr verwendet werden.'''
==Einbinden einer Applet-Klasse==
Um ein Applet mit dem Object-Tag in eine Webseite einzubinden, werden folgende Zeilen notiert:
<pre>
<object classid="java:MeinApplet.class" 
    codetype="application/x-java-applet" width="800" height="600">
</object>
</pre>

===Applets in Packages===
Normalerweise werden Java-Klassen in Packages zusammen gefasst. Bei der Erzeugung des Applet-Tags gibts dann einige Dinge zu beachten. So muss nun auch der Name des Packages in das ''code''-Attribut.

Beispiel:
<pre><object classid="java:applets.MyApplet.class"
   codetype="application/x-java-applet" width="400" height="300">
</object></pre>
Das Applet deklariert ein hier ein Package ''applets'', also muss die class-Datei im Verzeichnis ''applets'' liegen.
Die HTML-Datei muss oberhalb von ''applets'', d.h. eine Verzeichnisebene über ''applets'' liegen.

==Einbinden eines Applets aus einer Jar-Datei==
Applets können auch in einer '''Jar-Datei zusammengefasst und komprimiert''' werden, was einerseits die Übertragung verkürzt, andererseits bspw. zum [http://wiki.byte-welt.net/wiki/Applets_und_WebStart-Anwendungen_signieren Signieren von Applets] erforderlich ist.
<pre>
<object archive="MeinJar.jar" classid="java:MeinApplet.class" 
    codetype="application/x-java-applet" width="800" height="600">
</object>
</pre>

===Einbinden mehrerer Jar-Dateien===
Manchmal benötigt man externe Bibliotheken, bspw. XML-Bibliotheken oder [[LookAndFeel]]'s, die in einer Jar-Datei ausgeliefert werden.<br>
'''Mehrere Jar-Dateien werden im archive-Attribut mit Kommata getrennt aufgelistet.'''
<pre>
<object archive="MeinJar.jar, ExterneJar.jar" classid="java:MeinApplet.class" 
    codetype="application/x-java-applet" width="800" height="600">
</object>
</pre>

==Einbinden eines Applets aus einem anderen Verzeichnis==
'''Beispiel 1'''

Wenn das Applet nicht auf dem gleichen Rechner oder in einem anderen Verzeichnis (unabhängig von deklarierten Packages) wie die einbettende HTML-Datei liegt, kommt das ''codebase''-Attibut ins Spiel.
In diesem Beispiel liegt die Jar-Datei in einem Verzeichnis namens ''applets'' - über dem Verzeichnis, in dem sich die einbettende HTML-Datei befindet.
<pre>
<object codebase="../applets" archive="MeinJar.jar" classid="java:MeinApplet.class" 
    codetype="application/x-java-applet" width="800" height="600">
</object>
</pre>


'''Beispiel 2'''
<pre><object codebase="./applets" archive="MyAppletLib.jar" classid="java:applets.MyApplet.class" 
     codetype="application/x-java-applet" width="400" height="300">
</object></pre>
In diesem Beispiel befindet sich das Applet und alle noch benötigten Dateien und Klassen in einem Jar-Archiv namens ''MyAppletLib.jar''. Das Jar-Archiv ist in dem im ''codebase''-Attribut angebenen Verzeichnis relativ zur HTML-Datei gespeichert (Eine Verzeichnisebene tiefer, im Verzeichnis ''applets''). Würde bspw. das ''codebase''-Attribut fehlen, müsste die Jar-Datei im Verzeichnis der HTML-Datei gespeichert sein.
Im Jar-Archiv existiert im Wurzelverzeichnis ein Package namens ''applets'' in welchem das Applet liegt.

==Einbinden eines Applets von einem anderen Server==
In diesem Beispiel liegt die Jar-Datei auf einem anderen [[Webserver]] in einem Verzeichnis namens ''applets''.

Der Browser wird hier angewiesen, das Applet von der im ''codebase''-Attribut angegebenen URL zu laden. Das Applet leigt in diesem Beispiel in einem Verzeichnis ''examples'' auf einem anderen Webserver. Auch hier liegt das Applet wieder in einem Package ''applets'', welches sich innerhalb des Verzeichnisses ''examples'' befindet.
<pre>
<object codebase="http://www.meine-domain.de/examples" archive="MeinJar.jar" classid="java:applets.MeinApplet.class" 
    codetype="application/x-java-applet" width="800" height="600">
</object>
</pre>

==Zusätzliche Attribute==
===param===
Applets sind keineswegs starre Konstrukte. Es können von außen durch Parameter Werte eingeschleust werden, die entweder statisch festgelegt oder dynamisch, bspw. mit PHP generiert wurden.

<pre>
<object classid="java:MeinApplet.class" 
    codetype="application/x-java-applet" width="400" height="300">
    <param name="bild1" value="duke.gif" />
</object>
</pre>

===Permission (seit Java 7 Update 51)===
Oracle selbst benutzt in seinen Dokumentationen immer noch das Applet-Tag! Aber im Object-Tag sollte der neue Pflichtparameter auch funktionieren.<br>
Seit Version 7 Update 51 der JRE ist im Applet-Tag ein ganz bestimmter Parameter Pflicht, der mit den Einstellungen des Manifests (Applets müssen nun immer signiert sein) übereinstimmen muss. Anderenfalls wird das Applet blockiert.
<pre>
<applet code="MeinApplet.class" width="800" height="600">
<param name="permissions" value="sandbox" />
</applet>
</pre>
Zwei Werte kommen für Permission zur Auswahl:
*'''sandbox''' - zur Kennzeichnung, dass das Applet keine weiteren Rechte auf dem Client benötigt
*'''all-permissions''' - zur Kennzeichnung, dass das Applet volle Rechte auf dem Client benötigt

Zusätzlich müssen Applets nun signiert werden. Im Manifest der Jar-Datei muss der gleiche Wert für permission eingetragen werden, sonst wird das Applet blockiert, bzw. nicht gestartet.<br>

 '''Hinweis: Hilfestellungen zum Signieren gibts im Artikel [[Java-Applets und Java WebStart-Anwendungen signieren]]'''

=Einbinden per Javascript=
Das von Oracle bereit gestellte [http://docs.oracle.com/javase/tutorial/deployment/deploymentInDepth/depltoolkit_index.html Deployment Toolkit] erleichtert dem Entwickler das Einbinden von Applets.
Es macht ihn unabhängig von Browser spezifischen oder Betriebssystem abhängigen Eigenheiten. Seit Java 1.6 Update 10 ist das Toolkit standardmäßig mit an Bord.
<code=php>
<script src="http://www.java.com/js/deployJava.js"></script>
<script>
   var attributes = {code:'applets.MyApplet.class', width: 400, height: 300};
   var parameters = {jnlp_href: 'myapplet_demo.jnlp'};
   deployJava.runApplet(attributes, parameters, '1.6');
</script>
</code=php>
Zum Start von Webstart- oder JavaFX-Anwendungen kann die JNLP-Datei und die benötigte JRE-Version bekannt gemacht werden. In unserem Beispiel wird die JRE 1.6 vorausgesetzt.
Außerdem können über die JNLP-Datei zusätzliche Einstellungen für Berechtigungen vorgenommen werden.

=<span style="color:red;">Das Applet-Tag</span>=
Bis zur Verabschiedung des HTML 4.0-Standards, war das Applet-Tag zum Einbinden von Java-Applets in Webseiten vorgesehen.
'''Inzwischen gilt es als veraltet und wurde vom W3C mit dem Object-Tag ersetzt. In HTML5 funktioniert es gar nicht mehr.'''
==Einbinden einer Applet-Klasse==
<pre>
<applet code="MeinApplet.class" width="800" height="600">
</applet>
</pre>

==Einbinden eines Applets aus einer Jar-Datei==
<pre>
<applet archive="MeinJar.jar" code="MeinApplet.class" width="800" height="600">
</applet>
</pre>

===Einbinden mehrerer Jar-Dateien===
<pre>
<applet archive="MeinJar.jar,ExternesJar.jar" code="MeinApplet.class" width="800" height="600">
</applet>
</pre>

==Einbinden eines Applets aus einem anderen Verzeichnis==
In diesem Beispiel liegt die Jar-Datei in einem Verzeichnis namens '''applets''' - über dem Verzeichnis, in dem sich die einbettende HTML-Datei befindet.
<pre>
<applet codebase="../applets" archive="MeinJar.jar" code="MeinApplet.class" width="800" height="600">
</applet>
</pre>

==Einbinden eines Applets von einem anderen Server==
In diesem Beispiel liegt die Jar-Datei auf einem anderen [[Webserver]] in einem Verzeichnis namens '''applets'''.
<pre>
<applet codebase="http://www.meine-domain.de/applets" archive="MeinJar.jar" code="MeinApplet.class" width="800" height="600">
</applet>
</pre>

==Zusätzliche Attribute==
===param===
Mit dem Parameter-Attribut können in der Webseite beliebige Werte von außen ins Applet eingeschleust und verarbeitet werden.
<pre>
<applet code="MeinApplet.class" width="800" height="600">
<param name="bild1" value="duke.gif">
</applet>
</pre>

===Permission (seit Java 7 Update 51)===
Oracle selbst benutzt in seinen Dokumentationen immer noch das Applet-Tag! Seit Version 7 Update 51 der [[JRE]] ist im Applet-Tag ein ganz bestimmter Parameter Pflicht, der mit den Einstellungen des Manifests (Applets müssen nun immer signiert sein) übereinstimmen muss. Anderenfalls wird das Applet blockiert.
<pre>
<applet code="MeinApplet.class" width="800" height="600">
<param name="permissions" value="sandbox" />
</applet>
</pre>
Zwei Werte kommen für Permission zur Auswahl:
*'''sandbox''' - zur Kennzeichnung, dass das Applet keine weiteren Rechte auf dem Client benötigt
*'''all-permissions''' - zur Kennzeichnung, dass das Applet volle Rechte auf dem Client benötigt

=Weiterführende Links=
*http://www.heise.de/developer/artikel/Java-foerdert-nun-signierte-Applets-1840305.html
*[[Java-Applets und Java WebStart-Anwendungen signieren‎]]

[[Kategorie:Java]]
[[Kategorie:Tutorials_(Java)]]
[[Kategorie:HTML]]