Proz-S4

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 1

4. Pakiet

java.applet

4.1 Pakiet

java.applet

4.2 Apletowe API

4.1 Pakiet

java.applet

Aplet jest

niesamodzielnym programem

, doł

czanym do innej (ale

specjalizowanej) aplikacji, w rodzaju przegl

darka internetowa (stanowi

ona kontekst dla apletu).
Ka

dy aplet tworzony jest jako

klasa pochodna

od klasy

Applet

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 2

1) Klasa

java.applet.Applet

Deklaracja

public class Applet extends java.awt.Panel

Implementowane interfejsy:

javax.accessibility.Accessible

(przez

Panel

java.awt.image.ImageObserver,

java.awt.MenuContainer i
java.io.Serializable

(przez

Component

public interface Accessible

– interfejs wyznacza jedn

metod

AccessibleContext

getAccessibleContext()

–

zwraca

obiekt

typu

AccessibleContext

, zwi

zany z zadanym obiektem i zawieraj

informacje o obiekcie i jego mo

liwo

ciach – np. o wykonywanych

akcjach, jego graficznej reprezentacji, selekcji komponentów potomnych,
prezentacji edytowalnego tekstu.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 3

•

Klasa zagnie

ona w klasie

Applet

protected class Applet.AccessibleApplet extends Panel.AccessibleAWTPanel

Ta klasa implementuje mechanizm informowania o obiekcie apletu (np.
jego stanie i roli) oraz jego mo

liwo

ciach.

•

public interface ImageObserver

– interfejs wyznacza jedn

metod

boolean

imageUpdate(Image img, int infoflags, int x, int y, int width, int he);

metoda

wywoływana

jest

celu

obserwacji

post

asynchronicznego ładowania obrazu.

•

public interface MenuContainer

–

bazowy interfejs dla wszystkich

kontenerów zawieraj

cych menu.

•

public interface Serializable

– pusty interfejs, który wskazuje na

liwo

ść

serializacji obiektu. Klasa mo

e (ale nie musi)

implementowa

metody:

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 4

private void writeObject(java.io.ObjectOutputStream out) throws IOException
private void readObject(java.io.ObjectInputStream in) throws IOException,
ClassNotFoundException;

Konstruktor klasy

Applet

public Applet() throws HeadlessException ;

Wyj

tek zgłaszany jest w sytuacji, gdy aplet wołany jest w

rodowisku

nie

dysponuj

cym

urz

dzeniami

wprowadzania

danych

przez

ytkownika.

Obok klasy

Applet

pakiet

java.applet

zawiera te

3 interfejsy

public interface AppletContext

– wyznacza metody dla pobrania

informacji o

rodowisku wykonania apletu, czyli o dokumencie HTML,

zawieraj

cym dany aplet, i informacje o innych apletach tego

dokumentu. Wyznacza nast

puj

ce metody:

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 5

Applet getApplet(String name)

– pobiera aplet o podanej nazwie znajdujący

się w kontekście danego apletu;

Enumeration getApplets()

– znajduje wszystkie aplety znajdujące się w

kontekście danego apletu;

AudioClip

getAudioClip(URL url)

– tworzy klip dźwiękowy;

Image getImage(URL url)

– tworzy obiekt dla pliku graficznego;

InputStream getStream(String key)

– pobiera strumień wejściowy związany z

zadanym kluczem i występujący w kontekście apletu;

Iterator getStreamKeys()

– pobera klucze dla wszystkich strumieni w

kontekście apletu;

void

setStream(String key, InputStream stream)

– związuje zadany strumień

z zadanym kluczem;

void

showDocument(URL url)

– powoduje zmianę wyświetlanej strony na

stronę o zadanym URL;

void

showDocument(URL url, String target)

– Ŝądanie wyświetlenia zadanej

strony;

void

showStatus(String status)

– wyświetla zadany napis w oknie stanu.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 6

public interface AppletStub

- podczas pierwszego utworzenia apletu

doł

czana jest namiastka ("stub") apletu metod

setStub

– namiastka

redniczy pomi

dzy apletem a procesem przegl

darki. Wyznacza

takie metody, jak:

void

appletResize(int width, int height)

– do zmiany rozmiaru okna apletu;

AppletContext

getAppletContext()

– do uzyskania obiektu kontekstu apletu.

URL

getCodeBase()

– do pobrania bazowego adresu URL apletu;

URL

getDocumentBase()

– do pobrania globalnej kartoteki dokumentu;

String getParameter(String name)

– do pobrania wartości nazwanego

parametru.

boolean isActive()

– podaje to, czy aplet jest w stanie aktywnym.

public interface AudioClip

– wyznacza metody dla odtwarzania klipów

kowych.

void

loop()

- uruchamia odtwarzanie klipu dźwiękowego w pętli;

void

play()

– uruchamia odtwarzanie klipu dźwiękowego;

void

stop()

– zatrzymuje odtwarzanie klipu dźwiękowego.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 7

2) Charakterystyka

Klasa

Applet

posiada metody wywoływane przez przegl

dark

wtedy,

gdy zachodz

zmiany w stanie apletu

– inicjalizuje si

, rozpoczyna

wykonanie, zatrzymuje, jest usuwany.

Nadpisanie

tych metod pozwala

na odpowiedni

reakcj

apletu na zmian

jego stanu.

Applet

dziedziczy metody do

malowania grafiki i obrazów

oraz

obsługi

zdarze

po klasie

Container

w pakiecie

AWT

(„Abstract Windowing

Toolkit”) – przeznaczonym do tworzenia graficznego interfejsu
u

ytkownika (GUI).

Apletów dotycz

ograniczenia zabezpieczaj

: zwykle nie mog

odczytywa

i zapisywa

plików na komputerze na którym si

wykonuj

, nie mog

czy

z innym komputerem za wyj

tkiem

swojego „domowego”.

Znacznik

<APPLET>

zyka HTML umo

liwia doł

czenie apletu do

strony html.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 8

3) Bezpo

