AutoBuffer (h2o-core version 3.12.0.1 API)

java.lang.Object
- water.AutoBuffer

```
public final class AutoBuffer
extends java.lang.Object
```
A ByteBuffer backed mixed Input/Output streaming class, using Iced serialization. Reads/writes empty/fill the ByteBuffer as needed. When it is empty/full it we go to the ByteChannel for more/less. Because DirectByteBuffers are expensive to make, we keep a few pooled. When talking to a remote H2O node, switches between UDP and TCP transport protocols depending on the message size. The TypeMap is not included, and is assumed to exist on the remote H2O node. Supports direct NIO FileChannel read/write to disk, used during user-mode swapping. The TypeMap is not included on write, and is assumed to be the current map on read. Support read/write from byte[] - and this defeats the purpose of a Streaming protocol, but is frequently handy for small structures. The TypeMap is not included, and is assumed to be the current map on read. Supports read/write from a standard Stream, which by default assumes it is NOT going in and out of the same Cloud, so the TypeMap IS included. The serialized object can only be read back into the same minor version of H2O.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class AutoBuffer.AutoBufferException

Nested Classes
Modifier and Type	Class and Description
`static class`	`AutoBuffer.AutoBufferException`

Field Summary

Fields
Modifier and Type Field and Description

java.lang.String sourceName

static int TCP_BUF_SIZ

Fields
Modifier and Type	Field and Description
`java.lang.String`	`sourceName`
`static int`	`TCP_BUF_SIZ`

Constructor Summary

Constructors
Constructor and Description
`AutoBuffer()` Write to an ever-expanding byte[].
`AutoBuffer(byte[] buf)` Read from a fixed byte[]; should not be closed.
`AutoBuffer(java.nio.channels.FileChannel fc, boolean read, byte persist)` Spill-to/from-disk request.
`AutoBuffer(java.io.InputStream is)` Read from a persistent Stream (including all TypeMap info) into same exact rev of H2O).
`AutoBuffer(int len)` Write to a known sized byte[].
`AutoBuffer(java.io.OutputStream os, boolean persist)` Write to a persistent Stream, including all TypeMap info to allow later reloading (by the same exact rev of H2O).

Method Summary

