java.sun.com

   JAVA - Applets - Methoden

 Startseite
 Applets

 Indexverzeichnis

JAVA - Applets - Methoden

Hier sind alle Methoden aufgelistet, die in der Klasse java.applet.Applet enthalten sind.
Die wichtigsten Methoden
Übersicht der Methoden
  Seitenende


Die wichtigsten Methoden

Die Methoden init, start, stop und destroy sind für den Programmierer anfangs die wichtigsten, da sie den Ablauf des Applets steuern.

public void init() Die Methode public void init() wird beim Applet zuerst aufgerufen. In ihr wird alles geladen, was beim Starten vorhanden sein muß. Dazu zählen z.B. Parameter, Bilder, Musikdateien, grafische Objekte (Buttons, Checkboxen usw.) uvm.

public void start() Die Methode start() wird immer aufgerufen, wenn die Web-Page, die das Applet enthaelt, sichtbar wird, also beim ersten Mal nach der Ausfuehrung der init-Methode und spaeter jedesmal, wenn der User in diese Web-Page zurueckkehrt

public void stop() Die Methode public void stop() wird immer aufgerufen, wenn der User die Web-Page verlaesst, also wenn er auf eine andere Web-Page geht oder wenn der Browser gechlossen wird.

public void destroy() Die Methode public void destroy() wird nach der stop-Methode aufgerufen, wenn der Browser geschlossen wird bzw. auf eine andere Internet-Seite gegangen wird (nicht beim Zurückspringen auf vorher angesehene Seiten mit 'Zurück' oder 'Back').

Wann die Methoden aufgerufen werden, kann man mit folgendem kurzen Programm ansehen. Die Ausgaben sind im Browser in der Java-Konsole sichtbar.

BeispielProgrammbeispiel: Ansehen 
import java.applet.*;
import java.awt.*;

public class Test1 extends Applet{
	
	public void start(){
		System.out.println("start-Methode");
	}
	
	public void init(){
		System.out.println("init-Methode");
	}
	
	public void stop(){
		System.out.println("stop-Methode");
	}
	
	public void destroy(){
		System.out.println("destroy-Methode");
	}
}

Man beachte bitte, daß grundsätzlich alle Methoden in jedem Applet vorhanden sind, allerdings anfangs noch leer sind. Erst wenn eine der Methoden in dem eigenen Applet eingefügt/hingeschrieben wird, "überschreibt" man die entsprechende Methode. Beim Überschreiben bleibt die Funktion der Methode erhalten. Es wird nur festgelegt, was ausgeführt wird, sobald diese Methode gestartet wird.

  Seitenanfang


Übersicht der Methoden

Alle hier aufgeführten Methoden sind in jedem Applet vorhanden. Sie sind allerdings anfangs noch leer. Es liegt also am Programmierer, ihnen Leben einzuhauchen.

public void destroy() Die Methode public void destroy() wird automatisch aufgerufen, wenn entweder der Browser geschlossen wird bzw. auf eine andere Internet-Seite gegangen wird.

Die Methode public void destroy() wird vom Browser oder vom Appletviewer aufgerufen um das Applet zu informieren daß es "zurückgefordert" wurde und daß es alle Ressourcen (Speicher) freigeben ("zerstören") soll, die es zugeteilt bekommen hat. Vor der destroy-Methode wird immer die Methode public void stop() aufgerufen.
Ein Applet sollte diese Methode überschreiben, wenn etwas ausgeführt werden soll, bevor es "zerstört" werden soll. Z.B. ein Applet, daß mit Threads arbeitet benutzt meist die Methode public void init(), um es zu erzeugen, und die Methode public void destroy(), um es wieder zu zerstören.
Voraussetzung, daß die Methode ausgeführt werden kann, ist, daß das Applet zur Zeit (wo die Methode destroy aufgerufen werden soll) nichts ausführt.

public AppletContext getAppletContext() Die Methode public AppletContext getAppletContext() bestimmt den Applet-Kontext (Zusammenhang), welcher es dem Applet ermöglicht, Daten abzufragen und die Umgebung zu beeinflussen, in der es läuft.
Diese Umgebung des Applets beschreibt das Dokument, das das Applet beinhaltet.

Rückgabe: Applet-Kontext

