Node.js में कैश मेमोरी को ऐक्सेस करना

आपको Apigee Edge दस्तावेज़ दिख रहा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है इस पेज पर जाएं Apigee X दस्तावेज़. जानकारी

Edge से डिस्ट्रिब्यूट किए गए कैश मेमोरी को ऐक्सेस करने के लिए, apigee-access मॉड्यूल का इस्तेमाल किया जा सकता है Node.js ऐप्लिकेशन के अंदर दिखेंगे. मॉड्यूल में कोडिंग प्राप्त करने के तरीके शामिल हैं कैश मेमोरी में सेव करने और डेटा को डालने, पाने, और हटाने के लिए किया जाता है.

Apigee Edge की मदद से डिस्ट्रिब्यूट की गई कैश मेमोरी की मदद से, स्ट्रिंग या अन्य डेटा स्टोर किया जा सकता है. ज़्यादातर कैश मेमोरी की तरह, इसमें यह सबसे कम इस्तेमाल किया गया कैश मेमोरी है, जिसका साइज़ सबसे बड़ा है. Apigee Edge में, कैश मेमोरी का बंटवारा किया जा चुका है उन सभी नोड में से जहां आपका Node.js ऐप्लिकेशन काम करता है. कैश मेमोरी को मैनेज करने के लिए, Apigee Edge एपीआई. एपीआई का इस्तेमाल करके, मैन्युअल तरीके से कैश रिसॉर्स बनाया जा सकता है या डिफ़ॉल्ट संसाधन. Apigee Edge पर कैश मेमोरी के बारे में जानने के लिए, Edge में परसिस्टेंस टूल लेख पढ़ें. ज़्यादा जानकारी के लिए डिस्ट्रिब्यूट किए गए कैश के बारे में जानने के लिए, देखें उदाहरण: सामान्य मकसद कैश मेमोरी में सेव करने की सुविधा.

apigee-access मॉड्यूल और इसकी अन्य सुविधाओं के बारे में जानने के लिए, यहां देखें apigee-access मॉड्यूल का इस्तेमाल करना.

तरीके

(1) getकैश

var cache = apigee.getCache(cacheName);

नाम वाली कैश मेमोरी खोजें और अगर ज़रूरी हो, तो उसे बनाएं. नतीजे के तौर पर मिलने वाली कैश मेमोरी, पहले से तय किए गए सेट का इस्तेमाल करती है का इस्तेमाल करें.

पैरामीटर:

cacheName - एक स्ट्रिंग, कैश मेमोरी. (कैश मेमोरी संसाधन का नाम नहीं).

लौटाए जाने वाले प्रॉडक्ट:

एक कैश ऑब्जेक्ट.

उदाहरण:

var apigee = require('apigee-access');
var cache = apigee.getCache('cache');

(2) getकैश

var customCache = apigee.getCache(cacheName, options );

कॉन्फ़िगरेशन ऑब्जेक्ट में, पसंद के मुताबिक कैश मेमोरी में सेव किए गए संसाधन को ऐक्सेस करें. यह जानने के लिए कि कैश मेमोरी संसाधन बनाने के लिए, एनवायरमेंट बनाना और उसमें बदलाव करना देखें कैश मेमोरी में सेव करें.

पैरामीटर:

cacheName - एक स्ट्रिंग, आपके हिसाब से कैश मेमोरी का इस्तेमाल किया जा सकता है. (कैश मेमोरी संसाधन का नाम नहीं है)

