add more buffer feature.

Signed-off-by: stream <stream1984@gmail.com>

src/main/java/io/vertx/core/buffer/Buffer.java

@@ -57,7 +57,7 @@ static Buffer buffer() {
    * If you know the buffer will require a certain size, providing the hint can prevent unnecessary re-allocations
    * as the buffer is written to and resized.
    *
-   * @param initialSizeHint  the hint, in bytes
+   * @param initialSizeHint the hint, in bytes
    * @return the buffer
    */
   static Buffer buffer(int initialSizeHint) {
@@ -67,8 +67,8 @@ static Buffer buffer(int initialSizeHint) {
   /**
    * Create a new buffer from a string. The string will be UTF-8 encoded into the buffer.
    *
-   * @param string  the string
-   * @return  the buffer
+   * @param string the string
+   * @return the buffer
    */
   static Buffer buffer(String string) {
     return factory.buffer(string);
@@ -78,8 +78,8 @@ static Buffer buffer(String string) {
    * Create a new buffer from a string and using the specified encoding.
    * The string will be encoded into the buffer using the specified encoding.
    *
-   * @param string  the string
-   * @return  the buffer
+   * @param string the string
+   * @return the buffer
    */
   static Buffer buffer(String string, String enc) {
     return factory.buffer(string, enc);
@@ -88,8 +88,8 @@ static Buffer buffer(String string, String enc) {
   /**
    * Create a new buffer from a byte[]. The byte[] will be copied to form the buffer.
    *
-   * @param bytes  the byte array
-   * @return  the buffer
+   * @param bytes the byte array
+   * @return the buffer
    */
   @GenIgnore
   static Buffer buffer(byte[] bytes) {
@@ -110,7 +110,7 @@ static Buffer buffer(byte[] bytes) {
    *   Buffer clone = Buffer.buffer(src.getByteBuf());
    * </pre>
    *
-   * @param byteBuf  the Netty ByteBuf
+   * @param byteBuf the Netty ByteBuf
    * @return the buffer
    */
   @GenIgnore
@@ -165,20 +165,40 @@ static Buffer buffer(ByteBuf byteBuf) {
    */
   int getInt(int pos);
 
+  /**
+   * Gets a 32-bit integer at the specified absolute {@code index} in this buffer with Little Endian Byte Order.
+   *
+   * @throws IndexOutOfBoundsException if the specified {@code index} is less than {@code 0} or {@code index + 4} is greater than {@code this.capacity}
+   */
+  int getIntLE(int pos);
+
   /**
    * Returns the unsigned {@code int} at position {@code pos} in the Buffer, as a {@code long}.
    *
    * @throws IndexOutOfBoundsException if the specified {@code pos} is less than {@code 0} or {@code pos + 4} is greater than the length of the Buffer.
    */
   long getUnsignedInt(int pos);
 
+  /**
+   * @param pos
+   * @return
+   */
+  long getUnsignedIntLE(int pos);
+
   /**
    * Returns the {@code long} at position {@code pos} in the Buffer.
    *
    * @throws IndexOutOfBoundsException if the specified {@code pos} is less than {@code 0} or {@code pos + 8} is greater than the length of the Buffer.
    */
   long getLong(int pos);
 
+  /**
+   * Gets a 64-bit long integer at the specified absolute {@code index} in this buffer in Little Endian Byte Order.
+   *
+   * @throws IndexOutOfBoundsException if the specified {@code index} is less than {@code 0} or {@code index + 8} is greater than the length of the Buffer.
+   */
+  long getLongLE(int pos);
+
   /**
    * Returns the {@code double} at position {@code pos} in the Buffer.
    *
@@ -200,13 +220,55 @@ static Buffer buffer(ByteBuf byteBuf) {
    */
   short getShort(int pos);
 
+  /**
+   * Gets a 16-bit short integer at the specified absolute {@code index} in this buffer in Little Endian Byte Order.
+   *
+   * @throws IndexOutOfBoundsException if the specified {@code index} is less than {@code 0} or {@code index + 2} is greater than the length of the Buffer.
+   */
+  short getShortLE(int pos);
+
   /**
    * Returns the unsigned {@code short} at position {@code pos} in the Buffer, as an {@code int}.
    *
    * @throws IndexOutOfBoundsException if the specified {@code pos} is less than {@code 0} or {@code pos + 2} is greater than the length of the Buffer.
    */
   int getUnsignedShort(int pos);
 
+  /**
+   * Gets an unsigned 16-bit short integer at the specified absolute {@code index} in this buffer in Little Endian Byte Order.
+   *
+   * @throws IndexOutOfBoundsException if the specified {@code index} is less than {@code 0} or {@code index + 2} is greater than the length of the Buffer.
+   */
+  int getUnsignedShortLE(int pos);
+
+  /**
+   * Gets a 24-bit medium integer at the specified absolute {@code index} in this buffer.
+   *
+   * @throws IndexOutOfBoundsException if the specified {@code index} is less than {@code 0} or {@code index + 3} is greater than the length of the Buffer.
+   */
+  int getMedium(int pos);
+
+  /**
+   * Gets a 24-bit medium integer at the specified absolute {@code index} in this buffer in the Little Endian Byte Order.
+   *
+   * @throws IndexOutOfBoundsException if the specified {@code index} is less than {@code 0} or {@code index + 3} is greater than the length of the Buffer.
+   */
+  int getMediumLE(int pos);
+
+  /**
+   * Gets an unsigned 24-bit medium integer at the specified absolute {@code index} in this buffer.
+   *
+   * @throws IndexOutOfBoundsException if the specified {@code index} is less than {@code 0} or {@code index + 3} is greater than the length of the Buffer.
+   */
+  int getUnsignedMedium(int pos);
+
+  /**
+   * Gets an unsigned 24-bit medium integer at the specified absolute {@code index} in this buffer in Little Endian Byte Order.
+   *
+   * @throws IndexOutOfBoundsException if the specified {@code index} is less than {@code 0} or {@code index + 3} is greater than the length of the Buffer.
+   */
+  int getUnsignedMediumLE(int pos);
+
   /**
    * Returns a copy of the entire Buffer as a {@code byte[]}
    */
@@ -330,34 +392,83 @@ static Buffer buffer(ByteBuf byteBuf) {
   @Fluent
   Buffer appendInt(int i);
 
+  /**
+   * Appends the specified {@code int} to the end of the Buffer in the Little Endian Byte Order. The buffer will expand as necessary to accommodate any bytes written.<p>
+   * Returns a reference to {@code this} so multiple operations can be appended together.
+   */
+  @Fluent
+  Buffer appendIntLE(int i);
+
   /**
    * Appends the specified unsigned {@code int} to the end of the Buffer. The buffer will expand as necessary to accommodate any bytes written.<p>
    * Returns a reference to {@code this} so multiple operations can be appended together.
    */
   @Fluent
   Buffer appendUnsignedInt(long i);
 
+  /**
+   * Appends the specified unsigned {@code int} to the end of the Buffer in the Little Endian Byte Order. The buffer will expand as necessary to accommodate any bytes written.<p>
+   * Returns a reference to {@code this} so multiple operations can be appended together.
+   */
+  @Fluent
+  Buffer appendUnsignedIntLE(long i);
+
+  /**
+   * Appends the specified 24bit {@code int} to the end of the Buffer. The buffer will expand as necessary to accommodate any bytes written.<p>
+   * Returns a reference to {@code this} so multiple operations can be appended together.
+   */
+  @Fluent
+  Buffer appendMedium(int i);
+
+  /**
+   * Appends the specified 24bit {@code int} to the end of the Buffer in the Little Endian Byte Order. The buffer will expand as necessary to accommodate any bytes written.<p>
+   * Returns a reference to {@code this} so multiple operations can be appended together.
+   */
+  @Fluent
+  Buffer appendMediumLE(int i);
+
   /**
    * Appends the specified {@code long} to the end of the Buffer. The buffer will expand as necessary to accommodate any bytes written.<p>
    * Returns a reference to {@code this} so multiple operations can be appended together.
    */
   @Fluent
   Buffer appendLong(long l);
 
+  /**
+   * Appends the specified {@code long} to the end of the Buffer in the Little Endian Byte Order. The buffer will expand as necessary to accommodate any bytes written.<p>
+   * Returns a reference to {@code this} so multiple operations can be appended together.
+   */
+  @Fluent
+  Buffer appendLongLE(long l);
+
   /**
    * Appends the specified {@code short} to the end of the Buffer.The buffer will expand as necessary to accommodate any bytes written.<p>
    * Returns a reference to {@code this} so multiple operations can be appended together.
    */
   @Fluent
   Buffer appendShort(short s);
 
+  /**
+   * Appends the specified {@code short} to the end of the Buffer in the Little Endian Byte Order.The buffer will expand as necessary to accommodate any bytes written.<p>
+   * Returns a reference to {@code this} so multiple operations can be appended together.
+   */
+  @Fluent
+  Buffer appendShortLE(short s);
+
   /**
    * Appends the specified unsigned {@code short} to the end of the Buffer.The buffer will expand as necessary to accommodate any bytes written.<p>
    * Returns a reference to {@code this} so multiple operations can be appended together.
    */
   @Fluent
   Buffer appendUnsignedShort(int s);
 
+  /**
+   * Appends the specified unsigned {@code short} to the end of the Buffer in the Little Endian Byte Order.The buffer will expand as necessary to accommodate any bytes written.<p>
+   * Returns a reference to {@code this} so multiple operations can be appended together.
+   */
+  @Fluent
+  Buffer appendUnsignedShortLE(int s);
+
   /**
    * Appends the specified {@code float} to the end of the Buffer. The buffer will expand as necessary to accommodate any bytes written.<p>
    * Returns a reference to {@code this} so multiple operations can be appended together.
@@ -408,20 +519,55 @@ static Buffer buffer(ByteBuf byteBuf) {
   @Fluent
   Buffer setInt(int pos, int i);
 
+  /**
+   * Sets the {@code int} at position {@code pos} in the Buffer to the value {@code i} in the Little Endian Byte Order.<p>
+   * The buffer will expand as necessary to accommodate any value written.
+   */
+  @Fluent
+  Buffer setIntLE(int pos, int i);
+
   /**
    * Sets the unsigned {@code int} at position {@code pos} in the Buffer to the value {@code i}.<p>
    * The buffer will expand as necessary to accommodate any value written.
    */
   @Fluent
   Buffer setUnsignedInt(int pos, long i);
 
+  /**
+   * Sets the unsigned {@code int} at position {@code pos} in the Buffer to the value {@code i} in the Little Endian Byte Order.<p>
+   * The buffer will expand as necessary to accommodate any value written.
+   */
+  @Fluent
+  Buffer setUnsignedIntLE(int pos, long i);
+
+  /**
+   * Sets the 24bit {@code int} at position {@code pos} in the Buffer to the value {@code i}.<p>
+   * The buffer will expand as necessary to accommodate any value written.
+   */
+  @Fluent
+  Buffer setMedium(int pos, int i);
+
+  /**
+   * Sets the 24bit {@code int} at position {@code pos} in the Buffer to the value {@code i}. in the Little Endian Byte Order<p>
+   * The buffer will expand as necessary to accommodate any value written.
+   */
+  @Fluent
+  Buffer setMediumLE(int pos, int i);
+
   /**
    * Sets the {@code long} at position {@code pos} in the Buffer to the value {@code l}.<p>
    * The buffer will expand as necessary to accommodate any value written.
    */
   @Fluent
   Buffer setLong(int pos, long l);
 
+  /**
+   * Sets the {@code long} at position {@code pos} in the Buffer to the value {@code l} in the Little Endian Byte Order.<p>
+   * The buffer will expand as necessary to accommodate any value written.
+   */
+  @Fluent
+  Buffer setLongLE(int pos, long l);
+
   /**
    * Sets the {@code double} at position {@code pos} in the Buffer to the value {@code d}.<p>
    * The buffer will expand as necessary to accommodate any value written.
@@ -443,13 +589,27 @@ static Buffer buffer(ByteBuf byteBuf) {
   @Fluent
   Buffer setShort(int pos, short s);
 
+  /**
+   * Sets the {@code short} at position {@code pos} in the Buffer to the value {@code s} in the Little Endian Byte Order.<p>
+   * The buffer will expand as necessary to accommodate any value written.
+   */
+  @Fluent
+  Buffer setShortLE(int pos, short s);
+
   /**
    * Sets the unsigned {@code short} at position {@code pos} in the Buffer to the value {@code s}.<p>
    * The buffer will expand as necessary to accommodate any value written.
    */
   @Fluent
   Buffer setUnsignedShort(int pos, int s);
 
+  /**
+   * Sets the unsigned {@code short} at position {@code pos} in the Buffer to the value {@code s} in the Little Endian Byte Order.<p>
+   * The buffer will expand as necessary to accommodate any value written.
+   */
+  @Fluent
+  Buffer setUnsignedShortLE(int pos, int s);
+
   /**
    * Sets the bytes at position {@code pos} in the Buffer to the bytes represented by the {@code Buffer b}.<p>
    * The buffer will expand as necessary to accommodate any value written.