Snmp4j编程简介之二：PDU

PDU（协议数据单元），用来表示管理站跟代理站点进行通信的数据。包括PDU的类型、传输的数据集合、错误说明等。
    除Snmpv1 Trap外，其他操作类型的PDU大致相同。
    Snmp4j针对Snmp的各个版本，开发了三个有关PDU的类。PDU（针对Snmpv2c）、PDUv1（针对Snmpv1）、ScopedPDU（针对Snmpv3），但三个类除各自特别的一些参数外，都基本相同。所以Snmp4j在设计的时候，将PDU设计成另外两个的超类，使他们能够共享大部分功能。

（1）PDU
    1）pdu类型（Snmpv1支持5种，get、set、getnext、trap、getresponse,Snmpv2c增加了getbulk、inform）
    int   getType（）
    void   setType（int type)
   
    2）错误（主要有6种错误，请参见RFC）
    void   setErrorStatus(int   status)
    int   getErrorStatus()
    String    getErrorStatusText()
    void   setErrorIndex（int index）
    int   getErrorindex（）

    3）变量
    void add(VariableBinding vb) // 对于除get、getnext、getbulk外
    void addAll(VariableBinding[] vbs) // 对于除get、getnext、getbulk外的
    void addOID(VariableBinding vb) // 对于get、getnext、getbulk
    void addAllOID(VariableBinding[] vbs) // 对于get、getnext、getbulk
    VariableBinding get（int i）
    VariableBinding[] toArray()
    Vector   getVariableBindings()
    void set（int i，VariableBinding vb）
    void   remove（int i）
    void   clear（）
    int   size（）
   
（2）PDUv1
    PDUv1继承了PDU，除Snmp v1 trap操作外 ，其它都跟PDU相同。因为Snmp v1的Trap设计PDU不同于其他操作的PDU，它包括：对象标识符（OID）、代理ip地址（agent-addr）、时间戳（time-stamp）、通用代理类型（generic-trap）、特定代理类型（specific-trap)。所以相应的增加了对这些字段的get/set操作。具体参见API文档。

（3）ScopedPDU
    SnmpV3采用了不同安全策略，它的PDU也增加了有关安全方面的几个字段：上下文名称（ContextName）、上下文引擎ID（contextEngineID）等，其它PDU字段属于USM来管理。
    所以ScopedPDU在PDU的基础上增加了相应的get/set操作。参见API。

示例代码如下：（摘自API文档）

• SNMPv1/v2c GETNEXT PDU

  import org.snmp4j.PDU;
  import org.snmp4j.smi.*;
  ...
  PDU pdu = new PDU();
  pdu.add(new VariableBinding(new OID("1.3.6.1.2.1.1.1"))); // sysDescr
  pdu.add(new VariableBinding(new OID("1.3.6.1.2.1.2.1"))); // ifNumber
  pdu.setType(PDU.GETNEXT);
  ...

• SNMPv3 GETBULK PDU

  import org.snmp4j.ScopedPDU;
  import org.snmp4j.smi.*;
  ...
  ScopedPDU pdu = new ScopedPDU();
  pdu.add(new VariableBinding(new OID("1.3.6.1.2.1.2.1"))); // ifNumber
  pdu.add(new VariableBinding(new OID("1.3.6.1.2.1.2.2.1.10"))); // ifInOctets
  pdu.add(new VariableBinding(new OID("1.3.6.1.2.1.2.2.1.16"))); // ifOutOctets
  pdu.setType(PDU.GETBULK);
  pdu.setMaxRepetitions(50);
  // Get ifNumber only once
  pdu.setNonRepeaters(1);
  // set context non-default context (default context does not need to be set)
  pdu.setContextName(new OctetString("subSystemContextA"));
  // set non-default context engine ID (to use targets authoritative engine ID
  // use an empty (size == 0) octet string)
  pdu.setContextEngineID(OctetString.fromHexString("80:00:13:70:c0:a8:01:0d"));
  ...

• SNMPv1 TRAP PDU

  import org.snmp4j.PDUv1;
  ...
  PDUv1 pdu = new PDUv1();
  pdu.setType(PDU.V1TRAP);
  pdu.setGenericTrap(PDUv1.COLDSTART);
  ...

• SNMPv2c/SNMPv3 INFORM PDU

  import org.snmp4j.ScopedPDU;
  ...
  ScopedPDU pdu = new ScopedPDU();
  pdu.setType(PDU.INFORM);
  // sysUpTime
  long sysUpTime = (System.currentTimeMillis() - startTime) / 10;
  pdu.add(new VariableBinding(SnmpConstants.sysUpTime, new TimeTicks(sysUpTime)));
  pdu.add(new VariableBinding(SnmpConstants.snmpTrapOID, SnmpConstants.linkDown));
  // payload
  pdu.add(new VariableBinding(new OID("1.3.6.1.2.1.2.2.1.1"+downIndex),
                              new Integer32(downIndex)));
  ...

评论

2 楼 vincent2001 2008-08-13  

Hi LZ

  Sorry for typing English..I don't have Chinese input software in company computer.

  Thank you for your detailed description of SNMP4J and examples.very helpful for me!

  I am thinking do you have any idea about MessageDispacher and Session...do we need that ?

1 楼 jinyan798 2008-08-12