Methods
Modifier and Type	Method and Description
`byte[]`	`buf()`
`byte[]`	`bufClose()`
`int`	`close()`
`AutoBuffer`	`flipForReading()`
`<T extends Freezable> T`	`get()`
`<T extends Freezable> T`	`get(java.lang.Class<T> tc)`
`byte`	`get1()`
`int`	`get1U()`
`char`	`get2()`
`short`	`get2s()`
`int`	`get3()`
`int`	`get4()`
`float`	`get4f()`
`long`	`get8()`
`double`	`get8d()`
`<T extends Freezable> T[]`	`getA(java.lang.Class<T> tc)`
`byte[]`	`getA1()`
`byte[]`	`getA1(int len)`
`short[]`	`getA2()`
`int[]`	`getA4()`
`float[]`	`getA4f()`
`long[]`	`getA8()`
`double[]`	`getA8d()`
`<T extends Freezable> T[][]`	`getAA(java.lang.Class<T> tc)`
`byte[][]`	`getAA1()`
`short[][]`	`getAA2()`
`int[][]`	`getAA4()`
`float[][]`	`getAA4f()`
`long[][]`	`getAA8()`
`double[][]`	`getAA8d()`
`<T extends Freezable> T[][][]`	`getAAA(java.lang.Class<T> tc)`
`int[][][]`	`getAAA4()`
`long[][][]`	`getAAA8()`
`double[][][]`	`getAAA8d()`
`<T> T[][][]`	`getAAASer(java.lang.Class<T> tc)`
`<T> T[][]`	`getAASer(java.lang.Class<T> tc)`
`java.lang.String[][]`	`getAAStr()`
`<E extends java.lang.Enum> E[]`	`getAEnum(E[] values)`
`<T> T[]`	`getASer(java.lang.Class<T> tc)`
`java.lang.String[]`	`getAStr()`
`boolean[]`	`getAZ()`
`<E extends java.lang.Enum> E`	`getEnum(E[] values)`
`Keyed`	`getKey(Futures fs)`
`Keyed`	`getKey(Key k, Futures fs)`
`java.lang.Object`	`getSer()`
`<T> T`	`getSer(java.lang.Class<T> tc)`
`java.lang.String`	`getStr()`
`java.lang.String`	`getStr(int off, int len)`
`boolean`	`getZ()`
`boolean`	`isClosed()`
`static java.lang.Object`	`javaSerializeReadPojo(byte[] bytes)`
`static byte[]`	`javaSerializeWritePojo(java.lang.Object o)`
`int`	`position()`
`AutoBuffer`	`position(int p)`
`AutoBuffer`	`put(Freezable f)`
`AutoBuffer`	`put1(int b)`
`AutoBuffer`	`put2(char c)`
`AutoBuffer`	`put2(short s)`
`AutoBuffer`	`put2s(short s)`
`AutoBuffer`	`put3(int x)`
`AutoBuffer`	`put4(int i)`
`AutoBuffer`	`put4f(float f)`
`AutoBuffer`	`put8(long l)`
`AutoBuffer`	`put8d(double d)`
`AutoBuffer`	`putA(Freezable[] fs)`
`AutoBuffer`	`putA1(byte[] ary)`
`AutoBuffer`	`putA1(byte[] ary, int length)`
`AutoBuffer`	`putA1(byte[] ary, int sofar, int length)`
`AutoBuffer`	`putA4(int[] ary)`
`AutoBuffer`	`putA4f(float[] ary)`
`AutoBuffer`	`putA8(long[] ary)`
`AutoBuffer`	`putA8d(double[] ary)`
`AutoBuffer`	`putAA(Freezable[][] fs)`
`AutoBuffer`	`putAA1(byte[][] ary)`
`AutoBuffer`	`putAA4(int[][] ary)`
`AutoBuffer`	`putAA4f(float[][] ary)`
`AutoBuffer`	`putAA8(long[][] ary)`
`AutoBuffer`	`putAA8d(double[][] ary)`
`AutoBuffer`	`putAAA(Freezable[][][] fs)`
`AutoBuffer`	`putAAA4(int[][][] ary)`
`AutoBuffer`	`putAAA8(long[][][] ary)`
`AutoBuffer`	`putAAA8d(double[][][] ary)`
`AutoBuffer`	`putAAASer(java.lang.Object[][][] fs)`
`AutoBuffer`	`putAASer(java.lang.Object[][] fs)`
`AutoBuffer`	`putAAStr(java.lang.String[][] fs)`
`AutoBuffer`	`putAEnum(java.lang.Enum[] enums)`
`AutoBuffer`	`putASer(java.lang.Object[] fs)`
`AutoBuffer`	`putAStr(java.lang.String[] fs)`
`AutoBuffer`	`putAZ(boolean[] ary)`
`AutoBuffer`	`putEnum(java.lang.Enum x)`
`AutoBuffer`	`putInt(int x)`
`AutoBuffer`	`putJNULL()`
`AutoBuffer`	`putJSON(Freezable ice)`
`AutoBuffer`	`putJSON(java.lang.String name, Freezable f)`
`AutoBuffer`	`putJSON1(byte b)`
`AutoBuffer`	`putJSON1(java.lang.String name, byte b)`
`AutoBuffer`	`putJSON4(int i)`
`AutoBuffer`	`putJSON4(java.lang.String name, int i)`
`AutoBuffer`	`putJSON4f(java.lang.String name, float f)`
`AutoBuffer`	`putJSON8(java.lang.String name, long l)`
`AutoBuffer`	`putJSON8d(java.lang.String name, double d)`
`AutoBuffer`	`putJSONA(Freezable[] fs)`
`AutoBuffer`	`putJSONA(java.lang.String name, Freezable[] f)`
`AutoBuffer`	`putJSONA1(byte[] ary)`
`AutoBuffer`	`putJSONA1(java.lang.String name, byte[] b)`
`AutoBuffer`	`putJSONA2(java.lang.String name, short[] ary)`
`AutoBuffer`	`putJSONA4(java.lang.String name, int[] a)`
`AutoBuffer`	`putJSONA4f(java.lang.String name, float[] a)`
`AutoBuffer`	`putJSONA8(java.lang.String name, long[] ary)`
`AutoBuffer`	`putJSONA8d(double[] a)`
`AutoBuffer`	`putJSONA8d(java.lang.String name, double[] a)`
`AutoBuffer`	`putJSONAA(Freezable[][] fs)`
`AutoBuffer`	`putJSONAA(java.lang.String name, Freezable[][] f)`
`AutoBuffer`	`putJSONAA1(java.lang.String name, byte[][] b)`
`AutoBuffer`	`putJSONAA4(java.lang.String name, int[][] a)`
`AutoBuffer`	`putJSONAA8(java.lang.String name, long[][] ary)`
`AutoBuffer`	`putJSONAA8d(double[][] a)`
`AutoBuffer`	`putJSONAA8d(java.lang.String name, double[][] a)`
`AutoBuffer`	`putJSONAAA(Freezable[][][] fs)`
`AutoBuffer`	`putJSONAAA(java.lang.String name, Freezable[][][] f)`
`AutoBuffer`	`putJSONAAA4(java.lang.String name, int[][][] a)`
`AutoBuffer`	`putJSONAAA8(java.lang.String name, long[][][] ary)`
`AutoBuffer`	`putJSONAAA8d(java.lang.String name, double[][][] a)`
`AutoBuffer`	`putJSONAAASer(java.lang.String name, java.lang.Object[][][] oooo)`
`AutoBuffer`	`putJSONAASer(java.lang.String name, java.lang.Object[][] ooo)`
`AutoBuffer`	`putJSONAAStr(java.lang.String name, java.lang.String[][] sss)`
`AutoBuffer`	`putJSONAEnum(java.lang.Enum[] enums)`
`AutoBuffer`	`putJSONAEnum(java.lang.String name, java.lang.Enum[] enums)`
`AutoBuffer`	`putJSONASer(java.lang.String name, java.lang.Object[] oo)`
`AutoBuffer`	`putJSONAStr(java.lang.String[] ss)`
`AutoBuffer`	`putJSONAStr(java.lang.String name, java.lang.String[] ss)`
`AutoBuffer`	`putJSONAZ(java.lang.String name, boolean[] f)`
`AutoBuffer`	`putJSONEnum(java.lang.String name, java.lang.Enum e)`
`AutoBuffer`	`putJSONName(java.lang.String s)`
`AutoBuffer`	`putJSONSer(java.lang.String name, java.lang.Object o)`
`AutoBuffer`	`putJSONStr(java.lang.String s)`
`AutoBuffer`	`putJSONStr(java.lang.String name, java.lang.String s)`
`AutoBuffer`	`putJSONStrUnquoted(java.lang.String s)`
`AutoBuffer`	`putJSONStrUnquoted(java.lang.String name, java.lang.String s)`
`AutoBuffer`	`putJSONZ(java.lang.String name, boolean value)`
`AutoBuffer`	`putKey(Key k)`
`AutoBuffer`	`putSer(java.lang.Object obj)`
`AutoBuffer`	`putStr(java.lang.String s)`
`AutoBuffer`	`putZ(boolean b)`
`void`	`skip(int skip)` Skip over some bytes in the byte buffer.
`java.lang.String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

sourceName
```
public java.lang.String sourceName
```

TCP_BUF_SIZ
```
public static int TCP_BUF_SIZ
```

Constructor Detail
- AutoBuffer
```
public AutoBuffer(java.nio.channels.FileChannel fc,
          boolean read,
          byte persist)
