ADF BC ADF steht für Application Developer Framework, BC für Business Components. Um die ADF BC zu nutzen soll ein ADF Schema angelegt werden. Business Components können über die New Galary generiert werden. Die Generierung erfolgt dann anhand von Tabellen, welche innerhalb des Wizards ausgewählt werden können. (Categorie: Business Tier → ADF Business Components Items: Business Components from Tables) An dieser Stelle soll etwas von der Generierung abstand genommen werden. Über die New Galary soll ein Business Component Diagramm erstellt werden:

1

Ein leeres BC Diagramm wird geöffnet. Um die erstellten Tabellen als Grundlage zu verwenden kopiert man die Datenbanktabellen per drag & drop auf das noch leere Diagramm. Hierfür wird in den Connection Navigator gewechselt und die Tabellen, die verwendet werden sollen (im Beispiel Planet, Ring und Satellite), per Gruppenselect (CTRL-click) ausgewählt. Nun sollte der Create Tables Dialog erscheinen:

Die ausgewählten Objekte werden im Diagramm dargestellt:

Um diese Business Components zu testen kann in einem leeren Bereich des Diagramms das Popup-Menü der Maus eingeblendet werden: Generate → Default Data Model Components for Diagramm

2

Hierdurch gelangt man in den Wizard für Create Default Data Model Components.

Dadurch, dass kein Objekt den Fokus hatte und man Generate Default Data Model Components for Diagramm ausgewählt hat, selektiert der JDeveloper alle Objekte um Views und Links dafür zu erstellen.

3

Im 2.Schritt kann die Test-Applikation (hier TestGalaxy) definiert werden:

Im letzten Schritt, den man mit Weiter erreicht, wird einen Übersicht über die Views und Links erstellt, die man gerade erstellt hat. Dann Fertig stellen und speichern. Ein Ausschnitt aus dem Navigationsfenster zeigt die generierten Objekte, aufgelistet nach ihnen zugeordneten Packages:

Die erstellte Applikation TestGalaxy kann jetzt getestet werden. Im Applications Navigator ist von TestGalaxy das Popup-Menü zu öffnen und Test auszuwählen.

4

Zum Testen muß sich jetzt an die Datenbank angemeldet werden.

Nach der Anmeldung erscheint die Hauptseite des Oracle Business Component Browser mit Sicht auf die Views. Die Views können hier getestet werden. Es können Daten eingegeben, bearbeitet und gelöscht werden. Über die beiden Pfeile in der oberen, rechten Ecke des Browsers können diese Änderungen und Daten in die Datenbank übernommen werden.

5

Validation Auf dieser Ebene der Applikationsentwicklung können auch Validationrules definiert werden. Zu Unterscheiden sind built-in und custom Validations. Es gibt eine Vielzahl von bereitgestellten Gültigkeitsregeln (built-in) für Zeichenketten oder Zahlen (greater than, greater or equal than etc.). Kann eine Regel durch die built-in´s nicht abgedeckt werden, so ist es möglich selbst Regeln (java-Klassen) zu schreiben. Hierbei handelt es sich dann um die custom validation rules.

Built-in validation Aus dem BC-Diagramm heraus kann für jedes Attribut der Attribut-Editor, einfach durch Doppelklick auf dem jeweiligen Attribut, aufgerufen werden.

Hier können die Properties des Attributs verändert werden. Durch Auswahl der Validation kann man die definierten Validationrules des Attributs einsehen oder neue Validationrules definieren.

6

Für das ausgewählte Attribut gibt es noch keine Validation-Rules. Für ein Attribut können mehrere Gesetzmässigkeiten definiert werden. Durch die Auswahl von New kann eine neue Validationrule angegeben werden:

Die Density soll immer einen Wert >= 1 besitzen.

7

Mit OK kommt man in das vorherige Fenster zurück. Wären hier jetzt mehrere Rules definiert so könnte eines ausgewählt werden.

Diese neue Gesetzmässigkeit, die für das Attribut jetzt aktiviert ist, kann in der Testumgebung der Applikation getestet werden. Hierfür ist im Applications Navigator von TestGalaxy das Popup-Menü zu öffnen und Test auszuwählen.

8

Custom validation Um für unsere Business Components nun selbstdefinierte Regeln zu erstellen, geht man in die Project Properties, welche über das Popup-Menü über dem Projektknoten (Model) erreichbar sind. Man spricht von selbstdefinierten Regeln, wenn sie in der Logik aufwendiger sind und nicht über die Datenbank angeboten werden. Diese Art der Regeln sind unabhängig von einem Attribut definiert, sie können also für mehrere Attribute übernommen werden. Daher macht es auch Sinn, diese Regeln in einem separaten Package zu speichern, damit es von anderen Applikationen importiert werden kann.