rednia klasa pochodna

Klasa

JApplet

(w pakiecie

javax.swing

)

public class JApplet extends Applet implements Accessible,

RootPaneContainer

JApplet

umo

liwia u

ycie klas

JFC/Swing

dla apletu.

Obiekt klasy

JApplet

zawiera jeden jedyny komponent klasy

JRootPane

(który posiada

contentPane, glassPane, layeredPane

) a dalsze komponenty

nale

y doł

cza

nie bezpo

rednio do apletu a do jego

contentPane

Np. dla obiektu klasy

Applet

piszemy:

applet.add( komponent );

ale dla klasy

JApplet

nale

y doda

komponent w nast

puj

cy sposób:

applet.getContentPane().add( komponent );

Podobne ró

nice wyst

dla innych operacji, jak np. ustawianie

menad

era

układu

LayoutManager

usuwanie

komponentów,

porz

dkowanie - wszystkie te operacje wykonuje si

na obiekcie

składowym

contentPane

a nie na samym obiekcie klasy

JApplet

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 9

4) Metody klasy

Applet

informuj

ce o stanie apletu

public boolean isActive()

Informuje o tym, czy aplet jest aktywny. Aplet staje si

aktywny tu

przed

wywołaniem jego metody

start

, a przestaje by

aktywny tu

przed

wywołaniem jego metody

stop

public String getAppletInfo()

Podaje informacj

o danym aplecie - autora, wersj

, prawa autorskie, itp.

public Locale getLocale()

Podaje obiekt klasy

Locale

dla apletu - reprezentuje on region kulturowy.

li nie ustawiono obiektu

Locale

to zwracany jest domy

lny obiekt.

public final class Locale extends Object implements Cloneable, Serializable

(w pakiecie

java.util

)

Konstruktory klasy:

Locale(String language)
Locale(String language, String country)
Locale(String language, String country, String variant)

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 10

Argumenty konstruktorów

Locale

language

- to kod j

zyka (kod dwu-literowy według normy ISO-639 -

"małe litery");

country

- to kod kraju (kod 2-literwoy kraju według normy ISO-3166 -

"du

e litery");

variant

- to kod charakteryzuj

cy producenta lub przegl

dark

- np.

"es", "ES", "Traditional_WIN".

public AccessibleContext getAccessibleContext() ;

Metoda

zwraca

obiekt

typu

AccessibleApplet

pełni

rol

AccessibleContext

dla danego apletu.

Szereg metod

Applet

jest dziedziczonych z klas:

java.awt.Panel,
java.awt.Container,
java.awt.Component,
java.lang.Object.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 11

5) Czas

ycia apletu - główne metody

Ładowanie apletu

tworzony jest obiekt klasy apletu (klasa pochodna od

Applet);

aplet sam si

inicjalizuje -

init

;

aplet jest uruchamiany

- start .

Opuszczenie i powrót do strony z apletem

Podczas opuszczania strony przez u

ytkownika jej aplet mo

e si

zatrzyma

–

stop

. Podczas powrotu do strony jej aplet mo

e si

wznowi

–

start

. Podobna sytuacja zachodzi gdy okno strony jest

miniaturyzowane i ponownie przywracane.

wie

anie apletu

Niekiedy przegl

darka umo

liwia od

wie

anie apletu, tzn. jego

zwolnienie (

stop

destroy

) i ponowne załadowanie.

Usuwanie apletu

Aplet ma szans

wykonania ko

cowych operacji czyszcz

cych

