Книги-online

JavaArray

Обёрнутый в оболочку Java-массив, доступ к которому имеется в коде JavaScript, являющийся членом типа JavaArray.

Создание

Любым методом Java, который возвращает массив. Кроме того, Вы можете создать JavaArray из произвольного типа данных, используя метод newInstance класса Array:

public static Object newInstance(Class componentType, int length)
   throws NegativeArraySizeException

Описание

Объект JavaArray является экземпляром Java-массива, который создаётся в или передаётся в JavaScript. JavaArray является оболочкой для экземпляра; все ссылки на этот экземпляр массива делаются через JavaArray.

Вы обязаны специфицировать объект класса, такой как объект, возвращаемый java.lang.Object.forName для параметра componentType экземпляра newInstance, если Вы используете этот метод для создания массива. Вы не можете использовать объект JavaClass для параметра componentType.

Используйте индексы с базой 0 для доступа к элементам объекта JavaArray так же, как Вы делаете при доступе к элементам массива в языке Java. Например:

var javaString = new java.lang.String("Hello world!");
var byteArray  = javaString.getBytes();
byteArray[0] // возвращает 72
byteArray[1] // возвращает 101

Любые Java-данные, перенесённые в JavaScript, конвертируются в типы данных JavaScript. Если JavaArray передаётся обратно в Java, оболочка с массива снимается, и он может использоваться кодом Java. См. в книге Клиентский JavaScript. Руководство. информацию о конвертации типов данных.

Свойство. Резюме.

length

Метод. Резюме.

toString

Примеры

Пример 1. Инстанциация (создание экземпляра) JavaArray в JavaScript.

Здесь экземпляр byteArray объекта JavaArray создаётся методом java.lang.String.getBytes, который возвращает массив.

var javaString = new java.lang.String("Hello world!");
var byteArray = javaString.getBytes();

Пример 2. Инстанциация (создание экземпляра) JavaArray в JavaScript с помощью метода newInstance.

Используйте объект класса, возвращаемый java.lang.Class.forName, как аргумент для метода newInstance, как показано в следующем коде:

var dataType = java.lang.Class.forName("java.lang.String")
var dogs = java.lang.reflect.Array.newInstance(dataType, 5)

length

Количество элементов в Java-массиве, представленном объектом JavaArray.

Описание

В отличие от Array.length, JavaArray.length является свойством только для чтения. Вы не можете изменить значение свойства JavaArray.length, поскольку массивы Java всегда имеют фиксированное количество элементов.

См. также

toString

Возвращает строковое представление объекта JavaArray.

Параметры

Отсутствуют.

Описание

Метод toString наследуется из объекта Object и возвращает следующее значение:

[object JavaArray]

Дата последнего обновления: 28 мая 1999 года.
Copyright (c) 1999 Netscape Communications Corporation