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));
         }
     };
 }