Byte-Welt Wiki - Benutzerbeiträge [de]

Einbinden von Java-Applets in HTML-Dateien

2014-04-28T06:53:31Z

Fischauge: /* Einbinden eines Applets aus einem anderen Verzeichnis */ erweitert

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]]

=Das Object-Tag=
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. 
'''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>

ACHTUNG: Wenn die HTML Seite von einem Script (beispielsweise aus dem Verzeichnis /cgi-bin heraus) an den Browser gesendet wird, hat sich nur die folgende Syntax als lauffähig in allen aktuellen Versionen des Internet Explorer, Firefox, Chrome und Opera herausgestellt:
<pre><object type="application/x-java-applet" codebase="../java" width="800" height="600">
<param name="code" value="MyApplet.class">
<param name="archive" value="../java/MyApplet.jar">
</object></pre>
In diesem Beispiel liegt das Applet im Verzeichnis /java und das Script mit dem die HTML Seite ausgegeben wird im Verzeichnis /cgi-bin 
Das Wesentliche daran ist, dass der Pfad zur JAR Datei auf jeden Fall im archive Parameter mit angegeben werden muss. Das codebase Attribut ist in diesem Fall nicht zwingend notwendig. 
(Stand: 28.04.2014)

'''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. 
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. 

'''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.

=Das Applet-Tag=
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

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. 

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

=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]]

Einbinden von Java-Applets in HTML-Dateien

2014-04-28T06:42:04Z

Fischauge: Punkt 1 Multibrowser Einbindung wieder entfernt, es geht einfacher.

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]]

=Das Object-Tag=
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. 
'''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. 
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. 

'''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.

=Das Applet-Tag=
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

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. 

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

=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]]

Einbinden von Java-Applets in HTML-Dateien

2014-04-26T16:43:33Z

Fischauge: /* Multi Browser Einbindung mit HTML 5 (Stand April 2014) */

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]]

=Multi Browser Einbindung mit HTML 5 (Stand April 2014)=
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 <applet> Tag, die andere (z.B. Firefox und Opera) ein <object> Tag. 
Dieses Problem kann man mit Javascript und einer Browserweiche lösen. 
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 <body> zu verwenden, nicht innerhalb von <head> und der passende Doctype ist <!DOCTYPE HTML>. 
Und zwar verhält es sich so, dass die eine Partei (z.B. IE11 + Chrome) das <object> ignoriert und das <applet> ausführt. Die andere Parten ignoriert hingegen alles innerhalb von <comment> und führt das <object> Tag aus.

Zu den Parametern: 
meinjava.jar ist das signierte Java Applet 
meinjava.class ist das im JAR befindliche Java Programm 
codebase="..." wird angegeben, wenn sich das JAR nicht im Public Root Verzeichnis befindet sondern in einem Unterordner 
<param name="permissions" value="all-permissions"> muss in der value exakt mit der Angabe in der manifest.mf Datei im JAR übereinstimmen! 
version=1.6 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 pluginspage angegeben ist 
Weitere Parameter über das <param> Tag können bei Bedarf ergänzt werden, sie müssen jeweils doppelt ergänzt werden, und zwar einmal oben für den <object> Abschnitt und einmal in der Mitte für den <applet> Abschnitt. 
 
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 <object> bzw. <embed> und Internet Explorer kann man komplett vergessen. Der IE zeigt bei <embed> lediglich Fehlermeldungen in der Konsole, führt aber garnichts aus. Aus diesem Grund werden hier nicht alle möglichen Oracle Docs verlinkt. 
Wer dennoch gern dort lesen möchte findet den Einstieg hier: [http://www.oracle.com/technetwork/java/javase/documentation/index.html Java SE Documentation]

=Das Object-Tag=
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. 
'''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. 
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. 

