DataBuffer

इस बफ़र के बैकिंग स्टोरेज का दौरा करता है।

बफ़र कार्यान्वयन प्रदान किए गए विज़िटर को वास्तविक डेटा संग्रहण का संदर्भ वापस भेजने के लिए ज़िम्मेदार है। विज़िटर को सभी संभावित प्रकार के डेटा स्टोरेज को संभालने की ज़रूरत नहीं है और वह केवल स्टोरेज के तरीकों को ओवरराइड कर सकता है जिसमें वह वास्तव में रुचि रखता है। किसी अन्य प्रकार के स्टोरेज के लिए, यह कॉल fallback() पर फ़ॉलबैक हो जाएगी ताकि विज़िटर कुछ सामान्य रूटीन निष्पादित कर सके यदि आवश्यकता है।

इस बफ़र में स्रोत सरणी में ऑब्जेक्ट के संदर्भ लिखें।

यदि गंतव्य बफ़र आकार, यानी size > dst.size() से कॉपी करने के लिए अधिक मान हैं, तो कोई मान स्थानांतरित नहीं किया जाता है और एक बफ़रओवरफ़्लो अपवाद फेंक दिया जाता है। दूसरी ओर, यदि स्रोत बफ़र आकार की प्रतिलिपि बनाने के लिए अधिक मान हैं, यानी > src.size() , तो एक बफ़रअंडरफ्लोटएक्सेप्शन फेंक दिया जाता है।

अन्यथा, यह विधि इस बफ़र से n = size मानों को गंतव्य बफ़र में कॉपी करती है।

डेटा बफ़र्स के बीच समानता की जाँच करता है।

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

IntDataBuffer buffer = DataBuffers.of(1, 2, 3);

 assertEquals(buffer, DataBuffers.of(1, 2, 3));  // true
 assertEquals(buffer, DataBuffers.ofObjects(1, 2, 3));  // true, as Integers are equal to ints
 assertNotEquals(buffer, DataBuffers.of(1, 2, 3, 0));  // false, different sizes
 assertNotEquals(buffer, DataBuffers.of(1, 3, 2));  // false, different order
 assertNotEquals(buffer, DataBuffers.of(1L, 2L, 3L));  // false, different types
 

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

