jParser जावास्क्रिप्ट के साथ बाइनरी फ़ाइलों से डेटा संरचनाओं को पढ़ना आसान बनाता है।

• एक बार जब आप एक संरचना का वर्णन करते हैं, तो इसका विश्लेषण स्वचालित रूप से होता है।
  
• डेटा विश्लेषण प्रक्रिया को स्व-लिखित कार्यों के साथ विस्तारित किया जा सकता है। गैर-तुच्छ फ़ाइलों के विश्लेषण को क्या सरल करता है।
  
• jParser ब्राउज़र और NodeJS दोनों में काम करता है, क्योंकि यह jDataView पर आधारित काम करता है।

एपीआई

प्राथमिक संरचनाएं:

• निरुपित पूर्णांक: uint8, uint16, uint32
  
• एक संकेत के साथ: int8, int16, int32
  
• आंशिक फ्लोटिंग पॉइंट: फ्लोट 32, फ्लोट64
  
• स्ट्रिंग: चार, स्ट्रिंग (लेन)
  
• सरणी: सरणी (प्रकार, लेन)
  
• स्थिति: बताओ, छोड़ें (लेन), तलाश (पीओएस), तलाश (पीओएस, फंक)

JParser विधियाँ:

• पार्स (मूल्य) - विश्लेषण शुरू होता है, पुनरावर्ती उपयोग किया जा सकता है। व्यवहार तर्क के प्रकार पर निर्भर करता है:
  
  
  • फ़ंक्शन: एक फ़ंक्शन को कॉल करता है;
    
  • स्ट्रिंग: डेरेफेरिंग (निर्दिष्ट नाम संरचना से लिया गया है);
    
  • सरणी: एक फ़ंक्शन को कॉल करना जिसका नाम सरणी का पहला तत्व है, और बाद के तत्व तर्क के रूप में काम करते हैं;
    
  • ऑब्जेक्ट: समान फ़ील्ड नामों पर पार्स किए गए मानों के साथ कोई ऑब्जेक्ट देता है।
  
  
• बताओ () - विश्लेषण की गई फ़ाइल में वर्तमान स्थिति (ऑफसेट) लौटाता है।
  
• स्किप (गिनती) - फ़ाइल में गणना द्वारा आगे बढ़ें (उन्हें छोड़ें)।
  
• तलाश (स्थिति) - विश्लेषण की गई फ़ाइल में निर्दिष्ट ऑफसेट पर जाएं।
  
• तलाश (स्थिति, कॉलबैक) - निर्दिष्ट ऑफ़सेट पर जाएं, कॉलबैक निष्पादित करें (), फिर पिछली स्थिति पर लौटें।
  
• करंट - वर्तमान वस्तु का विश्लेषण किया जा रहा है। विश्लेषण के दौरान पहले से प्राप्त परिणामों तक पहुंचने के लिए उपयोग करें।

जेपीसर निर्माणकर्ता:

• नया jParser (डेटा, संरचना)
  
  
  • डेटा jDataView डेटा पार्स किया जा रहा है । आप बाइट्स (स्ट्रिंग) का एक स्ट्रिंग पास कर सकते हैं, आप एक ArrayBuffer या Node.js बफर पास कर सकते हैं - ये डेटा प्रकार स्वचालित रूप से jDataView में परिवर्तित हो जाते हैं।
    
  • संरचना - सभी डेटा संरचनाओं के विवरण के साथ एक वस्तु।

उदाहरण

C की सामान्य संरचना

आप सी-जैसे डेटा संरचनाओं का वर्णन कर सकते हैं। यह एक जावास्क्रिप्ट ऑब्जेक्ट है जिसमें फ़ील्ड डेटा नाम हैं और उनके मान प्रकार हैं।

var parser = new jParser(file, { header: { fileId: 'int32', recordIndex: 'int32', hash: ['array', 'uint32', 4], fileName: ['string', 256], } }); parser.parse('header'); // { // fileId: 42, // recordIndex: 6002, // hash: [4237894687, 3491173757, 3626834111, 2631772842], // fileName: ".\\Resources\\Excel\\Items_Weapons.xls" // } 

संदर्भ

संरचनाओं में अन्य संरचनाएं हो सकती हैं। इसके विवरण को संदर्भित करने के लिए एक स्ट्रिंग के रूप में संरचना के नाम का उपयोग करें। निम्नलिखित उदाहरण विश्व Warcraft के लिए मॉडल युक्त फ़ाइल संरचना का हिस्सा है:

 nofs: { count: 'uint32', offset: 'uint32' }, animationBlock: { interpolationType: 'uint16', globalSequenceID: 'int16', timestamps: 'nofs', keyFrame: 'nofs' }, uvAnimation: { translation: 'animationBlock', rotation: 'animationBlock', scaling: 'animationBlock' } 

हेल्पर कार्य करता है

