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 מהמערך הנתון למאגר זה, החל מההיסט הנתון.