दिए गए सूचकांक पर मान पढ़ता है। महत्वपूर्ण: इस पद्धति का उपयोग गैर-आदिम प्रकार के बफ़र्स तक सीमित होना चाहिए या जब डेटा प्रकार कॉलर द्वारा निश्चित रूप से ज्ञात नहीं होता है। किसी भी अन्य मामले में, इसके आदिम संस्करण के उपयोग को प्राथमिकता दें जो प्रदर्शन में काफी सुधार करेगा (उदाहरण के लिए IntDataBuffer.getInt(idx)

बताता है कि यह बफ़र किसी पहुंच योग्य सरणी द्वारा समर्थित है या नहीं।

एक नया बफ़र बनाता है जिसकी सामग्री इस बफ़र की सामग्री का एक साझा अनुवर्ती है, जिसका आकार दिए गए मान पर सेट है।

नया आकार इस बफ़र आकार से बड़ा नहीं होना चाहिए. इस बफ़र की सामग्री में परिवर्तन नए बफ़र में दिखाई देंगे और इसके विपरीत। नया बफ़र केवल-पढ़ने के लिए होगा यदि, और केवल तभी, जब यह बफ़र केवल-पढ़ने के लिए हो।

यह कॉल slice(0, size) के बराबर है

एक नया बफ़र बनाता है जिसकी सामग्री इस बफ़र की सामग्री का एक साझा अनुवर्ती है, जो दिए गए सूचकांक से शुरू होती है।

सूचकांक इस बफ़र आकार से अधिक नहीं होना चाहिए। इस बफ़र की सामग्री में परिवर्तन नए बफ़र में दिखाई देंगे और इसके विपरीत। नया बफ़र केवल-पढ़ने के लिए होगा यदि, और केवल तभी, जब यह बफ़र केवल-पढ़ने के लिए हो।

यह कॉल slice(index, size() - index) के बराबर है

इस बफ़र में ऑब्जेक्ट के संदर्भों को गंतव्य सरणी में पढ़ें।

यह विधि इस बफ़र से मानों को दिए गए गंतव्य सरणी में स्थानांतरित करती है। यदि अनुरोध को पूरा करने के लिए बफ़र में आवश्यक से कम मान हैं, अर्थात, यदि dst.length > size() , तो कोई मान स्थानांतरित नहीं किया जाता है और एक बफ़रअंडरफ़्लोएक्सेप्शन फेंक दिया जाता है।

अन्यथा, यह विधि इस बफ़र से n = dst.length मानों को दिए गए सरणी में कॉपी करती है।

इस बफ़र में ऑब्जेक्ट के संदर्भों को गंतव्य सरणी में पढ़ें।

यह विधि इस बफ़र से मानों को दिए गए गंतव्य सरणी में स्थानांतरित करती है। यदि अनुरोध को पूरा करने के लिए बफ़र में आवश्यक से कम मान हैं, यानी, यदि length > size() , तो कोई मान स्थानांतरित नहीं किया जाता है और एक बफ़रअंडरफ़्लोएक्सेप्शन फेंक दिया जाता है।

अन्यथा, यह विधि इस बफ़र से n = length मानों को दिए गए ऑफसेट से शुरू करके दिए गए सरणी में कॉपी करती है।

दिए गए सूचकांक पर दिए गए मान को इस बफ़र में लिखता है। महत्वपूर्ण: इस पद्धति का उपयोग गैर-आदिम प्रकार के बफ़र्स तक सीमित होना चाहिए या जब डेटा प्रकार कॉलर द्वारा निश्चित रूप से ज्ञात नहीं होता है। किसी भी अन्य मामले में, इसके आदिम संस्करण के उपयोग को प्राथमिकता दें जो प्रदर्शन में काफी सुधार करेगा (उदाहरण के लिए IntDataBuffer.setInt(idx)

बफ़र का आकार, तत्वों में.

उदाहरण के लिए, बाइट बफ़र के मामले में, यह मान इस बफ़र द्वारा रखे जा सकने वाले बाइट्स की संख्या के बराबर है। एक पूर्णांक बफ़र के लिए, यह पूर्णांकों की संख्या के बराबर है, इसलिए इस बफ़र के बाइट्स में आकार size() * Integer.BYTES है।

एक नया बफ़र बनाता है जिसकी सामग्री इस बफ़र की सामग्री का एक साझा अनुवर्ती है, जो दिए गए सूचकांक और दिए गए आकार से शुरू होती है।

सूचकांक और नया आकार इस बफ़र आकार से अधिक नहीं होना चाहिए। इस बफ़र की सामग्री में परिवर्तन नए बफ़र में दिखाई देंगे और इसके विपरीत। नया बफ़र केवल-पढ़ने के लिए होगा यदि, और केवल तभी, जब यह बफ़र केवल-पढ़ने के लिए हो।

एक DataBufferWindow बनाता है जो इस बफ़र का आंशिक दृश्य प्रदान करता है।

बनाई गई विंडो का एक निश्चित आकार होता है और यह इस बफ़र के साथ "slide" कर सकता है ताकि नए बफ़र इंस्टेंस को आवंटित किए बिना डेटा के विभिन्न दृश्य प्रदान किए जा सकें, जैसे offset(long) करता है। जब यह ऑपरेशन बार-बार दोहराया जाता है तो इससे समग्र प्रदर्शन में सुधार होता है। उदाहरण के लिए:

IntDataBuffer bufferA = DataBuffers.ofInts(1024);
 // ... init buffer data
 IntDataBuffer bufferB = DataBuffers.ofInts(1, 2, 3, 4);

 // Return the index of the first occurrence of bufferB in bufferA using a sliding window
 DataBufferWindow<IntDataBuffer> windowA = bufferA.window(4);
 for (int i = 0; i < bufferA.size() - bufferB.size(); ++i) {
     if (windowA.slideTo(i).buffer().equals(bufferB)) {
         return i;
     
 }
 }

लौटाया गया ऑब्जेक्ट स्टेटफुल है और थ्रेड-सुरक्षित नहीं है।

इस बफ़र में स्रोत सरणी में ऑब्जेक्ट के संदर्भ लिखें।

यह विधि दिए गए स्रोत सरणी में मानों को इस बफ़र में स्थानांतरित करती है। यदि इस बफ़र की तुलना में स्रोत सरणी में अधिक मान हैं, अर्थात, यदि src.length > size() , तो कोई मान स्थानांतरित नहीं किया जाता है और एक बफ़रओवरफ़्लोएक्सेप्शन फेंक दिया जाता है।

अन्यथा, यह विधि दिए गए सरणी से n = src.length मानों की प्रतिलिपि बनाती है।

पूर्णांक सरणियों का उपयोग करते हुए बल्क पुट विधि।

यह विधि दिए गए स्रोत सरणी में मानों को इस बफ़र में स्थानांतरित करती है। यदि इस बफ़र की तुलना में स्रोत सरणी में अधिक मान हैं, यानी, यदि length > size() , तो कोई मान स्थानांतरित नहीं किया जाता है और एक बफ़रओवरफ़्लो अपवाद फेंक दिया जाता है।

अन्यथा, यह विधि दिए गए ऑफसेट से शुरू करके दिए गए सरणी से n = length मानों को इस बफ़र में कॉपी करती है।