Tutorial 2: Schritt 1 – Java-DC anlegen,
lokal bauen, einchecken 
In diesem Schritt legt Entwickler 1 eine einfache Development-Component (DC) vom Typ Java an und veröffentlicht einige Klassen in einem Public Part (den Sie als eine DC-Schnittstelle bezeichnen könnten).
...
Voraussetzungen
· Sie haben das SAP NetWeaver Developer Studio gestartet.
· Sie haben eine Development-Configuration importiert.
Neue Development-Component (DC) und Activity anlegen
...
Sie befinden sich in der Perspektive Development Configuration in der View Inactive DCs.
1. Öffnen Sie den Knoten Ihrer SC Appl_dev.
2. Markieren Sie den Eintrag example.org_applicationund wählen Sie aus dem Kontextmenü Create new DC.
Sie sehen den Assistenten Development Component Project.
3. Geben Sie im Assistenten folgendes ein:
a. Vendor: example.org (wenn nötig)
b. Name:
i. (Präfix aus der Auswahlliste): appl
ii. (Texteingabe): tax/calc
c. Caption: Tax Calculator
d. Domain: Financial Services, wenn vorhanden.
e. Type: Java.
4. Wählen Sie Next.
Das Dialogfenster DTR Activity erscheint.
5. Um eine neue Activity anzulegen, wählen Sie New Activity...
Mit dieser Activity wird das Anlegen der Komponente im DTR aufgezeichnet.
6. Geben Sie New Java Component als Anzeigenamen der neuen Activity ein und wählen Sie OK.
Sie gelangen erneut auf das Dialogfenster DTR Activity. Ihre neue Activity ist markiert.
7. Wählen Sie Next.
Sie gelangen auf das Dialogfenster New Java Project.
8. Übernehmen Sie die vorgeschlagenen Einstellungen mit Finish.
Der Assistent legt nun die DC an. Die Perspektive Java öffnet sich automatisch und Sie sehen ein neues Projekt für Ihre Komponente in der View Package Explorer.
Package zur DC hinzufügen
Sie befinden sich in der Java Perspektive.
...
1. Wählen Sie die View Package Explorer.
2. Öffnen Sie den Projektknoten Ihrer Komponente und markieren Sie den Ordner src/packages.
3. Wählen Sie aus dem Kontextmenü New ® Package.
4. Geben Sie als Namen des neuen Java-Packages org.example.tax ein und wählen Sie Finish.
Interface zur DC hinzufügen
...
1. Markieren Sie das Package org.example.tax und wählen Sie aus dem Kontextmenü New ® Interface.
2. Geben Sie als Namen ITaxCalculator ein und wählen Sie Finish.
Sie gelangen auf ein Dialogfenster Add files to DTR.
3. Bestätigen Sie die Frage, ob die neue Datei zum Design Time Repository hinzugefügt werden soll, mit OK.
4. Markieren Sie Ihre Activity New Java Component und wählen Sie erneut OK.
Sie können für bestimmte Entwicklungsabschnitte eine Activity zur Default-Activity erklären. Alle Änderungen werden dabei automatisch zu dieser Activity hinzugefügt. Wählen Sie dazu in der View Open Activities im Kontextmenü einer Activity Use as Default. Um diese Option abzuschalten, wählen sie in derselben View im Kontextmenü des Workspaces Always Explicitly Select Activity. Wenn Sie z.B. eine neue DC anlegen, sollten Sie diese Option wählen oder eine neue Default-Activity auswählen, da Activities – auch – zum Gruppieren zusammengehöriger Dateiversionen dienen.
Sie sehen den Java-Editor für ITaxCalculator.
5. Fügen Sie folgendes Coding ein:
package org.example.tax;
public interface ITaxCalculator {
double calculateTax(double income);
}
6. Sichern Sie Ihre Eingaben.
Klassen zur DC hinzufügen
Sie befinden sich in der Java Perspektive in der View Package Explorer.
Klasse TaxCalculator hinzufügen
...
1. Markieren Sie das Package org.example.tax und wählen Sie aus dem Kontextmenü New ® Class.
2. Geben Sie als Namen TaxCalculator ein und wählen Sie Finish.
Sie sehen ein Dialogfenster.
3. Bestätigen Sie die Frage, ob die neue Datei zum DTR hinzugefügt werden soll, mit OK.
4. Markieren Sie die Activity New Java Component, wenn nötig, und wählen Sie erneut OK.
Wenn Sie diese zur Default-Activity erklärt haben, unterbleibt die Abfrage.
Sie sehen den Java-Editor für TaxCalculator.
5. Fügen Sie folgendes Coding ein:
package org.example.tax;
public class TaxCalculator implements
ITaxCalculator{
private double
rate = 0.5;
public double
calculateTax(double income) {
return
income*rate;
}
}
6. Sichern Sie Ihre Eingaben.
Klasse TaxFactory hinzufügen
...
1. Markieren Sie das Package org.example.tax und wählen Sie aus dem Kontextmenü New ® Class.
2. Geben Sie als Namen TaxFactory ein und wählen Sie Finish.
Sie sehen ein Dialogfenster.
3. Bestätigen Sie die Frage, ob die neue Datei zum DTR hinzugefügt werden soll, mit OK.
4. Markieren Sie die Activity New Java Component, wenn nötig und wählen Sie erneut OK.
Sie sehen den Java-Editor für TaxFactory.
5. Fügen Sie folgendes Coding ein:
package org.example.tax;
public class TaxFactory {
public static ITaxCalculator createInstance(){
return new TaxCalculator();
}
}
6. Sichern Sie Ihre Eingaben.
DC lokal bauen
Sie befinden sich in der Java Perspektive.
...
1. Wechseln Sie in die View Java DC Explorer.
2. Wählen Sie im Kontextmenü Ihrer DC Development Component ® Build...
Sie gelangen auf ein Dialogfenster Build Development Components.
3. Wählen Sie Ihren Projektknoten und bestätigen Sie mit OK.
Die Komponente wird kompiliert, aber es werden keine Archive angelegt, da die Komponente noch keine Public Parts hat.
Public Parts zur DC hinzufügen
Public Part api
Fügen Sie zur Komponente einen Public Part hinzu, der ITaxCalculator und TaxFactory veröffentlicht. Sie befinden sich in der Java Perspektive.
...
1. Navigieren Sie zur View Java DC Explorer.
2. Um einen Public Part hinzuzufügen, öffnen Sie Ihren DC-Knoten.
3. Öffnen Sie den Knoten DC MetaData.
4. Markieren Sie den Knoten Public Parts.
5. Wählen Sie aus dem Kontextmenü New Public Part...
Sie sehen ein Dialogfenster Add Public Part.
6. Geben Sie im Dialogfenster api als Namen des neuen Public Part ein.
7. Markieren Sie den Auswahlknopf Provides an API for developing/compiling other DCs.
Damit legen Sie einen Public Part an, gegen den andere Komponenten kompiliert werden können. Weitere Informationen zum Zweck von Public Parts finden Sie unter Verwendungszwecke von Public Parts.
8. Geben Sie als Caption API of the Tax Calculator ein.
9. Bestätigen Sie Ihre Änderungen mit Finish.
Sie sehen ein Dialogfenster.
10. Bestätigen Sie die Frage, ob die neue Datei zum DTR hinzugefügt werden soll, mit OK.
11. Markieren Sie die Activity New Java Component, wenn nötig und wählen Sie erneut OK.
Public-Part-Entities zum Public Part api hinzufügen
...
1. Öffnen Sie den Knoten Public Parts in der View Java DC Explorer.
Sie sehen einen neuen Eintrag namens api.
2. Wählen Sie api ® Entities und dann aus dem Kontextmenü Edit Entities...
Sie gelangen auf ein Dialogfenster Input Help: Entities.
3. Markieren Sie Java Class in dem Baum Select Entity Type und markieren Sie die Ankreuzfelder folgender Einträge in der hierarchischen Darstellung:
a. ITaxCalculator
b. TaxFactory.
4. Wählen Sie im Abschnitt Add Entity to Public Part den Eintrag as Class und bestätigen Sie mit Finish.
Damit werden ITaxCalculator und TaxFactory zum Public Part hinzugefügt.
DC lokal bauen
Sie befinden sich in der Java Perspektive in der View Java DC Explorer.
...
1. Wählen Sie im Kontextmenü Ihrer DC Development Component ® Build...
Sie gelangen auf ein Dialogfenster Build Development Components.
2. Wählen Sie Ihren Projektknoten (wenn nötig) und bestätigen Sie mit OK.
Für die gewählte DC wird ein Archiv angelegt.
Prüfen Sie dies nach: Folgen Sie dazu in der View Package Explorer folgendem Pfad: gen ® default ® public ® api ® lib ® java: Das Archiv heißt example.org~appl~tax~calc~api.jar.
Public Part tax
Sie befinden sich in der Java Perspektive in der View Java DC Explorer.
...
1. Um einen Public Part hinzuzufügen, öffnen Sie den Knoten DC MetaData und markieren Sie Public Parts.
2. Wählen Sie aus dem Kontextmenü New Public Part.
Sie gelangen auf ein Dialogfenster.
3. Geben Sie im Dialogfenster New Public Part als Name des neuen Public Part tax ein.
4. Markieren Sie den Auswahlknopf Can be packaged into other build results (e.g.SDAs).
Mit diesem Public Part wird ein Laufzeitarchiv assembliert, das einen vollständigen Satz Klassen enthält. Darüber hinaus wird dieser Public Part später dazu verwendet, diese Bibliothek in einer deploybaren J2EE-Bibliothek zu verpacken.
Den Verwendungszweck des Public Part können Sie in der View Properties sehen und ändern.
5. Geben Sie Tax Calculator Library als Caption ein.
6. Bestätigen Sie Ihre Änderungen mit Finish.
Sie sehen ein Dialogfenster.
7. Bestätigen Sie die Frage, ob die neue Datei zum DTR hinzugefügt werden soll, mit OK.
8. Markieren Sie die Activity New Java Component und wählen Sie erneut OK, wenn Sie keine Default-Activity verwenden.
Öffnen Sie den Knoten Public Parts in der View Java DC Explorer. Sie sehen nun zwei Public Parts: api und tax.
Public-Part-Entities zum Public Part tax hinzufügen
...
1. Markieren Sie den Entities-Knoten von tax und wählen Sie aus dem Kontextmenü Edit Entities...
Sie gelangen zu einem Assistenten.
2. Markieren Sie in der Liste Select Entity Type den Eintrag Java Package Tree.
3. Markieren Sie in dem Baum Select Entities den Eintrag org.
4. Wählen Sie im Abschnitt Add Entity to Public Part den Eintrag as Class.
5. Bestätigen Sie Ihre Eingaben mit Finish.
Damit wird der Package Tree zum Public Part hinzugefügt. Sie sehen nun die entsprechenden Einträge unter dem Knoten Entities.
DC lokal bauen
Sie befinden sich in der Java Perspektive.
...
1. Wählen Sie die View Java DC Explorer.
2. Wählen Sie im Kontextmenü Development Component ® Build...
Sie gelangen auf ein Dialogfenster Build Development Components.
3. Wählen Sie Ihren Projektknoten (wenn nötig) und bestätigen Sie mit OK.
Jetzt legt der Komponenten-Build zwei Archive an:
¡ example.org~appl~tax~calc~api.jar enthält die Klassen, gegen die andere Komponenten kompiliert werden können
¡ example.org~appl~tax~calc~tax.jar enthält alle Klassen, kann aber nicht für Component-Builds eingesetzt werden. Daher ist die Klasse TaxCalculator eine private Klasse für die Komponente.
Sie finden diese in der Java Perspektive in der View Package Explorer unter folgendem Pfad: Projektknoten ®gen ®default ® public ®
· api ® lib ® java ® api.jar
· tax ® lib ® java ® tax.jar
Activity einchecken
...
...
1. Wechseln Sie zur Perspektive Development Configuration.
Dort ist standardmäßig die View Open Activities enthalten. Sie sehen den Knoten Ihrer Development-Configuration.
2. Öffnen Sie den Knoten und den darunter liegenden Knoten des Workspace.
Sie sehen Ihre offenen Activities.
3. Markieren Sie in der View Open Activities die Activity New Java Component.
Sie können die View Open Activities auch anderen Perspektiven hinzufügen, um das Wechseln der Perspektive zu vermeiden.
4. Wählen Sie aus dem Kontextmenü Checkin.
Sie gelangen auf ein Dialogfenster.
5. Geben Sie bei Bedarf eine Beschreibung Ihrer Änderungen ein und bestätigen Sie mit OK.
Sie gelangen auf ein Dialogfenster Activation, das den sofortigen Build im CBS erlaubt.
6. Um Ihre DC erst späten zu bauen, wählen Sie Cancel.
Alle Änderungen werden im DTR-Server gesichert.