UTOPP-Dokumentation. Harald Borsutzky Burghard Grüter Wolfram Urich Carsten Keßler Christoph Pohlmann Dominik Wilmsen Eugen Scheinke

Transkript

1 UTOPP-Dkumentatin Harald Brsutzky Burghard Grüter Wlfram Urich Carsten Keßler Christph Phlmann Dminik Wilmsen Eugen Scheinke

2 Inhalt:!"Prduktbeschreibung...S. 2!"Pflichtenheft...S. 3!"Prdukteinsatz...S. 3!"Prduktumgebung...S. 3!"Prduktinfrmatinen...S. 3!"Use-Cases S. 3!"Beispieldialge (Entwürfe)......S. 10!"Klassendiagramme...S. 13!"Qualitätsziele...S. 23!"Testszenarien...S. 23!"Entwicklungsumgebung...S. 25!"Kurzmanual...S. 25!"Screenshts...S. 26 Kurze Prduktbeschreibung Wir wllen ein UML-Mdellierungstl entwickeln, dass dem User den möglichst kmfrtablen Entwurf vn Klassen- und Use-Case-Diagrammen ermöglichen sll. Dabei sll das Prgramm über Eingabemasken die erfrderlichen Angaben vm Benutzer abfragen und aus diesen Angaben dann das jeweilige Diagramm als grafisches Objekt erzeugen. 2

3 Pflichtenheft!"Mußkriterien Utpp sll aus Angaben des Users Klassen- und Use-Case- Diagramme erzeugen. Alle erstellten Diagramm swie die dazugehörigen Daten sllen abgespeichert werden können.!"wunschkriterien Die Benutzerberfläche sllte möglichst User-freundlich sein. Außerdem wäre eine Speicherung im XML-Frmat schön, um die Daten auch außerhalb des Prgramms anzeigen zu können.!"abgrenzungskriterien Das Prgramm sll keinen autmatische Surcecde-Erzeugung enthalten. Es sll keine Multi-User-Anwendung werden sndern auf einen Arbeitsplatz beschränkt bleiben. Prdukteinsatz:!"Anwendungsbereiche Sftwarmdellierung und entwicklung mit Hilfe der UML.!"Zielgruppen Mehr der weniger erfahrene Prgrammierer, die mit der UML ihre Sftwaremdelle entwerfen und ein Werkzeug zum schnellen zusammenklicken der UML- Kmpnenten zur Verfügung haben wllen. Prduktumgebung:!"Sftware!"Hardware Java Runtime Envirnment PC Prduktinfrmatinen : Use-Cases : 0, Editieren Akteure : Use-Case 1 bzw. 2 Ablauf : - Klick auf 'editieren' - Eingabemaske erscheint ( aktuelle Daten werden abgefragt ) - Felder : Steretyp Paket Klassenname Attribute ( Datentypen, Sichtbarkeit, Initiatialwert ) Operatinen (Sichtbarkeit, Datentypen) - User füllt Felder aus klickt auf 'k' in der Eingabemaske Nachbedingungen : Daten werden zurückgeliefert 3

4 1, Anlegen einer Klasse Akteure : Benutzer Ablauf : - Benutzer klickt auf 'neue Klasse' - Use-Case 0 wird gestartet - Falls Daten krrekt wird neues Objekt angelegt Nachbedingung : Neues Objekt wird angelegt Vrbedingung : Objekt nch nicht vrhanden 2, Klasse editieren Akteure : Benutzer Ablauf : - Benutzer klickt auf 'editiere Klasse' - Use-Case 0 erhält vrhandene Daten - Benutzer ändert Daten - Use-Case 0 gibt Daten zurück - Falls Daten krrekt wird Objekt geändert und gespeichert Nachbedingung : Objekt ist geändert Vrbedingung : Klasse vrhanden 3, Klasse löschen Akteure: Benutzer Ablauf: - Benutzer klickt auf Klasse löschen - - Sicherheitsabfrage erscheint: wirklich löschen? - - Wenn Ja, Klasse löschen und alle Assziatinen, mit denen die Klasse zusammenhängt, löschen (Aufruf vn Use-Case 7); snst Abbruch des Use-Cases Nachbedingung: Klasse ist gelöscht 4, Assziatinsdaten erfassen 4