'''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.

=Das Applet-Tag=
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]]

Einbinden von Java-Applets in HTML-Dateien

2014-04-26T16:39:34Z

Fischauge: Abschnitt Multi Browser Einbindung mit HTML 5 (Stand April 2014) ergänzt, spätere Aufteilung in 1.1 HTML und 1.2 Javascript vorgesehen..

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]]

=Multi Browser Einbindung mit HTML 5 (Stand April 2014)=
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 <applet> Tag, die andere (z.B. Firefox und Opera) ein <object> Tag. 
Dieses Problem kann man mit Javascript und eine Browserweiche lösen. 
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 <body> zu verwenden, nicht innerhalb von <head> und der passende Doctype ist <!DOCTYPE HTML>. 
Und zwar verhält es sich so, dass die eine Partei (z.B. IE11 + Chrome) das <object> ignoriert und das <applet> ausführt. Die andere Parten ignoriert hingegen alles innerhalb von <comment> und führt das <object> Tag aus.

Zu den Parametern: 
meinjava.jar ist das signierte Java Applet 
meinjava.class ist das im JAR befindliche Java Programm 
codebase="..." wird angegeben, wenn sich das JAR nicht im Public Root Verzeichnis befindet sondern in einem Unterordner 
<param name="permissions" value="all-permissions"> muss in der value exakt mit der Angabe in der manifest.mf Datei im JAR übereinstimmen! 
version=1.6 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 pluginspage angegeben ist 
Weitere Parameter über das <param> Tag können bei Bedarf ergänzt werden, sie müssen jeweils doppelt ergänzt werden, und zwar einmal oben für den <object> Abschnitt und einmal in der Mitte für den <applet> Abschnitt. 
 
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 <object> bzw. <embed> und Internet Explorer kann man komplett vergessen. Der IE zeigt bei <embed> lediglich Fehlermeldungen in der Konsole, führt aber garnichts aus. Aus diesem Grund werden hier nicht alle möglichen Oracle Docs verlinkt. 
Wer dennoch gern dort lesen möchte findet den Einstieg hier: [http://www.oracle.com/technetwork/java/javase/documentation/index.html Java SE Documentation]

=Das Object-Tag=
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. 
'''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. 
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. 

'''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.

=Das Applet-Tag=
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]]

Java-Applets und Java WebStart-Anwendungen signieren

2014-04-24T08:41:52Z

Fischauge: /* Anwendung signieren */

=Anwendung signieren=
{{In Arbeit}}
'''Java-Applets haben seit Java 7 Update 51 keine Rechte mehr auf dem Gastsystem! Es muss mindestens eine Anpassung der Sicherheitseinstellungen im Java Control Panel erfolgen.''' 
Der Artikel [[Java Applets starten - ab Java 7 Update 51]] befasst sich eingehender mit der Inbetriebnahme von Java-Applets.

Unsignierte Applets haben außerdem keinen Zugriff auf die lokale Datei- und Verzeichnisebene des [[Client]]s und dürfen sich nur zu dem Rechner verbinden, von dem sie auch heruntergeladen wurden.
Für Applikationen erlaubte Dinge, wie Ports öffnen, sensible oder persönliche Daten aus dem [[Client]]-PC auslesen oder die VM beenden, sind einem unsignierten Applet ebenfalls untersagt.

Ein nicht signiertes Applet wird daher bei einem unerlaubten Zugriff immer eine [http://www.google.de/search?btnI&q=site:docs.oracle.com/javase/7/docs/api/%20inurl:AccessControlException java.security.AccessControlException] werfen.

'''Hinweis: Signierte Applets können jedoch erweiterte Rechte auf dem Client erhalten.'''

==Möglichkeiten der Signierung==
Es gibt zwei Möglichkeiten eine Java-Anwendung zu signieren:
# Die kostenpflichtige Ausstellung eines [[Zertifikat]]s von einem darauf spezialisierten Unternehmen, wie z.B. VeriSign (ehem. Thawte). So ein Zertifikat kann mehrere 100 Dollar kosten.
# Die Signierung des Programms durch den Programmierer selbst.
Dabei wird mit den Tools des JDK/SDK ein Zertifikat erzeugt. Auch die Erzeugung eines Zertifikats mittels OpenSSL ist denkbar.

'''In beiden Fällen öffnet sich vor dem Start der Anwendung ein Fenster mit einem Sicherheitshinweis, welches sich vom Benutzer die Erlaubnis einholt, eventuell potenziell unsichere/gefährliche Operationen auf seinem System durchführen zu dürfen.''' 
Der Benutzer selbst muss entscheiden, ob er dem Applet vertrauen möchte, oder nicht.

'''Hinweis: Die Informationsdialoge sind in keinem Fall modifizierbar oder unterdrückbar.'''

'''Hinweis: Wenn die Anwendung mit einem selbst erzeugten Zertifikat signiert wurde, wird der Hersteller immer als 'UNKNOWN' ausgewiesen.'''

{{In Arbeit}}
Hier kannst du auch ein signiertes Applet testen. Es wird einige System-Informationen aus deinem System lesen und anzeigen, wenn du den Zugriff gestattest.
Zugriffe, die erweiterte Rechte benötigen sind im Applet pink dargestellt. (Link wird nachgereicht!)

'''Häufig ist zu beobachten, dass Programmierer in ihren Applets Bilder mit den verkehrten Methoden einbinden. Dazu mehr unter [[Grafikdateien laden und anzeigen]].

'''Hinweis: Zum Signieren eines Java-Applets muss dieses in einer Jar-Datei gespeichert sein.'''