Um eine neue Regel anzulegen ist nun New auszuwählen. Die neue Regel wird als Java-Klasse erstellt. Man gibt den Namen der Klasse und das zugehörige Package an. Über das Extends kann noch eine zu beerbende Klasse angegeben werden.

9

Mit dem OK, wird ein Java-Klassengerüst erstellt. Im Editor-Window wird der Sourcecode der generierten Klasse angezeigt, im Structure-Window werden die bereits generierten Methoden und Attribute aufgelistet. Diese Klasse besitzt noch keine Logik. Es gibt einen leeren Default-Konstruktor, get()- u. set()- Methoden und Methoden zur Validierung von Exceptions. Die Methode ValidateValue() ist generiert, besitzt aber durch das return true nicht wirklich eine Logik, die von Bedeutung wäre.

/**Return true if value is valid */

public boolean validateValue(Object value) { return true;

} Der Rumpf der Methode soll nun folgendermassen aussehen:

/**Return true if value is valid */ public boolean validateValue(Object value) {

boolean returnVal; if (value.toString().length() < maxLength) {

returnVal=true; } else {

returnVal=false; } return returnVal;

}

Diese neue Validationrule kann nun für ein oder mehrere Attribute Anwendung finden. Aus dem Business Component Diagramm heraus kann für jedes Attribut der Attribut-Editor geöffnet werden, siehe Built In Validation. Im Attribut Editor ist auf den Validation-Node zu wechseln um mit New eine neue Valiationrule für das Attribut anzulegen. Aus der DropDownListBox ist dann die erstellte ValidationRule auszuwählen. Auch diese Gesetzmässigkeit kann nun über die TestGalaxy Applikation getestet werden.

10

Views Für das UserInterface können vorab Views erzeugt werden, welche letztendlich die SQL-Statements für die Webpages abbilden können. Mit Hilfe des Business Component Diagramms können Views sehr einfach per drag & drop erzeugt werden, indem ein View Object von der Component Palette auf einen freien Platz in das BC-Diagramm gezogen wird. Die Bezugsobjekte können dann ebenfalls per drag & drop innerhalb der View platziert werden. In unserem Fall sind die Bezugsobjekte im Applications Navigator unter Model → Application Sources im Package galaxy.model.businessdomain zu finden. Per drag & drop können nun z.B. Planet und Satellite in die View gezogen werden.

Im View Object Editor stellt sich das Ganze wie folgt da: Planet und Satellite sind durch das drag & drop bereits vorselektiert.

11

Unter dem Knotenpunkt Attributes können nun Attribute aus den zuvor selektierten Objekten ausgewählt werden:

Hinter dem kleinen + verstecken sind noch die Attribute und deren Properties:

12

Hinter dem Knotenpunkt SQL Statement ist das resultierende Statement zu finden.

13

Durch die zuvor ausgewählten Entity Objects, welche durch drag & drop in die View gelangt sind, und durch die Selektion der Attribute ist das SQL-Statement generiert worden. Mit Hilfe der Option Expert Mode, welche hier unten links angeklickt werden kann, ist es möglich das Statement manuell zu erstellen oder zu verändern. Mit Hilfe des Test-Buttons kann sichergetellt werden, dass das Statement syntaktisch korrekt ist. Um diese View zu testen kann sie nun in die TestGalaxy Applikation gebracht werden. Hierfür ist aus dem Popup-Menü der TestGalaxy Applikation Edit TestGalaxy… auszuwählen. Unter Data Model kann nun unter den verfügbaren Views die neu erstellte Views dem Data Model hinzugefügt werden.

Nachdem die View hinzugefügt wurde und dies mit OK bestätigt wurde kann nun die Applikation getestet werden.

14

View Link Relationships zwischen den Query-Result-Sets werdend durch Definition von View Links repräsentiert. Mit der Definition einer View Link erzeugt der JDeveloper einen parametrisierten SQL Ausdruck, auch View Link SQL genannt. Der View Link SQL Ausdruck beeinhaltet eine Bind-Variable für jedes Attribut um die Verbindung der korrespondierenden Attribute der Relationship zu verbinden. Die ADF BC´s verwenden den View Link SQL Ausdruck um eine Zeile der Ursprungsview mit einer oder mehreren Zeilen der Korrespondierenden View zu verbinden. Zu unterscheiden sind:

1. one-to-many, uni-directional view link Definitionen und 2. many-to-many, bi-directional view link Definitionen

