एसएनएमपी + जावा - व्यक्तिगत अनुभव। MIB फ़ाइलों का पार्सर लिखना

SNMP सबसे उपयोगकर्ता के अनुकूल प्रोटोकॉल नहीं है: MIB फाइलें बहुत लंबी और भ्रमित करने वाली होती हैं, और OID को याद रखना असंभव है। लेकिन क्या होगा यदि आपको जावा में एसएनएमपी के साथ काम करने की आवश्यकता है? उदाहरण के लिए, SNMP सर्वर API की जांच करने के लिए ऑटोटेस्ट लिखें।

परीक्षण और त्रुटि के द्वारा, विषय पर जानकारी के बजाय अल्प राशि के साथ, हम अभी भी यह पता लगाते हैं कि जावा और एसएनएमपी मित्र कैसे बनाएं।

लेखों की इस श्रृंखला में मैं प्रोटोकॉल के साथ प्राप्त अनुभव को साझा करने का प्रयास करूंगा। श्रृंखला का पहला लेख जावा में एमआईबी फाइलों के पार्सर के कार्यान्वयन के लिए समर्पित होगा। दूसरे भाग में मैं एक एसएनएमपी क्लाइंट लिखने के बारे में बात करूंगा। तीसरे भाग में, हम एक लिखित पुस्तकालय का उपयोग करने के एक वास्तविक उदाहरण के बारे में बात करेंगे: एसएनएमपी के माध्यम से एक उपकरण के साथ बातचीत को सत्यापित करने के लिए ऑटोटेस्ट।

प्रविष्टि

यह सब SNMP प्रोटोकॉल का उपयोग करके ऑडियो-वीडियो रिकॉर्डर के संचालन को सत्यापित करने के लिए ऑटोटेस्ट लिखने के कार्य के साथ शुरू हुआ। स्थिति की शिकायत यह है कि जावा में एसएनएमपी के साथ बातचीत करने पर बहुत अधिक जानकारी नहीं है, खासकर जब यह इंटरनेट के रूसी-भाषा खंड में आता है। बेशक, कोई C # या पायथन की ओर देख सकता है। लेकिन C # में, प्रोटोकॉल की स्थिति जावा में जितनी जटिल है। अजगर में कुछ अच्छे पुस्तकालय हैं, लेकिन हमारे पास जावा में इस उपकरण के रीस्ट एपीआई ऑटोटेस्ट के लिए पहले से ही तैयार बुनियादी ढांचा था।

किसी भी अन्य नेटवर्क संचार प्रोटोकॉल के साथ, हमें विभिन्न प्रकार के अनुरोधों के साथ काम करने के लिए एक SNMP क्लाइंट की आवश्यकता है। ऑटोटेस्टर को स्केलर और टेबल मापदंडों के लिए जीईटी और एसईटी अनुरोधों की सफलता को सत्यापित करने में सक्षम होना चाहिए। तालिकाओं के लिए, अभिलेखों के जोड़ और विलोपन को सत्यापित करने में सक्षम होना भी आवश्यक था, यदि तालिका स्वयं इन कार्यों की अनुमति देती है।

लेकिन क्लाइंट के अलावा, लाइब्रेरी को MIB फ़ाइलों के साथ काम करने के लिए एक वर्ग रखना पड़ता था। यह वर्ग डेटा प्रकार, स्वीकार्य मूल्यों की सीमाओं आदि को प्राप्त करने के लिए MIB फ़ाइल को पार्स करने में सक्षम होना चाहिए, ताकि हार्डकोड न हो कि हमेशा क्या बदल सकता है।

