Интерфейс ArrayReference

Все суперинтерфейсы:: Mirror, ObjectReference, Value

public interface ArrayReference extends ObjectReference

Предоставляет доступ к объекту массива и его компонентам в целевой виртуальной машине. Каждый компонент массива отражается объектом Value. Компоненты массива в совокупности размещаются в объектах List, а не в массивах, для согласованности с остальной частью API и для взаимодействия с другими API.

С:: 1.3

Краткое описание полей

Поля, объявленные в интерфейсе com.sun.jdi.ObjectReference

INVOKE_NONVIRTUAL, INVOKE_SINGLE_THREADED

Краткое описание методов

Модификатор и тип	Метод	Описание
`Value`	`getValue(int index)`	Возвращает значение компонента массива.
`List<Value>`	`getValues()`	Возвращает все компоненты в этом массиве.
`List<Value>`	`getValues(int index, int length)`	Возвращает диапазон компонентов массива.
`int`	`length()`	Возвращает количество компонентов в этом массиве.
`void`	`setValue(int index, Value value)`	Заменяет компонент массива другим значением.
`void`	`setValues(int index, List<? extends Value> values, int srcIndex, int length)`	Заменяет диапазон компонентов массива другими значениями.
`void`	`setValues(List<? extends Value> values)`	Заменяет все компоненты массива другими значениями.

Методы, объявленные в интерфейсе com.sun.jdi.Mirror

toString, virtualMachine

Методы, объявленные в интерфейсе com.sun.jdi.ObjectReference

disableCollection, enableCollection, entryCount, equals, getValue, getValues, hashCode, invokeMethod, isCollected, owningThread, referenceType, referringObjects, setValue, uniqueID, waitingThreads

Методы, объявленные в интерфейсе com.sun.jdi.Value

type

Подробное описание методов

length

int length()

Возвращает количество компонентов в этом массиве.

Возвращает:: целое число компонентов в этом массиве.

getValue

Value getValue(int index)

Возвращает значение компонента массива.

Параметры:

index - индекс компонента для извлечения

Возвращает:

объект Value по заданному индексу.

Исключения:

IndexOutOfBoundsException - если index выходит за пределы этого массива, то есть, если выполняется хотя бы одно из следующих условий:

    index < 0
    index >= length()

getValues

List<Value> getValues()

Возвращает все компоненты в этом массиве.

Возвращает:: список объектов Value, по одному для каждого компонента массива в порядке индекса массива. Для массивов нулевой длины возвращается пустой список.

getValues

List<Value> getValues(int index, int length)

Возвращает диапазон компонентов массива.

Параметры:

index - индекс первого компонента для извлечения

length - количество компонентов для извлечения, или -1 для извлечения всех компонентов до конца этого массива.

Возвращает:

список объектов Value, по одному для каждого запрошенного компонента массива в порядке индекса массива. Когда в указанном диапазоне нет элементов (например, length равно нулю), возвращается пустой список

Исключения:

IndexOutOfBoundsException - если диапазон, заданный index и length, не находится в пределах массива, то есть, если выполняется хотя бы одно из следующих условий:

    index < 0
    index > length()

или если length != -1 и выполняется хотя бы одно из следующих условий:

    length < 0
    index + length >  length()

setValue

void setValue(int index, Value value) throws InvalidTypeException, ClassNotLoadedException

Заменяет компонент массива другим значением.

Объектные значения должны быть совместимы по присваиванию с типом компонента (это подразумевает, что тип компонента должен быть загружен через загрузчик классов объявляющего класса). Примитивные значения должны быть либо совместимы по присваиванию с типом компонента, либо должны быть преобразуемы к типу компонента без потери информации. Смотрите раздел JLS 5.2 для получения дополнительной информации о совместимости по присваиванию.

Параметры:

index - индекс компонента для задания

value - новое значение

Исключения:

    index < 0
    index >= length()

InvalidTypeException - если тип value несовместим с объявленным типом компонентов массива.

ClassNotLoadedException - если тип компонента массива еще не загружен через соответствующий загрузчик классов.

VMCannotBeModifiedException - если VirtualMachine только для чтения - см. VirtualMachine.canBeModified().

См. также:

setValues

void setValues(List<? extends Value> values) throws InvalidTypeException, ClassNotLoadedException

Заменяет все компоненты массива другими значениями. Если заданный список больше по размеру, чем массив, значения в конце списка игнорируются.

Объектные значения должны быть совместимы по присваиванию с типом элемента (это подразумевает, что тип компонента должен быть загружен через загрузчик классов, окружающего класса). Примитивные значения должны быть либо совместимы по присваиванию с типом компонента, либо должны быть преобразуемы к типу компонента без потери информации. Смотрите раздел JLS 5.2 для получения дополнительной информации о совместимости по присваиванию.

Параметры:

values - список объектов Value, которые должны быть помещены в этот массив. Если values.size() меньше, чем длина массива, устанавливаются первые values.size() элементов.

Исключения:

InvalidTypeException - если какой-либо из новых values несовместим с объявленным типом компонентов массива.

ClassNotLoadedException - если тип компонента массива еще не загружен через соответствующий загрузчик классов.

VMCannotBeModifiedException - если VirtualMachine только для чтения - см. VirtualMachine.canBeModified().

См. также:

setValues

void setValues(int index, List<? extends Value> values, int srcIndex, int length) throws InvalidTypeException, ClassNotLoadedException

Заменяет диапазон компонентов массива другими значениями.

Объектные значения должны быть совместимы по присваиванию с типом компонента (это подразумевает, что тип компонента должен быть загружен через загрузчик классов, окружающего класса). Примитивные значения должны быть либо совместимы по присваиванию с типом компонента, либо должны быть преобразуемы к типу компонента без потери информации. Смотрите раздел JLS 5.2 для получения дополнительной информации о совместимости по присваиванию.

Параметры:

index - индекс первого компонента для задания.

values - список объектов Value, которые должны быть помещены в этот массив.

srcIndex - индекс первого значения источника для использования.

length - количество компонентов для задания, или -1 для задания всех компонентов до конца этого массива или конца values (в зависимости от того, что приходит первым).

Исключения:

InvalidTypeException - если какой-либо элемент values несовместим с объявленным типом компонентов массива.

IndexOutOfBoundsException - если диапазон массива, заданный с помощью index и length, не находится в пределах массива, или если диапазон источника, заданный srcIndex и length, не находится в пределах values, то есть, если выполняется любое из следующих условий:

    index < 0
    index > length()
    srcIndex < 0
    srcIndex > values.size()

или если length != -1 и выполняется любое из следующих условий:

    length < 0
    index + length > length()
    srcIndex + length > values.size()

VMCannotBeModifiedException - если VirtualMachine только для чтения - см. VirtualMachine.canBeModified().

ClassNotLoadedException

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/jdk.jdi/com/sun/jdi/ArrayReference.html