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