one-to-many, uni-directional view link Zunächst werden eine PlanetView und eine SatelliteView benötigt. Aus der Component Palette ist dann das Objekt View Link auszuwählen. Dieser View Link wird dann mit der Maus von Planet zu Satellite gezogen.

Der View Link wird der TestGalaxy Applikation hinzugefügt und kann getestet werden.

15

many-to-many, bi-directional view link Die Vorgehensweise für einen bi-direktionalen View ist ähnlich dem uni-direktionalem View. Im BC-Diagramm kann die Kardinalität des View Links geändert werden, indem mit der Maus die 1 selektiert wird und gegen ein * ausgetauscht wird.

Für dieses Beispiel ist es allerdings nicht sinnvoll. Eine andere Möglichkeit die Kardinalität des View Links zu ändern sind die View Link Properties, welche über das Popup-Menü des View Links zu erreichen ist.

16

Über diese Properties kann auch der SQL-Ausdruck verändert werden und neue o. andere Bindparameter gesetzt werden.

17

JSP

Simple JSP Application Anhand der ADF BC´s soll nun eine JSP Applikation erstellt werden. Zunächst soll eine JSF Navigation erstellt werden. Hierfür ist aus dem Popup-Menü des ViewController´s Open JSF Navigation auszuwählen.

Im Editor-Window erscheint ein leere Page Flow Diagramm. Aus der Component Palette ist nun JSF Page auszuwählen und per drag & drop auf das Diagramm zu ziehen. Für die neue Seite kann jetzt ein Name vergeben werden. Per Doppelklick gelangt man dann in den Create JSP Wizard. Hinweis: Sollte eine Funktionalität mal nicht zur Verfügung stehen,

so ist sie dem Projekt hinzuzufügen. Im selben Popup-Menü kann unter Project Properties dies getan werden. In den Project Properties gibt es einen Knoten Technologie Scope, wo verfügbare und ausgewählte Technologien für das Projekt verwaltet werden. Sind also z.B. Struts gewünscht und nicht ausgewählt, so ist es möglich es dem Projekt hier hinzuzufügen. Auf diese Weise kann man, unabhängig von den Anfangs gewählten Projekteinstellungen, sein Projekt neu einrichten.

18

19

20

Mit dem letzten Weiter kommt dann noch eine Fertigstellungsmeldung, die nicht weiter von Bedeutung ist. Per drag & drop soll nun aus der Data Control Palette eine View ausgewählt werden und auf der leeren Page platziert werden. Aus der drag & drop dropdown Liste ist dann ADF Read-Only Form auszuwählen:

Hinweis: Eine Read-Only Form beschreibt die Information einer Zeile aus der View. Über die Edit Form Fields können jetzt noch die Attribute ausgewählt werden, welche in der Seite angezeigt werden sollen, was über ein Multiselect möglich ist. Hier können auch die Labels „neu“ gesetzt werden

21

Selbst das ADF Variablen Binding und die UI Komponenten können neu gesetzt werden. Wählt man Include Navigation Controls an, so werden die Control-Buttons (First, Last, Previous und Next) für die Navigation durch die Datensätze mit erstellt. Die generierte Seite sieht in der Design-View dann wie folgt aus:

Durch den Test der Seite, möglich über das Popup-Menü durch Auswahl von Run sieht das Ganze dann wie folgt aus:

22

Master Detail Applikation Die Schritte sind ähnlich derer, die eben für eine einfache Seite dargelegt wurden. Für eine Master Detail Seite braucht man abhängige View. In unserem Datenmodell hängt alles von Planet ab, so ist der Master zunächst einmal eine Planet View.

Aus der Data Control Palette kann nun unter den abhängigen View gewählt werden:

Diese View wird per drag&drop unterhalb der PlanetView (unterhalb des blau eingegrenzten Bereiches) gezogen. Aus dem drag&drop Menü wird nun ADF Read-only-Table ausgewählt, da zum Master ja alle abhängigen Daten angezeigt werden sollen:

23

Im Design sieht es dann wie folgt aus. Die Spalte Planet wurde hierbei gelöscht, da sie ja bereits über den Master angezeigt wird.

Der resultierende Applikationsausschnitt sieht dann wie folgt aus:

Die abhängigen Daten werden über das Binding (in der Data Control Palette über die untergeordneten Views) mit gesteuert. Die Gestaltung von Search Pages oder Creation Pages läuft ist vergleichbar. Aus dem Popup-Menü des drag&drop-Vorgangs ist dann entsprechend ADF Search Form oder ADF Creation Form auszuwählen.

24