SW_12. Vzor Příkaz - Command Vzor Návštěvník - Visitor

Transkript

1 SW_12 Vzor Příkaz - Command Vzor Návštěvník - Visitor 1

2 Problém: Vzor Příkaz - Command Standardní cesta pro vykonání metody je její vyvolání. V některých situacích nejsme schopni řídit načasování (timing) kontextu, ve kterém by se měly metody volat. Dalším problémem je flexibilní zpracování návratové hodnoty metody. 2

3 Kontext: Vzor Příkaz - Command Jak ovládat řadu zařízení přes dálkový ovladač. Požadujeme, aby ovladač měl jednoduché funkce a abychom byli schopni modifikovat jím ovládaná zařízení (přidat nové, odebrat původní). 3

4 Řešení: Vzor Příkaz Zapouzdření operace do formy objektu typu command. Oddělení požadavku na danou akci od objektu, který skutečně akci provede. Návrhový vzor Command právě oddělí uvedené části od sebe. 4

5 Vzor Příkaz Vzor si vysvětleme na příkladu dálkového ovladače (remote controller), který bude skutečným žadatelem (requester) provedení konkrétních akcí, které zvolíme stiskem daných tlačítek ovladače. Požadavek pak provede konkrétní třída daného zařízení. 5

6 Vzor Příkaz Jednoduchými požadovanými operacemi mohou být požadavky na rozsvícení, zhasnutí světla, zapnutí, vypnutí televizoru. Objekt command pak bude provádět tuto konkrétní operaci. Bude třeba tedy vytvořit řadu objektů command pro každé tlačítko vzdáleného ovladače, které pak zabezpečí vykonání konkrétní operace. 6

7 Postup 1. Klient vytvoří objekt command. 2. Klient vykoná metodu setcommand() k uložení objektu command do invokátoru (vyvolávače). 3. Později klient požádá invokátor o provedení objektu command. Projevuje se snaha ukládat tyto objekty command do nějaké kolekce a pak je vyvolat. Využití při událostmi řízeném programování. 7

8 Postup Za zmínku stojí, že poté, co je objekt command nahrán do invokátoru (metodou setcommand()), může být objekt command využit jednou nebo vícekrát, nebo také zrušen či nahrazen jiným objektem command. 8

