Help

Einleitung

Nicht jedermann wird als Webmaster geboren und Java oder JavaScript ist nicht in 5 Minuten erlernbar, selbst der Einbau von vorgefertigten Modulen stellt manchen Neuling, der mit der Syntax nicht vertraut ist, vor beinahe unlösbare Probleme.
Hier bei Nightfire versuchen wir, nicht nur die besten Applets und Scripte anzubieten, sondern den Usern auch beim Einbau in ihre eigene Website durch eine möglichst detaillierte Beschreibung der Applets und Scripte zur Seite zu stehen.
Auf dieser Seite erfahren Sie Basisinformationen über JavaApplets, wie Sie die Applets oder Scripte downloaden und entpacken und schliesslich in Ihre Website einbauen können.

Querverweise

Zur Beantwortung spezifischer Fragen konsultieren Sie bitte die FAQ.
Sollten Sie auch dort keine Antwort auf Ihre Frage finden, können Sie sie in unserem Forum platzieren.

Inhalt

Wie gehe ich mit ZIP- Dateien um?

Wie binde ich ein Applet in meine Webseite ein?

Wie binde ich ein JavaScript in meine Webseite ein?

TroubleShooting

Wie gehe ich mit ZIP- Dateien um?

Bei ZIP- Dateien handelt es sich um Dateiarchive, in welchen mehrere Dateien in komprimierter Form zusammengefasst werden.
Um diese Dateien auszupacken, benötigen Sie eine spezielle Software wie Winzip (Shareware) oder PowerArchiver (Freeware).

Vorgehensweise:

- Öffnen Sie den Windows- Explorer
- Kopieren Sie die ZIP- Datei in ein leeres Verzeichnis Ihrer Wahl
- Rechtsklicken Sie auf die ZIP- Datei. Im sich öffnenden Kontextmenu wählen Sie 'Extract to' oder 'Extrahiere nach' (je nach verwendeter Software)
- Nachdem das Archiv ausgepackt wurde, liegen alle für das jeweilige Beispiel benötigten Dateien vor.
- Nun können Sie die Beispieldateien und Dokumentationen betrachten und daran gehen, die Beispiele in eigene Projekte zu integrieren.

Wie binde ich ein Java-Applet in meine Website ein?

Die Einbindung eines Java-Applets erfolgt über den HTML-Tag <APPLET>, gefolgt von einer Reihe von Parametern, die mit </APPLET> abgeschlossen werden, ähnlich dem nachstehenden Beispiel:

<applet code="Fade.class" width="300" height="50">
    <param name="bgcolor" value="000000">
    <param name="txtcolor" value="ffffff">
    ....

</applet>

Der Applet-Tag kann folgende Einträge enthalten:

code="xyz.class" Aufruf der Class-Datei, die den Programmcode in kompilierter Form enthält. Der Browser sucht die Klassendatei standardmässig im selben Verzeichnis, wo sich auch die aurufende HTML- Seite befindet.
codebase="<Pfad>" Befinden sich die Class-Dateien nicht im gleichen Verzeichnis wie die HTML-Seite, können sie über Angabe des Pfades angesprochen werden. Bsp: codebase= "/applets"
archive="xyz.jar" Wenn sich die Class-Dateien in einer Archivdatei, einer Art ZIP-File (mit Extension .jar gekennzeichnet) befinden, können sie hiermit aufgerufen werden. (siehe dazu auch hier)
width="Pixel/Prozent" Bestimmen der Anzeigebreite des Java-Applets, mit
height="Pixel/Prozent" die Höhe. Die Wirkungsweise ist die gleiche wie bei der Angabe von  Breite und Höhe eines Objekts.
align="Pixel" Hiermit können Sie ein Java-Applet beschriften oder Text um das Objekt fließen lassen. Mit align=top richten Sie einen nachfolgenden Text obenbündig zum Applet aus, mit align=middle mittig, und mit align=bottom untenbündig. Mit align=left können Sie nachfolgende Elemente rechts um das Java-Applet lassen, mit align=right richten Sie das Applet rechtsbündig aus und nachfolgende Elemente fließen links um das Applet. Diese Angaben haben die gleiche Wirkung wie die entsprechenden Angaben, die  Objekte beschriften bzw.  Text um Objekte fließen lassen.
hspace="Pixel" Bestimmen Sie den horizontalen Abstand des Java-Applets zu seiner Umgebung, mit
vspace="Pixel/Prozent" den vertikalen Abstand. Die Wirkungsweise ist die gleiche wie bei der Angabe von Abstand zwischen Objekt und Umgebung.
Parameter
<param name="..." value="..."> Param- Tags können in das Applet- Tag eingebunden werden, um zusätzliche Informationen an das Applet zu senden. Jedes Param- Tag hat einen Namen und einen Wert, und das Applet-Tag kann beliebig viele Parameter im Rumpf enthalten.

