DataBuffer

เยี่ยมชมพื้นที่เก็บข้อมูลสำรองของบัฟเฟอร์นี้

การใช้งานบัฟเฟอร์มีหน้าที่รับผิดชอบในการส่งคืนการอ้างอิงไปยังการจัดเก็บข้อมูลจริงไปยังผู้เยี่ยมชมที่ให้ไว้ ผู้เยี่ยมชมไม่จำเป็นต้องจัดการกับการจัดเก็บข้อมูลทุกประเภทที่เป็นไปได้ และสามารถแทนที่เฉพาะวิธีการจัดเก็บข้อมูลที่ตนสนใจจริงๆ เท่านั้น สำหรับพื้นที่จัดเก็บข้อมูลประเภทอื่น การเรียกนี้จะเป็นทางเลือกสำรองไปยัง fallback() เพื่อให้ผู้เยี่ยมชมสามารถดำเนินการรูทีนทั่วไปบางอย่างได้หาก จำเป็น

เขียนการอ้างอิงของออบเจ็กต์ในอาร์เรย์ต้นทางลงในบัฟเฟอร์นี้

หากมีค่าที่จะคัดลอกมากกว่าขนาดบัฟเฟอร์ปลายทาง เช่น size > dst.size() จะไม่มีการถ่ายโอนค่าใด ๆ และ BufferOverflowException จะถูกส่งออกไป ในทางกลับกัน หากมีค่ามากกว่าที่จะคัดลอกขนาดบัฟเฟอร์ต้นทาง เช่น > src.size() ดังนั้น BufferUnderfloatException จะถูกส่งออกไป

มิฉะนั้น วิธีการนี้จะคัดลอกค่า n = size จากบัฟเฟอร์นี้ไปยังบัฟเฟอร์ปลายทาง

ตรวจสอบความเท่าเทียมกันระหว่างบัฟเฟอร์ข้อมูล

บัฟเฟอร์ข้อมูลจะเท่ากับวัตถุอื่นถ้าวัตถุนี้เป็น DataBuffer อื่นที่มีขนาด ประเภท และองค์ประกอบเท่ากันและอยู่ในลำดับเดียวกัน ตัวอย่างเช่น:

IntDataBuffer buffer = DataBuffers.of(1, 2, 3);

 assertEquals(buffer, DataBuffers.of(1, 2, 3));  // true
 assertEquals(buffer, DataBuffers.ofObjects(1, 2, 3));  // true, as Integers are equal to ints
 assertNotEquals(buffer, DataBuffers.of(1, 2, 3, 0));  // false, different sizes
 assertNotEquals(buffer, DataBuffers.of(1, 3, 2));  // false, different order
 assertNotEquals(buffer, DataBuffers.of(1L, 2L, 3L));  // false, different types
 

โปรดทราบว่าการคำนวณที่จำเป็นในการตรวจสอบความเท่าเทียมกันระหว่างบัฟเฟอร์สองตัวอาจมีราคาแพงในบางกรณี ดังนั้นจึงขอแนะนำว่าอย่าใช้วิธีนี้ในเส้นทางวิกฤติที่ประสิทธิภาพมีความสำคัญ