(

destroy

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 12

public void init()

Metoda wywoływana przez przegl

dark

w celu poinformowania apletu

o tym,

e został załadowany do pami

ci. Nast

puje to zawsze przed

pierwszym wywołaniem metody

start

. Umo

liwia to własn

inicjalizacj

apletu, np. uruchomienie w

tków.

public void start()

Metoda wywoływana przez przegl

dark

w celu poinformowania apletu

o tym,

e powinien rozpocz

ąć

lub wznowi

swoje wykonywanie, np.

wykonywa

animacj

public void stop()

Metoda wywoływana przez przegl

dark

w celu poinformowania apletu

o tym,

e powinien zawiesi

swoje wykonywanie, np. zatrzyma

animacj

public void destroy()

Metoda wywoływana przez przegl

dark

w celu poinformowania apletu

o tym,

e b

dzie usuni

ty z pami

ci i powinien usun

ąć

wszelkie zasoby,

z których korzysta, np. usun

ąć

tki. Przed t

metod

zawsze b

dzie

wołana metoda

stop

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 13

Przykład.

Aplet

Simple

wietla napis odpowiedni do swojego stanu.

import java.applet.Applet;
import java.awt.Graphics;
public class Simple extends Applet {
StringBuffer buffer;

// Przechowuje prezentowany tekst

    public void init() {
        buffer = new StringBuffer();
        addItem("initializing... ");
    }
    public void start() {
        addItem("starting... ");
    }
    public void stop() {
        addItem("stopping... ");
    }
    public void destroy() {
        addItem("preparing for unloading...");
    }

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 14

    void addItem(String newWord) {
        System.out.println(newWord);
        buffer.append(newWord);
        repaint();
    }
    public void paint(Graphics g) {

// Wykreśla prostokąt wokół obszaru ekranu apletu

g.drawRect(0, 0, size().width - 1, size().height - 1);

// Wypisz aktualny napis w obszarze ekranu apletu.

g.drawString(buffer.toString(), 5, 15);
}
}

Aplet wywoływany jest ze strony html, np.:

Ten aplet pojawia si

z tekstem oddaj

cym stan obiektu klasy

Simple

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 15

Główne metody apletu

init(), start(), stop(), destroy()

Np. Nasza klasa

Simple

public class Simple extends Applet {
. . .
public void init() { . . . }

// Inicjalizacja podczas ładowania apletu

public void start() { . . . }

// Uruchamianie wykonania apletu

public void stop() { . . . }

// Zatrzymanie wykonywania apletu

public void destroy() { . . . }

// Czyszczenie podczas usuwanie apletu

. . .
}

Metoda

init

zawiera zwykle to co powinien zawiera

konstruktor.

W aplecie, który wykonuje co

cej ni

tylko reakcje na akcje

ytkownika, powinno si

nadpisa

metod

start.

Ta metoda

wykonuje zadanie apletu lub uruchamia jego w

tki. Wtedy tak

nale

y nadpisa

metod

stop.

Metoda

destroy

umo

liwia zwolnienie zasobów, których nie

decydujemy si

zwalnia

w metodzie

stop

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 16

6) Metody dla wykre

lania grafiki i dla obsługi zdarze

Dost

pne s

dwie metody (dziedziczone z klasy

Container

) dla

realizacji wy

wietlania apletu:

public void paint(Graphics g)
public void update(Graphics g)

paint()

– metoda przeznaczona dla definicji sposobu wy

wietlenia

apletu;

update()

– ta metoda wywoływana jest przez

repaint()

(dla cało

lub cz

ęś

ci komponentu) i powoduje wy

wietlenie apletu metod

paint()

; umo

liwia zdefiniowanie w klasie apletu dodatkowych

czynno

ci, które nale

y wykona

podczas od

wie

ania wygl

apletu.

Graphics

reprezentuje obszar graficzny danego komponentu.

Np. w klasie

Simple

nadpisano metod

paint

class Simple extends Applet {
. . .

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 17

public void paint(Graphics g) { . . . }
. . .
}

Klasa

Component

posiada szereg metod obsługi zdarze

, np.

action

mouseDown

; a tak

e jedn

metod

dla wszystkich zdarze

handleEvent

Np. Uzupełnimy klas

Simple

o obsług

zdarzenia klikni

cia mysz

import java.awt.Event;
. . .
public boolean mouseDown(Event event, int x, int y) {
addItem("click!... ");
return true;
}

Teraz gdy klikniemy w polu apletu wy

wietli si

napis "click!...".

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 18

Inne metody obsługi zdarze

dziedziczone przez

Applet

Component

keyDown, keyUp,
mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp,
processComponentEvent,  processFocusEvent,  processHierarchyBoundsEvent,
processHierarchyEvent,
processInputMethodEvent,
processKeyEvent,
processMouseEvent, processMouseMotionEvent, processMouseWheelEvent.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 19

7) Metody słu

Ŝą

ce doł

czaniu komponentów GUI (w AWT)

Prosty kod metody

paint

w klasie

Simple

nie obsługuje przepełnienia

ekranu, tzn. nie zapewnia przesuwu wy

wietlania ("scrolling").

Np. po przepełnieniu dalszy tekst nie jest widoczny:

na zastosowa

klasy komponentów interfejsu u

ytkownika -

przeznaczone dla projektowania interfejsu u

ytkownika programu (UI),

np. z pakietów

AWT

lub

Swing

Klasa

Applet

dziedziczy z klasy

Container

, czyli mo

na dodawa

komponenty i korzysta

z menad

era układu dla operowania

pozycjami komponentów na ekranie.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 20

Pakiet AWT

zawiera nast

puj

ce komponenty dla GUI:

•

kontenery (klasy

java.awt.

Panel

, java.awt.

Window

i ich pochodne).

•

przycisk (klasa

java.awt.Button

)

•

okienko wyboru (klasa

java.awt.Checkbox

) i grupa wykluczaj

cych si

