The allocateDirect() method of java.nio.ByteBuffer class is used Allocates a new direct byte buffer.
The new buffer’s position will be zero, its limit will be its capacity, its mark will be undefined, and each of its elements will be initialized to zero. Whether or not it has a backing array is unspecified.
This method is 25%-75% faster than allocate() method.
Syntax:
public static ByteBuffer allocateDirect(int capacity)
Parameters: This method takes capacity, in bytes, as parameter.
Return Value: This method returns the new byte buffer.
Exception: This method throws IllegalArgumentException, If the capacity is a negative integer.
Below are the examples to illustrate the allocateDirect() method:
Examples 1:
// Java program to demonstrate// allocateDirect() method import java.nio.*;import java.util.*; public class GFG { public static void main(String[] args) { // Declaring the capacity of the ByteBuffer int capacity = 4; // Creating the ByteBuffer try { // creating object of ByteBuffer // and allocating size capacity ByteBuffer bb = ByteBuffer.allocateDirect(capacity); // creating byte array of size capacity byte[] value = { 20, 30, 40, 50 }; // wrap the byte array into ByteBuffer bb = ByteBuffer.wrap(value); // print the ByteBuffer System.out.println("Direct ByteBuffer: " + Arrays.toString(bb.array())); // print the state of the buffer System.out.print("\nState of the ByteBuffer : "); System.out.println(bb.toString()); } catch (IllegalArgumentException e) { System.out.println("Exception thrown : " + e); } catch (ReadOnlyBufferException e) { System.out.println("Exception thrown : " + e); } }} |
Output:
Direct ByteBuffer: [20, 30, 40, 50] State of the ByteBuffer : java.nio.HeapByteBuffer[pos=0 lim=4 cap=4]
Examples 2: To show IllegalArgumentException
// Java program to demonstrate// allocateDirect() method import java.nio.*;import java.util.*; public class GFG { public static void main(String[] args) { // Declaring the capacity // with negative value int capacity = -4; // Creating the ByteBuffer try { // creating object of ByteBuffer // and allocating size capacity System.out.println("Trying to allocate" + " negative value in ByteBuffer"); ByteBuffer bb = ByteBuffer.allocateDirect(capacity); // creating byte array of size capacity byte[] value = { 20, 30, 40, 50 }; // wrap the byte array into ByteBuffer bb = ByteBuffer.wrap(value); // print the ByteBuffer System.out.println("Direct ByteBuffer: " + Arrays.toString(bb.array())); // print the state of the buffer System.out.print("\nState of the ByteBuffer : "); System.out.println(bb.toString()); } catch (IllegalArgumentException e) { System.out.println("Exception thrown : " + e); } catch (ReadOnlyBufferException e) { System.out.println("Exception thrown : " + e); } }} |
Output:
Trying to allocate negative value in ByteBuffer Exception thrown : java.lang.IllegalArgumentException: Negative capacity: -4