Section 24.95. JavaArray: JavaScript representation of a Java array


24.95. JavaArray: JavaScript representation of a Java array

LiveConnect

24.95.1. Synopsis

javaarray.length // The length of the array

javaarray[index] // Read or write an array element

24.95.2. Properties


length

A read-only integer that specifies the number of elements in the Java array represented by the JavaArray object.

24.95.3. Description

The JavaArray object is a JavaScript representation of a Java array that allows JavaScript code to read and write the elements of the array using familiar JavaScript array syntax. In addition, the JavaArray object has a length field that specifies the number of elements in the Java array.

When reading and writing values from array elements, data conversion between JavaScript and Java representations is automatically handled by the system. See Chapter 12 for full details.

24.95.4. Usage

Note that Java arrays differ from JavaScript arrays in a couple of important aspects. First, Java arrays have a fixed length that is specified when they are created. For this reason, the JavaArray length field is read-only. The second difference is that Java arrays are typed (i.e., their elements must all be of the same type of data). Attempting to set an array element to a value of the wrong type results in a JavaScript error or exception.

24.95.5. Example

java.awt.Polygon is a JavaClass object. You can create a JavaObject representing an instance of the class like this:

 p = new java.awt.Polygon( ); 

The object p has properties xpoints and ypoints, which are JavaArray objects representing Java arrays of integers. You can initialize the contents of these arrays with JavaScript code like the following:

 for(var i = 0; i < p.xpoints.length; i++)     p.xpoints[i] = Math.round(Math.random( )*100); for(var i = 0; i < p.ypoints.length; i++)     p.ypoints[i] = Math.round(Math.random( )*100); 

24.95.6. See Also

getClass( ), JavaClass, JavaObject, JavaPackage; Chapter 12




JavaScript. The Definitive Guide
JavaScript: The Definitive Guide
ISBN: 0596101996
EAN: 2147483647
Year: 2004
Pages: 767

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net