Java ByteBuffer wrap()方法及示例

wrap(byte[] array)

java.nio.ByteBuffer 类的 wrap() 方法用于将一个字节数组包裹成一个缓冲区。新的缓冲区将以给定的字节数组为后盾；也就是说，对缓冲区的修改将导致数组的修改，反之亦然。新缓冲区的容量和限制将是array.length，它的位置将是0，它的标记将是未定义的。它的支持数组将是给定的数组，它的数组偏移将是零。

语法

public static ByteBuffer wrap(float[] array)

参数： 该方法接收一个浮点数组作为参数，该数组将支持这个缓冲区。

返回值： 该方法返回新的字节缓冲区。

下面是一些例子来说明 wrap() 方法。

例子 1:

// Java program to demonstrate
// wrap() method
  
import java.nio.*;
import java.util.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // Declare and initialize the byte array
        byte[] bbb = { 10, 20, 30 };
  
        // print the byte array length
        System.out.println("Array length : "
                           + bbb.length);
  
        // print the byte array element
        System.out.println("\nArray element : "
                           + Arrays.toString(bbb));
  
        // wrap the byte array into byteBuffer
        // using wrap() method
        ByteBuffer byteBuffer = ByteBuffer.wrap(bbb);
  
        // Rewind the ByteBuffer
        byteBuffer.rewind();
  
        // print the byte buffer
        System.out.println("\nbyteBuffer : "
                           + Arrays.toString(byteBuffer.array()));
  
        // print the ByteBuffer capacity
        System.out.println("\nbyteBuffer capacity : "
                           + byteBuffer.capacity());
  
        // print the ByteBuffer position
        System.out.println("\nbyteBuffer position:  "
                           + byteBuffer.position());
    }
}

输出。

Array length : 3

Array element : [10, 20, 30]

byteBuffer : [10, 20, 30]

byteBuffer capacity : 3

byteBuffer position:  0

参考资料: https://docs.oracle.com/javase/9/docs/api/java/nio/ByteBuffer.html#wrap-byte:A-

wrap(byte[] array, int offset, int length)

新的缓冲区将由给定的字节数组支持；也就是说，对缓冲区的修改将导致数组的修改，反之亦然。新的缓冲区的容量将是array.length，它的位置将是offset，它的极限将是offset + length，它的标记将是undefined。它的支持数组将是给定的数组，它的数组偏移将是0。

语法:

public static ByteBuffer wrap(byte[] array, 
                          int offset, int length)

参数： 该方法需要以下参数。

array: 将支持新缓冲区的数组。
offset: 要使用的子数组的偏移量；必须是非负数，并且不大于array.length。新缓冲区的位置将被设置为这个值。
length: 要使用的子数组的长度；必须是非负数，并且不大于array.length – offset。新缓冲区的极限将被设置为offset + length。

返回值： 该方法返回新的字节缓冲区。

抛出： 该方法抛出 IndexOutOfBoundsException （如果offset和length参数的前提条件不成立）。

下面是说明wrap()方法的例子。

例子 1 :

// Java program to demonstrate
// wrap() method
  
import java.nio.*;
import java.util.*;
  
public class GFG {
  
    public static void main(String[] args)
    {
  
        // Declare and initialize the byte array
        byte[] bbb = { 10, 20, 30 };
  
        // print the byte array length
        System.out.println("Array length : "
                           + bbb.length);
  
        // print the byte array element
        System.out.println("\nArray element : "
                           + Arrays.toString(bbb));
  
        // wrap the byte array into ByteBuffer
        // using wrap() method
        ByteBuffer byteBuffer = ByteBuffer.wrap(bbb, 0,
                                                bbb.length);
  
        // Rewind the bytebuffer
        byteBuffer.rewind();
  
        // print the byte buffer
        System.out.println("\nbyteBuffer : "
                           + Arrays.toString(byteBuffer.array()));
  
        // print the ByteBuffer capacity
        System.out.println("\nbyteBuffer capacity : "
                           + byteBuffer.capacity());
  
        // print the ByteBuffer position
        System.out.println("\nbyteBuffer position:  "
                           + byteBuffer.position());
    }
}

输出。

Array length : 3

Array element : [10, 20, 30]

byteBuffer : [10, 20, 30]

byteBuffer capacity : 3

byteBuffer position:  0

实例2： 演示NullPointerException

// Java program to demonstrate
// asReadOnlyBuffer() method
  
import java.nio.*;
import java.util.*;
  
public class GFG {
  
    public static void main(String[] args)
    {
  
        // Declare and initialize the byte array
        byte[] bbb = { 10, 20, 30 };
  
        // print the byte array length
        System.out.println("Array length : " + bbb.length);
  
        // print the byte array element
        System.out.println("\nArray element : " + Arrays.toString(bbb));
  
        try {
            // wrap the byte array into byteBuffer
            // using wrap() method
            System.out.println("\nHere "
                               + "offset and length does not hold"
                               + " the required condition ");
            ByteBuffer byteBuffer = ByteBuffer.wrap(bbb,
                                                    1,
                                                    bbb.length);
  
            // Rewind the bytebuffer
            byteBuffer.rewind();
  
            // print the byte buffer
            System.out.println("\nbyteBuffer : "
                               + Arrays.toString(byteBuffer.array()));
  
            // print the byteBuffer capacity
            System.out.println("\nbytebuffer capacity : "
                               + byteBuffer.capacity());
  
            // print the byteBuffer position
            System.out.println("\nbytebuffer position:  "
                               + byteBuffer.position());
        }
        catch (IndexOutOfBoundsException e) {
            System.out.println("Exception throws:  " + e);
        }
    }
}

输出。

Array length : 3

Array element : [10, 20, 30]

Here offset and length does not hold the required condition 
Exception throws:  java.lang.IndexOutOfBoundsException