public String getAppletInfo() Gibt Informationen über dieses Applet zurück. Ein Applet sollte diese Methode überschreiben, um einen String über den Autor, die Version und das Copyright des Applets zurückzugeben.
Die Ausführung von dieser Methode setzt voraus, daß von der Appletklasse null zurückgeben wird.

Rückgabe: String (Text), der Informationen über den Autor, die Version und das Copyright des Applets zurückgibt

public AudioClip getAudioClip(URL url) Gibt das AudioClip-Objekt zurück, daß durch das URL-Objekt bestimmt wird.
Diese Methode wird immer sofort gestartet, auch wenn der Audioclip nicht existiert. Wenn das Applet versucht, den Audioclip abzuspielen, werden die Daten geladen.

Parameter:

    url - absolute URL welche den Ort des Audioclip festlegt
Rückgabe: Audioclip, der durch URL bestimmt wird
public AudioClip getAudioClip(URL url, String name) Gibt das AudioClip-Objekt zurück, daß durch das URL-Objekt und den Namen bestimmt wird.
Diese Methode wird immer sofort gestartet, auch wenn der Audioclip nicht existiert. Wenn das Applet versucht, den Audioclip abzuspielen, werden die Daten geladen.

Parameter:

    url - absolute URL welche den Ort des Audioclip festlegt
    name - der "relative" Ort des Audioclip in Beziehung zur angegebenen URL
Rückgabe: Audioclip, der durch URL bestimmt wird
public URL getCodeBase() Liefert die Basis-URL des Applets.

Rückgabe: die URL#_top_ des Applets

public URL getDocumentBase() Liefert die URL des Dokumentes, in das das Applet eingebaut ist.

Rückgabe: die URL#_top_ des Dokumentes, das das Applet enthält

public Image getImage(URL url) Gibt ein Image-Objekt zurück, das am Bildschirm ausgegeben werden kann. Die URL muß als absolut angegeben werden. Diese Methode wird immer sofort gestartet, auch wenn kein Image vorhanden ist. Sobald das Applet versucht, das Bild zu zeichnen, werden die Daten geladen. Die Methode Graphiks, die das Bild zeichnet, malt das Bild schrittweise auf den Schirm.

Parameter:

    url - absolute URL welche den Ort des Image festlegt
Rückgabe: Image, das durch die URL bestimmt wird
public Image getImage(URL url, String name) Gibt ein Image-Objekt zurück, das am Bildschirm ausgegeben werden kann. Die URL muß als absolut angegeben werden. Diese Methode wird immer sofort gestartet, auch wenn kein Image vorhanden ist. Sobald das Applet versucht, das Bild zu zeichnen, werden die Daten geladen. Die Methode Graphiks, die das Bild zeichnet, malt das Bild schrittweise auf den Schirm.

Parameter:

    url - absolute URL welche den Ort des Image festlegt
    name - der "relative" Ort des Image in Beziehung zur angegebenen URL
Rückgabe: Image, das durch die URL bestimmt wird
public Locale getLocale() Gibt den Ort des Applet zurück, sofern diese festgelegt wurde. Wenn kein Ort eingestellt wurde, wird der voreingestellte Ort zurückgegeben.

Rückgabe: Ort des Applets
Überschreibt: die Methode getLocale der Klasse java.awt.Component

public String getParameter(String name) Gibt den Wert (value) des genannten Parameters im HTML-tag zurück. Z.B. 
     <applet code="Clock.class" width=50 height=50>
     <param name=Color value="blue">
     </applet>

Der Name des Parameters ist "Color" und der Wert ist "blue".
Die angegebenen Werte sind nicht case sensitive. Der Parameterwert wird als String eingelesen, auch wenn eine Zahl angegeben wurde.

Parameter:

    name - der Parametername
Rückgabe: Wert des Parameters
public String[][] getParameterInfo() Liefert Informationen über die Parameter zurück, um das Applet anwenden zu können. Ein Applet sollte diese Methode überschreiben, um ein Array von Strings (Texten), die die Paramter beschreiben, zurückzugeben.
Jedes Element des Arrays sollte drei Strings enthalten, die den Namen, den Typ und eine Beschreibung enthalten, z.B. 
     String pinfo[][] = {
       {"fps",    "1-10",    "frames per second"},
       {"repeat", "boolean", "repeat image loop"},
       {"imgs",   "url",     "images directory"}
     };