In unseren Beispielen sind jeweils fixfertige Codes enthalten, die Sie kopieren und in Ihre Projekte einbinden können. Danach können Sie die Parameter Ihren Bedürfnissen anpassen.

Reicht es, den Applet-Tag in die HTML-Seite einzubinden?

Nein! Der Applet-Tag stellt nur eine Referenz zu einer oder mehreren Class- oder JAR-Dateien, in denen der eigentliche Programmcode enthalten ist, dar.
Es ist deshalb wichtig, diese Dateien ebenfalls zu berücksichtigen. In den ZIP-Dateien, die Sie downloaden, sind alle Dateien enthalten, die zum jeweiligen Applet gehören. Diese Dateien müssen Sie in die angegebenen Verzeichnisse kopieren.

Wo müssen die Class-/Jar- Dateien abgespeichert werden?

Wie bereits weiter oben beschrieben, sucht der Browser die Class- und/oder Jar- Dateien standardmässig im gleichen Verzeichnis, wo sich auch die aufrufende HTML-Seite befindet.
Bei Verwendung des Attributs codebase müssen sich die Class- und/oder Jar- Dateien in dem im Attribut angegebenen Verzeichnis befinden.

Bitte beachten Sie auch, dass verschiedene Applets auf Bild-, Text- oder Musik- Dateien zugreifen. Diese Dateien müssen sich dort befinden, wo das Applet sie erwartet! Lesen Sie deshalb bitte immer die Beschreibungen zu den jeweiligen Applets.

Wie binde ich ein JavaScript in meine Webseite ein?

Ein JavaScript steht immer zwischen einem öffnenden <SCRIPT> und einem abschliessenden </SCRIPT> Tag. Um dem Browser eindeutig zu erkennen zu geben, um welche Art von Scriptsprache es sich handelt, enthält der Script- Tag zumeist den Zusatz language= "JavaScript".

Bsp.:

<SCRIPT LANGUAGE="JavaScript>

   .......

</SCRIPT>

JavaScripts können an verschiedenen Stellen innerhalb einer Webseite eingebaut werden. In den Beispielcodes verwenden wir deshalb folgende Konventionen:

zwischen <HEAD> und </HEAD>

Dieses Script muss in den Kopfbereich der HTML-Seite gesetzt werden.

Bsp.:

<HEAD>
<SCRIPT LANGUAGE="JavaScript>

   .......

</SCRIPT>

....

</HEAD>

zwischen <BODY> und </BODY>

Dieses Script muss in den Bodybereich der HTML-Seite gesetzt werden.

Bsp.:

<BODY>
<SCRIPT LANGUAGE="JavaScript>

   .......

</SCRIPT>

....

</BODY>

in den <BODY> Tag

Eine Besonderheit des Bodytags ist, dass hier nicht nur Schriftfarben und Hintergrundbilder definiert werden können, sondern auch Aktionen, die beim Laden, bzw. entladen der Webseite ausgeführt werden. Hierzu wird als Attribut ein sog. Eventhandler eingesetzt, dem als Wert die auszuführende Funktion mitgegeben wird.

Bsp.:

<BODY text="#FFFFFF" bgcolor="#000000" link="#FFFF00" vlink="#C0C0C0" onload="einefunktion();">

TroubleShooting

An dieser Stelle möchten wir ein paar Probleme und Fehler ansprechen, die die häufigste Ursache dafür sind, dass ein ein JavaApplet oder JavaScript nicht so funktioniert, wie es sollte.

Einbinden mit einem HTML-Editor
Das Angebot an HTML- Editoren ist mittlerweile ziemlich unübersichtlich geworden. Das Vorgehen beim Einbinden von externem Code wird von vielen Editoren unterschiedlich gehandhabt. Deshalb gehen wir darauf erst gar nicht ein und beschreiben hier die aus unserer Sicht einfachste und schnellste Methode.

Jede Windows- Maschine verfügt über DAS Tool schlechthin, Applets und Scripts schnell und problemlos einzubinden. Die Rede ist vom guten, alten Notepad.