5 Akteur: Use-Cases 5 und 6 Ablauf: Eingabemaske erscheint, zur Auswahl: Assziatin zwischen 2 der mehr als 2 Klassen Eingabemaske für Assziatin zwischen 2 Klassen: Klasse 1 Rlle Klasse 1 Multiplizität Klasse 1 Klasse 2 Rlle Klasse 2 Multiplizität Klasse 2 Assziatinstyp: zur Auswahl stehen: - Vererbung - Gerichtete Assziatin - Abgeleitete Assziatin - Qualifizierte Assziatin - Gerdnete Assziatin - Verfeinerung - Abhängigkeit - Kmpsitin - Aggregatin - Mehrgliedrige Assziatin Beschriftung der Assziatin Eingabemaske für Assziatinen zwischen mehr als 2 Klassen: Klassenliste wird angezeigt Buttn hinzufügen, um Klassen aus der Liste in die Assziatin aufzunehmen 5

6 Für jede hinzugefügte Klasse werden Rlle und Multiplizität erfragt Nachbedingung: Daten werden zurückgeliefert 5, Anlegen einer Assziatin Akteur: Benutzer Ablauf: - Benutzer klickt auf neue Assziatin - Use-case 4 wird aufgerufen - Falls die Daten krrekt sind, wird ein neues Objekt angelegt Vrbedingungen: Es ist nch keine Assziatin zwischen den beteiligten Klassen vrhanden Nachbedingungen: Assziatin wurde angelegt 6, Assziatin editieren Akteur: Benutzer Ablauf: - Benutzer klickt auf Assziatin editieren - Use-Case 4 wird aufgerufen, dabei wird die Änderung der beteiligten Klassen deaktiviert (hierzu muss die Assziatin gelöscht werden und eine neue angelegt werden) Nachbedingungen: Assziatin wurde mit Änderungen gespeichert 7, Assziatin löschen Akteur: Benutzer der Use-Case 3 6

7 Ablauf: - Benutzer klickt auf Assziatin löschen - Sicherheitsabfrage erscheint: Wirklich löschen? - Wenn Ja wird die Assziatin gelöscht, snst Abbruch des Use-Cases Nachbedingung: Assziatin gelöscht 8, Use-Case Daten erfassen Akteur: Use Case 9 bzw. 10 Ablauf: Eingabemaske erscheint mit flgenden Eingabefeldern: Name Akteur Ablauf Vrbedingungen Nachbedingungen Invarianten Fehler Dialgbeispiel Nicht-funktinale Anwendungsanfrderungen Variatinen Ansprechpartner Regeln Services [ Wunsch: Beziehungen zu anderen Use-Cases definieren ] Nach Ausfüllen der gewünschten Felder (hier müssen nicht alle Felder ausgefüllt werden, nur der Name muss eingegeben werden) schließt der Benutzer die Eingabe mit Klick auf Okay ab. 7

8 Nachbedingungen: Daten wurden zurückgegeben 9, Use-Case anlegen Akteur: Benutzer Ablauf: - Benutzer klickt auf neuer Use-Case - Use-Case 8 wird aufgerufen - Neuer Use-Case wird mit den übergebenen Daten angelegt und gespeichert Nachbedingung: Use-Case ist gespeichert 10, Use-Case ändern Akteur: Benutzer Ablauf: - Benutzer klickt auf Use-Case ändern - Use-Case 8 wird aufgerufen, dabei werden die aktuellen Angaben zum Use- Case angezeigt - Benutzer ändert die Angaben seinen Wünschen gemäss - Use-Case wird mit den geänderten, vn Use-Case 8 zurückgegebenen Daten gespeichert Vrbedingung: Zu bearbeitender Use-Case exisitiert bereits Nachbedingungen: geänderter Use-Case wird abgespeichert 11, Use-Case löschen Akteur: Benutzer Ablauf: 8

