Rational Developer for System z

Listen der Kategorien, Eigenschaften und Kategorieinstanzen abrufen

Dieses Beispiel veranschaulicht, wie die Liste der registrierten Kategorien und Eigenschaften programmgesteuert abgerufen wird. Derzeit können die Namen der registrierten Kategorien und Eigenschaften abgerufen werden. Für jede Kategorie kann die Instanz abgerufen werden und die Eigenschaftswerte in jeder Instanz können abgerufen werden.

Beispielszenario

Wenn Sie Informationen zu den Kategorien, Eigenschaften und Instanzen abrufen möchten, wählen Sie die Aktion API-Beispiele > Informationen zu Eigenschaften aus.

Für jede registrierte Kategorie werden der Name, die enthaltenen Eigenschaften und alle Instanzen in der der Workbench zugeordneten Standardausgabe angezeigt. Diese können Sie in dem DOS-Fenster, von dem aus die Workbench gestartet wurde, oder bei Verwendung der Laufzeitworkbench in der Ansicht 'Konsole' der Host-Workbench sehen.

Anmerkung: Je nach den Laufzeiteinstellungen für die Workbench wird die Standardausgabe für eine mit dem Eclipse-Standardsymbol gestartete Workbench möglicherweise nicht angezeigt.

Bildmaterial für listPropertiesResults

Erläuterung des Beispielcodes

Registrierte Kategorien abrufen

Das folgende Codefragment aus der Klasse ListPropertiesAction veranschaulicht, wie die registrierten Kategorien abgerufen werden:
  
ZOSPropertyGroupManager manager = ZOSPropertyGroupManager.getZOSPropertyGroupManager();
// Retrieve registered categories
List<ICategory> categories = manager.getCategories();

Zu Beginn wird die mithilfe der Methode getZOSPropertyGroupManager der Klasse ZOSPropertyGroupManager abgerufene Klasse ZOSPropertyGroupManager verwendet, um die ICategory-Objekte abzurufen, die die registrierten Kategorien darstellen. Die registrierten Kategorien können auch mithilfe der Klasse (LocalPropertyGroupManager) abgerufen werden, da beide Manager denselben Eclipse-Erweiterungspunkt nutzen, um Eigenschaften zu registrieren.

Kategorieobjekte verwenden

Das folgende Codefragment aus der Klasse ListPropertiesAction veranschaulicht, wie ICategory-Objekte verwendet werden:
 
for (ICategory category : categories) {
  System.out.println("---------------");
  System.out.println("Category: " + category.getName());
  // Retrieve registered properties for this category.
  List<IPropertyInfo> infos = category.getPropertyInformation();
  for (IPropertyInfo info : infos) {
    System.out.println("  Property: " + info.getName());
  }
  // Retrieve category instances for each registered category, and print
  // the properties and values for each instance.
  List<ICategoryInstance> instances = category.getInstances();
  for (ICategoryInstance instance : instances) {
    System.out.println("  Instance: ");
    List<IProperty> properties = instance.getProperties();
    for (IProperty property : properties) {
    System.out.println("    ----");
    System.out.println("    Property name: " + property.getName());
    System.out.println("    Property value: " + property.getValue());
  }
}

Jede Kategorie hat einen Namen und ermöglicht das Abrufen von IPropertyInfo-Objekten, die die Namen der für die Kategorie registrierten Eigenschaften enthalten.

Jede Kategorie ermöglicht das Abrufen von ICategoryInstance-Objekten, die Eigenschaftswerte enthalten. Schließlich enthalten die von einem ICategoryInstance-Objekt abgerufenen IProperty-Objekte den Namen der Eigenschaft und den Eigenschaftswert.

Der Menüpunkt wird der Workbench über ein Eclipse-Aktionsset hinzugefügt:
  <extension
         id="com.ibm.ftt.api.samples.actionSets"
         name="%apiSample.actionSets"
         point="org.eclipse.ui.actionSets">
      <actionSet label="com.ibm.ftt.api.samples.actionSet1"
            description="Action set for the API samples"
            visible="true"
            id="com.ibm.ftt.api.samples.actionSet1">
         <menu label="%apiMenu.title"
               id="com.ibm.ftt.api.samples.apiMenu">
            <separator name="com.ibm.ftt.api.samples.apiMenu.resourcesAPI"/>
         </menu>
         <action label="%apiMenu.samples.listProperties"
               class="com.ibm.ftt.api.samples.resources.ListPropertiesAction"
               style="push" menubarPath=
    "com.ibm.ftt.api.samples.apiMenu/com.ibm.ftt.api.samples.apiMenu.resourcesAPI"
               id="com.ibm.ftt.api.samples.listPropertiesAction"/>
               ......
      </actionSet>
   </extension>

Nutzungsbedingungen | Feedback

Dieses Information Center basiert auf Eclipse-Technologie (http://www.eclipse.org).