okien wyboru (

java.awt.CheckboxGroup

)

•

pole tekstowe 1-wierszowe (klasa

java.awt.TextField

)

•

obszar edycyjny (klasa

java.awt.TextArea

)

•

etykieta (klasa

java.awt.Label

)

•

lista wyborów (klasa

java.awt.List

)

•

rozwijana lista wyborów (klasa

java.awt.Choice

)

•

pasek przewijania (klasa

java.awt.Scrollbar)

•

obszar wykre

lania (klasa

java.awt.Canvas)

•

menu (klasy

java.awt.Menu, java.awt.MenuBar, java.awt.MenuItem,

java.awt.CheckboxMenuItem)

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 21

Niektóre metody klasy

Container

z których mo

e korzysta

aplet:

add

- dodaj podany komponent,

remove

- usu

podany komponent,

setLayout

- ustaw menad

era układu

public void resize(int width, int height)

Powoduje zmian

rozmiaru ekranu dla apletu na nowy (szeroko

ść

wysoko

ść

podane jako argumenty wywołania).

public void resize(Dimension d)

Powoduje zmian

rozmiaru ekranu dla apletu na nowy (szeroko

ść

wysoko

ść

podane s

w obiekcie-argumencie d).

Przykład.

W klasie

Simple

zastosujemy przesuwne, nie edytowalne

pole tekstowe - obiekt klasy

TextField

// Importowanie java.awt.Graphics nie jest juŜ potrzebne, gdyŜ teraz
// aplet nie implementuje metody paint().

import java.awt.TextField;
public class ScrollingSimple extends Applet {
TextField field;

// Zamiast ze StringBuffer korzystamy z TextField

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 22

public void init() {
field = new TextField();

// Utwórz obiekt klasy "pole tekstowe"

field.setEditable(false);

// Ustaw pole jako nie-edytowalne

setLayout(new java.awt.GridLayout(1,0));

// Ustaw układ tak, Ŝe

// pole jest najszersze z moŜliwych.

add(field);

// Dodaj pole tekstowe do apletu

validate();

// Opracuje kontener i wyświetli go na ekranie

addItem("initializing... ");
}

// . . .

void addItem(String newWord) {

// Teraz ta metoda dołącza tekst do naszego TextField.

        String t = field.getText();
        System.out.println(newWord);
        field.setText(t + newWord);
        repaint();

//Widok pola tekstowego na ekranie zostanie odświeŜony.

}

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 23

8) Co aplety mog

a czego nie mog

Przegl

darki "z rezerw

" traktuj

aplety ładowane przez sie

•

Aplet nie mo

e doł

cza

bibliotek ani definiowa

metod

"rodzimych".

•

Nie mo

e odczytywa

lub zapisywa

plików na maszynie na której

wykonuje.

•

Nie mo

e ł

czy

z si

z innymi maszynami za wyj

tkiem

własnej, z której pochodzi.

•

Nie mo

e uruchomi

adnego programu na aktualnej maszynie.

•

Nie mo

e odczytywa

pewnych własno

ci systemu.

•

Okna aktywowane przez aplet ró

od okien przegl

darki.

da przegl

darka dysponuje obiektem klasy

SecurityManager

, który

implementuje polityk

zabezpiecze

. Aplet mo

e przechwyci

wyj

tek

SecurityException

zgłaszany przez

SecurityManager

i odpowiednio

zareagowa

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 24

Jednak aplety posiadaj

wbudowane mo

liwo

ci, których nie

maj

aplikacje.

•

Aplet mo

e ł

czy

poprzez sie

ze "swoim komputerem".

•

Pracuj

c w ramach przegl

darki aplet mo

e wy

wietla

strony HTML.

•

Aplet mo

e wywoła

publiczne metody innego apletu z tej samej

strony.

•

Aplety ładowane z lokalnego systemu plików (z kartoteki w

CLASSPATH u

ytkownika) nie posiadaj

ogranicze

dotykaj

cych

apletów ładowanych poprzez sie

•

Aplet nie musi ko

czy

pracy wraz z opuszczeniem jego strony przez

ytkownika.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 25

9) Uruchamianie apletu

Nale

y doł

czy

aplet do dokumentu HTML znacznikiem

Nale

y poda

URL strony HTML przegl

darce Javy lub AppletViewer.

Np.

</APPLET>

Wykonanie instrukcji znacznika przez przegl

dark

-  rezerwuje dla apletu obszar ekranu o podanym rozmiarze,
-  ładuje bajt-kod podanego apletu,
-  tworzy obiekt podanej klasy apletu,
-  wywołuje metody

init

start

dla obiektu apletu.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 26

4.2 Apletowe API

1) Odszukanie i załadowanie plików z danymi

public URL getCodeBase()

Zwraca adres URL apletu - URL kartoteki z której ładuje si

aplet.

public URL getDocumentBase()

Zwraca adres URL z nazw

kartoteki w której znajduje si

dokument

HTML zawieraj

cy dany aplet.Np. je

li aplet zawarty jest w dokumencie:

http://java.sun.com/products/jdk/1.2/index.html

to jego "

document base

" wynosi:

http://java.sun.com/products/jdk/1.2/

li znacznik

nie zawiera "

code base

" to zarówno

code

base

jak i

document base

odnosz

do tej samej kartoteki.

Dane apletu s

zwykle adresowane wzgl

dem jego

code base

Dane specyfikowane przez u

ytkownika apletu s

adresowane

relatywnie do

document base

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 27

Przykład

. Obrazy i d

ki b

adresowane relatywnie do bazowego

URL. Nast

puj

ca instrukcja utworzy obiekt klasy

Image

zwi

zany z

plikiem

a.gif

w kartotece

imgDir

Image image = getImage(

getCodeBase(), "imgDir/a.gif"

);

public Image getImage(URL url)

Zwraca obiekt klasy

Image

, który mo

e by

wizualizowany na ekranie.

Argument typu URL podaje absolutny adres obrazu. Obraz ładowany
jest dopiero w momencie, gdy ma on by

umieszczony na ekranie.

public Image getImage(URL url, String name)

Zwraca obiekt klasy

Image

, który mo

e by

wizualizowany na ekranie.

Argument typu URL podaje absolutny adres, a drugi argument podaje
dokładne poło

enie obrazu wzgl

dem pierwszego adresu. Obraz

ładowany jest dopiero wtedy, gdy ma on by

umieszczony na ekranie.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 28

2) Wy

wietlanie krótkich napisów o statusie

W przegl

darce istnieje

wiersz statusu

, do którego dost

p ma

przegl

darka i jej aplety. Aplet mo

e wysyła

tam krótkie napisy

informuj

ce o aktualnym stanie przetwarzania.

public void showStatus(String msg)

- wy

wietlenie napisu - argumentu w "oknie statusu" przegl

darki.

Np.

showStatus("MyApplet: Loading image file " + file);

3) Wy

wietlanie dokumentów

Aplet mo

e przekaza

do przegl

darki wezwanie, aby ta wy

wietliła

sformatowany tekst w HTML. Słu

y do tego metoda

showDocument

klasie

AppletContext

, wyst

puj

ca w 2 postaciach:

public void showDocument(java.net.URL url)
public void showDocument(java.net.URL url, String targetWindow)

Pierwsza wersja podaje jedynie adres dokumentu przewidzianego do
wy

wietlenia.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 29

Druga wersja podaje tak

e w którym oknie nale

y wy

wietli

dokument.

Drugim argumentem mo

e by

"_blank

- w nowym, nienazwanym oknie;

windowName

- w oknie o podanej nazwie, w razie potrzeby utworzy

to okno;

"_self

- w oknie i ramce tej samej co aplet;

"_parent

- w oknie apletu ale w ramce przodka dla ramki apletu; je

ramka apletu nie posiada przodka to efekt jest ten sam co dla

"_self"

"_top

- w oknie apletu ale w ramce najwy

szego poziomu; je

li jest

nim ramka apletu to efekt jest ten samo co dla

"_self"

Przykład.

Pewien aplet

ShowDocument

ilustruje u

ycie metody

showDocument

- w obu wersjach i dla wszystkich opcji. Aplet wy

wietla

okno, w którym podajemy 1 lub 2 argumenty wywołania metody

showDocument

. Aplet wywołuje t

metod

po klikni

ciu przycisku "

Show

document"

lub przyci

ciu "

return

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 30

...// W naszej klasie pochodnej od Applet utworzymy główne okno
// związane z kontekstem apletu:

urlWindow = new URLWindow(getAppletContext());
. . .
class URLWindow extends Frame {

// Nasza klasa głównego okna

. . .
public URLWindow(AppletContext appletContext) {

// Okno uzyska

// kontekst naszego apletu.

. . .
this.appletContext = appletContext;
. . .
}

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 31

. . .
public boolean action(Event event, Object o) {

// Obsługa zdarzenia

. . .
String urlString =

/*napis wprowadzany przez uŜytkownika */;

         URL url = null;
         try {    url = new URL(urlString);
         } catch (MalformedURLException e) {

...// Poinformuj uŜytkownika i powróć ...

            }
            if (url != null) {
                if (

/* uŜytkownik nie określa okna */

) {

                    appletContext.showDocument( url );
                } else {
                    appletContext.showDocument( url,

/* podane okno */

);

                }
            }
        . . .

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 32

4) Przesyłanie komunikatów do innych apletów

Aplet mo

e odnale

źć

inne aplety i przesła

do nich komunikat.

Przegl

darki nakładaj

zwykle ograniczenia:

aplety powinny pochodzi

z tego samego serwera,

czasami powinny by

w tej samej kartotece (ten sam "

code base

"),

Java API wymaga, aby aplety wykonywały si

na tej samej stronie -

w tym samym oknie.

Pobranie kontekstu dla apletu

public AppletContext getAppletContext()

Okre

la kontekst dla apletu (m.in. dokument w którym jest zawarty), co

pozwoli apletowi na zapytania do

rodowiska i jego modyfikacj

Znalezienie apletu poprzez jego nazw

– metoda

getApplet()

w klasie

AppletContext

. Metoda

getApplet()

przeszukuje wszystkie aplety

znajduj

ce si

na bie

Ŝą

cej stronie i zwraca obiekt klasy

Applet

, je

znajdzie aplet o podanej nazwie.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 33

Domy

lnie

aplety

nie posiadaj

nazw. Nazw

nadaje si

apletowi na 2

sposoby:
(1) podajemy atrybut

NAME

na stronie ze znacznikiem apletu

; np.:

(2) Podaj

c parametr

NAME

w znaczniku

<PARAM>

; np.:

Uwaga: du

e i małe litery w nazwie apletu zwykle nie s

rozró

niane.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 34

Przykład.

Aplet

Sender

poszukuje apletu

Receiver

. Je

li go znajdzie

przesyła do niego komunikat.

Receiver

reaguje zmieniaj

c swój napis po

prawej stronie na: "

Otrzymano wiadomo

ść

sender-name

!".

Poniewa

Nadawca

" jest nazw

samego

ender

-a

, aplet o tej nazwie

zostanie znaleziony, ale nie otrzyma on komunikatu, gdy

nie jest

obiektem klasy

Receiver

Oto fragment apletu

Sender

słu

Ŝą

cy do komunikacji z

Receiver

Applet receiver = null;
String receiverName = nameField.getText();

// Podaj nazwę apletu

receiver = getAppletContext().getApplet(receiverName);

...

if (receiver != null) {

// Operatorem instanceof sprawdzimy, czy znaleziony obiekt jest
// klasy Receiver.

    if (!(receiver instanceof Receiver)) {
        status.appendText("Znaleziono aplet o nazwie "
                          + receiverName + ", "
                          + "ale nie jest on typu Receiver.\n");

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 35

    } else {
        status.appendText("Znaleziono aplet o nazwie "
                          + receiverName + ".\n"
                          + "  Przesyłam mu komunikat. \n");

// Konwersja do obiektu klasy Receiver aby móc wywołać metodę
// tej klasy a nie klasy Applet

((Receiver)receiver).processRequestFrom(myName);
}
} . . .

Uwagi

Aplet mo

e pobra

swoj

własn

nazw

wołaj

c metod

klasy

Aplet

getParameter

myName = getParameter("NAME");

li obiekt

Receiver

miałby równie

przesyła

zwrotnie komunikaty do

obiektu

Sender

, to

Sender

powinien mu przekaza

referencj

na siebie.

Np.:

((Receiver)receiver).startCommunicating(this);

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 36

Znalezienie wszystkich apletów na danej stronie

- metoda

getApplets()

Metoda

getApplets

zwraca obiekt klasy

Enumeration

cy list

wszystkich apletów danej strony.

Przykład.

Aplet

getApplets

listuje wszystkie aplety danej strony. Oto

fragmenty metody wywołuj

cej

getApplets

public void printApplets() {
Enumeration e = getAppletContext().getApplets();
. . .

// Obiekt typu Enumeration zawiera wszystkie aplety danej strony

    while (e.hasMoreElements()) {
        Applet applet = (Applet)e.nextElement();
        String info = ((Applet)applet).getAppletInfo();
        if (info != null) {
            textArea.appendText("- " + info + "\n");
        } else {
            textArea.appendText("- " + applet.getClass().getName() + "\n");
        }
    }     . . .
}

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 37

5) Odtwarzanie d

ków

Klasa

Applet

i interfejs

AudioClip

realizuj

mechanizm pobierania i

odtwarzania plików d

kowych.

Metody klasy

Applet

przeznaczone do pobierania plików d

kowych:

public static final AudioClip newAudioClip(URL url)

Pobiera plik d

kowy o podanym adresie URL.

public AudioClip getAudioClip(URL url)

Zwraca obiekt klasy

AudioClip

dla podanego adresu URL. Argument

typu

URL

podaje absolutny adres pliku. Jest on ładowany ale nie jest

jeszcze odtwarzany.

public AudioClip getAudioClip(URL url, String name)

Zwraca obiekt klasy

AudioClip

. Argument typu URL podaje absolutny

adres, a drugi argument podaje dokładne poło

enie pliku d

kowego

wzgl

dem pierwszego adresu. Plik jest ładowany ale nie jest jeszcze

odtwarzany.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 38

public void play(URL url)

Odtwarza plik d

kowy znajduj

cy si

pod podanym adresem

URL

Nie ma

adnego efektu, gdy plik nie istnieje.

public void play(URL url, String name)

Odtwarza plik d

kowy znajduj

cy si

pod adresem zło

onym z

adresu

URL

i wzgl

dnego adresu

name.

Nie ma

adnego efektu, gdy plik

nie istnieje.

Interfejs

AudioClip

wyznacza metody dla odtwarzania d

ku:

loop –

odtwarza obiekt klipu w p

tli,

play -

odtwarza obiekt klipu raz,

stop -

zatrzymuje odtwarzanie klipu

Przykład.

Aplet

SoundExample

ilustruje ładowanie i odtwarzanie wielu

plików d

kowych jednocze

nie.

AudioClip onceClip, loopClip;
onceClip = applet.getAudioClip(getCodeBase(), "bark.au");

// Utwórz klip

loopClip = applet.getAudioClip(getCodeBase(), "train.au");

// Utwórz klip

onceClip.play();

// Odtwórz raz

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 39

loopClip.loop();

// Wykonuj odtwarzanie w pętli.

loopClip.stop();

// Zatrzymaj odtwarzanie pojedyncze lub w pętli.

tla jest zatrzymywana, gdy u

ytkownik opuszcza stron

apletu i

wznawiana, gdy u

ytkownik powraca do strony apletu. Dzieje si

tak

dzi

ki wła

ciwemu zdefiniowaniu metod

stop

start

w aplecie:

public void stop() {

// looping jest polem typu boolean - początkowo ustawionym na "false";
// jest ustawiane na "true" gdy uŜytkownik wybiera przycisk w rodzaju
// "Odtwarzaj w petli" i na "false" gdy przycisk w rodzaju "Zatrzymaj".

if (looping) {
loopClip.stop();

// Zatrzymaj pętlę odtwarzania dźwięków

    }
}
public void start() {
    if (looping) {
        loopClip.loop();

// Restartuj pętlę odtwarzania dźwięków

}
}

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 40

6) Parametry apletu