9 - Benutzer klickt Use-Case löschen - Sicherheitsabfrage erscheint: wirklich löschen? - Bei Ja wird der Use-Case gelöscht, snst Abbruch Vrbedingung: Use-Case existiert bereits Nachbedingung: Use-Case ist gelöscht 12, Pflichtenheftdaten editieren Akteur: Benutzer, Use-Case 13 Ablauf: Eingabemaske erscheint, in der entweder die aktuellen Daten der (beim Anlegen eines neuen Prjekts) Default-Werte angezeigt werden: Zielbestimmung Prdukteinsatz Prduktumgebung Prduktleistungen Qualitätsziele Testfälle / -szenarien Use-Cases (nur namentlich anzugeben) Entwicklungsumgebung Ergänzungen [ Wunsch: GUI-Entwurf ] Dabei werden für alle hier aufgeführten Punkte (und deren Unterpunkte nach dem Pflichtenheft- Schema wie auf der Website zum PrPra hier der Einfachheit halber weggelassen) Textfelder zur Eingabe aufgeführt. Ein neues Pflichtenheft wird autmatisch angelegt, sbald der Benutzer ein neues Prjekt anlegt, daher haben wir für diese Aktin keinen eigenen Use-Case mdelliert. Nachbedingung: geändertes Pflichtenheft ist gespeichert 13, neues Prjekt anlegen Akteur: Benutzer 9

10 Ablauf: - Benutzer klickt auf neues Prjekt starten - Eventuell nch geöffnetes Prjekt wird gespeichert und geschlssen (es kann als nur 1 Prjekt zur gleichen Zeit geöffnet sein) - Der Name für das neue Prjekt wird erfragt - Hat der Benutzer die Namenseingabe beendet, wird geprüft, b es schn ein Prjekt mit gleichem Namen gibt. - Falls ja, wird der Benutzer zur Änderung aufgefrdert - Snst: Pflichtenheft wird angelegt und Use-Case 12 wird aufgerufen - Manager für Klassenliste, Use-Case Liste und Assziatinsliste werden angelegt Nachbedingung: Prjekt ist angelegt Entwürfe für die Eingabedialge Diese Dialge haben wir vr dem implementieren entwrfen und dann versucht, sie möglichst gut in Java nachzubauen. Eingabedialg für Assziatinen: 10

11 Eingabedialg für Assziatinen mit mehr als 2 Beteiligten: Eingabedialg zum anlegen einer neuen Klasse: Eingabedialg zum anlegen der zur Klasse gehörenden Attribute: 11

12 Eingabedialg zum anlegen der zur Klasse gehörenden Methden: Eingabedialg zum anlegen der zur Methde gehörenden Parameter: Eingabedialg für das Pflichtenheft: 12

13 Eingabedialg für das Pflichtenheft (2): Klassendiagramme Zunächst die Klassendiagramme, wie wir sie vr dem Implementieren entwrfen hatten. 13

14 14

15 15

16 Da wir jedch beim implemtieren festgestellt haben, daß wir mit diesem Mdell nicht sehr weit kmmen werden, haben wir es bei Bedarf (als ziemlich häufig) erweitert, s daß schließlich das unsere letzte Versin des Prgramms auf dem flgenden Mdell basiert: 16

17 Da in dieser Gesamtübersicht nicht viel zu erkennen ist, sind nachflgend nchmal die zentralen Ausschnitte unseres Mdells einzeln dargestellt: 17

18 Sämtliche Objekte werden in unserem Prjekt in Listen gespeichert, die alle vn der UmlObjectListe erben. 18

19 Alle Elemente der Uml swie unser UmlPrject sind vn einer Klasse UmlObject abgeleitet. 19

20 Verbungsdiagramme 20

21 21

22 22