อ่านค่าตามดัชนีที่กำหนด สิ่งสำคัญ: การใช้วิธีนี้ควรจำกัดไว้เฉพาะบัฟเฟอร์ประเภทที่ไม่ใช่แบบดั้งเดิม หรือเมื่อผู้เรียกไม่ได้กำหนดชนิดข้อมูลไว้ ในกรณีอื่น ๆ ให้เลือกใช้ตัวแปรดั้งเดิมซึ่งจะปรับปรุงประสิทธิภาพได้อย่างมาก (เช่น IntDataBuffer.getInt(idx)

บอกว่าบัฟเฟอร์นี้ได้รับการสนับสนุนโดยอาร์เรย์ที่สามารถเข้าถึงได้หรือไม่

สร้างบัฟเฟอร์ใหม่ซึ่งมีเนื้อหาเป็นลำดับย่อยที่ใช้ร่วมกันของเนื้อหาของบัฟเฟอร์นี้ ซึ่งมีขนาดถูกกำหนดเป็นค่าที่กำหนด

ขนาดใหม่ต้องไม่ใหญ่กว่าขนาดบัฟเฟอร์นี้ การเปลี่ยนแปลงเนื้อหาของบัฟเฟอร์นี้จะปรากฏในบัฟเฟอร์ใหม่และในทางกลับกัน บัฟเฟอร์ใหม่จะเป็นแบบอ่านอย่างเดียวก็ต่อเมื่อบัฟเฟอร์นี้เป็นแบบอ่านอย่างเดียวเท่านั้น

การโทรนี้เทียบเท่ากับ slice(0, size)

สร้างบัฟเฟอร์ใหม่ซึ่งมีเนื้อหาเป็นลำดับย่อยที่ใช้ร่วมกันของเนื้อหาของบัฟเฟอร์นี้ โดยเริ่มต้นจากดัชนีที่กำหนด

ดัชนีต้องไม่ใหญ่กว่าขนาดบัฟเฟอร์นี้ การเปลี่ยนแปลงเนื้อหาของบัฟเฟอร์นี้จะปรากฏในบัฟเฟอร์ใหม่และในทางกลับกัน บัฟเฟอร์ใหม่จะเป็นแบบอ่านอย่างเดียวก็ต่อเมื่อบัฟเฟอร์นี้เป็นแบบอ่านอย่างเดียวเท่านั้น

การโทรนี้เทียบเท่ากับ slice(index, size() - index)

อ่านการอ้างอิงของวัตถุในบัฟเฟอร์นี้ลงในอาร์เรย์ปลายทาง

วิธีนี้จะถ่ายโอนค่าจากบัฟเฟอร์นี้ไปยังอาร์เรย์ปลายทางที่กำหนด หากมีค่าในบัฟเฟอร์น้อยกว่าที่จำเป็นในการตอบสนองคำขอ นั่นคือ หาก dst.length > size() จะไม่มีการถ่ายโอนค่าใด ๆ และ BufferUnderflowException จะถูกส่งออก

มิฉะนั้น วิธีการนี้จะคัดลอกค่า n = dst.length จากบัฟเฟอร์นี้ไปยังอาร์เรย์ที่กำหนด

อ่านการอ้างอิงของวัตถุในบัฟเฟอร์นี้ลงในอาร์เรย์ปลายทาง

วิธีนี้จะถ่ายโอนค่าจากบัฟเฟอร์นี้ไปยังอาร์เรย์ปลายทางที่กำหนด หากมีค่าในบัฟเฟอร์น้อยกว่าที่จำเป็นในการตอบสนองคำขอ นั่นคือ หาก length > size() จะไม่มีการถ่ายโอนค่าใด ๆ และ BufferUnderflowException จะถูกส่งออกไป

มิฉะนั้น วิธีนี้จะคัดลอกค่า n = length จากบัฟเฟอร์นี้ไปยังอาร์เรย์ที่กำหนดโดยเริ่มต้นที่ออฟเซ็ตที่กำหนด

เขียนค่าที่กำหนดลงในบัฟเฟอร์นี้ที่ดัชนีที่กำหนด สิ่งสำคัญ: การใช้วิธีนี้ควรจำกัดไว้เฉพาะบัฟเฟอร์ประเภทที่ไม่ใช่แบบดั้งเดิม หรือเมื่อผู้เรียกไม่ได้กำหนดชนิดข้อมูลไว้ ในกรณีอื่น ๆ ให้เลือกใช้ตัวแปรดั้งเดิมซึ่งจะปรับปรุงประสิทธิภาพได้อย่างมาก (เช่น IntDataBuffer.setInt(idx)

ขนาดของบัฟเฟอร์ในองค์ประกอบ

ตัวอย่างเช่น ในกรณีของบัฟเฟอร์ไบต์ ค่านี้จะเท่ากับจำนวนไบต์ที่บัฟเฟอร์นี้สามารถเก็บได้ สำหรับบัฟเฟอร์จำนวนเต็ม จะเท่ากับจำนวนจำนวนเต็ม ดังนั้นขนาดเป็นไบต์ของบัฟเฟอร์นี้คือ size() * Integer.BYTES

สร้างบัฟเฟอร์ใหม่ที่มีเนื้อหาเป็นลำดับย่อยที่ใช้ร่วมกันของเนื้อหาของบัฟเฟอร์นี้ เริ่มต้นที่ดัชนีที่กำหนดและขนาดที่กำหนด

ดัชนีบวกขนาดใหม่ต้องไม่ใหญ่กว่าขนาดบัฟเฟอร์นี้ การเปลี่ยนแปลงเนื้อหาของบัฟเฟอร์นี้จะปรากฏในบัฟเฟอร์ใหม่และในทางกลับกัน บัฟเฟอร์ใหม่จะเป็นแบบอ่านอย่างเดียวก็ต่อเมื่อบัฟเฟอร์นี้เป็นแบบอ่านอย่างเดียวเท่านั้น

สร้าง DataBufferWindow ที่ให้มุมมองบางส่วนของบัฟเฟอร์นี้

หน้าต่างที่สร้างขึ้นมีขนาดคงที่และสามารถ "slide" ไปตามบัฟเฟอร์นี้เพื่อให้มีมุมมองที่แตกต่างกันของข้อมูลโดยไม่ต้องจัดสรรอินสแตนซ์บัฟเฟอร์ใหม่ เช่นเดียวกับ offset(long) ซึ่งช่วยปรับปรุงประสิทธิภาพโดยรวมเมื่อมีการทำซ้ำบ่อยครั้ง ตัวอย่างเช่น:

IntDataBuffer bufferA = DataBuffers.ofInts(1024);
 // ... init buffer data
 IntDataBuffer bufferB = DataBuffers.ofInts(1, 2, 3, 4);

 // Return the index of the first occurrence of bufferB in bufferA using a sliding window
 DataBufferWindow<IntDataBuffer> windowA = bufferA.window(4);
 for (int i = 0; i < bufferA.size() - bufferB.size(); ++i) {
     if (windowA.slideTo(i).buffer().equals(bufferB)) {
         return i;
     
 }
 }

วัตถุที่ส่งคืนนั้นมีสถานะและไม่ปลอดภัยต่อเธรด

เขียนการอ้างอิงของออบเจ็กต์ในอาร์เรย์ต้นทางลงในบัฟเฟอร์นี้

วิธีนี้จะถ่ายโอนค่าในอาร์เรย์ต้นทางที่กำหนดไปยังบัฟเฟอร์นี้ หากมีค่าในอาร์เรย์ต้นทางมากกว่าในบัฟเฟอร์นี้ กล่าวคือ หาก src.length > size() จะไม่มีการถ่ายโอนค่าใด ๆ และ BufferOverflowException จะถูกส่งออกไป

มิฉะนั้น เมธอดนี้จะคัดลอกค่า n = src.length จากอาร์เรย์ที่กำหนด

วิธี การใส่ จำนวนมากโดยใช้อาร์เรย์ int

วิธีนี้จะถ่ายโอนค่าในอาร์เรย์ต้นทางที่กำหนดไปยังบัฟเฟอร์นี้ หากมีค่าในอาร์เรย์ต้นทางมากกว่าในบัฟเฟอร์นี้ กล่าวคือ หาก length > size() จะไม่มีการถ่ายโอนค่าใด ๆ และ BufferOverflowException จะถูกส่งออกไป

มิฉะนั้น เมธอดนี้จะคัดลอกค่า n = length จากอาร์เรย์ที่กำหนดไปยังบัฟเฟอร์นี้ โดยเริ่มต้นที่ออฟเซ็ตที่กำหนด