Parametry s

dla apletu tym czym opcje linii komend dla programu.

Decyzje projektowe:

(1) Jakie parametry i z jakimi domy

lnymi warto

ciami powinien

przyjmowa

aplet?

(2) Metoda

getParameter

- aplet pobiera poprzez ni

warto

parametrów zadane przez u

ytkownika.

(3) Metoda

getParameterInfo

- aplet udost

pnia u

ytkownikowi

informacj

o swoich parametrach.

public String getParameter(String name)

Zwraca warto

ść

(lub

null

) podanego parametru w znaczniku HTML. Np.

dla znacznika:

wywołanie

getParameter("Color")

zwróci wynik

"blue"

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 41

public String[][] getParameterInfo()

Zwraca informacj

o parametrach istotnych dla danego apletu w postaci

tablicy napisów. Ka

dy napis powinien mie

3 cz

ęś

ci: nazw

, typ, opis.

Np.:

String pinfo[][] = {
   {"fps",    "1-10",    "frames per second"},
   {"repeat", "boolean", "repeat image loop"},
   {"imgs",   "url",     "images directory"}
};

Jakie parametry ?

Zale

y to od funkcji apletu. Np. parametry charakterystyczne dla

obrazów lub d

ków, poło

enia plików, wygl

du ramki apletu.

Jakie nazwy parametrów?

XXXSOURCE lub XXXSRC - dla plików danych. Np. IMAGESOURCE.
NAME - tylko dla nazwy apletu.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 42

Jakie warto

ci przyjmuj

parametry ?

Wszystkie warto

ci s

napisami (String). Napis jest interpretowany

przez aplet na ró

ne sposoby. Typowe interpretacje napisu to:

URL ,

liczba całkowita ,

liczba zmienno-przecinkowa ,

warto

ść

logiczna - "true"/"false" lub "yes"/"no" ,

napis,

lista powy

szych danych.

Jaka b

dzie warto

ść

domy

lna parametru?

Nawet gdy u

ytkownik nie przeka

e warto

ci parametru aplet powinien

pracowa

poprawnie dzi

ki istnieniu warto

ci domy

lnych.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 43

Przykład.

Nasza klasa nazywa si

AppletButton

. Jej GUI składa si

z przycisku i

etykiety oddaj

cej jej status. W wyniku klikni

cia przycisku aplet

wietla okno na ekranie. Klasa ta mo

e by

wykorzystywana w wielu

dalszych przykładach, gdy

jest bardzo elastyczna. T

elastyczno

ść

zapewniaj

jej parametry. U

ytkownik mo

e okre

: typ wy

wietlanego

okna, tytuł okna, wysoko

ść

i szeroko

ść

okna, etykiet

samego przycisku,

Np.
znacznik

APPLET

dla

AppletButton

e wygl

nast

puj

co:

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 44

Kod dla interpretacji wyniku metody

getParameter

Nale

y zdefiniowa

kod interpretuj

cy wynik metody zwracaj

cej

warto

ść

parametru podan

przez u

ytkownika.

public String getParameter(String name)

Np.

int requestedWidth = 0;
. . .
String windowWidthString = getParameter("WINDOWWIDTH");
if (windowWidthString != null) {
try {

// Spróbuj dokona

konwersji napisu do liczby całkowitej

requestedWidth = Integer.parseInt(windowWidthString);
} catch (NumberFormatException e) {

// Tutaj pobierz domy

warto

ść

parametru.

}
}

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 45

Metoda

getParameter

umo

liwia tak

e pobranie warto

atrybutów

dla

znacznika apletu

Przykład

W naszej klasie

AppletButton

zdefiniowali

my pobieranie

parametrów apletu.

