jdk-sandbox: nashorn/docs/JavaScriptingProgrammersGuide.html@d643e3ee819c (annotated)

16212 363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	1	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	2	<html class=" regenabled gecko radius jsenabled regloaded" xmlns="http://www.w3.org/1999/xhtml"><head>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	3	<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	4	<title>Java Scripting Programmer's Guide</title>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	5
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	6	<!-- ============ -->
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	7	<!-- MAIN CONTENT -->
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	8	<!-- ============ -->
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	9	<table summary="layout" border="0" width="100%">
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	10	<tbody><tr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	11	<td>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	12
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	13	<div id="sharepage" class="smallpagetitle"><h1>Java Scripting Programmer's Guide</h1><div class="sharepage"> <div class="sharepagew1 share-mailto"> <table summary="" cellpadding="0" cellspacing="0"><tbody><tr> <td id="share-mailto"><a href="mailto:?subject=Java%20Documentation%20Page:%20Java%20Scripting%20Programmer%27s%20Guide&body=Check%20out%20this%20page:%20%0A%0Ahttp%3A%2F%2Fdocs.oracle.com%2Fjavase%2F6%2Fdocs%2Ftechnotes%2Fguides%2Fscripting%2Fprogrammer_guide%2Findex.html" class="sharelink mailto" title="Email this page to a friend"></a></td> <td id="share-technorati"><a href="http://technorati.com/search/http%3A%2F%2Fdocs.oracle.com%2Fjavase%2F6%2Fdocs%2Ftechnotes%2Fguides%2Fscripting%2Fprogrammer_guide%2Findex.html" class="sharelink technorati" title="See who links to this page on Technorati"></a></td> <td id="share-delicious"><a href="http://del.icio.us/post?v=4;url=http%3A%2F%2Fdocs.oracle.com%2Fjavase%2F6%2Fdocs%2Ftechnotes%2Fguides%2Fscripting%2Fprogrammer_guide%2Findex.html;title=Java%20Scripting%20Programmer%27s%20Guide" class="sharelink delicious" title="Bookmark this page in del.icio.us"></a></td> <td id="share-digg"><a href="http://digg.com/submit?phase=2&url=http%3A%2F%2Fdocs.oracle.com%2Fjavase%2F6%2Fdocs%2Ftechnotes%2Fguides%2Fscripting%2Fprogrammer_guide%2Findex.html&title=Java%20Scripting%20Programmer%27s%20Guide" class="sharelink digg" title="Submit this page to Digg"></a></td> <td id="share-slashdot"><a href="http://slashdot.org/bookmark.pl?title=Java%20Scripting%20Programmer%27s%20Guide&url=http%3A%2F%2Fdocs.oracle.com%2Fjavase%2F6%2Fdocs%2Ftechnotes%2Fguides%2Fscripting%2Fprogrammer_guide%2Findex.html" class="sharelink slashdot" title="Submit this page to Slashdot"></a></td> <td id="share-blank"> </td></tr></tbody></table></div></div></div>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	14
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	15	</td>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	16	</tr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	17	</tbody></table>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	18	<!-- Body text begins here -->
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	19	<ul>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	20	<li><span><a href="#who">Who is the Java Scripting API
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	21	For?</a></span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	22	<li><span><a href="#package">Scripting Package</a></span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	23	<li><span><a href="#examples">Examples</a></span>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	24	<ul>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	25	<li><span><a href="#helloworld">"Hello, World"</a></span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	26	<li><span><a href="#evalfile">Evaluating a Script
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	27	File</a></span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	28	<li><span><a href="#scriptvars">Script Variables</a></span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	29	<li><span><a href="#invoke">Invoking Script Functions and
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	30	Methods</a></span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	31	<li><span><a href="#interfaces">Implementing Java Interfaces by
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	32	Scripts</a></span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	33	<li><span><a href="#scopes">Multiple Scopes for
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	34	Scripts</a></span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	35	</ul>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	36	</li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	37	<li><span><a href="#jsengine">JavaScript Script
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	38	Engine</a></span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	39	<li><span><a href="#jstojava">JavaScript to Java
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	40	Communication</a></span>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	41	<ul>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	42	<li><span><a href="#jsjavaclass">Accessing Java
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	43	Classes</a></span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	44	<li><span><a href="#jsimport">Importing Java Packages,
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	45	Classes</a></span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	46	<li><span><a href="#jsarrays">Creating, Converting and Using Java
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	47	Arrays</a></span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	48	<li><span><a href="#jsimplement">Implementing Java
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	49	Interfaces</a></span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	50	<li><span><a href="#jsextend">Extending Java classes
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	51	</a></span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	52	<li><span><a href="#jsoverload">Overload Resolution</a></span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	53	</ul>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	54	</li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	55	<li><span><a href="#engineimpl">Implementing Your Own Script
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	56	Engine</a></span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	57	<li><span><a href="#refs">References</a></span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	58	</ul>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	59	<span><a name="who" id="who"></a></span>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	60	<h2><span>Who is the Java Scripting API For?</span></h2>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	61	<span>Some useful characteristics of scripting languages
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	62	are:</span>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	63	<ul>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	64	<li><span><b>Convenience</b>: Most scripting languages are
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	65	dynamically typed. You can usually create new variables without
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	66	declaring the variable type, and you can reuse variables to store
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	67	objects of different types. Also, scripting languages tend to
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	68	perform many type conversions automatically, for example,
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	69	converting the number 10 to the text "10" as necessary.</span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	70	<li><span><b>Developing rapid prototypes</b>: You can avoid the
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	71	edit-compile-run cycle and just use edit-run!</span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	72	<li><span><b>Application extension/customization</b>: You can
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	73	"externalize" parts of your application - like configuration
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	74	scripts, business logic/rules and math expressions for financial
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	75	applications.</span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	76	<li><span><b>"Command line" shells for applications</b> -for
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	77	debugging, runtime/deploy time configuration etc. Most applications
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	78	have a web-based GUI configuaration tool these days. But
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	79	sysadmins/deployers frequently prefer command line tools. Instead
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	80	of inventing ad-hoc scripting language for that purpose, a
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	81	"standard" scripting language can be used.</span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	82	</ul>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	83	<p><span>The Java<font size="-1"><sup>TM</sup></font> Scripting API
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	84	is a scripting language indepedent framework for using script
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	85	engines from Java code. With the Java Scripting API, it is possible
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	86	to write customizable/extendable applications in the Java language
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	87	and leave the customization scripting language choice to the end
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	88	user. The Java application developer need not choose the extension
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	89	language during development. If you write your application with
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	90	JSR-223 API, then your users can use any JSR-223 compliant
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	91	scripting language.</span></p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	92	<hr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	93	<span><a name="package" id="package"></a></span>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	94	<h2><span>Scripting Package</span></h2>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	95	<p><span>The Java Scripting functionality is in the <code><a href="http://docs.oracle.com/javase/6/docs/api/javax/script/package-summary.html">javax.script</a></code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	96	package. This is a relatively small, simple API. The starting point
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	97	of the scripting API is the <code>ScriptEngineManager</code> class.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	98	A ScriptEngineManager object can discover script engines through
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	99	the jar file service discovery mechanism. It can also instantiate
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	100	ScriptEngine objects that interpret scripts written in a specific
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	101	scripting language. The simplest way to use the scripting API is as
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	102	follows:</span></p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	103	<ol>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	104	<li><span>Create a <code>ScriptEngineManager</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	105	object.</span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	106	<li><span>Get a <code>ScriptEngine</code> object from the
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	107	manager.</span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	108	<li><span>Evaluate script using the <code>ScriptEngine</code>'s
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	109	<code>eval</code> methods.</span></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	110	</ol>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	111	<p><span>Now, it is time to look at some sample code. While it is
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	112	not mandatory, it may be useful to know a bit of JavaScript to read
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	113	these examples.</span></p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	114	<hr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	115	<span><a name="examples" id="examples"></a></span>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	116	<h2><span>Examples</span></h2>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	117	<span><a name="helloworld" id="helloworld"></a></span>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	118	<h3><span>"Hello, World"</span></h3>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	119	<p><span>From the <code>ScriptEngineManager</code> instance, we
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	120	request a JavaScript engine instance using
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	121	<code>getEngineByName</code> method. On the script engine, the
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	122	<code>eval</code> method is called to execute a given String as
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	123	JavaScript code! For brevity, in this as well as in subsequent
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	124	examples, we have not shown exception handling. There are checked
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	125	and runtime exceptions thrown from <code>javax.script</code> API.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	126	Needless to say, you have to handle the exceptions
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	127	appropriately.</span></p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	128	<pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	129	<span><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	130	// <a href="source/EvalScript.java">EvalScript.java</a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	131
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	132	import javax.script.*;
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	133	public class EvalScript {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	134	public static void main(String[] args) throws Exception {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	135	// create a script engine manager
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	136	<span class="classref">ScriptEngineManager</span> factory = new ScriptEngineManager();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	137	// create a JavaScript engine
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	138	<span class="classref">ScriptEngine</span> engine = factory.<span class="methodref">getEngineByName</span>("nashorn");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	139	// evaluate JavaScript code from String
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	140	engine.<span class="methodref">eval</span>("print('Hello, World')");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	141	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	142	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	143	</code></span>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	144	</pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	145	<hr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	146	<a name="evalfile" id="evalfile"></a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	147	<h3>Evaluating a Script File</h3>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	148	<p>In this example, we call the <code>eval</code> method that
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	149	accepts <code>java.io.Reader</code> for the input source. The
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	150	script read by the given reader is executed. This way it is
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	151	possible to execute scripts from files, URLs and resources by
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	152	wrapping the relevant input stream objects as readers.</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	153	<pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	154	<code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	155	// <a href="source/EvalFile.java">EvalFile.java</a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	156
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	157	import javax.script.*;
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	158
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	159	public class EvalFile {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	160	public static void main(String[] args) throws Exception {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	161	// create a script engine manager
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	162	<span class="classref">ScriptEngineManager</span> factory = new ScriptEngineManager();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	163	// create JavaScript engine
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	164	<span class="classref">ScriptEngine</span> engine = factory.<span class="methodref">getEngineByName</span>("nashorn");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	165	// evaluate JavaScript code from given file - specified by first argument
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	166	engine.<span class="methodref">eval</span>(new java.io.FileReader(args[0]));
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	167	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	168	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	169	</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	170	</pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	171	Let us assume that we have the file named <a href="source/test.js">test.js</a> with the
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	172	following text:
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	173	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	174	print("This is hello from test.js");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	175	</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	176	</pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	177	We can run the above Java as
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	178	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	179	java EvalFile test.js
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	180	</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	181	</pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	182	<hr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	183	<a name="scriptvars" id="scriptvars"></a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	184	<h3>Script Variables</h3>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	185	<p>When you embed script engines and scripts with your Java
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	186	application, you may want to expose your application objects as
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	187	global variables to scripts. This example demonstrates how you can
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	188	expose your application objects as global variables to a script. We
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	189	create a <code>java.io.File</code> in the application and expose
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	190	the same as a global variable with the name "file". The script can
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	191	access the variable - for example, it can call public methods on
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	192	it. Note that the syntax to access Java objects, methods and fields
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	193	is dependent on the scripting language. JavaScript supports the
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	194	most "natural" Java-like syntax.</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	195	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	196	// <a href="source/ScriptVars.java">ScriptVars.java</a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	197
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	198	import javax.script.*;
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	199	import java.io.*;
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	200
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	201	public class ScriptVars {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	202	public static void main(String[] args) throws Exception {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	203	ScriptEngineManager manager = new ScriptEngineManager();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	204	ScriptEngine engine = manager.getEngineByName("nashorn");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	205
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	206	File f = new File("test.txt");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	207	// expose File object as variable to script
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	208	engine.<span class="methodref">put</span>("file", f);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	209
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	210	// evaluate a script string. The script accesses "file"
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	211	// variable and calls method on it
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	212	engine.eval("print(file.getAbsolutePath())");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	213	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	214	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	215
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	216	</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	217	</pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	218	<hr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	219	<a name="invoke" id="invoke"></a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	220	<h3>Invoking Script Functions and Methods</h3>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	221	<p>Sometimes you may want to call a specific scripting function
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	222	repeatedly - for example, your application menu functionality might
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	223	be implemented by a script. In your menu's action event handler you
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	224	may want to call a specific script function. The following example
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	225	demonstrates invoking a specific script function from Java
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	226	code.</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	227	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	228	// <a href="source/InvokeScriptFunction.java">InvokeScriptFunction.java</a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	229
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	230	import javax.script.*;
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	231
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	232	public class InvokeScriptFunction {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	233	public static void main(String[] args) throws Exception {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	234	ScriptEngineManager manager = new ScriptEngineManager();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	235	ScriptEngine engine = manager.getEngineByName("nashorn");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	236
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	237	// JavaScript code in a String
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	238	String script = "function hello(name) { print('Hello, ' + name); }";
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	239	// evaluate script
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	240	engine.eval(script);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	241
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	242	// <code>javax.script.Invocable</code> is an optional interface.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	243	// Check whether your script engine implements it or not!
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	244	// Note that the JavaScript engine implements Invocable interface.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	245	<span class="classref">Invocable</span> inv = (Invocable) engine;
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	246
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	247	// invoke the global function named "hello"
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	248	inv.<span class="methodref">invokeFunction</span>("hello", "Scripting!!" );
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	249	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	250	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	251
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	252	</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	253	</pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	254	<p>If your scripting language is object based (like JavaScript) or
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	255	object-oriented, then you can invoke a script method on a script
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	256	object.</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	257	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	258	// <a href="source/InvokeScriptMethod.java">InvokeScriptMethod.java</a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	259
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	260	import javax.script.*;
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	261
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	262	public class InvokeScriptMethod {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	263	public static void main(String[] args) throws Exception {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	264	ScriptEngineManager manager = new ScriptEngineManager();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	265	ScriptEngine engine = manager.getEngineByName("nashorn");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	266
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	267	// JavaScript code in a String. This code defines a script object 'obj'
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	268	// with one method called 'hello'.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	269	String script = "var obj = new Object(); obj.hello = function(name) { print('Hello, ' + name); }";
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	270	// evaluate script
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	271	engine.eval(script);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	272
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	273	// <code>javax.script.Invocable</code> is an optional interface.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	274	// Check whether your script engine implements or not!
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	275	// Note that the JavaScript engine implements Invocable interface.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	276	<span class="classref">Invocable</span> inv = (Invocable) engine;
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	277
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	278	// get script object on which we want to call the method
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	279	Object obj = engine.<span class="methodref">get</span>("obj");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	280
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	281	// invoke the method named "hello" on the script object "obj"
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	282	inv.<span class="methodref">invokeMethod</span>(obj, "hello", "Script Method !!" );
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	283	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	284	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	285
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	286	</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	287	</pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	288	<hr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	289	<a name="interfaces" id="interfaces"></a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	290	<h3>Implementing Java Interfaces by Scripts</h3>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	291	<p>Instead of calling specific script functions from Java,
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	292	sometimes it is convenient to implement a Java interface by script
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	293	functions or methods. Also, by using interfaces we can avoid having
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	294	to use the <code>javax.script</code> API in many places. We can get
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	295	an interface implementor object and pass it to various Java APIs.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	296	The following example demonstrates implementing the
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	297	<code>java.lang.Runnable</code> interface with a script.</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	298	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	299	// <a href="source/RunnableImpl.java">RunnableImpl.java</a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	300
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	301	import javax.script.*;
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	302
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	303	public class RunnableImpl {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	304	public static void main(String[] args) throws Exception {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	305	ScriptEngineManager manager = new ScriptEngineManager();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	306	ScriptEngine engine = manager.getEngineByName("nashorn");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	307
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	308	// JavaScript code in a String
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	309	String script = "function run() { print('run called'); }";
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	310
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	311	// evaluate script
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	312	engine.eval(script);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	313
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	314	<span class="classref">Invocable</span> inv = (Invocable) engine;
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	315
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	316	// get Runnable interface object from engine. This interface methods
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	317	// are implemented by script functions with the matching name.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	318	Runnable r = inv.<span class="methodref">getInterface</span>(Runnable.class);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	319
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	320	// start a new thread that runs the script implemented
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	321	// runnable interface
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	322	Thread th = new Thread(r);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	323	th.start();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	324	th.join();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	325	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	326	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	327	</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	328	</pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	329	<p>If your scripting language is object-based or object-oriented,
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	330	it is possible to implement a Java interface by script methods on
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	331	script objects. This avoids having to call script global functions
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	332	for interface methods. The script object can store the "state"
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	333	associated with the interface implementor.</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	334	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	335	// <a href="source/RunnableImplObject.java">RunnableImplObject.java</a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	336
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	337	import javax.script.*;
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	338
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	339	public class RunnableImplObject {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	340	public static void main(String[] args) throws Exception {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	341	ScriptEngineManager manager = new ScriptEngineManager();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	342	ScriptEngine engine = manager.getEngineByName("nashorn");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	343
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	344	// JavaScript code in a String
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	345	String script = "var obj = new Object(); obj.run = function() { print('run method called'); }";
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	346
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	347	// evaluate script
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	348	engine.eval(script);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	349
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	350	// get script object on which we want to implement the interface with
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	351	Object obj = engine.<span class="methodref">get</span>("obj");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	352
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	353	<span class="classref">Invocable</span> inv = (Invocable) engine;
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	354
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	355	// get Runnable interface object from engine. This interface methods
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	356	// are implemented by script methods of object 'obj'
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	357	Runnable r = inv.<span class="methodref">getInterface</span>(obj, Runnable.class);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	358
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	359	// start a new thread that runs the script implemented
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	360	// runnable interface
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	361	Thread th = new Thread(r);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	362	th.start();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	363	th.join();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	364	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	365	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	366	</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	367	</pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	368	<hr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	369	<a name="scopes" id="scopes"></a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	370	<h3>Multiple Scopes for Scripts</h3>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	371	<p>In the <a href="#scriptvars">script variables</a> example, we
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	372	saw how to expose application objects as script global variables.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	373	It is possible to expose multiple global "scopes" for scripts. A
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	374	single scope is an instance of <code>javax.script.Bindings</code>.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	375	This interface is derived from <code>java.util.Map<String,
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	376	Object></code>. A scope a set of name-value pairs where name is
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	377	any non-empty, non-null String.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	378	<code>javax.script.ScriptContext</code> interface supports multiple
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	379	scopes with associated Bindings for each
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	380	scope. By default, every script engine has a default script
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	381	context. The default script context has atleast one scope called
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	382	"ENGINE_SCOPE". Various scopes supported by a script context are
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	383	available through <code>getScopes</code> method.</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	384	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	385	// <a href="source/MultiScopes.java">MultiScopes.java</a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	386
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	387	import javax.script.*;
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	388
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	389	public class MultiScopes {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	390	public static void main(String[] args) throws Exception {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	391	ScriptEngineManager manager = new ScriptEngineManager();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	392	ScriptEngine engine = manager.getEngineByName("nashorn");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	393
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	394	engine.put("x", "hello");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	395	// print global variable "x"
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	396	engine.eval("print(x);");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	397	// the above line prints "hello"
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	398
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	399	// Now, pass a different script context
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	400	<span class="classref">ScriptContext</span> newContext = new <span class="classref">SimpleScriptContext</span>();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	401	newContext.setBindings(engine.createBindings(), ScriptContext.ENGINE_SCOPE);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	402	<span class="classref">Bindings</span> engineScope = newContext.<span class="methodref">getBindings</span>(ScriptContext.ENGINE_SCOPE);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	403
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	404	// add new variable "x" to the new engineScope
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	405	engineScope.<span class="methodref">put</span>("x", "world");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	406
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	407	// execute the same script - but this time pass a different script context
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	408	engine.eval("print(x);", newContext);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	409	// the above line prints "world"
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	410	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	411	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	412
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	413	</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	414	</pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	415	<hr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	416	<a name="jsengine" id="jsengine"></a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	417	<h2>JavaScript Script Engine</h2>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	418	<p>Oracle's implementation of JDK 8 is co-bundled with the Nashorn ECMAScript
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	419	script engine.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	420	<hr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	421	<a name="jstojava" id="jstojava"></a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	422	<h2>JavaScript to Java Communication</h2>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	423	<p>For the most part, accessing Java classes, objects and methods
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	424	is straightforward. In particular field and method access from
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	425	JavaScript is the same as it is from Java. We highlight important
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	426	aspects of JavaScript Java access here.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	427	The following examples are JavaScript snippets accessing Java. This
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	428	section requires knowledge of JavaScript. This section can be
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	429	skipped if you are planning to use some other JSR-223 scripting
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	430	language rather than JavaScript.</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	431	<hr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	432	<a name="jsjavaclass" id=jsjavalass"></a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	433	<h3>Accessing Java Classes</h3>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	434	<pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	435	<code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	436	// <a href="source/javatypes.js">javatypes.js</a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	437
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	438	var arrayListType = Java.type("java.util.ArrayList")
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	439	var intType = Java.type("int")
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	440	var stringArrayType = Java.type("java.lang.String[]")
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	441	var int2DArrayType = Java.type("int[][]")
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	442	</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	443	</pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	444
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	445	Note that the name of the type is always a string for a fully qualified name. You can use any of these types to create new instances, e.g.:
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	446
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	447	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	448	var anArrayList = new Java.type("java.util.ArrayList")
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	449	</code></pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	450
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	451	or
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	452
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	453	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	454	var ArrayList = Java.type("java.util.ArrayList")
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	455	var anArrayList = new ArrayList
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	456	var anArrayListWithSize = new ArrayList(16)
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	457	</code></pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	458
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	459	In the special case of inner classes, you need to use the JVM fully qualified name, meaning using $ sign in the class name:
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	460
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	461	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	462	var ftype = Java.type("java.awt.geom.Arc2D$Float")
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	463	</code></pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	464
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	465
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	466	However, once you retrieved the outer class, you can access the inner class as a property on it:
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	467
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	468	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	469	var arctype = Java.type("java.awt.geom.Arc2D")
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	470	var ftype = arctype.Float
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	471	</code></pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	472	<p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	473	You can access both static and non-static inner classes. If you want to create an instance of a non-static inner class, remember to pass an instance of its outer class as the first argument to the constructor.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	474	</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	475	<hr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	476	<a name="jsimport" id="jsimport"></a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	477	<h3>Importing Java Packages, Classes</h3>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	478	<p>The built-in functions <code>importPackage</code> (in compatibility script) and
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	479	<code>importClass</code> can be used to import Java packages and
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	480	classes.</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	481	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	482
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	483	// <a href="source/importpackageclass.js">importpackageclass.js</a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	484
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	485	// load compatibility script
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	486	load("nashorn:mozilla_compat.js");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	487	// Import Java packages and classes
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	488	// like import package.*; in Java
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	489	<span class="functionref">importPackage</span>(java.awt);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	490	// like import java.awt.Frame in Java
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	491	<span class="functionref">importClass</span>(java.awt.Frame);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	492	// Create Java Objects by "new ClassName"
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	493	var frame = new java.awt.Frame("hello");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	494	// Call Java public methods from script
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	495	frame.setVisible(true);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	496	// Access "JavaBean" properties like "fields"
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	497	print(frame.title);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	498	</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	499	</pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	500	<p>The <span class="objectref">Packages</span> global variable can
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	501	be used to access Java packages. Examples:
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	502	<code>Packages.java.util.Vector</code>,
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	503	<code>Packages.javax.swing.JFrame</code>. Please note that "java"
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	504	is a shortcut for "Packages.java". There are equivalent shortcuts
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	505	for javax, org, edu, com, net prefixes, so pratically all JDK
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	506	platform classes can be accessed without the "Packages" prefix.</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	507	<p>Note that java.lang is not imported by default (unlike Java)
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	508	because that would result in conflicts with JavaScript's built-in
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	509	Object, Boolean, Math and so on.</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	510	<p><code>importPackage</code> and <code>importClass</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	511	functions "pollute" the global variable scope of JavaScript. To
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	512	avoid that, you may use <span class="functionref">JavaImporter</span>.</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	513	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	514
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	515	// <a href="source/javaimporter.js">javaimporter.js</a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	516
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	517	// create JavaImporter with specific packages and classes to import
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	518
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	519	var SwingGui = new <span class="functionref">JavaImporter</span>(javax.swing,
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	520	javax.swing.event,
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	521	javax.swing.border,
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	522	java.awt.event);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	523	with (SwingGui) {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	524	// within this 'with' statement, we can access Swing and AWT
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	525	// classes by unqualified (simple) names.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	526
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	527	var mybutton = new JButton("test");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	528	var myframe = new JFrame("test");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	529	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	530
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	531	</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	532	</pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	533	<hr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	534	<a name="jsarrays" id="jsarrays"></a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	535	<h3>Creating, Converting and Using Java Arrays</h3>
16522 d643e3ee819c 8009757: Package access clean up and refactoring sundar parents: 16212 diff changeset	536	<p>
d643e3ee819c 8009757: Package access clean up and refactoring sundar parents: 16212 diff changeset	537	Array element access or length access is
16212 363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	538	the same as in Java. Also, a script array can be used when a Java
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	539	method expects a Java array (auto conversion). So in most cases we
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	540	don't have to create Java arrays explicitly.</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	541	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	542	// <a href="source/javaarray.js">javaarray.js</a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	543
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	544	// create Java String array of 5 elements
16522 d643e3ee819c 8009757: Package access clean up and refactoring sundar parents: 16212 diff changeset	545	var StringArray = Java.type("java.lang.String[]");
d643e3ee819c 8009757: Package access clean up and refactoring sundar parents: 16212 diff changeset	546	var a = new StringArray(5);
16212 363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	547
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	548	// Accessing elements and length access is by usual Java syntax
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	549	a[0] = "scripting is great!";
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	550	print(a.length);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	551	print(a[0]);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	552	</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	553	</pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	554	<p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	555	It is also possible to convert between JavaScript and Java arrays.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	556	Given a JavaScript array and a Java type, <code>Java.toJavaArray</code> returns a Java array with the same initial contents, and with the specified component type.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	557	</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	558	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	559	var anArray = [1, "13", false]
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	560	var javaIntArray = Java.toJavaArray(anArray, "int")
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	561	print(javaIntArray[0]) // prints 1
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	562	print(javaIntArray[1]) // prints 13, as string "13" was converted to number 13 as per ECMAScript ToNumber conversion
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	563	print(javaIntArray[2]) // prints 0, as boolean false was converted to number 0 as per ECMAScript ToNumber conversion
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	564	</code></pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	565	<p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	566	Given a Java array or Collection, <code>Java.toJavaScriptArray</code> returns a JavaScript array with a shallow copy of its contents. Note that in most cases, you can use Java arrays and lists natively in Nashorn; in cases where for some reason you need to have an actual JavaScript native array (e.g. to work with the array comprehensions functions), you will want to use this method.i
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	567	</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	568	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	569	var File = Java.type("java.io.File");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	570	var listCurDir = new File(".").listFiles();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	571	var jsList = Java.toJavaScriptArray(listCurDir);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	572	print(jsList);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	573	</code></pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	574	<hr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	575	<a name="jsimplement" id="jsimplement"></a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	576	<h3>Implementing Java Interfaces</h3>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	577	<p>A Java interface can be implemented in JavaScript by using a
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	578	Java anonymous class-like syntax:</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	579	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	580	// <a href="source/runnable.js">runnable.js</a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	581
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	582	var r = new java.lang.Runnable() {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	583	run: function() {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	584	print("running...\n");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	585	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	586	};
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	587
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	588	// "r" can be passed to Java methods that expect java.lang.Runnable
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	589	var th = new java.lang.Thread(r);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	590	th.start();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	591	th.join();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	592	</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	593	</pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	594	<p>When an interface with a single method is expected, you can pass
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	595	a script function directly.(auto conversion)</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	596	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	597	// <a href="source/samfunc.js">samfunc.js</a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	598
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	599	function func() {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	600	print("I am func!");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	601	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	602
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	603	// pass script function for java.lang.Runnable argument
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	604	var th = new java.lang.Thread(func);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	605	th.start();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	606	th.join();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	607	</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	608	</pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	609	<hr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	610	<a name="jsextend" id="jsextend"></a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	611	<h3>Extending Java classes</h3>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	612	<p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	613	If a Java class is abstract, you can instantiate an anonymous subclass of it using an argument list that is applicable to any of its public or protected constructors, but inserting a JavaScript object with functions properties that provide JavaScript implementations of the abstract methods. If method names are overloaded, the JavaScript function will provide implementation for all overloads. E.g.:
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	614	</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	615
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	616	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	617	var TimerTask = Java.type("java.util.TimerTask")
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	618	var task = new TimerTask({ run: function() { print("Hello World!") } })
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	619	</code></pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	620
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	621	Nashorn supports a syntactic extension where a "new" expression followed by an argument is identical to invoking the constructor and passing the argument to it, so you can write the above example also as:
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	622
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	623	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	624	var task = new TimerTask {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	625	run: function() {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	626	print("Hello World!")
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	627	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	628	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	629	</code></pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	630
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	631	which is very similar to Java anonymous inner class definition. On the other hand, if the type is an abstract type with a single abstract method (commonly referred to as a "SAM type") or all abstract methods it has share the same overloaded name), then instead of an object, you can just pass a function, so the above example can become even more simplified to:
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	632
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	633	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	634	var task = new TimerTask(function() { print("Hello World!") })
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	635	</code></pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	636
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	637	<p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	638	Note that in every one of these cases if you are trying to instantiate an abstract class that has constructors that take some arguments, you can invoke those simply by specifying the arguments after the initial implementation object or function.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	639	</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	640	<p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	641	The use of functions can be taken even further; if you are invoking a Java method that takes a SAM type, you can just pass in a function object, and Nashorn will know what you meant:
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	642	</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	643	<code><pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	644	Java.type("java.util.Timer")
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	645	timer.schedule(function() { print("Hello World!") })
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	646	</code></pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	647
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	648	Here, <code>Timer.schedule()</code> expects a <code>TimerTask</code> as its argument, so Nashorn creates an instance of a TimerTask subclass and uses the passed function to implement its only abstract method, run(). In this usage though, you can't use non-default constructors; the type must be either an interface, or must have a protected or public no-arg constructor.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	649
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	650	<p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	651	To extend a concrete Java class, you have to use <code>Java.extend</code> function.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	652	<code>Java.extend</code> returns a type object for a subclass of the specified Java class (or implementation of the specified interface) that acts as a script-to-Java adapter for it.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	653	</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	654	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	655	// <a href="source/javaextend.js">javaextend.js</a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	656
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	657	var ArrayList = Java.type("java.util.ArrayList")
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	658	var ArrayListExtender = Java.extend(ArrayList)
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	659	var printSizeInvokedArrayList = new ArrayListExtender() {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	660	size: function() { print("size invoked!"); }
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	661	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	662	var printAddInvokedArrayList = new ArrayListExtender() {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	663	add: function(x, y) {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	664	if(typeof(y) === "undefined") {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	665	print("add(e) invoked!");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	666	} else {
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	667	print("add(i, e) invoked!");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	668	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	669	}
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	670	};
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	671	printSizeInvokedArrayList.size();
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	672	printAddInvokedArrayList.add(33, 33);
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	673	</code></pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	674	<hr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	675	<a name="jsoverload" id="jsoverload"></a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	676	<h3>Overload Resolution</h3>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	677	<p>Java methods can be overloaded by argument types. In Java,
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	678	overload resolution occurs at compile time (performed by javac).
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	679	When calling Java methods from a script, the script
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	680	interpreter/compiler needs to select the appropriate method. With
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	681	the JavaScript engine, you do not need to do anything special - the
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	682	correct Java method overload variant is selected based on the
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	683	argument types. But, sometimes you may want (or have) to explicitly
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	684	select a particular overload variant.</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	685	<pre><code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	686	// <a href="source/overload.js">overload.js</a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	687
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	688	var out = java.lang.System.out;
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	689
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	690	// select a particular print function
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	691	out["println(java.lang.Object)"]("hello");
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	692	</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	693	</pre>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	694	<hr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	695	<a name="engineimpl" id="engineimpl"></a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	696	<h2>Implementing Your Own Script Engine</h2>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	697	<p>We will not cover implementation of JSR-223 compliant script
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	698	engines in detail. Minimally, you need to implement the
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	699	<code>javax.script.ScriptEngine</code> and
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	700	<code>javax.script.ScriptEngineFactory</code> interfaces. The
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	701	abstract class <code>javax.script.AbstractScriptEngine</code>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	702	provides useful defaults for a few methods of the
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	703	<code>ScriptEngine</code> interface.</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	704	<p>Before starting to implement a JSR-223 engine, you may want to
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	705	check <a href="http://java.net/projects/Scripting">http://java.net/projects/Scripting</a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	706	project. This project maintains JSR-223 implementations for many
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	707	popular open source scripting languages.</p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	708	<hr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	709	<a name="refs" id="refs"></a>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	710	<h2>References</h2>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	711	<ul>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	712	<li><a href="http://jcp.org/en/jsr/detail?id=223">JSR-223 Scripting
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	713	for the Java Platform</a></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	714	<li><a href="http://java.net/projects/Scripting">http://java.net/projects/Scripting
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	715	</a></li>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	716	</ul>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	717
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	718
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	719
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	720	<div class="hr"><hr></div>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	721	<table summary="layout" border="0" width="100%">
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	722	<tbody><tr valign="TOP">
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	723	<td width="30%"> <img src="Java%20Scripting%20Programmer%27s%20Guide_files/logo_oracle_footer.gif" alt="Oracle and/or its affiliates" border="0" height="29" width="100"><br>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	724	<font size="+1"> <i>Java Technology</i></font> </td>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	725
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	726	<td width="30%">
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	727	<p><font size="-2">
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	728	<a href="http://docs.oracle.com/javase/6/docs/legal/cpyr.html">Copyright �</a> 2013, Oracle and/or its affiliates. All rights reserved.
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	729	</font></p>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	730	</td>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	731	<td width="30%">
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	732	<p align="right"><font size="-2"><a href="http://download.oracle.com/javase/feedback.html">Contact Us</a></font></p><font size="-2">
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	733	</font></td>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	734	</tr>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	735	</tbody></table>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	736	<div class="hr"><hr></div>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	737	</div>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	738
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	739	<!-- Start SiteCatalyst code -->
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	740	<script language="JavaScript" src="Java%20Scripting%20Programmer%27s%20Guide_files/s_code_download.js"></script>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	741	<script language="JavaScript" src="Java%20Scripting%20Programmer%27s%20Guide_files/s_code.js"></script>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	742
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	743	<!-- ******** DO NOT ALTER ANYTHING BELOW THIS LINE ! ********* -->
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	744	<!-- Below code will send the info to Omniture server -->
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	745	<script language="javascript">var s_code=s.t();if(s_code)document.write(s_code)</script>
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	746
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	747	<!-- End SiteCatalyst code -->
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	748
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	749
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	750
363737d0d757 8007452: add scripting programmers doc changes for nashorn sundar parents: diff changeset	751	</body></html>

author	sundar
	Tue, 12 Mar 2013 18:12:42 +0530
changeset 16522	d643e3ee819c
parent 16212	363737d0d757
child 16784	ba0dd689dd98
permissions	-rw-r--r--