Überblick

Zum Generieren von Eclipse-Komponenten können Sie Lotus Expeditor Toolkit, eine Eclipse-integrierte Entwicklungsumgebung (IDE), oder Rational Application Developer verwenden. Verbundanwendungen, auf die über Notes zugegriffen wird, können Kombinationen von NSF-Komponenten und Eclipse-Komponenten enthalten. Diese Komponenten interagieren anschließend über die vom Eigenschaftsbroker unterstützte komponentenübergreifende Kommunikation.

Das Generieren einer Eclipse-Komponente umfasst Folgendes:

• Legen Sie die von der Komponente zu veröffentlichenden Eigenschaften fest.
• Legen Sie die Aktionen fest, die diese Komponente ausführen soll, wenn sie mit der Eigenschaft einer anderen Komponente verbunden ist.
• Erstellen Sie die WSDL-Datei, in der die Aktionen und Eigenschaften für die Komponente aufgelistet sind.
• Definieren Sie einen Erweiterungspunkt in Ihrem Plug-in (über die Datei PLUGIN.XML), in dem auf die WSDL verwiesen wird.
• Verwenden Sie die neuen Java(TM)-APIs des Eigenschaftsbrokers für Eigenschaften und Aktionen.
• Programmieren Sie Aktionen, die die in der Datei PLUGIN.XML definierten Schnittstellen implementieren. Die Klasse, die eine Aktion implementiert, muss im Erweiterungspunkt, auf den in der Datei PLUGIN.XML verwiesen wird, bereits definiert sein.
• Stellen Sie die Komponente bereit, indem Sie ein Projekt für die Aktualisierungssite erstellen oder aktualisieren. Dies ist ein Eclipse-Projekt und die Ausgabe dieses Projekts kann auf einem HTTP-Server oder in einem lokalem Ordner gehostet werden.

• Die Plug-ins müssen mithilfe einer Aktualisierungssite komprimiert werden.
• Die Aktualisierungssite kann entweder auf einem HTTP-Server (z. B. http://test.ibm.com/casample/site.xml) gehostet oder lokal zur Verfügung gestellt werden (z. B. file:/C:/test/casample/site.xml). Im zweiten Fall muss das Verzeichnis der Aktualisierungssite am gleichen Speicherort auf dem Computer des Benutzers verfügbar sein. Der zweite Fall wird in der Regel nur für Testzwecke verwendet.
• Die URL muss in der Datei CA.XML in der Eigenschaft url.feature festgelegt sein. Dies wird automatisch vom Composite Application Editor ausgeführt, wenn eine Komponente von einer Eclipse-Aktualisierungssite hinzugefügt wird.
• Wenn die Verbundanwendung zum ersten Mal in IBM® Lotus® Notes® geladen wird, erfolgt die Bereitstellung unter Verwendung der angegebenen URL. Die erforderlichen Plug-ins werden automatisch in die Ordner shared/eclipse heruntergeladen.

Es ist erforderlich, dass Sie Ihre Java(TM)-Plug-in-Komponenten erstellen und die Plug-ins anschließend mit einem Eclipse-Funktionsprojekt verknüpfen.
Anschließend müssen Sie ein Aktualisierungssite-Projekt erstellen bzw. aktualisieren. Dies ist ein Eclipse-Projekt und die Ausgabe dieses Projekts kann auf einem HTTP-Server gehostet werden. In der IBM Lotus Notes-Umgebung werden die Funktionen und Plug-ins über die Aktualisierungssite aktualisiert und bereitgestellt.

Sie können Eclipse-Komponente für die Verwendung in einer Verbundanwendung wie folgt entwickeln:

• Verwenden Sie eine Eclipse-IDE.
• Definieren Sie die Eigenschaften und Aktionen in einer .WSDL-Datei (eine XML-Datei).
• Definieren Sie als eine "extension" in der Datei PLUGIN.XML der Komponente die Klasse, die die Aktion implementiert, und den Link auf die .XML-Datei. Beispiel (siehe hervorgehobener Text):
  

  <plugin>

  <extension

           id="loadURLAction"

           name="Load A URL into Our Window"

           point="com.ibm.rcp.propertybroker.PropertyBrokerAction">

           <action

                 active="true"            

  class=

  "com.ibm.pvc.samples.propertybroker.browser.LoadURLAction"

                 file="loadurlaction.wsdl"/>

    </extension>

  ...

  </plugin>

Hinweis Weitere Informationen hierzu finden Sie in der Dokumentation zum IBM Lotus Expeditor-Toolkit.

import org.eclipse.core.commands.AbstractHandler;

import org.eclipse.core.commands.ExecutionEvent;

import com.ibm.rcp.propertybroker.event.*;

import com.ibm.rcp.propertybroker.property.*;

public class YourAction extends AbstractHandler {

public Object execute(ExecutionEvent arg0) throws ExecutionException {

Object event = arg0.getTrigger();

if (event instanceof PropertyChangeEvent){

PropertyChangeEvent e = (PropertyChangeEvent)event;

PropertyValue propValue = e.getPropertyValue();

if(propValue.getProperty().getType().equalsIgnoreCase("employeeName")) {

String employee = (String)propValue.getValue();

// do something

}

} return null; } }

import com.ibm.rcp.propertybroker.service.*;

...

String selectedEntry = ...;

PropertyBroker broker = PropertyBrokerFactory.getBroker();)

PropertyValue[] values = new PropertyValue[1];

SimpleProperty sProp = new SimpleProperty(selectedEntry);

Property property = broker.getProperty( "http://www.ibm.com/notes/pb/sample", "Subject");

values[0] = PropertyFactory.createPropertyValue(property, sProp);

broker.changedProperties(values);

Glossar