Die Ausführung der Methode setzt voraus, daß das Applet Null zurückgibt.

Rückgabe: ein Array, das die Parameter des Applets beschreibt, die gebraucht werden

public void init() Die Methode public void init() wird vom Browser oder vom Appletviewer aufgerufen und informiert das Applet, daß es ins System geladen wurde. Die Methode wird immer als erstes gestartet, noch vor der Methode public void start().
In ihr wird alles geladen, was beim Starten vorhanden sein muß. Dazu zählen z.B. Parameter, Bilder, Musikdateien, grafische Objekte (Buttons, Checkboxen usw.) uvm.
Voraussetzung, daß die Methode ausgeführt werden kann, ist, daß das Applet zur Zeit nichts ausführt.
public boolean isActive() Legt fest, ob das Applet aktiv ist. Ein Applet wird aktiviert noch bevor die Methode public void start() aufgerufen wird. Es wird inaktiv, bevor die Methode public void stop() ausgeführt wird.

Rückgabe: true, wenn das Applet aktiv, und false, wenn das Applet inaktiv ist

public static final AudioClip newAudioClip(URL url) Lädt ein Audioclip von der angegebenen URL.

Parameter:

    url - zeigt auf den Audioclip
Rückgabe: Audioclip, der durch die URL festgelegt wurde
public void play(URL url) Spielt den Audioclip, der durch die URL festgelegt wurde. Es passiert nichts, wenn der Audioclip nicht gefunden wird.

Parameter:

    url - absolute URL, die den Ort des Audioclip angibt
public void play(URL url, String name) Spielt den Audioclip, der durch die URL festgelegt wurde. Es passiert nichts, wenn der Audioclip nicht gefunden wird.

Parameter:

    url - absolute URL, die den Ort des Audioclip angibt
    name - Ort des Audioclip, relativ zur angegebenen URL
public void resize(Dimension d) Ändert die Größe des Applets.

Parameter:

    d - Dimension-Objekt, das die neuen Maße angbibt
Überschreibt: Methode resize der Klasse java.awt.Component
public void resize(int width, int height) Ändert die Größe des Applets.

Parameter:

    width - neue Breite des Applets
    height - neue Höhe des Applets
Überschreibt: Methode resize der Klasse java.awt.Component
public final void setStub(AppletStub stub) Fügt den Rumpf des Applets ein. Diese Methode wird automatisch vom System aufgerufen.

Parameter:

    stub - der neue Rumpf
public void showStatus(String msg) Mit der Methode public void showStatus(String msg) wird der String msg in der Statusleiste des Browser oder des Appletviewers angezeigt. Diese Statusleiste befindet sich meistens am unteren Rand. Mit der Methode kann ein aktueller Status angezeigt werden.

Parameter:

    msg - Text, der in der Statusleiste ausgeben werden soll.
public void start() Die Methode public void start() wird vom Browser oder vom Appletviewer aufgerufen und teilt dem Applet mit, daß es starten soll (d.h. mit den Ausführungen beginnen soll). start() wird nach der Methode public void init() und immer wenn die die Internet-Seite wieder besucht wird aufgerufen.
Ein Applet sollte diese Methode überschreiben, immer wenn es etwas ausführen möchte sobald die Internetseite angesehen wird, z.B. wenn eine Animation wieder gestartet werden soll und sie vorher mit der Methode stop() angehalten wurde.
Voraussetzung, daß die Methode ausgeführt wird, ist, daß das Applet gerade nichts macht.
public void stop() Die Methode public void stop() wird vom Browser oder vom Appletviewer aufgerufen und teilt dem Applet mit, daß es anhalten soll (d.h. die Ausführungen beenden). stop() wird aufgerufen, sobald eine andere Internet-Seite aufgerufen wird, die das Applet nicht mehr beinhaltet. Sie wird noch vor der Methode public void destroy() ausgeführt.
Ein Applet sollte diese Methode überschreiben, immer wenn es etwas ausführen möchte sobald die Internetseite verlassen wird, z.B. wenn eine Animation angehalten werden soll, die vorher mit der Methode start() aufgerufen wurde.
Voraussetzung, daß die Methode ausgeführt wird, ist, daß das Applet gerade nichts macht.

 
weiter:
zurück:		   Beispiel
  Grundlagen
  Seitenanfang © 1999-2001  Brit Schröter