```
  Spill-to/from-disk request.
- AutoBuffer
```
public AutoBuffer(byte[] buf)
```
  Read from a fixed byte[]; should not be closed.
- AutoBuffer
```
public AutoBuffer()
```
  Write to an ever-expanding byte[]. Instead of calling close(), call buf() to retrieve the final byte[].
- AutoBuffer
```
public AutoBuffer(int len)
```
  Write to a known sized byte[]. Instead of calling close(), call bufClose() to retrieve the final byte[].
- AutoBuffer
```
public AutoBuffer(java.io.OutputStream os,
          boolean persist)
```
  Write to a persistent Stream, including all TypeMap info to allow later reloading (by the same exact rev of H2O).
- AutoBuffer
```
public AutoBuffer(java.io.InputStream is)
```
  Read from a persistent Stream (including all TypeMap info) into same exact rev of H2O).

Method Detail

isClosed
```
public boolean isClosed()
```

toString
```
public java.lang.String toString()
```
Overrides:

toString in class java.lang.Object

close
```
public final int close()
```

position
```
public int position()
```

position
```
public AutoBuffer position(int p)
```

skip
```
public void skip(int skip)
```
Skip over some bytes in the byte buffer. Caller is responsible for not reading off end of the bytebuffer; generally this is easy for array-backed autobuffers and difficult for i/o-backed bytebuffers.

buf
```
public final byte[] buf()
```

bufClose
```
public final byte[] bufClose()
```

flipForReading
```
public AutoBuffer flipForReading()
```

getStr

public java.lang.String getStr(int off,
                      int len)

getZ
```
public boolean getZ()
```

get1
```
public byte get1()
```

get1U
```
public int get1U()
```

get2
```
public char get2()
```

get2s
```
public short get2s()
```

get3
```
public int get3()
```

get4
```
public int get4()
```

get4f
```
public float get4f()
```

get8
```
public long get8()
```

get8d
```
public double get8d()
```

putZ
```
public AutoBuffer putZ(boolean b)
```

put1
```
public AutoBuffer put1(int b)
```

put2
```
public AutoBuffer put2(char c)
```

put2
```
public AutoBuffer put2(short s)
```

put2s
```
public AutoBuffer put2s(short s)
```

put3
```
public AutoBuffer put3(int x)
```

put4
```
public AutoBuffer put4(int i)
```

put4f
```
public AutoBuffer put4f(float f)
```

put8
```
public AutoBuffer put8(long l)
```

put8d
```
public AutoBuffer put8d(double d)
```

put
```
public AutoBuffer put(Freezable f)
```

get
```
public <T extends Freezable> T get()
```

get

public <T extends Freezable> T get(java.lang.Class<T> tc)

putKey
```
public AutoBuffer putKey(Key k)
```

getKey

public Keyed getKey(Key k,
           Futures fs)

getKey
```
public Keyed getKey(Futures fs)
```

putInt
```
public AutoBuffer putInt(int x)
```

putAEnum

public AutoBuffer putAEnum(java.lang.Enum[] enums)

getAEnum

public <E extends java.lang.Enum> E[] getAEnum(E[] values)

putA

public AutoBuffer putA(Freezable[] fs)

putAA

public AutoBuffer putAA(Freezable[][] fs)

putAAA

public AutoBuffer putAAA(Freezable[][][] fs)

getA

public <T extends Freezable> T[] getA(java.lang.Class<T> tc)

getAA

public <T extends Freezable> T[][] getAA(java.lang.Class<T> tc)

getAAA

public <T extends Freezable> T[][][] getAAA(java.lang.Class<T> tc)

putAStr

public AutoBuffer putAStr(java.lang.String[] fs)

getAStr
```
public java.lang.String[] getAStr()
```

putAAStr

public AutoBuffer putAAStr(java.lang.String[][] fs)

getAAStr

public java.lang.String[][] getAAStr()

getAZ
```
public boolean[] getAZ()
```

getA1
```
public byte[] getA1()
```

getA1
```
public byte[] getA1(int len)
```

getA2
```
public short[] getA2()
```

getA4
```
public int[] getA4()
```

getA4f
```
public float[] getA4f()
```

getA8
```
public long[] getA8()
```

getA8d
```
public double[] getA8d()
```

getAA1
```
public byte[][] getAA1()
```

getAA2
```
public short[][] getAA2()
```

getAA4
```
public int[][] getAA4()
```

getAA4f
```
public float[][] getAA4f()
```

getAA8
```
public long[][] getAA8()
```

getAA8d
```
public double[][] getAA8d()
```

getAAA4
```
public int[][][] getAAA4()
```

getAAA8
```
public long[][][] getAAA8()
```

getAAA8d
```
public double[][][] getAAA8d()
```

getStr
```
public java.lang.String getStr()
```

getEnum

public <E extends java.lang.Enum> E getEnum(E[] values)

putAZ

public AutoBuffer putAZ(boolean[] ary)

putA1
```
public AutoBuffer putA1(byte[] ary)
```

putA1

public AutoBuffer putA1(byte[] ary,
               int length)

putA1

public AutoBuffer putA1(byte[] ary,
               int sofar,
               int length)

putA4
```
public AutoBuffer putA4(int[] ary)
```

putA8
```
public AutoBuffer putA8(long[] ary)
```

putA4f

public AutoBuffer putA4f(float[] ary)

putA8d

public AutoBuffer putA8d(double[] ary)

putAA1

public AutoBuffer putAA1(byte[][] ary)

putAA4

public AutoBuffer putAA4(int[][] ary)

putAA4f

public AutoBuffer putAA4f(float[][] ary)

putAA8

public AutoBuffer putAA8(long[][] ary)

putAA8d

public AutoBuffer putAA8d(double[][] ary)

putAAA4

public AutoBuffer putAAA4(int[][][] ary)

putAAA8

public AutoBuffer putAAA8(long[][][] ary)

putAAA8d

public AutoBuffer putAAA8d(double[][][] ary)

putStr

public AutoBuffer putStr(java.lang.String s)

putEnum

public AutoBuffer putEnum(java.lang.Enum x)

javaSerializeWritePojo

public static byte[] javaSerializeWritePojo(java.lang.Object o)

javaSerializeReadPojo

public static java.lang.Object javaSerializeReadPojo(byte[] bytes)

putSer

public AutoBuffer putSer(java.lang.Object obj)

putASer

public AutoBuffer putASer(java.lang.Object[] fs)

putAASer

public AutoBuffer putAASer(java.lang.Object[][] fs)

putAAASer

public AutoBuffer putAAASer(java.lang.Object[][][] fs)

getSer
```
public java.lang.Object getSer()
```

getSer

public <T> T getSer(java.lang.Class<T> tc)

getASer

public <T> T[] getASer(java.lang.Class<T> tc)

getAASer

public <T> T[][] getAASer(java.lang.Class<T> tc)

getAAASer

public <T> T[][][] getAAASer(java.lang.Class<T> tc)

putJNULL
```
public AutoBuffer putJNULL()
```

putJSONStrUnquoted

public AutoBuffer putJSONStrUnquoted(java.lang.String s)

putJSONStrUnquoted

public AutoBuffer putJSONStrUnquoted(java.lang.String name,
                            java.lang.String s)

putJSONName

public AutoBuffer putJSONName(java.lang.String s)

putJSONStr

public AutoBuffer putJSONStr(java.lang.String s)

putJSONAStr

public AutoBuffer putJSONAStr(java.lang.String[] ss)

putJSONStr

public AutoBuffer putJSONStr(java.lang.String name,
                    java.lang.String s)

putJSONAStr

public AutoBuffer putJSONAStr(java.lang.String name,
                     java.lang.String[] ss)

putJSONAAStr

public AutoBuffer putJSONAAStr(java.lang.String name,
                      java.lang.String[][] sss)

putJSONSer

public AutoBuffer putJSONSer(java.lang.String name,
                    java.lang.Object o)

putJSONASer

public AutoBuffer putJSONASer(java.lang.String name,
                     java.lang.Object[] oo)

putJSONAASer

public AutoBuffer putJSONAASer(java.lang.String name,
                      java.lang.Object[][] ooo)

putJSONAAASer

public AutoBuffer putJSONAAASer(java.lang.String name,
                       java.lang.Object[][][] oooo)

putJSONAZ

public AutoBuffer putJSONAZ(java.lang.String name,
                   boolean[] f)

putJSON

public AutoBuffer putJSON(Freezable ice)

putJSONA

public AutoBuffer putJSONA(Freezable[] fs)

putJSONAA

public AutoBuffer putJSONAA(Freezable[][] fs)

putJSONAAA

public AutoBuffer putJSONAAA(Freezable[][][] fs)

putJSON

public AutoBuffer putJSON(java.lang.String name,
                 Freezable f)

putJSONA

public AutoBuffer putJSONA(java.lang.String name,
                  Freezable[] f)

putJSONAA

public AutoBuffer putJSONAA(java.lang.String name,
                   Freezable[][] f)

putJSONAAA

public AutoBuffer putJSONAAA(java.lang.String name,
                    Freezable[][][] f)

putJSONZ

public AutoBuffer putJSONZ(java.lang.String name,
                  boolean value)

putJSON1
```
public AutoBuffer putJSON1(byte b)
```

putJSONA1

public AutoBuffer putJSONA1(byte[] ary)

putJSON1

public AutoBuffer putJSON1(java.lang.String name,
                  byte b)

putJSONA1

public AutoBuffer putJSONA1(java.lang.String name,
                   byte[] b)

putJSONAA1

public AutoBuffer putJSONAA1(java.lang.String name,
                    byte[][] b)

putJSONAEnum

public AutoBuffer putJSONAEnum(java.lang.String name,
                      java.lang.Enum[] enums)

putJSONAEnum

public AutoBuffer putJSONAEnum(java.lang.Enum[] enums)

putJSONA2

public AutoBuffer putJSONA2(java.lang.String name,
                   short[] ary)

putJSON8

public AutoBuffer putJSON8(java.lang.String name,
                  long l)

putJSONEnum

public AutoBuffer putJSONEnum(java.lang.String name,
                     java.lang.Enum e)

putJSONA8

public AutoBuffer putJSONA8(java.lang.String name,
                   long[] ary)

putJSONAA8

public AutoBuffer putJSONAA8(java.lang.String name,
                    long[][] ary)

putJSONAAA8

public AutoBuffer putJSONAAA8(java.lang.String name,
                     long[][][] ary)

putJSON4
```
public AutoBuffer putJSON4(int i)
```

putJSON4

public AutoBuffer putJSON4(java.lang.String name,
                  int i)

putJSONA4

public AutoBuffer putJSONA4(java.lang.String name,
                   int[] a)

putJSONAA4

public AutoBuffer putJSONAA4(java.lang.String name,
                    int[][] a)

putJSONAAA4

public AutoBuffer putJSONAAA4(java.lang.String name,
                     int[][][] a)

putJSON4f

public AutoBuffer putJSON4f(java.lang.String name,
                   float f)

putJSONA4f

public AutoBuffer putJSONA4f(java.lang.String name,
                    float[] a)

putJSON8d

public AutoBuffer putJSON8d(java.lang.String name,
                   double d)

putJSONA8d

public AutoBuffer putJSONA8d(java.lang.String name,
                    double[] a)

putJSONAA8d

public AutoBuffer putJSONAA8d(java.lang.String name,
                     double[][] a)

putJSONAAA8d

public AutoBuffer putJSONAAA8d(java.lang.String name,
                      double[][][] a)

putJSONA8d

public AutoBuffer putJSONA8d(double[] a)

putJSONAA8d

public AutoBuffer putJSONAA8d(double[][] a)

Class AutoBuffer

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

sourceName

TCP_BUF_SIZ

Constructor Detail

AutoBuffer

AutoBuffer

AutoBuffer

AutoBuffer

AutoBuffer

AutoBuffer

Method Detail

isClosed

toString

close

position

position

skip

buf

bufClose

flipForReading

getStr

getZ

get1

get1U

get2

get2s

get3

get4

get4f

get8

get8d

putZ

put1

put2

put2

put2s

put3

put4

put4f

put8

put8d

put

get

get

putKey

getKey

getKey

putInt

putAEnum

getAEnum

putA

putAA

putAAA

getA

getAA

getAAA

putAStr

getAStr

putAAStr

getAAStr

getAZ

getA1

getA1

getA2

getA4

getA4f

getA8

getA8d

getAA1

getAA2

getAA4

getAA4f

getAA8

getAA8d