DataLayout

बफ़र में संग्रहीत डेटा को किसी दिए गए प्रकार में परिवर्तित करता है।

DataLayout उदाहरणों का उपयोग DataBuffer के डेटा को संग्रहीत करने और पढ़ने के लिए एक कस्टम प्रारूप को परिभाषित करने के लिए किया जाता है। वे बफ़र में संग्रहीत डेटा के प्रकार ( बफ़र प्रकार) और अंतिम उपयोगकर्ता द्वारा हेरफेर किए गए डेटा के प्रकार ( उपयोगकर्ता प्रकार) के बीच एक पृथक्करण परत प्रदान करते हैं।

चूँकि लिखे या पढ़े गए प्रत्येक मान के लिए रूपांतरण विधियाँ लागू की जाती हैं, डेटा लेआउट के साथ काम करने से प्रदर्शन पर नकारात्मक प्रभाव पड़ सकता है, इसलिए जब भी संभव हो सीधे आदिम प्रकारों का उपयोग करना पसंद किया जाना चाहिए।

अपरिवर्तनीय डेटा लेआउट को लागू करने की भी सिफारिश की जाती है ताकि उनमें से प्रत्येक के लिए एक नया उदाहरण पुनः आवंटित किए बिना उन्हें कई बफ़र्स पर फिर से लागू किया जा सके। उदाहरण के लिए:

 class BigIntegerBufferAllocator {

     public DataBuffer<BigInteger> allocate(long size) {
         return LAYOUT.applyTo(DataBuffers.ofLongs(size * LAYOUT.scale()));  // scale is 1 by default
     }

     private static final DataLayout<LongDataBuffer, BigInteger> LAYOUT = new DataLayout<LongDataBuffer, BigInteger>() {

         @Override
         public void writeObject(LongDataBuffer buffer, BigInteger value, long index) {
             buffer.setLong(value.longValue(), index);
         }

         @Override
         public BigInteger readObject(LongDataBuffer buffer, long index) {
             return BigInteger.valueOf(buffer.getLong(index));
         }
     };
 }