ObjectSNMP Java SNMP开发组件用户手册

ObjectSNMP面向对象的SNMP软件V2010.10.261zhTelecomObjectSNMP用户手册版本：V2010.10.26全系列产品SugarNMS网络监控软件SugarNMS二次开发平台iTopoview网络拓扑图组件ObjectSNMPSNMP网关组件OEM、ODM定制开发服务面向对象的SNMP软件V2010.10.262目录一、O-MMapping映射基础...........................................................................................................................31.SNMP背景知识.......................................................................................................................................32.O-MMapping映射法则...........................................................................................................................33.O-MMapping映射示例...........................................................................................................................5二、ObjectSNMP开发步骤.............................................................................................................................8三、学习示例程序.........................................................................................................................................10四、使用MIB浏览器.....................................................................................................................................111.启动运行MIB浏览器.............................................................................................................................112.MIB浏览器常用操作.............................................................................................................................12五、ObjectSNMPAPI一览表........................................................................................................................131.InterfaceSNMPAPI.................................................................................................................................132.ClassSNMPFactory.................................................................................................................................163.ClassSNMPTarget...................................................................................................................................174.InterfaceOMMappingInfo.......................................................................................................................185.ClassSNMPSysConfig............................................................................................................................186.ClassSnmpMibBrowser..........................................................................................................................19ObjectSNMP面向对象的SNMP软件V2010.10.263一、O-MMapping映射基础1.SNMP背景知识在SNMP中,SNMP管理模型包含四个组成部分：1)SNMPNMS：SNMP管理站，利用SNMP协议对网络设备进行管理和监控的系统；2)SNMPAgent：SNMP代理，是运行在被管设备上的软件模块，用于维护被管设备的信息数据（即MIB），还负责接收、处理、响应来自NMS的请求报文，也可以主动发送一些通知报文给NMS；3)SNMP协议：规定NMS和Agent之间是如何交换管理信息的应用层协议，以GET、SET方式替代了复杂的命令集；4)MIB：管理信息库，每个Agent都有自己的MIB库。MIB是一种对象数据库，由设备所维护的被管理对象组成。SNMPMIB可以分为两大类，一类称之为组如下图的system组，有查询、修改操作，另一类称之为表，可以有多行数据，如下图的ospfStubAreaEntry表，有添加行、删除、查询、修改操作。每一个组或每一个表，均可以用与之相对应的Java对象来映射。2.O-MMapping映射法则Java对象映射ObjectSNMP面向对象的SNMP软件V2010.10.264Java映射项目对应的SNMP映射项目Java对象名MIB组或表的SNMPOIDJava对象属性名组或表下的节点名称（大小写一致）Java属性int类型最佳映射——SNMP数据类型INTEGER、Integer32也可以映射：Counter、Counter32、Gauge、Gauge32、Counter64、TimeTicksJava属性long类型最佳映射——SNMP数据类型Counter、Counter32、Gauge、Gauge32、Counter64、TimeTicks也可以映射——INTEGER、Integer32Java属性String类型最佳映射——SNMP数据类型Opaque、IPAddress、OBJECTIDENTIFIER、OCTETSTRING也可以映射——全部SNMP数据类型。Java对象属性读写所有Java对象均提供get/set方法，ObjectSNMP自动映射MIB节点的可读/可写权限。Java对象属性数量Java对象属性的数量可以与MIB组或表下的节点数量相同或不相同；不匹配的Java属性被自动忽略；在MIB中无法匹配的节点被自动忽略。操作映射含义SNMP语义API从MIB中读取JAVA对象GET多个OIDObjectgetMibObject(Objectobject,SNMPTargettarget)从MIB表中读取全部的JAVA对象GET或GETNext或GetBulk全部MIB表，仅对MIB表有效ListgetAllTableData(ClassobjectClass,SNMPTargettarget)修改MIB中的JAVA对象SET多个OIDupdate(Objectobject,SNMPTargettarget)在MIB表中添加JAVA对象SET多个OID，仅对MIB表有效addTableRow(Objectobject,SNMPTargettarget)从MIB表中删除JAVA对象SET，仅对MIB表有效delTableRow(Objectobject,SNMPTargettarget)快速OIDGET方法GETgetOIDValue(Stringoid,SNMPTargettarget)快速OIDGetNext方法GetNextgetNextOIDValue(Stringoid,SNMPTargettarget)ObjectSNMP面向对象的SNMP软件V2010.10.2653.O-MMapping映射示例下面以RFC1213.MIB中system分组和OSPF-MIB下面的ospfStubAreaEntry表来示范SNMP组和SNMP表的映射：systemmib组的映射System组的MIB结构如下图所示：与之相映射的JAVA对象是：publicclassMibSystemimplementscom.zhtelecom.common.snmp.OMMappingInfo{privateStringsysDescr;privateStringsysObjectID;privatelongsysUpTime;privateStringsysContact;privateStringsysName;privateStringsysLocation;privateintsysServices;get/set……..publicStringgetMappingOID()//需要告诉要映射MIB组或表的OID{return1.3.6.1.2.1.1;//system组的OID}}操作映射：1.从SNMPAgent(IP:127.0.0.1)获取mibsystem组下所有节点(OID)的值：SNMPTargettarget=newSNMPTarget();target.nodeIP=127.0.0.1;//SNMPAgent的IP地址target.readCommunity=”public”;//SNMPAgent的读共同体SNMPFactory.init(SNMPFactory.Mode_Local,null);//初始化ObjectSNMP模块SNMPAPIsnmpapi=SNMPFactory.getSNMPAPI();//获取ObjectSNMPAPIMibSystemmibobj=newMibSystem();MibSystemnewMibObj=snmpapi.getMibObject(mibobj,target);ObjectSNMP面向对象的SNMP软件V2010.10.266此操作后，newMibObj对象中的属性将从Agent得到最新的值。（用newMibObj而不是mibobj获取新值，是为了兼容RMI远程调