23 Qualitätsziele Ziel Funktinalität Zuverlässigkeit Benutzbarkeit Effizienz Änderbarkeit x x x x x Testszenarien Neues Prjekt anlegen: /T00/Aktin: Der Nutzer drückt die Taste Datei \ neues Prjekt. Ein Fester für den Namen des Prjekts wird angezeigt. Den Namen eingeben und bestätigen. Auswirkung: Ein neues Prjekt wird angelegt Pflichtenheft bearbeiten: /T11/Aktin: Der Nutzer macht flgende Eingaben: Zielbestimmungen, Prdukteinsatz, Prduktumgebung, Prduktleistungen usw. Nach der Eingabe wird die Taste Apply nicht betätigt. Auswirkung: Nach dem Abspeichern des ganzen Prjektes werden die Eingaben mit abgespeichert UseCase erstellen/bearbeiten: /T20/Aktin: Der Nutzer versucht 2UseCases mit gleichem Namen anzulegen: Die Taste Neu wird gedrückt und der Name (z.b. Licht aus), die Vrbedingung usw. eingegeben. Die Taste Neu wird zum zweiten Mal gedrückt und der selbe Name eingegeben. Auswirkung: Es wird ein zweiter UseCase mit dem gleichen Namen erstellt /T21/Aktin: Löschen eines UseCases: Der Nutzer markiert den zu löschenden UseCase und drückt die Taste löschen und bestätigt die Sicherheitsabfrage. Auswirkung: Der UseCase wird gelöscht und aus der Liste entfernt. /T22/Aktin: Löschen eines nicht existierenden UseCases: Der Nutzer drückt die Taste löschen und bestätigt die Sicherheitsabfrage. Auswirkung: keine 23

24 Klasse erstellen/ bearbeiten: /T30/Aktin: Anlegen einer neuen Klasse mit mehreren Methden und Attributen: Der Nutzer drückt die Taste Neu. Unter dem Menü Allgemein kann der Name, Steretyp, Zusicherung usw. eingegeben werden. (z.b. Name:Klasse1, Steretyp: Interface, Sichtbarkeit: private) Im Menü Attribute bzw. Methden können analg neue Attribute bzw. Methden erstellt werden. Auswirkung: Neue Klasse mit dem Namen Klasse1, Steretyp: Interface, Sichtbarkeit: private wird erstellt. Dabei ist die Reihenflge der Eingaben entscheidend: wirt zuerst Steretyp: Interface, Sichtbarkeit: private und erst dann der Name eingegeben, s wird auch nach dem drücken der Apply Taste, der Name nicht aktualisiert. Es lassen sich auch mehrere gleiche Methden und Attribute erstellen. /T31/Aktin: Bearbeiten einer Klasse: Der Nutzer ändert flgende Angaben: Name, Steretyp, Zusicherung, Parameter usw. z.b. Name:Klasse1 in Klasse2, Steretyp: abstrakte Klasse, Sichtbarkeit: private in public) im Menü Attribute bzw. Methden können analg neue Attribute bzw. Methden erstellt werden. Auswirkung: Neue Klasse mit dem Namen Klasse1, Steretyp: Interface, Sichtbarkeit: private wird erstellt. Dabei ist wie in T30 die Reihenflge der Eingaben entscheidend: wirt zuerst Steretyp: Interface, Sichtbarkeit und erst dann der Name geändert, s wird auch nach dem drücken der Apply Taste, der Name nicht aktualisiert. Die Parameter lassen sich nach den ersten Anlegen nicht mehr ändern. /T32/Aktin: löschen einer Klasse: Der Nutzer drückt die Taste löschen und bestätigt die Sicherheitsabfrage. Auswirkung: Neue Klasse wird gelöscht und aus der Liste entfernt. Assziatin erstellen/bearbeiten: /T40/ Aktin: erstellen bzw. bearbeiten einer Assziatin: Die Vrgehensweise ist analg zum erstellen/ bearbeiten einer Klasse. Auswirkung: keine besnderen Vrkmmnisse Prjekt speichern: /T50/ Aktin: Abspeichern eines Prjektes: der Nutzer drückt die Taste Datei/Prjekt speichern unter, und gibt den Namen unter dem das Prjekt gespeichert werden sll. Auswirkung: Das Prjekt wird unter dem eingegebenen Namen gespeichert. /T51/ Aktin: überschreiben eines abgespeicherten Prjektes: der Nutzer drückt die Taste Datei/Prjekt speichern. Auswirkung: Das Prjekt wird nicht überschrieben. Prjekt öffnen: /T60/Aktin: öffnen eines Prjektes: der Nutzer drückt die Taste Datei/Prjekt öffnen, und sucht sich das Prjekt welches geöffnet werden sll. Auswirkung: Das Prjekt wird geöffnet. 24