String windowClass;
String buttonText;
String windowTitle;
int requestedWidth = 0;
int requestedHeight = 0;
. . .
public void init() {
    windowClass = getParameter("WINDOWCLASS");
    if (windowClass == null) {
        windowClass = "TestWindow";
    }
    buttonText = getParameter("BUTTONTEXT");
    if (buttonText == null) {

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 46

        buttonText = "Click here to bring up a " + windowClass;
    }
    windowTitle = getParameter("WINDOWTITLE");

    if (windowTitle == null) { windowTitle = windowClass; }
    String windowWidthString = getParameter("WINDOWWIDTH");
    if (windowWidthString != null) {
        try {  requestedWidth = Integer.parseInt(windowWidthString);
        } catch (NumberFormatException e) {

// ... tu ustal domy

warto

ść

dla parametru "szeroko

ść

        }
    }
    String windowHeightString = getParameter("WINDOWHEIGHT");
    if (windowHeightString != null) {
        try {  requestedHeight = Integer.parseInt(windowHeightString);
        } catch (NumberFormatException e) {

// ... tu ustal domy

warto

ść

dla parametru "wysoko

ść

}
}

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 47

Przekazywanie informacji o parametrach

Nale

y zdefiniowa

metod

getParameterInfo()

tak, aby przegl

darka

mogła pobra

informacj

o parametrach naszego apletu.

Metoda

getParameterInfo

zwraca tablic

3-elementowych tablic typu

String

W ka

dej z tych 3-elementowych tablic 1-szy napis jest nazw

parametru, drugi podaj informacj

o typie warto

ci dla parametru a trzeci

opisuje znaczenie parametru.

Przykład.

Implementacja

getParameterInfo

w klasie

Animator

, w której okre

lono

13 parametrów, umo

liwiaj

cych u

ytkownikowi dostosowanie animacji

do swoich potrzeb.

public String[][] getParameterInfo() {
String[][] info = {

// Nazwa parametru Typ wartości Opis

{"imagesource", "URL", "a directory"},
{"startup", "URL", "displayed at startup"},

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 48

        {"background",      "URL",          "displayed as background"},
        {"startimage",        "int",              "start index"},
        {"endimage",         "int",              "end index"},
        {"namepattern",     "URL",          "used to generate indexed names"},
        {"pause",                "int",             "milliseconds"},
        {"pauses",              "ints",            "milliseconds"},
        {"repeat",               "boolean",     "repeat or not"},
        {"positions",          "coordinates",  "path"},
        {"soundsource",     "URL",          "audio directory"},
        {"soundtrack",       "URL",          "background music"},
        {"sounds",             "URLs",         "audio samples"},
    };
    return info;
}

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 49

7) Znacznik

<APPLET>

Znamy ju

najprostsz

posta

znacznika

<APPLET>

<APPLET CODE=KlasaPochodnaOdApplet.class WIDTH=liczba1Int
HEIGHT=liczba2Int>
</APPLET>

Parametry - znacznik

<PARAM>

ytkownik przekazuje parametry apletu korzystaj

c ze znaczników

<PARAM>

, które nale

y umie

zaraz po znaczniku

danego apletu.

Przykład.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 50

Alternatywny kod HTML i alternatywny tekst

Alternatywnym kodem HTML jest dowolny tekst wyst

puj

cy pomi

dzy

znacznikami

</APPLET>

po znacznikach

<PARAM>

przegl

darki Javy, rozpoznaj

ce znacznik

, ignoruj

alternatywny kod

HTML

– w przeciwnym razie wy

wietl

go.

na te

przegl

darkom przekaza

alternatywny tekst posługuj

c si

atrybutem

ALT

w znaczniku

li przegl

darka nie mo

wietli

apletu wy

wietli alternatywny tekst apletu.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 51

Przykład

<APPLET CODE="Animator.class" WIDTH=460 HEIGHT=160
ALT=

"Jeśli widać animację to znaczy, Ŝe aplet się wykonuje"

Przeglądarka ignoruje znacznik <APPLET> !

</APPLET>

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 52

Specyfikacja katalogu apletu

Domy

lnym poło

eniem apletu jest bie

Ŝą

cy katalog strony HTML z

apletem. Je

li aplet podany jest poprzez pakiet, to poszukuje si

go na

cie

ce pakietu, "wychodz

cej" z bie

Ŝą

cego katalog.

li aplet ma by

w innym miejscu posłu

nale

y atrybutem

CODEBASE

li aURL jest wzgl

dnym URL to "podczepiony" zostanie pod bie

Ŝą

katalog strony HTML. Je

li aURL jest absolutnym URL to mo

oznacza

nawet katalog zdalnego komputera w sieci.

4. Pakiet

java.applet

W. Kasprzak: Programowanie zdarzeniowe

4 - 53

Archiwizacja plików apletu

li kod apletu składa si

z wielu plików to opłaca si

je zarchiwizowa

w postaci jednego pliku.
Standardowy format archiwum w Javie to

JAR

(oparty na formacie ZIP).

Pliki typu

JAR

podaje si

w atrybucie

ARCHIVE

znacznika

na poda

na raz wiele plików archiwizacyjnych po przecinku.

Np.

<APPLET CODE="AppletSubclass.class" ARCHIVE="file1, file2"

WIDTH=anInt HEIGHT=anInt>

</APPLET>

Inne atrybuty znacznika

ALIGN, VSPACE, HSPACE, NAME