diff options
Diffstat (limited to 'files/zh-cn/archive/web/liveconnect/index.html')
| -rw-r--r-- | files/zh-cn/archive/web/liveconnect/index.html | 800 |
1 files changed, 0 insertions, 800 deletions
diff --git a/files/zh-cn/archive/web/liveconnect/index.html b/files/zh-cn/archive/web/liveconnect/index.html deleted file mode 100644 index 34b25bd823..0000000000 --- a/files/zh-cn/archive/web/liveconnect/index.html +++ /dev/null @@ -1,800 +0,0 @@ ---- -title: LiveConnect概述 -slug: Archive/Web/LiveConnect -tags: - - Java - - JavaScript - - LiveConnect - - 高级 -translation_of: Archive/Web/LiveConnect/LiveConnect_Overview ---- -<p>这一章描述了使用 <a href="/zh-CN/docs/LiveConnect" title="zh-CN/docs/LiveConnect">LiveConnect </a>技术来使JavaScript和Java能够互相通信。本章假设你熟悉Java编程。</p> - -<h2 id="使用包装器(Working_with_Wrappers)">使用包装器(Working with Wrappers)</h2> - -<p>在JavaScript中，包装器(<em>wrapper</em>)是一个目标语言数据类型的对象，它包装了一个源语言的对象。当使用JavaScript编程的时候，你可以使用包装器(wrapper)对象来访问Java对象的方法和字段;调用包装器(wrapper)的方法或者访问它的属性都会作用在Java对象上。在Java端，JavaScript对象被包装在类netscape.javascript.JSObject的实例中，然后传递给Java。</p> - -<p>当Javascript对象被传递给Java，运行时引擎会创建一个JSObject类型的Java包装器(<em>wrapper</em>);当JSObject从Java传递到JavaScript, 运行时引擎将它解包成它原来的JavaScript对象类型。JSObject类提供了一个接口用来调用JavaScript的方法和检测JavaScript的属性。</p> - -<h2 id="JavaScript到Java通信">JavaScript到Java通信</h2> - -<p>当你引用一个Java包或者类，或者使用Java的对象和数组，你会使用某一个特别的LiveConnect对象。所有访问Java的JavaScript使用下面表格中总结的对象：</p> - -<table class="standard-table"> - <caption>Table 9.1 LiveConnect对象</caption> - <thead> - <tr> - <th scope="col">对象</th> - <th scope="col">描述</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>JavaArray</code></td> - <td>包装了Java数组，从JavaScript代码中访问。</td> - </tr> - <tr> - <td><code>JavaClass</code></td> - <td>引用Java类。</td> - </tr> - <tr> - <td><code>JavaObject</code></td> - <td>包装了Java对象，从JavaScript代码中访问。</td> - </tr> - <tr> - <td><code>JavaPackage</code></td> - <td>引用Java包。</td> - </tr> - </tbody> -</table> - -<p><strong>注意:</strong> 因为Java是强类型语言，而JavaScript是弱类型的语言，当你使用LiveConnect的时候，JavaScript运行时引擎会将参数值转换为其他语言中的合适数据类型。请参考 <a href="/zh-CN/docs/JavaScript/Guide/Values,_Variables,_and_Literals#Data_Type_Conversion" title="zh-CN/docs/JavaScript/Guide/Values, Variables, and Literals#Data Type Conversion">Data Type Conversion</a> 来获取完整信息。</p> - -<p>在某些情形下，LiveConnect对象的存在是透明的，因为你凭借一定的直觉来和Java交互。例如，你能够通过使用new操作符跟上Java构造器来像下面一样创建一个Java字符串(String)对象，并且将它赋值给JavaScript变量myString：</p> - -<pre class="brush: js">var myString = new java.lang.String("Hello world"); -</pre> - -<p>在上面的例子中，变量myString是一个JavaObject，因为它持有一个Java的String对象。作为<code>JavaObject</code>, <code>myString</code>可以获取java.lang.String及其父类java.lang.Object的公有实例方法。这些Java方法在JavaScript中作为JavaObject的方法使用，你可以像下面这样来使用它们：</p> - -<pre class="brush: js">myString.length(); // returns 11 -</pre> - -<p>静态成员可以通过JavaClass对象来调用。</p> - -<pre class="brush: js">alert(java.lang.Integer.MAX_VALUE); //alerts 2147483647 -</pre> - -<h3 id="包对象">包对象</h3> - -<p>如果一个Java类不是java, sun, 或者netscape包的一部分，你需要使用Packages对象来访问它。例如，假设Redwood公司使用一个叫redwood的java包来包含各种它实现的Java类。为了创建一个redwood中HelloWorld类的实例，你像下面这样访问类的构造器：</p> - -<pre class="brush: js">var red = new Packages.redwood.HelloWorld(); -</pre> - -<p>你也可以使用默认包中的类(就是说，类没有显式的命名包)。例如，如果HelloWorld类在CLASSPATH中，并且不在包中，你可以像下面这样使用它：</p> - -<pre class="brush: js">var red = new Packages.HelloWorld(); -</pre> - -<p>LiveConnect<code>中的java</code>, <code>sun</code>, 和<code>netscape</code>对象提供了常用Java包的快捷方式。例如，你可以像下面这样使用：</p> - -<pre class="brush: js">var myString = new java.lang.String("Hello world"); -</pre> - -<p>来替换下面长版本:</p> - -<pre class="brush: js">var myString = new Packages.java.lang.String("Hello world"); -</pre> - -<h3 id="使用Java数组">使用Java数组</h3> - -<p>当任何Java方法创建了一个数组，并且你在JavaScript中引用那个数组，你就会使用到JavaArray。例如，下面的代码创建了有十个int类型元素的JavaArray x对象：</p> - -<pre class="brush: js">var x = java.lang.reflect.Array.newInstance(java.lang.Integer, 10); -</pre> - -<p>跟JavaScript的Array对象类似， JavaArray有一个length属性用来返回数组元素的长度。不像<code>Array.length</code>, <code>JavaArray.length是一个只读属性</code>, 因为Java数组的元素长度在创建的时候就固定了。</p> - -<h3 id="包和类的引用">包和类的引用</h3> - -<p>Simple references to Java packages and classes from JavaScript create the <code>JavaPackage</code> and <code>JavaClass</code> objects. In the earlier example about the Redwood corporation, for example, the reference Packages.redwood is a JavaPackage object. Similarly, a reference such as <code>java.lang.String</code> is a <code>JavaClass</code> object.</p> - -<p>Most of the time, you don't have to worry about the <code>JavaPackage</code> and <code>JavaClass</code> objects—you just work with Java packages and classes, and LiveConnect creates these objects transparently. There are cases where LiveConnect will fail to load a class, and you will need to manually load it like this:</p> - -<pre class="brush: js">var Widgetry = java.lang.Thread.currentThread().getContextClassLoader().loadClass("org.mywidgets.Widgetry"); -</pre> - -<p>In JavaScript 1.3 and earlier, <code>JavaClass</code> objects are not automatically converted to instances of <code>java.lang.Class</code> when you pass them as parameters to Java methods—you must create a wrapper around an instance of <code>java.lang.Class</code>. In the following example, the <code>forName</code> method creates a wrapper object <code>theClass</code>, which is then passed to the <code>newInstance</code> method to create an array.</p> - -<pre class="brush: js">// JavaScript 1.3 -var theClass = java.lang.Class.forName("java.lang.String"); -var theArray = java.lang.reflect.Array.newInstance(theClass, 5); -</pre> - -<p>In JavaScript 1.4 and later, you can pass a <code>JavaClass</code> object directly to a method, as shown in the following example:</p> - -<pre class="brush: js">// JavaScript 1.4 -var theArray = java.lang.reflect.Array.newInstance(java.lang.String, 5); -</pre> - -<h3 id="Arguments_of_Type_char">Arguments of Type char</h3> - -<p>In JavaScript 1.4 and later, you can pass a one-character string to a Java method which requires an argument of type <code>char</code>. For example, you can pass the string "H" to the <code>Character</code> constructor as follows:</p> - -<pre class="brush: js">var c = new java.lang.Character("H"); -</pre> - -<p>In JavaScript 1.3 and earlier, you must pass such methods an integer which corresponds to the Unicode value of the character. For example, the following code also assigns the value "H" to the variable <code>c</code>:</p> - -<pre class="brush: js">var c = new java.lang.Character(72); -</pre> - -<h3 id="Handling_Java_Exceptions_in_JavaScript">Handling Java Exceptions in JavaScript</h3> - -<p>When Java code fails at run time, it throws an exception. If your JavaScript code accesses a Java data member or method and fails, the Java exception is passed on to JavaScript for you to handle. Beginning with JavaScript 1.4, you can catch this exception in a <code>try...catch</code> statement. (Although this functionality (along with some others) had been broken in Gecko 1.9 (see {{ bug("391642") }}) as the Mozilla-specific LiveConnect code had not been maintained inside Mozilla, with Java 6 update 11 and 12 building support for reliance on Mozilla's implementation of the generic (and cross-browser) <a href="/zh-CN/docs/Plugins" title="zh-CN/docs/Plugins">NPAPI</a> plugin code, this has again been fixed.)</p> - -<p>For example, suppose you are using the Java <code>forName</code> method to assign the name of a Java class to a variable called <code>theClass</code>. The <code>forName</code> method throws an exception if the value you pass it does not evaluate to the name of a Java class. Place the <code>forName</code> assignment statement in a <code>try</code> block to handle the exception, as follows:</p> - -<pre class="brush: js">function getClass(javaClassName) { - try { - var theClass = java.lang.Class.forName(javaClassName); - } catch (e) { - return ("The Java exception is " + e); - } - return theClass; -} -</pre> - -<p>In this example, if <code>javaClassName</code> evaluates to a legal class name, such as "java.lang.String", the assignment succeeds. If <code>javaClassName</code> evaluates to an invalid class name, such as "String", the <code>getClass</code> function catches the exception and returns something similar to the following:</p> - -<pre>The Java exception is java.lang.ClassNotFoundException: String -</pre> - -<p>For specialized handling based on the exception type, use the <code>instanceof</code> operator:</p> - -<pre class="brush: js">try { - // ... -} catch (e) { - if (e instanceof java.io.FileNotFound) { - // handling for FileNotFound - } else { - throw e; - } -} -</pre> - -<p>See <a href="/zh-CN/docs/JavaScript/Guide/Statements#Exception_Handling_Statements" title="zh-CN/docs/JavaScript/Guide/Statements#Exception Handling Statements">Exception Handling Statements</a> for more information about JavaScript exceptions.</p> - -<h2 id="Java_to_JavaScript_Communication">Java to JavaScript Communication</h2> - -<p>If you want to use JavaScript objects in Java, you must import the <code>netscape.javascript</code> package into your Java file. This package defines the following classes:</p> - -<ul> - <li><code><a href="/zh-CN/docs/JavaScript/Reference/LiveConnect/JSObject" title="zh-CN/docs/JavaScript/Reference/LiveConnect/JSObject">netscape.javascript.JSObject</a></code> allows Java code to access JavaScript methods and properties.</li> - <li><code><a href="/zh-CN/docs/JavaScript/Reference/LiveConnect/JSException" title="zh-CN/docs/JavaScript/Reference/LiveConnect/JSException">netscape.javascript.JSException</a></code> allows Java code to handle JavaScript errors.</li> -</ul> - -<p>See the <a href="/zh-CN/docs/JavaScript/Reference" title="zh-CN/docs/JavaScript/Reference">JavaScript Reference</a> for more information about these classes.</p> - -<h3 id="Locating_the_LiveConnect_classes" name="Locating_the_LiveConnect_classes">Locating the LiveConnect classes</h3> - -<p>In older versions of the Netscape browser, these classes were distributed along with the browser. Starting with JavaScript 1.2, these classes are delivered in a .jar file; in previous versions of JavaScript, these classes are delivered in a .zip file. For example, with Netscape Navigator 4 for Windows NT, the classes are delivered in the <code>java40.jar</code> file in the <code>Program\Java\Classes</code> directory beneath the Navigator directory.</p> - -<p>More recently, the classes have been distributed with Sun's Java Runtime; initially in the file "jaws.jar" in the "jre/lib" directory of the runtime distribution (for JRE 1.3), then in "plugin.jar" in the same location (JRE 1.4 and up).</p> - -<h3 id="Using_the_LiveConnect_classes_with_the_JDK" name="Using_the_LiveConnect_classes_with_the_JDK">Using the LiveConnect classes with the JDK</h3> - -<p>To access the LiveConnect classes, place the .jar or .zip file in the <code>CLASSPATH</code> of the JDK compiler in either of the following ways:</p> - -<ul> - <li>Create a <code>CLASSPATH</code> environment variable to specify the path and name of .jar or .zip file.</li> - <li>Specify the location of .jar or .zip file when you compile by using the <code>-classpath</code> command line parameter.</li> -</ul> - -<p>You can specify an environment variable in Windows NT by double-clicking the System icon in the Control Panel and creating a user environment variable called <code>CLASSPATH</code> with a value similar to the following:</p> - -<pre class="eval">C:\Program Files\Java\jre1.4.1\lib\plugin.jar -</pre> - -<p>See the Sun JDK documentation for more information about <code>CLASSPATH</code>.</p> - -<p><strong>Note:</strong> Because Java is a strongly typed language and JavaScript is weakly typed, the JavaScript runtime engine converts argument values into the appropriate data types for the other language when you use LiveConnect. See <a href="#Data_Type_Conversions">Data Type Conversions</a> for complete information.</p> - -<h3 id="Using_the_LiveConnect_Classes">Using the LiveConnect Classes</h3> - -<p>All JavaScript objects appear within Java code as instances of <code>netscape.javascript.JSObject</code>. When you call a method in your Java code, you can pass it a JavaScript object as one of its argument. To do so, you must define the corresponding formal parameter of the method to be of type <code>JSObject</code>.</p> - -<p>Also, any time you use JavaScript objects in your Java code, you should put the call to the JavaScript object inside a <code>try...catch</code> statement which handles exceptions of type <code>netscape.javascript.JSException</code>. This allows your Java code to handle errors in JavaScript code execution which appear in Java as exceptions of type <code>JSException</code>.</p> - -<h4 id="Accessing_JavaScript_with_JSObject" name="Accessing_JavaScript_with_JSObject">Accessing JavaScript with JSObject</h4> - -<p>For example, suppose you are working with the Java class called <code>JavaDog</code>. As shown in the following code, the <code>JavaDog</code> constructor takes the JavaScript object <code>jsDog</code>, which is defined as type <code>JSObject</code>, as an argument:</p> - -<pre class="brush: java">import netscape.javascript.*; - -public class JavaDog{ - public String dogBreed; - public String dogColor; - public String dogSex; - - // define the class constructor - public JavaDog(JSObject jsDog){ - // use try...catch to handle JSExceptions here - this.dogBreed = (String)jsDog.getMember("breed"); - this.dogColor = (String)jsDog.getMember("color"); - this.dogSex = (String)jsDog.getMember("sex"); - } -} -</pre> - -<p>Notice that the <code>getMember</code> method of <code>JSObject</code> is used to access the properties of the JavaScript object. The previous example uses <code>getMember</code> to assign the value of the JavaScript property <code>jsDog.breed</code> to the Java data member <code>JavaDog.dogBreed</code>.</p> - -<p><strong>Note:</strong> A more realistic example would place the call to <code>getMember</code> inside a <code>try...catch</code> statement to handle errors of type <code>JSException</code>. See Handling JavaScript Exceptions in Java for more information.</p> - -<p>To get a better sense of how <code>getMember</code> works, look at the definition of the custom JavaScript object <code>Dog</code>:</p> - -<pre class="brush: js">function Dog(breed,color,sex){ - this.breed = breed; - this.color = color; - this.sex = sex; -} -</pre> - -<p>You can create a JavaScript instance of <code>Dog</code> called <code>gabby</code> as follows:</p> - -<pre class="brush: js">var gabby = new Dog("lab", "chocolate", "female"); -</pre> - -<p>If you evaluate <code>gabby.color</code>, you can see that it has the value "chocolate". Now suppose you create an instance of <code>JavaDog</code> in your JavaScript code by passing the <code>gabby</code> object to the constructor as follows:</p> - -<pre class="brush: js">var javaDog = new Packages.JavaDog(gabby); -</pre> - -<p>If you evaluate <code>javaDog.dogColor</code>, you can see that it also has the value "chocolate", because the <code>getMember</code> method in the Java constructor assigns <code>dogColor</code> the value of <code>gabby.color</code>.</p> - -<h4 id="Handling_JavaScript_Exceptions_in_Java" name="Handling_JavaScript_Exceptions_in_Java">Handling JavaScript Exceptions in Java</h4> - -<p>When JavaScript code called from Java fails at run time, it throws an exception. If you are calling the JavaScript code from Java, you can catch this exception in a <code>try...catch</code> statement. The JavaScript exception is available to your Java code as an instance of <code>netscape.javascript.JSException</code>.</p> - -<p><code>JSException</code> is a Java wrapper around any exception type thrown by JavaScript, similar to the way that instances of <code>JSObject</code> are wrappers for JavaScript objects. Use <code>JSException</code> when you are evaluating JavaScript code in Java.</p> - -<p>When you are evaluating JavaScript code in Java, the following situations can cause run-time errors:</p> - -<ul> - <li>The JavaScript code is not evaluated, either due to a JavaScript compilation error or to some other error that occurred at run time. The JavaScript interpreter generates an error message that is converted into an instance of <code>JSException</code>.</li> - <li>Java successfully evaluates the JavaScript code, but the JavaScript code executes an unhandled <code>throw</code> statement. JavaScript throws an exception that is wrapped as an instance of <code>JSException</code>. Use the <code>getWrappedException</code> method of <code>JSException</code> to unwrap this exception in Java.</li> -</ul> - -<p>For example, suppose the Java object <code>eTest</code> evaluates the string <code>jsCode</code> that you pass to it. You can respond to either type of run-time error the evaluation causes by implementing an exception handler such as the following:</p> - -<pre class="brush: java">import netscape.javascript.JSObject; -import netscape.javascript.JSException; - -public class eTest { - public static Object doit(JSObject obj, String jsCode) { - try { - obj.eval(jsCode); - } catch (JSException e) { - if (e.getWrappedException() == null) - return e; - return e.getWrappedException(); - } - return null; - } -} -</pre> - -<p>In this example, the code in the <code>try</code> block attempts to evaluate the string <code>jsCode</code> that you pass to it. Let's say you pass the string "<code>myFunction()</code>" as the value of <code>jsCode</code>. If <code>myFunction</code> is not defined as a JavaScript function, the JavaScript interpreter cannot evaluate <code>jsCode</code>. The interpreter generates an error message, the Java handler catches the message, and the <code>doit</code> method returns an instance of <code>netscape.javascript.JSException</code>.</p> - -<p>However, suppose <code>myFunction</code> is defined in JavaScript as follows:</p> - -<pre class="brush: js">function myFunction() { - try { - if (theCondition == true) { - return "Everything's ok"; - } else { - throw "JavaScript error occurred"; - } - } catch (e) { - if (canHandle == true) { - handleIt(); - } else { - throw e; - } - } -} -</pre> - -<p>If <code>theCondition</code> is false, the function throws an exception. The exception is caught in the JavaScript code, and if <code>canHandle</code> is true, JavaScript handles it. If <code>canHandle</code> is false, the exception is rethrown, the Java handler catches it, and the <code>doit</code> method returns a Java string:</p> - -<pre>JavaScript error occurred -</pre> - -<p>See <a href="/zh-CN/docs/JavaScript/Guide/Statements#Exception_Handling_Statements" title="zh-CN/docs/JavaScript/Guide/Statements#Exception Handling Statements">Exception Handling Statements</a> for complete information about JavaScript exceptions.</p> - -<h4 id="Backward_Compatibility" name="Backward_Compatibility">Backward Compatibility</h4> - -<p>In JavaScript 1.3 and earlier versions, the <code>JSException</code> class had three public constructors which optionally took a string argument, specifying the detail message or other information for the exception. The <code>getWrappedException</code> method was not available.</p> - -<p>Use a <code>try...catch</code> statement such as the following to handle LiveConnect exceptions in JavaScript 1.3 and earlier versions:</p> - -<pre class="brush: js">try { - global.eval("foo.bar = 999;"); -} catch (Exception e) { - if (e instanceof JSException) { - jsCodeFailed(); - } else { - otherCodeFailed(); - } -} -</pre> - -<p>In this example, the <code>eval</code> statement fails if <code>foo</code> is not defined. The <code>catch</code> block executes the <code>jsCodeFailed</code> method if the <code>eval</code> statement in the <code>try</code> block throws a <code>JSException</code>; the <code>otherCodeFailed</code> method executes if the <code>try</code> block throws any other error.</p> - -<h2 id="Data_Type_Conversions">Data Type Conversions</h2> - -<p>Because Java is a strongly typed language and JavaScript is weakly typed, the JavaScript runtime engine converts argument values into the appropriate data types for the other language when you use LiveConnect. These conversions are described in the following sections:</p> - -<ul> - <li><a href="#JavaScript_to_Java_Conversions">JavaScript to Java Conversions</a></li> - <li><a href="#Java_to_JavaScript_Conversions">Java to JavaScript Conversions</a></li> -</ul> - -<h3 id="JavaScript_to_Java_Conversions">JavaScript to Java Conversions</h3> - -<p>When you call a Java method and pass it parameters from JavaScript, the data types of the parameters you pass in are converted according to the rules described in the following sections:</p> - -<ul> - <li><a href="#Number_Values">Number Values</a></li> - <li><a href="#Boolean_Values">Boolean Values</a></li> - <li><a href="#String_Values">String Values</a></li> - <li><a href="#Undefined_Values">Undefined Values</a></li> - <li><a href="#Null_Values">Null Values</a></li> - <li><a href="#JavaArray_and_JavaObject_objects">JavaArray and JavaObject objects</a></li> - <li><a href="#JavaClass_objects">JavaClass objects</a></li> - <li><a href="#Other_JavaScript_objects">Other JavaScript objects</a></li> -</ul> - -<p>The return values of methods of <code>netscape.javascript.JSObject</code> are always converted to instances of <code>java.lang.Object</code>. The rules for converting these return values are also described in these sections.</p> - -<p>For example, if <code>JSObject.eval</code> returns a JavaScript number, you can find the rules for converting this number to an instance of <code>java.lang.Object</code> in <a href="#Number_Values">Number Values</a>.</p> - -<h4 id="Number_Values" name="Number_Values">Number Values</h4> - -<p>When you pass JavaScript number types as parameters to Java methods, Java converts the values according to the rules described in the following table:</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Java parameter type</th> - <th scope="col">Conversion rules</th> - </tr> - </thead> - <tbody> - <tr> - <td>double</td> - <td> - <ul> - <li>The exact value is transferred to Java without rounding and without a loss of magnitude or sign.</li> - <li><code>NaN</code> is converted to NaN.</li> - </ul> - </td> - </tr> - <tr> - <td>java.lang.Double<br> - java.lang.Object</td> - <td>A new instance of <code>java.lang.Double</code> is created, and the exact value is transferred to Java without rounding and without a loss of magnitude or sign.</td> - </tr> - <tr> - <td>float</td> - <td> - <ul> - <li>Values are rounded to float precision.</li> - <li>Values which are too large or small to be represented are rounded to +infinity or -infinity.</li> - <li><code>NaN</code> is converted to <code>NaN</code>.</li> - </ul> - </td> - </tr> - <tr> - <td>byte - <p>char<br> - int<br> - long</p> - short</td> - <td> - <ul> - <li>Values are rounded using round-to-negative-infinity mode.</li> - <li>Values which are too large or small to be represented result in a run-time error.</li> - <li><code>NaN</code> can not be converted and results in a run-time error.</li> - </ul> - </td> - </tr> - <tr> - <td><code>java.lang.String</code></td> - <td>Values are converted to strings. For example: - <ul> - <li>237 becomes "237"</li> - </ul> - </td> - </tr> - <tr> - <td>boolean</td> - <td> - <ul> - <li>0 and <code>NaN</code> values are converted to false.</li> - <li>Other values are converted to true.</li> - </ul> - </td> - </tr> - </tbody> -</table> - -<p>When a JavaScript number is passed as a parameter to a Java method which expects an instance of <code>java.lang.String</code>, the number is converted to a string. Use the <code>equals()</code> method to compare the result of this conversion with other string values.</p> - -<h4 id="Boolean_Values" name="Boolean_Values">Boolean Values</h4> - -<p>When you pass JavaScript Boolean types as parameters to Java methods, Java converts the values according to the rules described in the following table:</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Java parameter type</th> - <th scope="col">Conversion rules</th> - </tr> - </thead> - <tbody> - <tr> - <td>boolean</td> - <td>All values are converted directly to the Java equivalents.</td> - </tr> - <tr> - <td><code>java.lang.Boolean</code><br> - <code>java.lang.Object</code></td> - <td>A new instance of <code>java.lang.Boolean</code> is created. Each parameter creates a new instance, not one instance with the same primitive value.</td> - </tr> - <tr> - <td><code>java.lang.String</code></td> - <td>Values are converted to strings. For example: - <ul> - <li>true becomes "true"</li> - <li>false becomes "false"</li> - </ul> - </td> - </tr> - <tr> - <td>byte - <p>char<br> - double<br> - float<br> - int<br> - long</p> - short</td> - <td> - <ul> - <li>true becomes 1</li> - <li>false becomes 0</li> - </ul> - </td> - </tr> - </tbody> -</table> - -<p>When a JavaScript Boolean is passed as a parameter to a Java method which expects an instance of <code>java.lang.String</code>, the Boolean is converted to a string. Use the == operator to compare the result of this conversion with other string values.</p> - -<h4 id="String_Values" name="String_Values">String Values</h4> - -<p>When you pass JavaScript string types as parameters to Java methods, Java converts the values according to the rules described in the following table:</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Java parameter type</th> - <th scope="col">Conversion rules</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>java.lang.String</code><br> - <code>java.lang.Object</code></td> - <td>JavaScript 1.4: - <ul> - <li>A JavaScript string is converted to an instance of <code>java.lang.String</code> with a Unicode value.</li> - </ul> - - <p>JavaScript 1.3 and earlier:</p> - - <ul> - <li>A JavaScript string is converted to an instance of <code>java.lang.String</code> with an ASCII value.</li> - </ul> - </td> - </tr> - <tr> - <td>byte - <p>double<br> - float<br> - int<br> - long</p> - short</td> - <td>All values are converted to numbers as described in ECMA-262. The JavaScript string value is converted to a number according to the rules described in ECMA-262.</td> - </tr> - <tr> - <td>char</td> - <td>JavaScript 1.4: - <ul> - <li>One-character strings are converted to Unicode characters.</li> - <li>All other values are converted to numbers.</li> - </ul> - - <p>JavaScript 1.3 and earlier:</p> - - <ul> - <li>All values are converted to numbers.</li> - </ul> - </td> - </tr> - <tr> - <td>boolean</td> - <td> - <ul> - <li>The empty string becomes false.</li> - <li>All other values become true.</li> - </ul> - </td> - </tr> - </tbody> -</table> - -<h4 id="Undefined_Values" name="Undefined_Values">Undefined Values</h4> - -<p>When you pass undefined JavaScript values as parameters to Java methods, Java converts the values according to the rules described in the following table:</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Java parameter type</th> - <th scope="col">Conversion rules</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>java.lang.String</code><br> - <code>java.lang.Object</code></td> - <td>The value is converted to an instance of java.lang.String whose value is the string "undefined".</td> - </tr> - <tr> - <td>boolean</td> - <td>The value becomes false.</td> - </tr> - <tr> - <td>double<br> - float</td> - <td>The value becomes <code>NaN</code>.</td> - </tr> - <tr> - <td>byte - <p>char<br> - int<br> - long</p> - short</td> - <td>The value becomes 0.</td> - </tr> - </tbody> -</table> - -<p>The undefined value conversion is possible in JavaScript 1.3 and later versions only. Earlier versions of JavaScript do not support undefined values.</p> - -<p>When a JavaScript undefined value is passed as a parameter to a Java method which expects an instance of <code>java.lang.String</code>, the undefined value is converted to a string. Use the == operator to compare the result of this conversion with other string values.</p> - -<h4 id="Null_Values" name="Null_Values">Null Values</h4> - -<p>When you pass null JavaScript values as parameters to Java methods, Java converts the values according to the rules described in the following table:</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Java parameter type</th> - <th scope="col">Conversion rules</th> - </tr> - </thead> - <tbody> - <tr> - <td>Any class<br> - Any interface type</td> - <td>The value becomes null.</td> - </tr> - <tr> - <td>byte - <p>char<br> - double<br> - float<br> - int<br> - long</p> - short</td> - <td>The value becomes 0.</td> - </tr> - <tr> - <td>boolean</td> - <td>The value becomes false.</td> - </tr> - </tbody> -</table> - -<h4 id="JavaArray_and_JavaObject_objects" name="JavaArray_and_JavaObject_objects">JavaArray and JavaObject objects</h4> - -<p>In most situations, when you pass a JavaScript <code>JavaArray</code> or <code>JavaObject</code> as a parameter to a Java method, Java simply unwraps the object; in a few situations, the object is coerced into another data type according to the rules described in the following table:</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Java parameter type</th> - <th scope="col">Conversion rules</th> - </tr> - </thead> - <tbody> - <tr> - <td>Any interface or class that is assignment-compatible with the unwrapped object.</td> - <td>The object is unwrapped.</td> - </tr> - <tr> - <td><code>java.lang.String</code></td> - <td>The object is unwrapped, the <code>toString</code> method of the unwrapped Java object is called, and the result is returned as a new instance of <code>java.lang.String</code>.</td> - </tr> - <tr> - <td>byte - <p>char<br> - double<br> - float<br> - int<br> - long</p> - short</td> - <td>The object is unwrapped, and either of the following situations occur: - <ul> - <li>If the unwrapped Java object has a <code>doubleValue</code> method, the <code>JavaArray</code> or <code>JavaObject</code> is converted to the value returned by this method.</li> - <li>If the unwrapped Java object does not have a <code>doubleValue</code> method, an error occurs.</li> - </ul> - </td> - </tr> - <tr> - <td>boolean</td> - <td>In JavaScript 1.3 and later versions, the object is unwrapped and either of the following situations occur: - <ul> - <li>If the object is null, it is converted to false.</li> - <li>If the object has any other value, it is converted to true.</li> - </ul> - - <p>In JavaScript 1.2 and earlier versions, the object is unwrapped and either of the following situations occur:</p> - - <ul> - <li>If the unwrapped object has a booleanValue method, the source object is converted to the return value.</li> - <li>If the object does not have a booleanValue method, the conversion fails.</li> - </ul> - </td> - </tr> - </tbody> -</table> - -<p>An interface or class is assignment-compatible with an unwrapped object if the unwrapped object is an instance of the Java parameter type. That is, the following statement must return true:</p> - -<pre class="brush: js">unwrappedObject instanceof parameterType; -</pre> - -<h4 id="JavaClass_objects" name="JavaClass_objects">JavaClass objects</h4> - -<p>When you pass a JavaScript <code>JavaClass</code> object as a parameter to a Java method, Java converts the object according to the rules described in the following table:</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Java parameter type</th> - <th scope="col">Conversion rules</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>java.lang.Class</code></td> - <td>The object is unwrapped.</td> - </tr> - <tr> - <td><code>netscape.javascript.JSObject</code><br> - <code>java.lang.Object</code></td> - <td>The <code>JavaClass</code> object is wrapped in a new instance of <code>netscape.javascript.JSObject</code>.</td> - </tr> - <tr> - <td><code>java.lang.String</code></td> - <td>The object is unwrapped, the <code>toString</code> method of the unwrapped Java object is called, and the result is returned as a new instance of <code>java.lang.String</code>.</td> - </tr> - <tr> - <td>boolean</td> - <td>In JavaScript 1.3 and later versions, the object is unwrapped and either of the following situations occur: - <ul> - <li>If the object is null, it is converted to false.</li> - <li>If the object has any other value, it is converted to true.</li> - </ul> - - <p>In JavaScript 1.2 and earlier versions, the object is unwrapped and either of the following situations occur:</p> - - <ul> - <li>If the unwrapped object has a booleanValue method, the source object is converted to the return value.</li> - <li>If the object does not have a booleanValue method, the conversion fails.</li> - </ul> - </td> - </tr> - </tbody> -</table> - -<h4 id="Other_JavaScript_objects" name="Other_JavaScript_objects">Other JavaScript objects</h4> - -<p>When you pass any other JavaScript object as a parameter to a Java method, Java converts the object according to the rules described in the following table:</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Java parameter type</th> - <th scope="col">Conversion rules</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>netscape.javascript.JSObject</code><br> - <code>java.lang.Object</code></td> - <td>The object is wrapped in a new instance of <code>netscape.javascript.JSObject</code>.</td> - </tr> - <tr> - <td><code>java.lang.String</code></td> - <td>The object is unwrapped, the <code>toString</code> method of the unwrapped object is called, and the result is returned as a new instance of <code>java.lang.String</code>.</td> - </tr> - <tr> - <td>byte - <p>char<br> - double<br> - float<br> - int<br> - long</p> - short</td> - <td>The object is converted to a value using the logic of the <code>ToPrimitive</code> operator described in ECMA-262. The <em>PreferredType</em> hint used with this operator is Number.</td> - </tr> - <tr> - <td>boolean</td> - <td>In JavaScript 1.3 and later versions, the object is unwrapped and either of the following situations occur: - <ul> - <li>If the object is null, it is converted to false.</li> - <li>If the object has any other value, it is converted to true.</li> - </ul> - - <p>In JavaScript 1.2 and earlier versions, the object is unwrapped and either of the following situations occur:</p> - - <ul> - <li>If the unwrapped object has a booleanValue method, the source object is converted to the return value.</li> - <li>If the object does not have a booleanValue method, the conversion fails.</li> - </ul> - </td> - </tr> - </tbody> -</table> - -<h3 id="Java_to_JavaScript_Conversions">Java to JavaScript Conversions</h3> - -<p>Values passed from Java to JavaScript are converted as follows:</p> - -<ul> - <li>Java byte, char, short, int, long, float, and double are converted to JavaScript numbers.</li> - <li>A Java boolean is converted to a JavaScript boolean.</li> - <li>An object of class <code>netscape.javascript.JSObject</code> is converted to the original JavaScript object.</li> - <li>Java arrays are converted to a JavaScript pseudo-Array object; this object behaves just like a JavaScript <code>Array</code> object: you can access it with the syntax <code>arrayName[index]</code> (where <code>index</code> is an integer), and determine its length with <code>arrayName.length</code>.</li> - <li>A Java object of any other class is converted to a JavaScript wrapper, which can be used to access methods and fields of the Java object: - <ul> - <li>Converting this wrapper to a string calls the <code>toString</code> method on the original object.</li> - <li>Converting to a number calls the <code>doubleValue</code> method, if possible, and fails otherwise.</li> - <li>Converting to a boolean in JavaScript 1.3 and later versions returns false if the object is null, and true otherwise.</li> - <li>Converting to a boolean in JavaScript 1.2 and earlier versions calls the <code>booleanValue</code> method, if possible, and fails otherwise.</li> - </ul> - </li> -</ul> - -<p>Note that instances of java.lang.Double and java.lang.Integer are converted to JavaScript objects, not to JavaScript numbers. Similarly, instances of java.lang.String are also converted to JavaScript objects, not to JavaScript strings.</p> - -<p>Java <code>String</code> objects also correspond to JavaScript wrappers. If you call a JavaScript method that requires a JavaScript string and pass it this wrapper, you'll get an error. Instead, convert the wrapper to a JavaScript string by appending the empty string to it, as shown here:</p> - -<pre class="brush: js">var JavaString = JavaObj.methodThatReturnsAString(); -var JavaScriptString = JavaString + "";</pre> |