Umsetzung MIB-Variablen

Der MIBGEN-Generator führt für die verschiedenen SNMP-Datentypen eine Umsetzung durch. Dabei werden drei Arten von Datentypen betrachtet:

• Enumerationen
  Für Enumerationstypen erstellt der Generierungsvorgang jeweils eigene Klassen. Diese werden mit dem Variablenbezeichner, welcher um das Präfix ``Enum'' erweitert wird, benannt. In diesen Klassen werden mit den möglichen Werten dieser Enumerations-Variablen zwei Hashtabellen erzeugt. Eine String-Tabelle beinhaltet die formulierten Variablenwerte aus dem SYNTAX-Feld, während eine Integer-Tabelle den jeweiligen Index speichert. Es werden Konstruktoren zur Verwendung mit Strings und Integer-Werten, sowie für die Ausgabe der Hashtabellen erzeugt. Nachfolgend ist ein MIB-Enumerationstyp und dessen Umsetzung dargestellt.

  // Auszug aus der TIS-MIB
  enableDnsForWindows OBJECT-TYPE
      SYNTAX  INTEGER { checked(1), notChecked(2) }
      ACCESS  read-write
      STATUS  mandatory
      DESCRIPTION
      "This is the 'Enable DNS' flag as found in 
      WinNT Control Panel-> Network->Protocols."
  ::= { networkParms 9 }
  
  // Umsetzung der Enumerations-Variablen
  
  /**
   * The class is used for representing "EnableDnsForWindows".
   */
  public class EnumEnableDnsForWindows extends Enumerated  
            implements  Serializable {
    protected static Hashtable intTable= new Hashtable();
    protected static Hashtable stringTable= new Hashtable() ;
    static  {
      intTable.put(new Integer(1), "checked");
      intTable.put(new Integer(2), "notChecked");
      stringTable.put("checked", new Integer(1));
      stringTable.put("notChecked", new Integer(2));
    }
  ...
    public EnumEnableDnsForWindows(int valueIndex) 
         throws IllegalArgumentException {
      super(valueIndex);
    }
  ...
    public EnumEnableDnsForWindows(String x) 
         throws IllegalArgumentException {
      super(x);
    }

• Tabellen
  Tabellen werden, wie in Kapitel 6.3.1 erwähnt ebenfalls auf besondere Weise umgesetzt. Es wird pro Tabelleneintrag ein M-Bean erzeugt. Dies hat den Vorteil daß auf einfache Art und Weise auf die einzelnen Tabelleneinträge zugegriffen werden kann. Die Tabelleneinträge werden auf der zur Laufzeit des Agenten generierten HTML-Seite aufgeführt, falls über den HTML-Adapter und einen Web-Browser auf den Agenten zugegriffen wird. So können die Tabelleneinträge als URL direkt angewählt werden. Der Bezeichner des M-Beans setzt sich aus dem Tabellenbezeichner als Domäne, gefolgt vom Variablenbezeichner und einem (bzw. mehreren) Indizes zusammen. Im nachstehenden Source-Code ist ein Beispiel für eine Tabellenumsetzung zu finden.

  // Auszug aus TIS-MIB
  ...
  dnsServerTable OBJECT-TYPE
      SYNTAX  SEQUENCE OF DnsServerEntry
      ACCESS  not-accessible
      STATUS  mandatory
      DESCRIPTION
      "This is the list of DNS servers as found in 
      WinNT Control Panel-> Network->Protocols."
  ::= { networkParms 7 }
  
  // Auszug aus Datei "TableDnsServerTable.java"
  ...
  /**
   * The class is used for implementing the "DeviceTable" group.
   * The group is defined with the following oid: 1.3.6.1.4.1.2206.5.1.2.1.1.
   */
  public class TableDeviceTable extends SnmpMibTable  implements  Serializable {
  ...
  /**
   * Constructor for the table. Initialize metadata for "TableDeviceTable"
   */
  public TableDeviceTable(SnmpMib myMib) {
    super(myMib);
    node= new DeviceEntryMeta(myMib);
  }
  ...
  public synchronized  void addEntry(DeviceEntry entry)
    throws SnmpStatusException {
    SnmpIndex index= buildSnmpIndex(entry);
    addEntry(index, entry);
  }
  ...

  Wie im dem Beispiel angedeutet, werden eine Reihe von Methoden erzeugt, welche den Zugriff auf die Elemente der Tabelle ermöglichen. Die wesentlichen Methoden wären:
  • buildSnmpIndex
    Diese Methode erstellt ein Objekt der Klasse SnmpIndex. Diese Klasse wird von JDMK in der Package com.sun.jaw.snmp.agent bereitgestellt und ermöglicht eine bequeme Handhabung von SNMP-Indizes. Das Index-Objekt wird als Parameter von buildOidFromIndex verwendet.
  • buildOidFromIndex
    Mit Hilfe dieser Methode wird aus dem mit buildSnmpIndex erstellten Tabellenindex ein SnmpOID-Objekt erzeugt. Dieses Objekt beinhaltet die erzeugte OID sowie mehrere Methoden, welche es ermöglichen, die OID unterschiedlich zu repräsentieren. In der Implementierung werden diese Methoden verwendet, um eine Stringdarstellung der OID für den Zugriff über Native-Methoden zu erstellen.
  • addEntry
    Ermöglicht das Hinzufügen von Tabelleneinträgen innerhalb der JDMK-MIB. Es ist allerdings bei der Implementierung darauf zu achten, daß die Tabelleneinträge zu den Applikationen (AMS etc.) durchgeschrieben werden müssen. Dies geschieht durch Anwendung von Native- Methoden und wird in Kapitel 6.4 beschrieben..
  • removeEntry
    Analog zum Einfügen von Tabelleneinträgen können diese wieder entfernt werden.
• einfache MIB-Datentypen
  Einfache Datentypen wie INTEGER und OCTET STRING werden direkt als Java-Integer bzw. Byte-Array umgesetzt. Je nach Zugriffsmöglichkeit werden get- und set-Methoden generiert. Diese Methoden werden bei der Implementierung um die eigentlichen Zugriffe auf die Applikationen (AMS etc.) erweitert. Es sei erwähnt, daß diese Umsetzung unter Umständen zu Schwierigkeiten führen kann, da z.B. die IP-Adresse als OCTET STRING gekennzeichnet wurde. Dies schränkt den Wertebereich jedoch auf -127 bis 127 ein und hat zudem zur Folge, daß auf der zur Laufzeit generierten HTML-Seite die Repräsentation der Adresse als Byte-Array dargestellt ist. Hier ist es notwendig eine benutzerspezifische Anpassung der HTML-Seite durchzuführen (vgl. 6.7.1).