极客教程Java ByteBuffer putShort()方法及示例
putShort(int value)
java.nio.ByteBuffer 类的 putShort(int value) 方法用于将包含给定短值的两个字节，按照当前的字节顺序，写到这个缓冲区的当前位置，然后将位置递增2。
语法
public abstract ByteBuffer putShort(short value)
参数： 该方法接收要写入的短值。
返回值： 该方法返回这个缓冲区。
异常： 该方法会抛出以下异常。
- BufferOverflowException- 如果这个缓冲区的当前位置不小于它的极限值。
- ReadOnlyBufferException- 如果这个缓冲区是只读的。
下面是一些例子来说明putShort(short value)方法。
例1 :
// Java program to demonstrate
// putShort() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 6;
// Creating the ByteBuffer
try {
// creating object of ByteBuffer
// and allocating size capacity
ByteBuffer bb = ByteBuffer.allocate(capacity);
// putting the value in ByteBuffer
// using putShort() method
bb.putShort((short)0x041A)
.putShort((short)0x042A)
.putShort((short)0x043A)
.rewind();
// print the ByteBuffer
System.out.print("Original ByteBuffer: [ ");
for (int i = 1; i <= capacity / 2; i++)
System.out.print(bb.getShort() + " ");
System.out.print("]");
}
catch (BufferOverflowException e) {
System.out.println("Exception throws : " + e);
}
catch (ReadOnlyBufferException e) {
System.out.println("Exception throws : " + e);
}
}
}
输出
Original ByteBuffer: [ 1050 1066 1082 ]
例2： 为了证明BufferOverflowException。
// Java program to demonstrate
// putShort() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 6;
// Creating the ByteBuffer
try {
// creating object of ByteBuffer
// and allocating size capacity
ByteBuffer bb = ByteBuffer.allocate(capacity);
// putting the value in ByteBuffer
// using putShort() method
bb.putShort((short)0x041A)
.putShort((short)0x042A)
.putShort((short)0x043A)
.rewind();
// print the ByteBuffer
System.out.print("Original ByteBuffer: [ ");
for (int i = 1; i <= capacity / 2; i++)
System.out.print(bb.getShort() + " ");
System.out.print("]");
// putting the value in ByteBuffer
// using putInt() method
bb.putShort((short)234);
}
catch (BufferOverflowException e) {
System.out.println("\n\nbuffer's current position"
+ " is not smaller than its limit");
System.out.println("Exception throws : " + e);
}
catch (ReadOnlyBufferException e) {
System.out.println("Exception throws : " + e);
}
}
}
输出
Original ByteBuffer: [ 1050 1066 1082 ]
buffer's current position is not smaller than its limit
Exception throws : java.nio.BufferOverflowException
实例3： 为了证明ReadOnlyBufferException。
// Java program to demonstrate
// putShort() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 6;
// Creating the ByteBuffer
try {
// creating object of ByteBuffer
// and allocating size capacity
ByteBuffer bb = ByteBuffer.allocate(capacity);
// putting the value in ByteBuffer
// using putShort() method
bb.putShort((short)0x041A)
.putShort((short)0x042A)
.putShort((short)0x043A)
.rewind();
// print the ByteBuffer
System.out.print("Original ByteBuffer: [ ");
for (int i = 1; i <= capacity / 2; i++)
System.out.print(bb.getShort() + " ");
System.out.print("]");
// Creating a read-only copy of ByteBuffer
// using asReadOnlyBuffer() method
ByteBuffer bb1 = bb.asReadOnlyBuffer();
System.out.println("\n\nTrying to put the short value"
+ " in read-only buffer");
// putting the value in readonly ByteBuffer
// using putShort() method
bb1.putShort((short)234);
}
catch (BufferOverflowException e) {
System.out.println("\n\nbuffer's current position"
+ " is not smaller than its limit");
System.out.println("Exception throws : " + e);
}
catch (ReadOnlyBufferException e) {
System.out.println("Exception throws : " + e);
}
}
}
输出
Original ByteBuffer: [ 1050 1066 1082 ]
Trying to put the short value in read only buffer
Exception throws : java.nio.ReadOnlyBufferException
putShort(int index, short value)
java.nio.ByteBuffer类 的 putShort(int index, short value) 方法用于在给定的索引处将包含给定的两个值的字节按照当前的字节顺序写入这个缓冲区。
语法
public abstract ByteBuffer putShort(int index, short value)
参数： 该方法接受以下参数作为参数。
- index : 将被写入的字节的索引
- value : 要写入的短值
返回值 ：该方法返回这个缓冲区。
异常： 该方法会抛出以下异常。
- IndexOutOfBoundsException- 如果索引是负数或者不小于缓冲区的极限值
- ReadOnlyBufferException- 如果这个缓冲区是只读的。
下面是一些例子来说明putShort(int index, short value)方法。
例子1 :
// Java program to demonstrate
// putShort() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 6;
// Creating the ByteBuffer
try {
// creating object of ByteBuffer
// and allocating size capacity
ByteBuffer bb = ByteBuffer.allocate(capacity);
// putting the value in ByteBuffer
// using putShort() at index 0
bb.putShort(0, (short)23);
// putting the value in ByteBuffer
// using putShort() at index 2
bb.putShort(2, (short)34);
// putting the value in ByteBuffer
// using putShort() at index 4
bb.putShort(4, (short)27);
// rewinding the ByteBuffer
bb.rewind();
// print the ByteBuffer
System.out.print("Original ByteBuffer: [ ");
for (int i = 1; i <= capacity / 2; i++)
System.out.print(bb.getShort() + " ");
System.out.print("]\n");
}
catch (IndexOutOfBoundsException e) {
System.out.println("Exception throws : " + e);
}
catch (ReadOnlyBufferException e) {
System.out.println("Exception throws : " + e);
}
}
}
输出
Original ByteBuffer: [ 23 34 27 ]
例2： 演示IndexOutOfBoundsException。
// Java program to demonstrate
// putShort() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 6;
// Creating the ByteBuffer
try {
// creating object of ByteBuffer
// and allocating size capacity
ByteBuffer bb = ByteBuffer.allocate(capacity);
// putting the value in ByteBuffer
// using putShort() at index 0
bb.putShort(0, (short)23);
// putting the value in ByteBuffer
// using putShort() at index 2
bb.putShort(2, (short)34);
// putting the value in ByteBuffer
// using putShort() at index 4
bb.putShort(4, (short)27);
// rewinding the ByteBuffer
bb.rewind();
// print the ByteBuffer
System.out.print("Original ByteBuffer: [ ");
for (int i = 1; i <= capacity / 2; i++)
System.out.print(bb.getShort() + " ");
System.out.print("]\n");
// putting the value in ByteBuffer
// using putShort() at index -1
bb.putShort(-1, (short)45);
}
catch (IndexOutOfBoundsException e) {
System.out.println("\nindex is negative or not smaller "
+ "than the buffer's limit");
System.out.println("Exception throws : " + e);
}
catch (ReadOnlyBufferException e) {
System.out.println("Exception throws : " + e);
}
}
}
输出
Original ByteBuffer: [ 23 34 27 ]
index is negative or not smaller than the buffer's limit
Exception throws : java.lang.IndexOutOfBoundsException
例3： 演示ReadOnlyBufferException。
// Java program to demonstrate
// putShort() method
import java.nio.*;
import java.util.*;
public class GFG {
public static void main(String[] args)
{
// Declaring the capacity of the ByteBuffer
int capacity = 6;
// Creating the ByteBuffer
try {
// creating object of ByteBuffer
// and allocating size capacity
ByteBuffer bb = ByteBuffer.allocate(capacity);
// Creating a read-only copy of ByteBuffer
// using asReadOnlyBuffer() method
ByteBuffer bb1 = bb.asReadOnlyBuffer();
System.out.println("Trying to put the int value"
+ " in read-only buffer");
// putting the value in readonly ByteBuffer
// using putInt() method
bb1.putInt(0, 23);
}
catch (IndexOutOfBoundsException e) {
System.out.println("Exception throws : " + e);
}
catch (ReadOnlyBufferException e) {
System.out.println("Exception throws : " + e);
}
}
}
输出
Trying to put the int value in read only buffer
Exception throws : java.nio.ReadOnlyBufferException
参考资料
- https://docs.oracle.com/javase/9/docs/api/java/nio/ByteBuffer.html#putShort-short-
- https://docs.oracle.com/javase/9/docs/api/java/nio/ByteBuffer.html#putShort-int-short-