Core JavaScript 1.5 Reference:Global Objects:JavaPackage
From MDC
Contents |
[edit] Summary
Core Object
A JavaScript reference to a Java package.
[edit] Created by
A reference to the package name used with the Packages keyword:
Packages.JavaPackage
JavaPackage is the name of the object's Java package. If the package is in the java, netscape, or sun packages, the Packages keyword is optional.
[edit] Description
In Java, a package is a collection of Java classes or other Java packages. For example, the netscape package contains the package netscape.javascript; the netscape.javascript package contains the classes JSObject and JSException.
In JavaScript, a JavaPackage is a reference to a Java package. For example, a reference to netscape is a JavaPackage. netscape.javascript is both a JavaPackage and a property of the netscape JavaPackage.
A JavaClass object is a reference to one of the classes in a package, such as netscape.javascript.JSObject. The JavaPackage and JavaClass hierarchy reflect the Java package and class hierarchy.
Although the packages and classes contained in a JavaPackage are its properties, you cannot use a for...in statement to enumerate them as you can enumerate the properties of other objects.
[edit] Properties
The properties of a JavaPackage are the JavaClass objects and any other JavaPackage objects it contains.
[edit] Examples
Suppose the Redwood corporation uses the Java redwood package to contain various Java classes that it implements. The following code creates the JavaPackage red:
var red = Packages.redwood;