नए प्राथमिक प्रकारों को परिभाषित करना आपके लिए मुश्किल नहीं होगा। आप मौजूदा प्रकार के निर्माणों का उपयोग कर सकते हैं, जैसे ऑब्जेक्ट्स (निम्नलिखित उदाहरण में फ्लोट 3 ) या सरणियाँ (उदाहरण में फ्लोट 4 )। यदि आप अधिक जटिल प्रकार को परिभाषित करना चाहते हैं, तो हमेशा एक नए फ़ंक्शन को परिभाषित करने का अवसर होता है जो इस पर निर्भर करता है। प्राथमिक विश्लेषण के लिए यह तरीका (निम्न उदाहरण में hex32 और string0 ):

 float3: { x: 'float32', y: 'float32', z: 'float32' }, float4: ['array', 'float32', 4], hex32: function () { return '0x' + this.parse('uint32').toString(16); }, string0: function (length) { return this.parse(['string', length]).replace(/\0+$/g, ''); } 

फीडबैक

यदि सरणी का आकार पहले से ज्ञात नहीं है, तो आप इसकी जगह संरचना में एक फ़ंक्शन डाल सकते हैं जो पूर्णांक देता है। इस फ़ंक्शन में, आप इस का उपयोग कर सकते हैं। वर्तमान में विश्लेषण की जा रही वस्तु तक पहुँचने के लिए और इसके पहले से ही प्राप्त फ़ील्ड्स को पढ़ने के लिए।

 image: { width: 'uint8', height: 'uint8', pixels: [ 'array', ['array', 'rgba', function () { return this.current.width; }], function () { return this.current.height; } ] } 

उन्नत डेटा विश्लेषण

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

 entryHeader: { start: 'int32', count: 'int32' }, entry: function (type) { var that = this; var header = this.parse('entryHeader'); var res = []; this.seek(header.start, function () { for (var i = 0; i < header.count; ++i) { res.push(that.parse(type)); } }); return res; }, name: { language: 'int32', text: ['string', 256] }, file: { names: ['entry', 'name'] } 

शुरुआत हो रही है

NodeJS इंजन पर

बस jParser स्थापित करने के लिए npm का उपयोग करें - और आप तैयार हैं :-)

 npm install jParser 

 var fs = require('fs'); var jParser = require('jParser'); fs.readFile('file.bin', function (err, data) { var parser = new jParser(data, { magic: ['array', 'uint8', 4] }); console.log(parser.parse('magic')); }); 

ब्राउज़र में

मैंने jQuery को पैच किया , यह सुनिश्चित करते हुए कि बाइनरी फाइलें सबसे अच्छा बाइनरी प्रारूप में डाउनलोड की जाती हैं। इस पैच किए गए jQuery कोड के साथ ही jDataView और jParser को कनेक्ट करें - और आप तैयार हैं :-)

 <script src="https://raw.github.com/vjeux/jDataView/master/jquery/jquery-1.7.1-binary-ajax.js"></script> <script src="https://raw.github.com/vjeux/jDataView/master/src/jdataview.js"></script> <script src="https://raw.github.com/vjeux/jParser/master/src/jparser.js"></script> <script> $.get('file.bin', function (data) { var parser = new jParser(data, { magic: ['array', 'uint8', 4] }); console.log(parser.parse('magic')); }, 'dataview'); </script> 

सावधानियों

यह उपकरण अपने काम में एक अनिर्दिष्ट जावास्क्रिप्ट सुविधा पर निर्भर करता है: किसी ऑब्जेक्ट के फ़ील्ड को उस क्रम में ट्रैवर्स करना जिसमें वे निर्दिष्ट हैं। ध्यान रखें कि क्रोम और ओपेरा में, यह निहित नियम डिजिटल नाम वाले क्षेत्रों के लिए काम नहीं करता है।

सभी मौजूदा जावास्क्रिप्ट कार्यान्वयन में काम करने के लिए इस लाइब्रेरी के लिए इन दो नियमों का पालन करें:

• डेटा संरचना विवरण में संख्या के साथ फ़ील्ड नाम शुरू न करें।
  
• एक बार दिए गए नाम के साथ फ़ील्ड को फिर से परिभाषित न करें, एक ही नाम के दूसरे फ़ील्ड को एक ही ऑब्जेक्ट में न डालें।

डेमो

ICO विश्लेषण । यह NodeJS इंजन का उपयोग करके द्विआधारी विश्लेषण का एक सरल उदाहरण है। यह दिखाता है कि बाइनरी डेटा को पार्स करते समय कितने विशिष्ट कार्य उत्पन्न होते हैं।

• ico.js - jParser के लिए डेटा संरचना।
  
• ico.json - विश्लेषण का परिणाम।

अनपैक टार । यह एक ब्राउज़र के अंदर एक बाइनरी फ़ाइल को पार्स करने का एक सरल उदाहरण है।

• tar.html jParser संरचना है।

Warcraft मॉडल शावर की दुनिया । तीन-आयामी मॉडल के बाइनरी कोड को पढ़ने के लिए jParser का उपयोग करता है, फिर इसे प्रदर्शित करने के लिए WebGL।

• m2.js jParser संरचना है।
  
• model.json विश्लेषण का परिणाम है।

डियाब्लो 3 आंतरिक फ़ाइलें

• कन्वर्ट.कॉफी jParser के लिए एक रूपरेखा है। फ़ाइल संरचना लिखने के लिए कॉफी स्क्रिप्ट का उपयोग करना और भी आसान है।
  
• संसाधित फ़ाइलों के उदाहरण:
  
  
  • Items_Weapons.json
    
  • क्वेस्ट / प्रोटेक्टरऑफट्रिस्टम.जॉन
    
  • ट्रेजरक्लास / कंकाल