1. Erstellen Sie Ihre HTML-Seite mit Ihrem bevorzugten Editor.
2. Speichern Sie die Seite ab.
3. Öffnen Sie die Seite mit Notepad.
4. Kopieren Sie den Code für das Script oder Applet in die Zwischenablage
5. Fügen Sie den Code an der Stelle in die Seite ein, wo sie das Script oder Applet hinhaben möchten.
6. Speichern Sie die Seite ab.

That's it!

Sie haben ein Applet wie oben beschrieben eingefügt, aber es funktioniert nicht.
1. Wahrscheinlich sehen Sie eine graue Fläche an der Stelle, wo das Applet prangen sollte.
2. Fahren Sie mit der Maus auf die graue Fläche. In der Statuszeile des Browsers wird nun eine Fehlermeldung angezeigt.
3. Die häufigst auftretende Fehlermeldung: Class xy not found!
Ursache: Die Class- Datei konnte nicht gefunden werden
Lösung 1: Prüfen Sie, ob die Classdatei vorhanden ist und sich im richtigen Verzeichnis befindet.
Lösung 2: Überprüfen Sie die Gross/Kleinschreibweise. Applets sind case-sensitiv und unterscheiden zwischen Gross- und Kleinschreibweise.
4. Zu Applets gehören oft Bild- Dateien. Prüfen Sie, ob alle Dateien sich in den angegebenen Verzeichnissen befinden.
5. Tritt die Fehlermeldung SecurityException auf, dann arbeiten Sie wahrscheinlich mit dem Internet Explorer und versuchen auf ein Verzeichnis zuzugreifen, das sich nicht auf derselben Verzeichnisebene wie die HTML-Seite befindet. Dieser Fehler tritt nur auf lokalen Rechnern auf und nicht online. Testen Sie die Funktion des Applets lokal mit Netscape.
6. Prüfen Sie auf alle Fälle die Vollständigkeit und Syntax des Codes. Oft sind einfache Schreibfehler oder das Fehlen von Codezeilen die Ursache der Probleme. Wir haben die Applets allesamt getestet und wie sie an den Beispielen online sehen können, funktionieren sie auch.

Sie haben ein JavaScript wie oben beschrieben eingefügt, aber es funktioniert nicht.
1. JavaScript reagiert sehr empfindlich auf falsch gesetzte Zeilenumbrüche. Diese treten gerne auf, wenn Sie den Code aus einer HTML-Seite herauskopieren. Kopieren Sie im Zweifelsfall den HTML-Code direkt aus dem Quelltext unserer Beispielseite. Wir haben keine Beschränkungen der rechten Maustaste in unsere Seiten eingebaut, nutzen Sie diese Gelegenheit. ;-)
2. Prüfen Sie, ob Sie den Code vollständig und an den richtigen Stellen eingesetzt haben.
3. Prüfen Sie, ob alle Bilddateien vorhanden und in den richtigen Verzeichnissen gespeichert sind.
4. Auch hier gilt: Wir haben die Scripts getestet und sie funktionieren ;-)

Natürlich möchten wir trotz aller Sorgfalt nicht ausschliessen, dass uns ein Fehler unterlaufen ist. Deshalb wenden Sie sich ungeniert an support@nightfire.ch oder helpdesk@nightfire.ch, wenn Sie nicht mehr weiterwissen. Wir werden Fehler umgehend beheben und Ihnen bei der Lösung zur Seite stehen.

JAR Dateien

In den JDK (Java Development Kit) Versionen vor 1.1 musste jede Resource einzeln heruntergeladen werden, wenn sich ein Applet aus mehreren Klassendateien zusammensetzte oder Grafiken und Audio- Dateien enthielt. Um dieses Problem aus dem Weg zu schaffen, führte SUN JAR- Dateien ein. Basierend auf dem ZIP- Format , ermöglicht es eine JAR- Datei, mehrere Resourcen in einer einzigen Archivdatei zusammenzufassen.

Eine JAR-Datei beinhaltet eine Manifest- Datei im Archiv. Diese Manifest- Datei mit dem Namen META- INF/MANIFEST.MF enthält Informationen über die Komponentendateien im Archiv. Darüber hinaus können im META- INF- Verzeichnis des Archivs digitale Signaturen abgelegt werden. Code, der durch einen zuverlässigen Anbieter signiert wurde, kann besondere Privilegien erhalten, etwa in Dateien zu schreiben.

Mitglied bei Linkstation
Mitglied bei Linkstation

Copyright © 1998- Nightfire Webworker Archiv