options - कॉन्फ़िगरेशन ऑब्जेक्ट. कॉन्टेंट बनाने ऑब्जेक्ट खाली हो सकता है या उसमें ये वैकल्पिक पैरामीटर हो सकते हैं:

  • resource: किसी Apigee "कैश संसाधन" का नाम जहां कैश मेमोरी में सेव किया गया डेटा सेव किया जाता है. कैश मेमोरी में सेव किए गए संसाधनों का इस्तेमाल, कैश मेमोरी और अन्य कैश मेमोरी को बेहतर बनाने के लिए किया जाता है पैरामीटर का इस्तेमाल करें. अगर यह तय नहीं किया गया है, तो किसी डिफ़ॉल्ट संसाधन का इस्तेमाल किया जाएगा. अगर कैश मेमोरी में सेव किया गया रिसॉर्स, मौजूद होने पर, इस तरीके से गड़बड़ी होती है.

  • scope: इससे पता चलता है कि कैश मेमोरी में सेव की गई एंट्री को प्रीफ़िक्स किया गया है या नहीं टकरावों से बचाता है. मान्य वैल्यू global, application, और हैं exclusive.

    • global: कैश मेमोरी में सेव की गई सभी एंट्री को, इसमें मौजूद सभी Node.js ऐप्लिकेशन पर वही Apigee "एनवायरमेंट".

    • application: कैश मेमोरी में सेव की गई सभी एंट्री को Node.js की मदद से सेव की गई ऐसी कैश मेमोरी में सेव किया जाएगा जो का हिस्सा भी है.

    • exclusive: (डिफ़ॉल्ट) कैश एंट्री सिर्फ़ Node.js की मदद से समान नाम वाले ऐप्लिकेशन हों. यह डिफ़ॉल्ट रूप से होता है.

  • prefix: अगर कैश मेमोरी की कुंजी के नाम में प्रीफ़िक्स शामिल है, तो पॉप्युलेट होने में उसकी जानकारी' कैश से जुड़ी नीति और कैश मेमोरी वाली कुंजियों के साथ काम करना, इनका इस्तेमाल करें इस पैरामीटर का इस्तेमाल करें. Edge, वीडियो में अपने-आप डबल-अंडरस्कोर सफ़िक्स जोड़ देता है उपसर्ग नाम. इसलिए, अगर "UserToken" प्रीफ़िक्स के साथ कैश कुंजी बनाई गई है, तो यह प्रीफ़िक्स है यहां "UserToken__" है.

  • defaultTtl: इससे कैश मेमोरी में सेव होने के लिए डिफ़ॉल्ट समय के बारे में पता चलता है एंट्री, सेकंड में. अगर इसके बारे में नहीं बताया गया है, तो कैश मेमोरी संसाधन में डिफ़ॉल्ट TTL (टीटीएल) होगा इस्तेमाल किया गया.

  • timeout: कुछ सेकंड में डिस्ट्रिब्यूट हो चुका कैश मेमोरी. डिफ़ॉल्ट 30 सेकंड. इंतज़ार के समय के लिए संवेदनशील ऐप्लिकेशन हो सकते हैं को कम करना है, तो कैश मेमोरी में सेव किया जाने वाला ओवरलोड हो गया.

लौटाए जाने वाले प्रॉडक्ट:

कैश मेमोरी में सेव किया गया कस्टम ऑब्जेक्ट.

उदाहरण:

var apigee = require('apigee-access');
var customCache = apigee.getCache('doesNotMatter',
  { resource: 'MyCustomResource', scope: 'global', prefix: 'UserToken'} );
customCache.put("myCacheKey", "xyz");

यह इस तरह से कॉन्फ़िगर की गई lookupकैश नीति के साथ काम करता है:

<LookupCache name="Lookup-Cache-1">
  <CacheKey>
    <Prefix>UserToken</prefix>    
    <KeyFragment>myCacheKey</KeyFragment>
  </CacheKey>
  <CacheResource>MyCustomResource</CacheResource>
  <Scope>Global</Scope>
  <AssignTo>contextVariable</AssignTo>
</LookupCache>

पुट

cache.put('key', data, ttl, function(error));

डेटा को कैश मेमोरी में रखें.

पैरामीटर:

  • key: (ज़रूरी है) ऐसी स्ट्रिंग जो यूनीक तरीके से आइटम को कैश मेमोरी में सेव करें. कैश कुंजियों का साइज़ 2 केबी से ज़्यादा नहीं होना चाहिए.

  • data: (ज़रूरी है) ऐसी स्ट्रिंग, बफ़र या ऑब्जेक्ट जो कैश मेमोरी में सेव किए जाने वाले डेटा को दिखाता है. किसी अन्य तरह का डेटा दिखने पर गड़बड़ी हो सकती है. आपकी सुविधा के लिए, "JSON.stringify" का इस्तेमाल करके, ऑब्जेक्ट स्ट्रिंग में बदल दिए जाएंगे.

  • ttl: (ज़रूरी नहीं) कैश मेमोरी में सेव करें. अगर इसके बारे में नहीं बताया गया है, तो डिफ़ॉल्ट टीटीएल का इस्तेमाल किया जाएगा.

  • callback: (ज़रूरी नहीं) अगर बताया गया है, तो एक फ़ंक्शन जो कैश मेमोरी में डेटा के सुरक्षित रूप से पहुंचने के बाद, को कॉल किया जाएगा. इसे गड़बड़ी ऑब्जेक्ट के साथ कॉल किया जाएगा अगर कोई इंसर्शन गड़बड़ी होती है, तो पहले पैरामीटर के तौर पर सेट करें. ऐसा न होने पर, उसे कोई पैरामीटर नहीं.

उदाहरण:

var apigee = require('apigee-access');
var cache = apigee.getCache();
// Insert a string into cache using the default TTL
cache.put('key1', 'Buenos dias, Mundo!');
// Insert a string into cache using a TTL of 120 seconds
cache.put('key2', 'Hello, World!', 120);
// Insert a string with the default TTL, and get notified when the insert is complete
cache.put('key3', 'Ciao, Mondo!', function(error) {
  // "error" will be falsy unless there was an error on insert
});
// Insert a string with a TTL of 600 seconds, and get notified when the insert is complete
cache.put('key4', 'Hallo Wereld!', 600, function(error) {
  // "error" will be falsy unless there was an error on insert
});

डाउनलोड करना

cache.get('key', function(error, data));

कैश मेमोरी से डेटा वापस पाना.

पैरामीटर:

  • key (ज़रूरी है): ऐसी स्ट्रिंग जो खास तौर पर आइटम को कैश मेमोरी में सेव करें.

    Apigee Edge नीति (जैसे, कैश मेमोरी का डेटा अपने-आप भरने की नीति) से, कैश मेमोरी में सेव की जाने वाली एंट्री के लिए, को नीति बनाने के तरीके के आधार पर कैश कुंजी बनानी होगी एंट्री के लिए कुंजियां. ऐसा करने के लिए, आपको जानना होगा कि नीति कैसे कॉन्फ़िगर की गई है. हालांकि कैश मेमोरी में सेव की गई कुंजियों के साथ काम करना यह बताती है कि नीतियों के तहत कैश कुंजियां कैसे बनाई जाती हैं. ध्यान रखें कि आपको दायरे से जुड़ी स्ट्रिंग वैल्यू; Node.js से मिले कॉल में, स्कोप पहले से ही संदर्भ.

  • callback (ज़रूरी है): एक फ़ंक्शन, जिसे कॉल किया जाएगा जब डेटा उपलब्ध हो. अगर कैश मेमोरी में सेव किया गया डेटा है, तो उसे दूसरे चरण में वापस कर दिया जाता है पैरामीटर.

    • error - गड़बड़ी वाला कोई ऑब्जेक्ट. अगर कोई गड़बड़ी होती है कैश मेमोरी से वापस पाने के दौरान, यहां गड़बड़ी वाला ऑब्जेक्ट सेट किया जाएगा. नहीं तो, पैरामीटर "undefined" पर सेट होगा.

    • data - वापस पाया गया डेटा, अगर है, तो. ऐसा होगा चार वैल्यू में से कोई एक:

      • अगर कोई स्ट्रिंग डाली गई है, तो यह एक स्ट्रिंग होगी.
      • अगर आपने कोई बफ़र जोड़ा है, तो यह बफ़र होगा.
      • अगर कोई ऑब्जेक्ट डाला गया था, तो वह एक स्ट्रिंग होगी, जिसमें ऑब्जेक्ट को ढूंढने के लिए उसका इस्तेमाल करना है.
      • अगर कुछ नहीं मिलता है, तो यह "तय नहीं है" होगा.

उदाहरण:

var apigee = require('apigee-access');
var cache = apigee.getCache();
cache.get('key', function(error, data) {
  // If there was an error, then "error" will be set.
  // If error is falsy, "data" is the item that was retrieved:
  //   - undefined, in the case of cache miss, or
  //   - a Buffer, or
  //   - a String
});

हटाएं

cache.remove('key', function(error));

कैश मेमोरी में सेव किया गया आइटम अमान्य करें. कुंजी के अमान्य होने पर, इसके बाद के get() अनुरोध वापस मिलेंगे "तय नहीं है" जब तक कोई दूसरी वैल्यू न डाली जाए.

पैरामीटर:

  • key (ज़रूरी है): ऐसी स्ट्रिंग जो खास तौर पर आपकी अमान्य करने के लिए कैश में आइटम का उपयोग करें.

    Apigee Edge नीति (जैसे, कैश मेमोरी का डेटा अपने-आप भरने की नीति) से, कैश मेमोरी में सेव की जाने वाली एंट्री के लिए, को नीति बनाने के तरीके के आधार पर कैश कुंजी बनानी होगी एंट्री के लिए कुंजियां. ऐसा करने के लिए, आपको जानना होगा कि नीति कैसे कॉन्फ़िगर की गई है. हालांकि कैश मेमोरी में सेव की गई कुंजियों के साथ काम करना यह बताती है कि नीतियों के तहत कैश कुंजियां कैसे बनाई जाती हैं. ध्यान रखें कि आपको दायरे से जुड़ी स्ट्रिंग वैल्यू; Node.js से मिले कॉल में, स्कोप पहले से ही संदर्भ.

  • callback (ज़रूरी है): एक कॉलबैक फ़ंक्शन, जो अगर कोई गड़बड़ी हुई है, तो पहले पैरामीटर के रूप में गड़बड़ी ऑब्जेक्ट के साथ कॉल किया जाएगा.

उदाहरण:

var apigee = require('apigee-access');
var cache = apigee.getCache();
cache.remove('key', function(error) {
});