9 public interface Command { public void execute(); Poznámky Vytvoření prvního objektu command Předtím, než vytvoříme první objekt command, který bude rozsvěcet světlo, deklarujeme nejdříve rozhraní, které bude využívat vzdálený ovladač.

10 public class LightOnCommand implements Command { private Light light; Poznámky public LightOnCommand(Light light) { // konstruktor this.light = light; public void execute() { light.on(); Jediná metoda rozhraní se jmenuje execute(). Následuje třída konkrétní Command (LightOnCommand), která implementuje rozhraní Command.

11 public class Light { // konstruktor public Light() { public void on() { System.out.println("Light is on"); public void off() { System.out.println("Light is off"); Poznámky Vidíme, že třída Light deklaruje datový atribut light (světlo), který je nastaven v konstruktoru. Implementace metody exekute() pak vyvolá metodu on() třídy Light, čímž se rozsvítí světlo. Třída Light (světlo) má jistě i metodu off(), kterou se světlo zhasne.

12 public class SimpleRemoteControl { Command slot; // místo pro zařízení public SimpleRemoteControl() { // konstruktor Poznámky Použití objektu command public void setcommand(command command) { slot = command; public void buttonwaspressed() { slot.execute(); Předpokládejme, že máme dálkový ovladač s jedním tlačítkem a odpovídajícím místem (pozicí, slotem) pro zařízení, které budeme dálkovým ovladačem řídít. Metoda setcommand() Metoda setcommand() nastavuje konkrétné objekt command do proměnné slot. Při změně objektu command, musíme tuto metodu vyvolat znova. Metoda buttonwaspressed() je vyvolána vždy při stisku tlačítka.

13 public class RemoteControlTest { public static void main(string[] args) { SimpleRemoteControl remote = new SimpleRemoteControl(); // objekt light je příjemcem požadavku Light light = new Light(); LightOnCommand lighton = new LightOnCommand(light); Jednoduchý test funkčnosti je pak následující: Poznámky remote.setcommand(lighton); remote.buttonwaspressed(); Třída RemoteControlTest představuje klienta ve vzoru Command. Objekt remote je náš invoker (ten, kdo se něčeho dovolává) a je mu předán konkrétní objekt commanderu v metodě setcommand().

14 Vzor Příkaz - definování Vzor Command zapouzdřuje pořadavek (request) jako objekt a tím nám dovoluje parametrizovat další objekty s odlišnými požadavky, frontovat nebo zaznamenávat požadavky a podporovat operaci undo (zrušení provedené operace). 14

15 Vzor Příkaz - definování Víme, že objekt command svazuje dohromady množinu akcí na konkrétním příjemci. Příjemcem bylo světlo, ale mohou to být např. garážová vrata, u kterých můžeme požadovat akce: zavření, otevření, zastavení, zhasnutí světla v garáži, rozsvícení světla v garáži. Abychom toho dosáhli, vzor pakuje akce a příjemce do jednoho objektu, který vystavuje jednu metodu execute(). 15

16 Vzor Příkaz - definování Když je objekt vyvolán, metoda execute() způsobí vyvolání akcí příjemce. Z vnějšího pohledu žádné jiné objekty skutečně neví, jaké akce jsou na příjemci vykonány; tyto objekty pouze ví, že když vyvolají metodu execute(), jejich požadavek bude obsloužen. 16

17 Vzor Příkaz - definování Podíváme se blíže na garáž. Vidíme, že se jedná celkem o pět akcí. Musíme proto doplnit odpovídající objekty command pro každou akci. 17

18 public class GarageDoor { Poznámky public GarageDoor() { public void up() { System.out.println("Garage Door is Open"); public void down() { System.out.println("Garage Door is Closed"); public void stop() { System.out.println("Garage Door is Stopped"); public void lighton() { System.out.println("Garage light is on"); public void lightoff() { System.out.println("Garage light is off");

19 public class GarageDoorOpenCommand implements Command { GarageDoor garagedoor; Poznámky public GarageDoorOpenCommand(GarageDoor garagedoor) { this.garagedoor = garagedoor; public void execute() { garagedoor.up();

20 public class RemoteControlTest { public static void main(string[] args) { SimpleRemoteControl remote = new SimpleRemoteControl(); GarageDoor garagedoor = new GarageDoor(); GarageDoorOpenCommand garageopen = new GarageDoorOpenCommand(garageDoor); Poznámky remote.setcommand(garageopen); remote.buttonwaspressed();

21 Diagram tříd 21

22 Aplikace Rozhraní Command je rozhraní v našem případě zatím pouze s metodou execute(). Třída ConcreteCommand je v našich příkladech reprezentovaná třídami LightOnCommand a GarageDoorOpenCommand. Třídu Receiver (příjemce) reprezentují konkrétní třídy Light (světlo) a GarageDoor. Třída Invoker s metodou setcommand() je reprezentovaná třídou SimpleRemoteControl. 22

23 Aplikace Třída Client je reprezentovaná třídou s hlavní metodou, tedy třídou RemoteControlTest. Třída Client je zodpovědná za vytváření objektů tříd ConcreteCommand a nastavení jejich příjemce (receiver). Třída Invoker uchovává objekt command a v daném místě žádá objekt command o provedení požadavku, vyvoláním jeho metody execute(). 23

24 Aplikace Třída ConcreteCommand definuje vazbu mezi akcí a příjemcem. Invoker vyvolá požadavek vyvoláním metody execute() a objekt concretecommand to vykoná vyvoláním jedné nebo více akcí na příjemci. Příjemce (receiver) zná, jak provést konkrétní požadavek. Jako příjemce může sloužit libovolná třída. 24

25 Aplikace Nyní se podíváme, jak bychom řešili vzdálený ovladač pro sedm zařízení. Pokud budeme ovládat např. světlo v kuchyni a světlo v obývacím pokoji, nutně potřebujeme dva konkrétní objekty command, jeden pro světlo v kuchyni a druhý pro světlo v obývacím pokoji. Vzor Command to neumí rozlišit. 25

26 Aplikace Další věc, kterou musíme zavést, jsou pole pro nastavení jednotlivých zařízení. Tato pole povedeme dvoje a to pro zapnutí a vypnutí, což jsou nejzákladnější operace. 26

27 public class RemoteControl { Command[] oncommands; // pole pro zapnutí Command[] offcommands; // pole pro vypnutí Poznámky public RemoteControl() { oncommands = new Command[7]; offcommands = new Command[7]; Command nocommand = new NoCommand(); for (int i = 0; i < 7; i++) { oncommands[i] = nocommand; offcommands[i] = nocommand; public void setcommand(int slot, Command oncommand, Command offcommand) { oncommands[slot] = oncommand; offcommands[slot] = offcommand; public void onbuttonwaspushed(int slot) { oncommands[slot].execute();

28 public void offbuttonwaspushed(int slot) { offcommands[slot].execute(); Poznámky public String tostring() { StringBuffer stringbuff = new StringBuffer(); stringbuff.append("\n---- Remote Control -----\n"); for (int i = 0; i < oncommands.length; i++) { stringbuff.append("[slot " + i + "] " + oncommands[i].getclass().getname() + " " + offcommands[i].getclass().getname() + "\n"); return stringbuff.tostring();

29 public class NoCommand implements Command { public void execute() { Poznámky Vzdálený ovladač ovládá sedm jednoduchých zařízení (zapnutí / vypnutí). Na začátku třídy nastavíme všechny přepínače na objekt nocommand, jehož třídu uvádíme. To znamená, že pokud nějaký přepínač nebude definovaný, implicitně bude jako nocommand, tedy prázdná metoda execute().

30 Aplikace Metoda setcommand() má tři parametry pro uchování všech informací. Prvním parametrem je slot, který tvoří index pro uložení informací v polích. Další dva parametry jsou pro konkrétní objekty command pro zapnutí a pro vypnutí. Metoda tostring() vypisuje všechna nastavení této třídy. 30

31 public class StereoOnWithCDCommand implements Command { Stereo stereo; Poznámky public StereoOnWithCDCommand(Stereo stereo) { this.stereo = stereo; public void execute() { stereo.on(); stereo.setcd(); stereo.setvolume(11); Třída StereoOnWithCDCommand může mít pak následný kód:

32 public class Stereo { String location; public Stereo(String location) { this.location = location; public void on() { System.out.println(location + " stereo is on"); public void off() { System.out.println(location + " stereo is off"); Poznámky Tato třída konkrétního commandu spouští stereo, spouští CD přehravač s hlasitistí 11. Třída příjemce (receiver) má následující kód. public void setcd() { System.out.println(location + " stereo is set for CD input"); public void setdvd() { System.out.println(location + " stereo is set for DVD input");

33 public void setradio() { System.out.println(location + " stereo is set for Radio"); Poznámky public void setvolume(int volume) { // code to set the volume // valid range: 1-11 (after all 11 is better than // 10, right?) System.out.println(location + " Stereo volume set to " + volume);

34 public class RemoteLoader { public static void main(string[] args) { RemoteControl remotecontrol = new RemoteControl(); Light livingroomlight = new Light("Living Room"); Light kitchenlight = new Light("Kitchen"); CeilingFan ceilingfan= new CeilingFan("Living Room"); GarageDoor garagedoor = new GarageDoor(""); Stereo stereo = new Stereo("Living Room"); Poznámky K otestování našeho postupu pak bude sloužit třída RemoteLoader. LightOnCommand livingroomlighton = new LightOnCommand(livingRoomLight); LightOffCommand livingroomlightoff = new LightOffCommand(livingRoomLight); LightOnCommand kitchenlighton = new LightOnCommand(kitchenLight); LightOffCommand kitchenlightoff = new LightOffCommand(kitchenLight); CeilingFanOnCommand ceilingfanon = new CeilingFanOnCommand(ceilingFan); CeilingFanOffCommand ceilingfanoff = new CeilingFanOffCommand(ceilingFan); GarageDoorUpCommand garagedoorup = new GarageDoorUpCommand(garageDoor); GarageDoorDownCommand garagedoordown = new GarageDoorDownCommand(garageDoor);

35 StereoOnWithCDCommand stereoonwithcd = new StereoOnWithCDCommand(stereo); StereoOffCommand stereooff = new StereoOffCommand(stereo); Poznámky remotecontrol.setcommand(0, livingroomlighton, livingroomlightoff); remotecontrol.setcommand(1, kitchenlighton, kitchenlightoff); remotecontrol.setcommand(2, ceilingfanon, ceilingfanoff); remotecontrol.setcommand(3, stereoonwithcd, stereooff); System.out.println(remoteControl); remotecontrol.onbuttonwaspushed(0); remotecontrol.offbuttonwaspushed(0); remotecontrol.onbuttonwaspushed(1); remotecontrol.offbuttonwaspushed(1); remotecontrol.onbuttonwaspushed(2); remotecontrol.offbuttonwaspushed(2); remotecontrol.onbuttonwaspushed(3); remotecontrol.offbuttonwaspushed(3);

36 Aplikace Jak jste si všimli, objekt třídy NoCommand je příkladem null objektu. Ten také slouží k návratu objektu z metody, když nemáme co poslat zpět. 36

37 Poznámky public interface Command { public void execute(); public void undo(); Přidání metody undo do rozhraní Command Když rozhraní Command podporuje metodu undo, musíme ji doplnit nejdříve do rozhraní.

38 public class LightOnCommand implements Command { Light light; public LightOnCommand(Light light) { this.light = light; public void execute() { light.on(); Poznámky Teď se podíváme, jak budeme metodu undo() implementovat do tříd konkrétních commandů. public void undo() { light.off(); Ukážeme si to na příkladu rozsvícení a zhasnutí světla.

39 public class LivingroomLightOffCommand implements Command { Light light; Poznámky public LivingroomLightOffCommand(Light light) { this.light = light; public void execute() { light.off(); public void undo() { light.on(); Vidíme, že operace on() a off() jsou opačné. Ještě musíme opravit třídu RemoteControl.

40 public class RemoteControl { Command[] oncommands; Command[] offcommands; Command undocommand; Poznámky public RemoteControl() { oncommands = new Command[7]; offcommands = new Command[7]; Command nocommand = new NoCommand(); for(int i=0;i<7;i++) { oncommands[i] = nocommand; offcommands[i] = nocommand; undocommand = nocommand; public void setcommand(int slot, Command oncommand, Command offcommand) { oncommands[slot] = oncommand; offcommands[slot] = offcommand;

41 public void onbuttonwaspushed(int slot) { oncommands[slot].execute(); undocommand = oncommands[slot]; Poznámky public void offbuttonwaspushed(int slot) { offcommands[slot].execute(); undocommand = offcommands[slot]; public void undobuttonwaspushed() { undocommand.undo(); public String tostring() { StringBuffer stringbuff = new StringBuffer(); stringbuff.append("\n---- Remote Control -----\n"); for (int i = 0; i < oncommands.length; i++) { stringbuff.append("[slot " + i + "] " + oncommands[i].getclass().getname() + " " + offcommands[i].getclass().getname() + "\n"); stringbuff.append("[undo] " + undocommand.getclass().getname() + "\n"); return stringbuff.tostring();

42 public class RemoteLoaderTest { Poznámky public static void main(string[] args) { RemoteControl remotecontrol = new RemoteControl(); Light livingroomlight = new Light("Living Room"); LightOnCommand livingroomlighton = new LightOnCommand(livingRoomLight); Objekty command pak ještě mohou být ukládány do kolekcí a pak spouštěny najednou. LightOffCommand livingroomlightoff = new LightOffCommand(livingRoomLight); remotecontrol.setcommand(0, livingroomlighton, livingroomlightoff); remotecontrol.onbuttonwaspushed(0); remotecontrol.offbuttonwaspushed(0); System.out.println(remoteControl); remotecontrol.undobuttonwaspushed(); remotecontrol.offbuttonwaspushed(0); remotecontrol.onbuttonwaspushed(0); System.out.println(remoteControl); remotecontrol.undobuttonwaspushed();

43 Shrnutí vzoru Příkaz Tento vzor má řadu uplatnění, např. ošetřování chybových stavů, práce s událostmi řízených programech. Operace, která se má provést je zabalena do objektu a pak se s ní dá pružně manipulovat. Klient je odstíněn od konkrétní implementace metody execute(). Konkrétní metoda je vybrána podle typu objektu, který metodu execute() aktuálně vyvolává. 43

44 Shrnutí vzoru Příkaz Navíc možnost připojení objektu třídy nocommand a metoda undo(). Konkrétní metoda je vybrána podle typu objektu, který metodu execute() aktuálně vyvolává. Navíc jsme viděli, jak se dá připojit objekt třídy nocommand a metoda undo(). 44

45 Vzor Command - příkaz Příkazy vzoru Command se dají uložit do objektu třídy kolekce (např. Register) kvalifikovaného na objekt rozhraní Command. To pak vede k tomu, že se dá vytvořit dynamický seznam požadavků, které se postupně provádějí. 45

46 Kontext: Návštěvník - Visitor Je daná základní hierarchie tříd daného problému, do které není možné dělat změny. Může to být hierarchie tříd dodaná jiným dodavatelem. Jako změny myslíme dodání dalších polymorfických metod, které by rozšířily funkčnost stávající hierarchie tříd. 46

47 Návštěvník - Visitor Problém: Je třeba dodat další metody do hierarchie tříd bez fyzického přidání daných metod do každé třídy uvedené hierarchie. Řešení: Řešení přináší návrhový vzor Visitor (návštěvník), který dovoluje vytvoření oddělené hierarchie tříd typu Visitor k virtualizaci operací prováděných na původní hierarchii tříd. 47

48 Konkrétní příklad - diagram tříd 48

49 Návštěvník - Visitor Neměnnou strukturu tříd představují třídy na levé straně obrázku, tedy třídy Tvar, Kruh a Ctverec. Na pravé straně obrázku je pak hierarchie tříd, které se využívají na rozšíření funkčnosti stávající hierarchie. Jedná se nám o to, že chceme doplnit metody pro výpočet obsahu a obvodu daných obrazců. 49

50 Návštěvník - Visitor Postup při použití vzoru je následující: Ve stávající (neměnné) hierarchii tříd doplníme metodu accept() s argumentem instancí rozhraní Visitor do každé třídy. Abstraktní třída Tvar deklaruje metodu accept() jako abstraktní a její podtřídy ji pak implementují podle svých skutečných potřeb. Formální tvar je stejný, jen pseudoproměnná this je různá. 50

51 public double accept(visitor v) { return v.visit(this); Poznámky Podle počtu rozšiřujících metod, o které chceme rozšířit stávající hierarchii tříd, doplníme třídy implementující rozhraní Visitor. V našem případě se jedná o třídy VisitObsah a VisitObvod, protože chceme doplnit operace počítající obsah a obvod obrazců.

52 public class VisitObvod implements Visitor{ public double visit(kruh c) { return 2 * Math.PI * c.getpolomer(); public double visit(ctverec s){ return 4 * s.getstrana(); Poznámky Dále musíme vytvořit ve třídách VisitObsah a VisitObvod tolik metod visit(), kolik máme různých obrazců. Protože máme dva Protože máme dva obrazce (Square a Circle), stačí nám dvě metody visit().

53 Návštěvník - Visitor Jedna metoda visit() počítá obvod kruhu a druhá metoda visit počítá obsah kruhu. Pro větší názornost uvedeme celý kód jednoduchého příkladu: 53

54 public abstract class Tvar { public abstract void vykresli(); public abstract void smaz(); public abstract double accept(visitor v); Poznámky public class Kruh extends Tvar{ private int polomer; public Kruh() { polomer = 16; public double accept(visitor v) { return v.visit(this); public int getpolomer() { return polomer; public void vykresli() { System.out.println("Kruh.vykresli"); public void smaz() { System.out.println("Kruh.smaz");

55 public class Ctverec extends Tvar{ private int strana; public Ctverec() { strana = 12; public double accept(visitor v) { return v.visit(this); public int getstrana() { return strana; public void vykresli() { System.out.println("Ctverec.vykresli"); public void smaz() { System.out.println("Ctverec.smaz"); Poznámky public interface Visitor { public double visit(kruh c); public double visit(ctverec s);

56 public class VisitObsah implements Visitor{ public double visit(kruh c){ return Math.PI * c.getpolomer() * c.getpolomer(); public double visit(ctverec s){ return s.getstrana() * s.getstrana(); Poznámky public class VisitObvod implements Visitor{ public double visit(kruh c) { return 2 * Math.PI * c.getpolomer(); public double visit(ctverec s){ return 4 * s.getstrana(); return 4 * s.getstrana();

57 public class TvarTest { public static void main(string args[]) { VisitObsah visitobsah = new VisitObsah(); VisitObvod visitobvod = new VisitObvod(); List <Tvar>tvary = new ArrayList<Tvar>(); tvary.add(new Ctverec()); tvary.add(new Kruh()); tvary.add(new Kruh()); tvary.add(new Ctverec()); tvary.add(new Kruh()); Iterator<Tvar>itr = tvary.iterator(); while(itr.hasnext()) { Tvar s = itr.next(); s.vykresli(); s.smaz(); System.out.printf("Obsah obrazce: %s je: %.2f\n", s.getclass().getname(), s.accept(visitobsah)); System.out.printf("Obvod obrazce: %s je: %.2f\n", s.getclass().getname(), s.accept(visitobvod)); Poznámky

58 Ctverec.vykresli Ctverec.smaz Obsah obrazce: Ctverec je: 144,00 Obvod obrazce: Ctverec je: 48,00 Kruh.vykresli Kruh.smaz Obsah obrazce: Kruh je: 804,25 Obvod obrazce: Kruh je: 100,53 Kruh.vykresli Kruh.smaz Obsah obrazce: Kruh je: 804,25 Obvod obrazce: Kruh je: 100,53 Ctverec.vykresli Ctverec.smaz Obsah obrazce: Ctverec je: 144,00 Obsah obrazce: Ctverec je: 144,00 Obvod obrazce: Ctverec je: 48,00 Kruh.vykresli Kruh.smaz Obsah obrazce: Kruh je: 804,25 Obvod obrazce: Kruh je: 100,53 Poznámky

59 Shrnutí vzoru Návštěvník Je zřejmé, že můžeme zavést novou operaci (metodu) nad libovolnou strukturou, a to pouze dodáním nové třídy implementující rozhraní Visitor. Problém ale nastane, pokud rozšíříme stávající neměnnou strukturu tříd o další třídu. To však odporuje úvodnímu předpokladu, že struktura tříd je neměnná. 59