25 Entwicklungsumgebung Sftware: Arg-UML swie OEW-Demversin zur Mdellierung, Brland JBuilder Fundatin (freie Versin) swie evtl. Kawa zur Implementierung Hardware: PCs Orgware: - Schnittstellen: - Manual Vrwrt Das Prgramm UTOPP vn Greenhrn Ltd. dient zur Mdellierung vn Prgrammen mit Hilfe der Unified Mdelling Language (UML). Diese besteht aus unterschiedlichen Diagrammen, die ihrerseits verschiedene graphische Kmpnenten besitzen. Ihre Bedeutung ist dabei eindeutig festgelegt. Das Prjekt (Teil I) Zur Mdellierung eines Prgramms werden alle erfrderlichen Daten in einem Prjekt zusammengefaßt. Diese bestehen aus dem Pflichtenheft, den Assziatinen, den Klassen und den Use-Cases (Anwendungsfällen), wbei die letzen drei als Diagramm dargestellt werden können. Das Pflichtenheft Nach Eingabe der erfrderlichen Daten muß der Apply-Buttn gedrückt werden, um die Einträge zu sichern. Die Assziatinen Im linken Teil des Fensters befindet sich ein Kntextfeld in welchem die Ass-ziatinen angezeigt werden. Durch Markieren einer Assziatin erscheinen die zugehörigen Daten autmatsich in der Eingabemaske w sie nach Belieben editiert werden können. Der Neu-Buttn dient zum Anlegen (Trmmemwirbel!) einer neuen Assziatin. Anstatt des Knpfdrucks kann auch im Kntextfeld die rechte Maustaste gedrückt werden, wdurch zusätzlich in einem Ppup-Menü die Einträge Löschen, Zu Multiassziatin und Zu Binärassziatin erscheinen. Wie der Name schn sagt kann man hier zwischen Binär- und Multiassziatin wählen. Auf ähnliche Weise erflgt die Eingabe und Übernahme der Rllen. Zum Speichern ist wiederum der Apply-Buttn zu betätigen. 25

26 Die Klassen Die Benutzung des Eingabedialgs erflgt analg zu der der Assziatinen. Die Use-Cases Auch die Bedienung des Use-Case-Eingabedialgs gleicht der der Assziatinen. Das Diagramm Nachdem man ein neues Diagramm angelegt der einer altes geladen hat werden mit den sich im beren Bildschirmbereich befindlichen Auswahlmenüs die zuvr erstellten UML-Objekte ausgewählt und anschließend angezeigt. Um ein Diagramm zu löschen klickt man mit dem rechten Mausknpf das entsprechende Objekt an und bestätigt das daraufhin erscheinende Kntextmenü Aus Diagramm entfernen durch Betätigen des linken Mausknpfes. Das Prjekt (Teil II) Zu guter Letzt müssen die Daten nch gespeichert werden; dies erreicht man indem man im Hauptfenster Datei anklickt und drt mit Prjekt speicher (unter) das Prjekt sichert. Screenshts Screenshts der wichtigsten Elemente der letzten Versin unseres Prgramms. 26

27 27

28 28

29 29