==SignTool für Windows==
Folgende kleine Batchdatei, kann das komfortable '''Erstellen einer Jar-Datei und anschließende Signieren''' eines Applets vereinfachen.
Einfach die blauen Texte der Datei mit Hilfe eines Texteditors modifizieren, unter einem Namen wie bspw. SignTool.bat in deinem Projektverzeichnis speichern und per Doppelklick ausführen.

'''Hinweis: Die Batchdatei darf auf keinen Fall den Namen eines der Tools aus dem JDK erhalten!'''

@echo off
rem * SignTool by L-ectron-X ( byte-welt.net )
rem **************************************************************************
rem * Ablauf beim Signieren
rem *
rem * Erzeugen eines eigenen Schlüssels und Zertifikats
rem * Mit KeyTool, einem Werkzeug aus dem SDK, einen neuen Schlüssel erzeugen:
rem * keytool -genkeypair -selfcert -alias Signer -dname "cn=Dein Name, c=de"
rem * Gib anschließend Dein Passwort ein.
rem *
rem * keytool unterstützt weitere Angaben:
rem * CN=commonName
rem * OU=organizationUnit
rem * O=organizationName
rem * L=localityName
rem * S=stateName
rem * C=country
rem *
rem * Mehr über keytool: http://docs.oracle.com/javase/6/docs/technotes/tools/solaris/keytool.html
rem *
rem * Signieren des Applets mit Hilfe des Tools jarsigner
rem * jarsigner signed.jar Signer
rem * Und noch einmal dein Passwort eingeben.
rem ***************************************************************************
echo = SignTool =
echo Dieses Tool hilft beim Erzeugen von signierten jar-Dateien
echo.
echo Schritt 1: jar-Dateien erzeugen
echo ------------------------------- 
rem Pfad zum SDK setzen
rem --> optional, (auskommentieren, wenn eine Umgebungsvariable gesetzt wurde)
set java_home=.;C:\Programme\Java\jdk1.8.0\bin
set path=.;%path%;%java_home% 
echo Manifestdatei erzeugen...
echo Manifest-Version: 1.0>manifest.mf
echo Created-by: SignTool by L-ectron-X - byte-welt.net>>manifest.mf 
rem --> Anpassen, wenn eine Applikation statt eines Applets signiert werden soll!
rem * Applikationen brauchen die Main-Class-Definition im Manifest. Dann ist das rem zu entfernen.
rem echo Main-Class: package.MainClass>>manifest.mf 
rem --> Anpassen, wenn das Applet bzw. die Applikation Resourcen weiterer Jar-Dateien benutzt!
rem echo Class-Path: ./lib/External.jar>>manifest.mf 
rem --> Anpassen, wenn eine Applikation erweiterte Rechte auf dem Client benoetigt.
rem --> Wenn das Permission-Attribut nicht angegeben wird, wird die Anwendung blockiert!
rem * Es wird zwischen den Werten sandbox und all-permissions unterschieden.
rem * Mehr dazu unter http://docs.oracle.com/javase/8/docs/technotes/guides/jweb/security/manifest.html#permissions
echo Permissions: sandbox>>manifest.mf 
rem --> Anpassen, wenn verhindert werden soll, dass die Anwendung auf einer anderen Domain 're-deployed' wird.
rem * Die Domain muss mit dem Speicherort der Anwendung übereinstimmen, sonst wird die Anwendung blockiert.
rem * Mehr dazu unter http://docs.oracle.com/javase/8/docs/technotes/guides/jweb/security/manifest.html#codebase
rem echo Codebase: http://byte-welt.net>>manifest.mf 
rem --> Anpassen, es wird empfohlen, den Namen der Anwendung anzugeben.
rem * Es soll dem Benutzer die Entscheidung erleichtern, der Anwendung zu vertrauen.
rem * Mehr dazu unter http://docs.oracle.com/javase/8/docs/technotes/guides/jweb/security/manifest.html#app_name
rem echo Application-Name: Hallo Welt!>>manifest.mf 
rem * Leerzeile nicht vergessen!
echo.>>manifest.mf 
if exist *.jar goto key
echo jar-Datei mit angegebenen Parametern erzeugen...
rem --> anpassen!
rem * In folgendem Beispiel werden alle '''.class-Dateien''' mit Package ('''de.domain.applets''') und die Verzeichnisse '''bilder''' und '''etc'''
rem * mit ins jar-Archiv gepackt.
jar cfmv MeinJar.jar manifest.mf de/domain/applets/*.class bilder etc 
:key
echo.
echo Schritt 2: Schluessel und Zertifikat generieren
echo -----------------------------------------------
rem --> anpassen!
rem -validity 18250 (365 Tage x 50) erzeugt ein 50 Jahre gültiges Zertifikat
keytool -genkeypair -selfcert -validity 3650 -alias Signer -dname "cn=Dein Name, c=de" 
if not exist *.jar goto error 
echo.
echo Schritt 3: jar-Datei signieren
echo ------------------------------
echo jarsigner erwartet hier nochmals dein Passwort.
rem --> anpassen!
jarsigner MeinJar.jar Signer 
echo.
echo Schritt 4: Zertifikat testen
echo ----------------------------
rem --> anpassen!
jarsigner -verify -verbose -certs MeinJar.jar
goto end 
:error
echo.
echo Es wurde keine jar-Datei zum Signieren gefunden.
echo Die Erzeugung der jar-Datei ist moeglicherweise fehlgeschlagen.
echo Pruefe deine Modifikationen in der SignTool-Batchdatei! 
:end
if not exist manifest.mf goto console
echo.
rem Manifest von Festplatte löschen
del manifest.mf 
:console
rem Console für Ausgaben noch geöffnet lassen
echo.
pause

In deinem Projekt-Verzeichnis sollte vorzugsweise noch keine jar-Datei angelegt sein, das Tool wird dann auch eine korrekte jar-Datei aus deinen .class-Dateien erzeugen können.
Auch wenn Du eine jar-Datei schon erzeugt hast und nur die Signierung mit Hilfe dieser Batchdatei durchführen möchtest, genügt die Modifikation der Batchdatei an den ausgewiesenen Stellen.
Wenn du bisher noch keine Signierung gemacht hast, wirst du im Verlauf des Batchdatei-Ablaufes nach einem Passwort gefragt, welches du selbst wählen kannst. Merke es dir gut. Wenn du es vergisst, kannst du so lange keine weiteren Applets signieren, bis du die .keystore-Datei aus deinem Benutzer-Verzeichnis gelöscht hast.

'''Damit das nun in einer Jar-Datei verpackte und signierte Applet auch ausgeführt werden kann, muss die HTML-Datei angepasst werden:''' 
[[Einbinden von Applets in HTML-Dateien]]

'''Für Webstart-Anwendungen''' müsste noch die JNLP-Datei angepasst werden, damit sie mit Annahme des Zertifikats (Vertrauenserklärung) alle Rechte des Benutzers auf seinem Rechner erhält: 
<code=xml>
<security>
<all-permissions/>
</security>
</code=xml>

Weitere Infos: [http://download.oracle.com/javase/6/docs/technotes/guides/jar/jarGuide.html JAR File Overview]

==Fehlermeldungen==
*Der Interpreter meldet, dass in einer signierten Jar-Datei ein unsignierter Eintrag gefunden wurde:
com.sun.deploy.net.JARSigningException: Unsignierter Eintrag in Ressource: <Jar file>
Wenn es Dateinamen mit Umlauten in der Jar-Datei gibt, kann es passieren, dass diese nicht signiert werden (können). 
Also sollten diese umbenannt, die referenzierenden Dateien aktualisiert und die Jar-Datei erneut signiert werden. Unter Umständen wird es notwendig, die .ds- und .dsa-Dateien aus dem META-INF-Verzeichnis der Jar-Datei zu löschen, damit beim erneuten Signieren saubere Schlüsseldateien erzeugt werden könnnen.

=Die Alternative=
Wer nicht signieren möchte, kann das Problem auch mit der JNLP-API angehen.
Hier ein Beispiel, wie man ohne Signieren vom Client lesen und auch auf ihn schreiben kann: 
*[http://docs.oracle.com/javase/tutorial/deployment/doingMoreWithRIA/usingJNLPAPI.html Oracle - Accessing the Client Using JNLP API]

=Weiterführende Links=
*[http://java.sun.com/docs/books/tutorial/deployment/jar/intro.html Understanding Signing and Verification (The Java™ Tutorials > Deployment > Packaging Programs in JAR Files)]
*[http://download.oracle.com/javase/1.3/docs/tooldocs/win32/keytool.html keytool-Key and Certificate Management Tool]
*[http://download.oracle.com/javase/6/docs/technotes/tools/windows/jarsigner.html jarsigner-JAR Signing and Verification Tool]
*[http://docs.oracle.com/javase/tutorial/deployment/doingMoreWithRIA/usingJNLPAPI.html Accessing the Client Using JNLP API (The Java™ Tutorials > Deployment > Doing More With Java Rich Internet Applications)]
*[http://docs.oracle.com/javase/1.4.2/docs/guide/jws/developersguide/syntax.html JNLP File Syntax]

[[Kategorie:Java]]
[[Kategorie:Java Verschiedenes]]
[[Kategorie:Tutorials (Java)]]
--[[Benutzer:L-ectron-X | L-ectron-X]] (15.05.2005, 18:58)