जावा के लिए उपयुक्त पुस्तकालयों की खोज करते समय, हमें एक भी पुस्तकालय नहीं मिला, जो दोनों अनुरोधों और एमआईबी फाइलों के साथ काम करने की अनुमति देगा। इसलिए, हम दो अलग-अलग पुस्तकालयों में बस गए। क्लाइंट के लिए, व्यापक रूप से उपयोग किए जाने वाले org.snmp4j.snmp4j (https://www.snmp4j.org) का विकल्प काफी तार्किक लगता था, और MIB फ़ाइलों के पार्सर के लिए, यह चुनाव न जाने-माने net.percederberg.mibble लाइब्रेरी (https: // www) से किया गया था। mibble.org)। अगर snmp4j के साथ चुनाव स्पष्ट था, तो उदाहरण के लिए पर्याप्त विस्तृत (यद्यपि अंग्रेजी-भाषा) प्रलेखन की उपलब्धता के लिए मिबल को चुना गया था। तो चलिए शुरू करते हैं।

MIB फ़ाइलों का पार्सर लिखना

हर कोई जिसने कभी MIB फाइल देखी है, वह जानता है कि यह एक दर्द है। आइए एक साधारण पार्सर की मदद से इसे ठीक करने का प्रयास करें, जो किसी फ़ाइल से जानकारी की खोज को बहुत आसान कर देगा, जिससे उसे किसी विशेष विधि को कॉल करने में कमी आएगी।

इस तरह के पार्सर का उपयोग MIB फ़ाइलों के साथ काम करने के लिए एक अलग उपयोगिता के रूप में किया जा सकता है या SNMP के तहत किसी अन्य परियोजना में शामिल किया जा सकता है, उदाहरण के लिए, जब एक SNMP क्लाइंट या परीक्षण स्वचालन लिख रहा हो।

परियोजना की तैयारी

असेंबली की आसानी के लिए, हम मावेन का उपयोग करते हैं। ऐड net.percederberg.mibble लाइब्रेरी (https://www.mibble.org) पर निर्भर करता है, जो हमारे लिए MIB फ़ाइलों के साथ काम करना आसान बना देगा:

<dependency> <groupId>net.percederberg.mibble</groupId> <artifactId>mibble</artifactId> <version>2.9.3</version> </dependency> 

चूंकि यह केंद्रीय मावेन रिपॉजिटरी में नहीं है, इसलिए हम निम्नलिखित कोड को pom.xml में जोड़ते हैं:

 <repositories> <repository> <id>opennms</id> <name>OpenNMS</name> <url>http://repo.opennms.org/maven2/</url> </repository> </repositories> 

यदि प्रोजेक्ट त्रुटियों के बिना मावेन का उपयोग करके इकट्ठा किया जाता है, तो सब कुछ काम के लिए तैयार है। यह केवल एक पार्सर वर्ग (चलो इसे MIBParser कहते हैं) बनाने के लिए बना हुआ है और हमें जो कुछ भी ज़रूरत है उसे आयात करें:

 import net.percederberg.mibble.*; 

MIB फ़ाइल को डाउनलोड और मान्य करें

कक्षा के अंदर केवल एक फ़ील्ड होगा - डाउनलोड की गई MIB फ़ाइल को संग्रहीत करने के लिए net.percederberg.mibble.Mib प्रकार की एक वस्तु:

 private Mib mib; 

फ़ाइल अपलोड करने के लिए, हम यह विधि लिखते हैं:

 private Mib loadMib(File file) throws MibLoaderException, IOException { MibLoader loader = new MibLoader(); Mib mib; file = file.getAbsoluteFile(); try { loader.addDir(file.getParentFile()); mib = loader.load(file); } catch (MibLoaderException e) { e.getLog().printTo(System.err); throw e; } catch (IOException e) { e.printStackTrace(); throw e; } return mib; } 

Net.percederberg.mibble.MIBLoader वर्ग उस फ़ाइल को मान्य करता है जिसे हम नेट में लोड करने और फेंकने का प्रयास कर रहे हैं। उसी निर्देशिका में झूठ मत बोलो या MIB वर्णों को आयात न करें।

लोडमिब विधि में, हम सभी अपवादों को पकड़ते हैं, उनके बारे में लॉग में लिखते हैं और आगे भेजते हैं, क्योंकि इस स्तर पर, काम की निरंतरता असंभव है - फ़ाइल मान्य नहीं है।

हम पार्सर कंस्ट्रक्टर में लिखित विधि कहते हैं:

 public MIBParser(File file) throws MibLoaderException, IOException { if (!file.exists()) throw new FileNotFoundException("File not found in location: " + file.getAbsolutePath()); mib = loadMib(file.getAbsoluteFile()); if (!mib.isLoaded()) throw new MibLoaderException(file, "Not loaded."); } 

यदि फ़ाइल सफलतापूर्वक डाउनलोड और पार्स हो गई है, तो काम करना जारी रखें।

एक MIB फ़ाइल से जानकारी पुनर्प्राप्त करने के तरीके

Net.percederberg.mibble.Mib वर्ग के तरीकों का उपयोग करके, आप क्रमशः getSymbol (स्ट्रिंग नाम) या getSymbolByOid (स्ट्रिंग ओआईडी) विधियों को कॉल करके नाम या OID द्वारा MIB फ़ाइल के अलग-अलग वर्णों की खोज कर सकते हैं। ये विधियाँ net.percederberg.mibble.MibSymbol ऑब्जेक्ट को लौटाती हैं, जिसके तरीके हम एक विशिष्ट MIB प्रतीक पर आवश्यक जानकारी प्राप्त करने के लिए उपयोग करेंगे।

आइए अपने ओआईडी द्वारा प्रतीक का नाम प्राप्त करने के लिए सबसे सरल और लिखने के तरीकों के साथ शुरू करें, इसके अलावा, नाम से ओआईडी:

 public String getName(String oid) { return mib.getSymbolByOid(oid).getName(); } public String getOid(String name) { String oid = null; MibSymbol s = mib.getSymbol(name); if (s instanceof MibValueSymbol) { oid = ((MibValueSymbol) s).getValue().toString(); if (((MibValueSymbol) s).isScalar()) oid = new OID(oid).append(0).toDottedString(); } return oid; } 

शायद ये एक विशेष MIB फ़ाइल की विशेषताएं हैं, जिसके साथ मुझे काम करने की आवश्यकता थी, लेकिन किसी कारण से, बिना शून्य के अंत में OID को स्केलर मापदंडों के लिए वापस कर दिया गया था, इसलिए OID विधि में एक कोड जोड़ा गया था, जो, यदि MIB यह अक्षर अदिश है, यह net.percederberg.mibble.OID वर्ग से परिशिष्ट (int सूचकांक) विधि का उपयोग करके प्राप्त OID में ".0" जोड़ता है। अगर यह आपके लिए एक बैसाखी के बिना काम करता है, तो बधाई :)

प्रतीक पर शेष डेटा प्राप्त करने के लिए, हम एक सहायक विधि लिखते हैं, जहाँ हमें ऑब्जेक्ट net.percederberg.mibble.snmp.SnmpObjectType मिलता है, जिसमें MIB प्रतीक के बारे में सभी आवश्यक जानकारी प्राप्त होती है।

 private SnmpObjectType getSnmpObjectType(MibSymbol symbol) { if (symbol instanceof MibValueSymbol) { MibType type = ((MibValueSymbol) symbol).getType(); if (type instanceof SnmpObjectType) { return (SnmpObjectType) type; } } return null; } 

उदाहरण के लिए, हम MIB प्रतीक का प्रकार प्राप्त कर सकते हैं:

 public String getType(String name) { MibSymbol s = mib.getSymbol(name); if (getSnmpObjectType(s).getSyntax().getReferenceSymbol() == null) return getSnmpObjectType(s).getSyntax().getName(); else return getSnmpObjectType(s).getSyntax().getReferenceSymbol().getName(); } 

टाइप करने के 2 तरीके हैं, क्योंकि आदिम प्रकारों के लिए, पहला विकल्प काम करता है:

 getSnmpObjectType(s).getSyntax().getName(); 

और आयातित लोगों के लिए, दूसरा:

 getSnmpObjectType(s).getSyntax().getReferenceSymbol().getName(); 

आप एक चरित्र का उपयोग स्तर प्राप्त कर सकते हैं:

 public String getAccess(String name) { MibSymbol s = mib.getSymbol(name); return getSnmpObjectType(s).getAccess().toString(); } 

सांख्यिक पैरामीटर के लिए न्यूनतम मान्य मूल्य:

 public Integer getDigitMinValue(String name) { MibSymbol s = mib.getSymbol(name); String syntax = getSnmpObjectType(s).getSyntax().toString(); if (syntax.contains("STRING")) return null; Pattern p = Pattern.compile("(-?\\d+)..(-?\\d+)"); Matcher m = p.matcher(syntax); if (m.find()) { return Integer.parseInt(m.group(1)); } return null; } 

एक संख्यात्मक पैरामीटर का अधिकतम अनुमत मूल्य:

 public Integer getDigitMaxValue(String name) { MibSymbol s = mib.getSymbol(name); String syntax = getSnmpObjectType(s).getSyntax().toString(); if (syntax.contains("STRING")) return null; Pattern p = Pattern.compile("(-?\\d+)..(-?\\d+)"); Matcher m = p.matcher(syntax); if (m.find()) { return Integer.parseInt(m.group(2)); } return null; } 

न्यूनतम अनुमत स्ट्रिंग लंबाई (स्ट्रिंग के प्रकार पर निर्भर करता है):

 public Integer getStringMinLength(String name) { MibSymbol s = this.mib.getSymbol(name); String syntax = this.getSnmpObjectType(s).getSyntax().toString(); Pattern p = Pattern.compile("(-?\\d+)..(-?\\d+)"); Matcher m = p.matcher(syntax); return syntax.contains("STRING") && m.find()?Integer.valueOf(Integer.parseInt(m.group(1))):null; } 

अधिकतम अनुमत स्ट्रिंग लंबाई (स्ट्रिंग के प्रकार पर निर्भर करता है):

 public Integer getStringMaxLength(String name) { MibSymbol s = mib.getSymbol(name); String syntax = getSnmpObjectType(s).getSyntax().toString(); Pattern p = Pattern.compile("(-?\\d+)..(-?\\d+)"); Matcher m = p.matcher(syntax); if (syntax.contains("STRING") && m.find()) { return Integer.parseInt(m.group(2)); } return null; } 

आप तालिका के सभी स्तंभों के नाम इसके नाम से भी प्राप्त कर सकते हैं:

 public ArrayList<String> getTableColumnNames(String tableName) { ArrayList<String> mibSymbolNamesList = new ArrayList<>(); MibValueSymbol table = (MibValueSymbol) mib.findSymbol(tableName, true); if (table.isTable() && table.getChild(0).isTableRow()) { MibValueSymbol[] symbols = table.getChild(0).getChildren(); for (MibValueSymbol mvs : symbols) { mibSymbolNamesList.add(mvs.getName()); } } return mibSymbolNamesList; } 

सबसे पहले, एक मानक तरीके से, हमें नाम से एक MIB प्रतीक मिलता है:

 MibValueSymbol table = (MibValueSymbol) mib.findSymbol(tableName, true); 

फिर हम जांचते हैं कि क्या यह एक तालिका है और यह कि बच्चा MIB प्रतीक इस तालिका की एक पंक्ति है और, यदि स्थिति सही है, तो लूप में हम तालिका पंक्ति के बच्चों के माध्यम से जाते हैं और परिणामी सरणी में तत्व का नाम जोड़ते हैं:

 if (table.isTable() && table.getChild(0).isTableRow()) { MibValueSymbol[] symbols = table.getChild(0).getChildren(); for (MibValueSymbol mvs : symbols) { mibSymbolNamesList.add(mvs.getName()); } } 

परिणाम

ये तरीके प्रत्येक विशिष्ट वर्ण के लिए MIB फ़ाइल से किसी भी जानकारी को प्राप्त करने के लिए पर्याप्त हैं, केवल उसका नाम जानते हुए। उदाहरण के लिए, एसएनएमपी क्लाइंट लिखते समय, आप इसमें ऐसे पार्सर को शामिल कर सकते हैं ताकि क्लाइंट तरीके ओआईडी को स्वीकार न करें, लेकिन एमआईबी प्रतीक नामों को। इससे, कोड की विश्वसनीयता बढ़ जाएगी ओआईडी में एक टाइपो उस चरित्र को जन्म नहीं दे सकता है जिसे हम संदर्भित करना चाहते हैं। और कोई ओआईडी नहीं - कोई समस्या नहीं।

प्लस कोड की पठनीयता है, जिसका अर्थ है इसकी स्थिरता। यदि कोड मानव नामों के साथ संचालित होता है, तो परियोजना के सार को समझना आसान है।

एक अन्य अनुप्रयोग परीक्षण स्वचालन है। परीक्षण डेटा में, कोई गतिशील रूप से MIB फ़ाइल से संख्यात्मक मापदंडों के सीमा मान प्राप्त कर सकता है। इसलिए, यदि परीक्षण किए गए घटक परिवर्तन के नए संस्करण में कुछ MIB प्रतीकों के सीमा मूल्य, आपको ऑटोटेक्स्ट कोड को बदलना नहीं होगा।

सामान्य तौर पर, एक पार्सर का उपयोग करते हुए, एमआईबी फाइलों के साथ काम करना अधिक सुखद हो जाता है, और वे इस तरह के दर्द को रोकते हैं।