View source for VJET/JSRReference

= Purpose =
The purpose is the document how the VJET JS or Java to JS is transformed into a Java API using a reference based programming model.

= What is a JSR =
A JSR (JavaScript Reference) is a Java type that serves as a reference to the following types:

* VJET JavaScript Authored in multiple languages
** JavaScript language
** Java language
* Native Types
** JavaScript Native Types
** DOM types

== Java APIs to Access JavaScript ==
JSR provides access to JavaScript and provides Java APIs for public

* Functions

* Methods
* Properties
* Function References
* Type References

Java code can access JavaScript references using Java. JavaScript developers can develop a definition neutral JavaScript Reference API. Developers can choose to use JavaScript authored in JavaScript language or in the Java language. JSRs are part of a larger technology set, V4, which supports the development of web pages and applications using Java. 


== Resource Access ==
JSRs provide a resource reference for any JavaScript resource backing the type. This is used for ensuring that when executing the JavaScript that all the definitions have loaded in the runtime. Resource Specs can be added to view specs. Please see the V4 resource pattern documentation for more information.


== APIs Public Access Required ==
Methods, nested classes, and properties that are public will have generated JSR apis. All others will not be generated in JSR.


= JSR Creation Options =
== VJET JS to JSR ==
VJET JS to Jsr is the entry point for JavaScript developers to work with Java developers. The JSR generated from the VJET JS source file is not meant to be edited by hand. The name of a JSR is composed of the name of the type it represents, appended with ‘Jsr’. For example, VJET JavaScript type named MyClass (.js) will generate a JSR named MyClassJsr.java. Generated java files should always be generated and never checked into source control. To handle this case the generated JSR contains a Java 5 annotation: @org.eclipse.vjet.resource.utils.CodeGen("JsrGenerator")


There are 3 ways this can be done:

# Eclipse plugin – right click V4-> Js reference generation - 
# Java main program - org.eclipse.vjet.jstojava.codegen.JsToJavaGen
# ANT task - org.eclipse.vjet.jstojava.prebuild.JsLibPreBuildTask

//Note for eBay this task has been integrated into the Build3 and Build2 systems.


== VJET Java to JSR ==
JSRs can also be generated from Java files. This provides the capability for JavaScript code to be authored in Java or JavaScript code without having consumer change their code if the signature doesn't change. The JSR generated from the Java source file is not meant to be edited by hand. The name of a JSR is composed of the name of the Java type it represents, appended with ‘Jsr’. For example, Java type named MyClass.java will generate a JSR named MyClassJsr.java. Generated java files should always be generated and never checked into source control. To handle this case the generated JSR contains a Java 5 annotation: @org.eclipse.vjet.resource.utils.CodeGen("JsrGenerator")


There are 3 ways this can be done:

# Eclipse plug-in – right click V4-> Java 2 Js Generation
# Java main program - org.eclipse.vjet.javatojs.cli.Java2Vjo
# ANT task - org.eclipse.vjet.javatojs.prebuild.J2JsBuildTask

== Hand coded Jsr ==
JSRs can also be generated by hand. For example if the original api authored by the JavaScript developer doesn't handle a specific case such as using a JavaScript type or DOM type but there is a more appropriate Java type that should be used a custom Jsr can be created.

= When to not use Jsr =
JSRs should not be used when writing JavaScript definitions using Java. Native java proxies should be used when trying to access native JavaScript code from a Java 2 Js definition. 


= VJET Types map to Jsr generated types =
A JSR definition preserves all aspects of the original type definition, including inheritance, interface implementations, and dependencies. For example, if a JavaScript definition inherits from another type, the JSR will extend from the super class; if a JavaScript definition implements an interface, the JSR will specify the implemented interface. Please refer to the Appendix Xxx for more information.


Below is the list of fundamental VJO types that are supported.


== Java Related types ==
# CType - a java class extending JsObj is generated
# IType – a java interface is generated
# EType – a java class extending JsEnum is generated
# Static Inner Type – a nested java class will be created for each public nested class.
# Instance Inner Type
# Anonymous Type

== Js Types with no equivalent Java type ==
# MType – a java class is generated since java doesn't support mixin natively. This type answers to let you know it isMixin and provides access to resource backing mixin.
# OType – a java class with nested java classes is generated.

= Js Functions =
The following diagram shows the relationships for the Java Script Reference model for JavaScript Functions,

[[Image:Vjet_jsrreference_jsfunction.png‎]]

== Functions with No Arguments ==
If a method takes no arguments, a single function reference is generated. The reference preserves all modifier information from the original definition, in this case, a void return type, and public access. 



{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JSR Java API

|- style="vertical-align:top" style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"|<source lang="javascript"> 
//> public void warn();
warn:function(){}
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">public JsFunc<Void> warn() {…}</source>

|- style="vertical-align:top" style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 

|- style="vertical-align:top" style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">public void warn(){}
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 

|}

== Functions with arguments ==
If a method takes one or more arguments, two function references are generated:

* A reference that accepts the given argument type

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JSR Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
//> public String foo(String s);
foo:function(s){}</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">public JsFunc<String> foo(String s) </source>


|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">public void warn(String s){}</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|}
* A reference that accepts a value binding


{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JSR Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
//> public String foo(String s);
foo:function(s){} // assume this code is in props section / static</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">public static JsFunc<String> foo(IValueBinding<String> s) </source>

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"|  <source lang="java">public String foo(String s)</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 
|}
* Passing a value binding allows delegation and deferring the materialization of a value to another object. <nowiki>In this case another Jsr property or function that returns JsFunc<String> can be passed into the warn method. For example since foo method returns JsFunc<String> it can be passed into itself. </nowiki>


{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java JSR Usage Code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Generated Js Method call code (un-optimized)

|- style="vertical-align:top" style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">MyJsr.foo(MyJsr.foo("test"));</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">a.b.c.MyJsr.foo(a.b.c.MyJsr.foo("test")); 
// note that there are optimization techniques we use to shorten this. </source>




|}

== Functions with Optional Arguments in methods (Js authored only) ==
===== Optional arguments will produce overloaded apis in JSR.  =====
=== One required argument and one optional argument: ===

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JSR Java API

|- style="vertical-align:top"
|  style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
//>public void foo(Foo a, String? b) 
foo : function(a, b){}</source>
|  style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public JsFunc<Void> foo(FooJsr a, String b)

public JsFunc<Void> foo(</nowiki>IValueBinding<nowiki><? extends 
FooJsr> a, IValueBinding<nowiki><String> b)

public JsFunc<Void> foo(FooJsr a)

public JsFunc<Void> foo(</nowiki>IValueBinding<? extends FooJsr> a)

</source>

|}

=== Multiple Optional Arguments: ===

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JSR Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
//>public void foo(Foo a, String? b, String? c) 
foo2 : function(a, b){} </source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public JsFunc<Void> foo2(FooJsr a, String b, String c)

public JsFunc<Void> foo2(IValueBinding<? extends
 FooJsr> a, IValueBinding<String> b, IValueBinding<String> c)

public JsFunc<Void> foo2(FooJsr a, String b)

public JsFunc<Void> foo2(IValueBinding<? extends 
FooJsr> a, IValueBinding<String> b)

public JsFunc<Void> foo2(FooJsr a)

public JsFunc<Void> foo2(IValueBinding<? extends FooJsr> a)
</source>

|}

=== Incorrect Optional arguments ===
Optional arguments are only supported as the last arguments in the argument list. If the optional argument occurs before a required argument the jsr generation will assume that the optional argument is required. 


{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JSR Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"|<source lang="javascript">
//>public void foo(Foo? a, String b) 
foo : function(a, b){}
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">

public JsFunc<Void> foo(FooJsr a, String b)

public JsFunc<Void> foo(IValueBinding<? extends FooJsr> a, IValueBinding<String> b)

</source>


|}

== Supporting Variable arguments ==
=== Variable Argument only ===

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JSR Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
//>public void foo3(Foo ... s)
foo3 : function(s){}
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public JsFunc<Void> foo3(FooJsr... p0)

public JsFunc<Void> foo3(IValueBinding<? extends FooJsr>... p0)
</source>

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public String foo3(Foo … s)
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|}

=== Required argument and Variable argument  ===

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JSR Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
//>public void foo5(String z, Foo ... b) 
foo5 : function(z, b){

}
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public JsFunc<Void> foo5(String z, FooJsr... b)

public JsFunc<Void> foo5(IValueBinding<String> z, IValueBinding<? 
extends FooJsr>... b)
</source>

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;" |

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public String foo3(Foo … s) </source>
| style="border:1px solid #AAAAAA;padding: 0.2em;" |
|}

=== Variable Argument listed before required argument – not supported ===
VJET validation error will be produced and if error is ignored no method will be generated. In Java authored code java compiler will give you an error.


{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JSR Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
//>public void foo4(Foo ... s, String b) 
foo3 : function(s, b){}
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| // nothing produced

|}

== Overloaded Methods ==
JavaScript developers can declare overloaded methods but JavaScript can only have one function per name so the Js developer must handle the overloading in the function internally. The Java developer can author 2 independent methods rather than rely on one method. The Jsr Generation supports up to 15 overloaded signatures.

=== Simple overloading scenario ===

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JSR Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
//>public void foo4(String) 
//>public void foo4(int) 
foo4 : function(){}
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public JsFunc<Void> foo4(String a)

public JsFunc<Void> foo4(IValueBinding<String> a)

public JsFunc<Void> foo4(int a)

public JsFunc<Void> foo4(IValueBinding<Integer> a, org.eclipse.vjet.aggregator.jsref.d.D1... notUsed)
</source>

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
public void foo4(String a){}

public void foo4(int a){}

</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"|

|}
<nowiki>Note: the D1 class is for working around a problem with overloading and generics in Java. We use the D1 vararg to fake out the compiler. Since the generic is an erasure the compile get's confused between IValueBinding<Integer> vs IValueBinding<String>. </nowiki>

=== Hand coding a function reference ===
In the base JsObj there is an overloaded method called call where you can pass in the return type, method name, and arguments. If you look at the generated code you will see this simple internal call. 


{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Original Js code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JSR Hand coded Function reference

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
//> public String foo(String s);
foo:function(s){} 
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public JsFunc<String> foo(String s){

return call(String.class, "foo").with(s);

}
</source>

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"|<source lang="javascript">
 //> public String foo2();
foo2:function(){} 
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public JsFunc<String> foo2(){
    return call(String.class,"foo2");
}
</source>

|}
If a JavaScript developer doesn't correctly declare a method you can add a call method directly. This is not recommended practice it is similar to using reflection to call a method. It is possible to get a runtime error because there is no contract that the method will exist.

= Js Property References =

[[Image:Vjet_jsrreference_jsproperty_reference.png]]

== Js property reference getting value (JsProp) ==
You can get a reference to the value. On the server side you will not have access to the value 10. You will have access to the property reference which could be passed into another IValueBinding based API. If you need access to the value you must be writing your JavaScript definitions in Java or JavaScript. 



{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JSR Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
MyProp:10, //< public int; assume protos
</source>

 
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">public JsProp<Integer> MyProp();</source>

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">public int MyProp = 10;</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|}

== Js property reference setting value (JsPropSetter) ==
If the property is public and not final a property setter api is available which allows you to change the property reference value. There are 2 apis created for this property one for the main type and one for the IValueBinding similar to the function with one argument. Properties do not allow for different types; JSRs only provide one argument methods.



{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JSR Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"|<source lang="javascript">
MyProp:10, //< public int; assume protos
</source>
 
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public IJsPropSetter MyProp(int v) {
    return setProp("MyProp", v);
}

public IJsPropSetter MyProp(IValueBinding<Integer> v) {
    return setProp("MyProp", v);
}

</source>

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">public int MyProp = 10;</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|}

= JavaScript Object References =
[[Image:Vjet_jsrreference_javascript_object_reference.png‎]]


== Constructors ==
=== Default Constructor ===
Constructors are generated for concrete types: 

* Ctypes / classes, 
* Etypes / enum, 
* Otypes (authored in Js only)

Constructors are not created for 

* Itypes / Interfaces
* Mixins (authored in Js only)

By default, JSRs include a no-argument default constructor, unless the constructor is overloaded:



{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
// no constructs method
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">public SimpleJsr()</source>

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">// no java constructor</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 
|}

=== Overloaded Constructor ===
==== Js to Jsr ====

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"|<source lang="javascript">
 //>public constructs(String)
constructs : function(a){}</source>

| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public FooJsr(String a)

public FooJsr(IValueBinding<String> a)
</source>
|}

==== Java to Jsr ====

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java authored Js code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">public FooJ2J(String a){}</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public FooJsr(String a)

public FooJsr(IValueBinding<String> a)</nowiki>
</source>
|}

=== Default protected constructor  ===
There is a default protected constructor created that takes the JsObjectMeta, determines if an instance should be created, and passes the value of the arguments. 


== Registration of the Object Instance ==
TODO

== Resource Pattern Integration ==
Any non native type that has a source backing file will have a resource spec added during code generation. Any reference to this Jsr will automatically add its resources into the JsRuntimeCtx.

=== Js Native Types ===
=== Vjo Types ===
When there is a resource that is required to support the definition of the JavaScript type the Jsr must implement an ISpecBasedComponent. Js Objects implement an ISpecBasedComponent to allow the active needs to be translated to a resource spec which supports resource aggregation.


ResourceSpec that is generated for user defined types should include the following:

# VjoBootstrap for Vjo Types, 
# The type itself and 
# all active needs and 
# honorary needs. Honorary needs are from sections such as extends, satisfies, and mixin. 

Resource Specs should not include inactive needs in resource spec or implied types such as JavaScript Date or DOM types.


= Types to JSR =
== Class or CType to JSR ==

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
vjo.ctype('vjo.example.MyCType') //< public
.endType();</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public class MyCTypeJsr extends JsObj {…
</source>
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
package vjo.example;

public class MyCType {

}
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"|

|}

== Interface or IType to JSR ==
In this case the interface doesn't extend JsObj the interface is used to load the resources and provide access to the type reference.



{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
vjo.itype('vjo.example.MyIType') //< public
.protos({

})
.endType();</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public interface MyITypeJsr {
…

</source>
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
package vjo.example;
public interface MyIType {

}
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|}

== MType to JSR ==
We create a JSR for resource pattern only. The APIs are not added to this class. The methods and properties declared in the mixin are added directly into the Jsr class since at the time of Java 5 and 6. Java does not support native mixin or module support. 



{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
vjo.mtype('vjo.MyMType') //< public
.endType();</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public abstract class MyMTypeJsr {

…
}
</source>


|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">// not applicable no mixin concept in Java.
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|}

== Java enum or EType to JSR ==
ETypes in JSR do not use the Java Enum construct instead they use a Java Class so that the members can be referenced. We support a simple enum to a more complex enum. In all cases the name references are static final. While the enum names are referenced statically in a Jsr there is actually an instance created during Js runtime for each name. We borrow the small talk static instance concept here. 

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
vjo.etype('vjo.MyEType') //< public
.values(
"A,B"
)
.endType();</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public final class MyETypeJsr extends JsEnum {
…

public static final JsProp<MyETypeJsr> A = 
              new JsProp<MyETypeJsr>(<S.getStaticAnchor(), "A");

public static final JsProp<MyETypeJsr> B = 
              new JsProp<MyETypeJsr>(S.getStaticAnchor(), "B");
…

}
</source>

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
package vjo;

public enum MyEType {
A,B
}

</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|}

== OType (JS only) ==
Object literal types provide JSR apis for functions and object literals without requiring class hierarchy. These APIs are used to ensure function signature safety and property safety rather than type safety since the function and object can live on their own in a JavaScript runtime.

=== Object Literal in Defs ===

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
vjo.otype('example.A')
.defs({
foo:{
a:10, //<int
b:null//<Date
},

foo2:{
a:10, //<int?
b:null//<Date?
}

})
.endType();
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public abstract class AJsr {

…

    public static class fooJsr extends JsObjectLiteral { 

        public static fooJsr obj(int a, Date b)
        public static fooJsr obj(IValueBinding<Integer> a, IValueBinding<? extends Date> b)
        public IValueBinding<Integer> getA() 
        public IValueBinding<? extends Date> getB()
    }

…
}
</source>

|}

=== Object Literal with optional properties ===
Optional properties create a similar pattern to the optional arguments in a method. In this case there are 5 methods created one for zero values, and then the arguments go in order of entry in the object literal with int a first, then b Date. The Jsr generator bases the order on order of entry and doesn't create additional overloaded methods for reverse order.


{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
vjo.otype('vjo.MyOType') //< public
.defs({
foo:{
a:10, //<int?
b:null//<Date?
}

})
.endType();</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public abstract class MyOTypeJsr {
…

    public static class fooJsr extends JsObjectLiteral { 

        public static fooJsr obj(int a, Date b) 

        public static fooJsr obj(IValueBinding<Integer> a, IValueBinding<? extends Date> b) 

        public static fooJsr obj()

        public static fooJsr obj(int a)

        public static fooJsr obj(IValueBinding<Integer> a)

        public IValueBinding<Integer> getA()

        public IValueBinding<? extends Date> getB() 

        …

    }

</source>
|}

=== Defining a Function Definition ===

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
vjo.otype('vjo.MyOType') //< public
.defs({
//>public MyOType.foo doIt() 
doIt : function(){

}

})
.endType();</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public abstract class MyOTypeJsr {
    …

    public static class doItJsr extends JsFuncRef<MyOTypeJsr.fooJsr> { 

        …

        // advanced API

        public doItJsr(JsObjData obj, String funcName)

        public doItJsr(JsObj obj, String funcName)


    }
    …

}

</source>

|}

==== Using Function Defs in CType (Simple) ====
CType definition:

<source lang="javascript">
vjo.ctype('org.eclipse.vjet.jsr.runtime.tests.otype.B') //< public
//>needs(org.eclipse.vjet.jsr.runtime.tests.otype.A)
.props({
    //>public void foo(A.foo) 
    foo : function(a){

    },

    //>public void foo(A.foo2) 
    foo2 : function(a){

    }
})
.endType();
</source>
Passing a typed object literal to a static function:

<source lang="java">
BJsr.foo(AJsr.fooJsr.obj(1, new Date()))
</source>

Resulting JS code:
<source lang="javascript">
org.eclipse.vjet.jsr.runtime.tests.otype.B.foo({a:1,b:new Date(1274728865945)});
</source>

Passing a typed object literal with optional arguments to a static function:

<source lang="java">
BJsr.foo2(AJsr.foo2Jsr.obj(1)
BJsr.foo2(AJsr.foo2Jsr.obj(1, new Date()))
</source>

Resulting JS code:
<source lang="javascript">
org.eclipse.vjet.jsr.runtime.tests.otype.B.foo2({a:1});
org.eclipse.vjet.jsr.runtime.tests.otype.B.foo2({a:1,b:new Date(1274728866195)});
</source>

==== Using Function Defs (Advanced) ====
If you want to pass a function reference into another function reference you can use the utility methods that are added. This is advanced because you must watch your execution scope for passing any methods on an instance. Jsrs do not automatically hitch the methods to the instance object. Also there is no type safety with this advanced mode so if the API changes or the method is removed you will not find out until runtime. This api is primarily for library developers or library developers who are adapting existing JavaScript object literals from the internet.

Step 1 defines the JS code:

OType: X – defines the function reference X.foo
<source lang="javascript">
vjo.otype('org.eclipse.vjet.jsr.runtime.tests.otype.X') //< public
.defs({
    //>public void foo(String x)
    foo:vjo.NEEDS_IMPL
})
.endType();
</source>

CType 1 : Y – defines a method that passes the function reference defined in X
<source lang="javascript">
vjo.ctype('org.eclipse.vjet.jsr.runtime.tests.otype.Y') //< public
//> needs(org.eclipse.vjet.jsr.runtime.tests.otype.X)
.protos({
    //>public void doIt(X.foo) 
    doIt : function(f){
        assertTrue(f != null);
        f("test");
    }
})
.endType();
</source>

CType 2 : Z – defines 2 methods that implement the api X.foo
<source lang="javascript">
vjo.ctype('org.eclipse.vjet.jsr.runtime.tests.otype.Z') //< public
//> needs(org.eclipse.vjet.jsr.runtime.tests.otype.X)
.props({
    //> X.foo
    method:function(x){
        //vjo.sysout.println(x);
        assertTrue(x == "test");
    }
})
.protos({
    //> X.foo
    bar : function(x){
        //vjo.sysout.println(x);
        assertTrue(x == "test");
    }
})
.endType();
</source>

Step 2 Generate the Jsr


Step 3 Using the Jsr


Pass an instance function into a static method:
<source lang="java">
XJsr.fooJsr foo = new XJsr.fooJsr(new ZJsr(), "bar");
new YJsr().doIt(foo);
</source>

Resulting Js 
<source lang="javascript">
var _r = vjo.Registry;
r.put('0',new org.eclipse.vjet.jsr.runtime.tests.otype.Z());
vjo.Registry._1.doIt(vjo.Registry._0.bar);
</source>

Pass a static function into a static method

<source lang="java">
XJsr.fooJsr foo2 = new XJsr.fooJsr(new JsObjData("org.eclipse.vjet.jsr.runtime.tests.otype.Z", ZJsr.class, "Z"), "method");
new YJsr().doIt(foo2)
</source>
Resulting JS code:
<source lang="javascript">
var _r = vjo.Registry;
function $o2(){return new org.eclipse.vjet.jsr.runtime.tests.otype.Y();};
_r.put('2',$o2());
vjo.Registry._2.doIt(org.eclipse.vjet.jsr.runtime.tests.otype.Z.method);
</source>

== Nested Types ==
=== Static Inner Type ===

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
vjo.ctype('vjo.NestedTypeEx') //< public
.props({
    Foo:vjo.ctype()
    .endType()
})
.endType();
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"|<source lang="java">
 public class NestedTypeExJsr extends JsObj {
    …
    public NestedTypeExJsr()
        …
    public static class FooJsr extends JsObj {
        public FooJsr()
        public static JsTypeRef<FooJsr> prototype = 
                                new JsTypeRef<FooJsr>(S);
    }
    public static JsTypeRef<NestedTypeExJsr> prototype = 
                                new JsTypeRef<NestedTypeExJsr>(S);

}
</source>
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public class NestedTypeEx {
    public static class Foo{}
}
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 
|}

= Function References and Type References =
The following diagram shows the relationships for the Java Script Reference model for JavaScript Function references, JavaScript type references (added by VJO JS), and JavaScript properties. 


[[Image:Vjet_jsrreference_function_reference.png]]


== Function References (JsFuncRef) ==
There are 2 ways to have a reference to a function one way is to use the JavaScript Function type in your API but this doesn't specify return type or arguments that are accepted. 

=== Function Ref using Function API ===
In the Java authored JS code you will notice the type is JFunction not Function. 



{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JSR Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">vjo.otype(…)
.defs({
    //> public int doIt(String x)
    doIt : function(x){}
}</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">public static class doItJsr extends JsFuncRef<Integer> { 

public doItJsr(JsObjData obj, String funcName)

public doItJsr(JsObj obj, String funcName)

}
</source>
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">// not supported </source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|}
TODO – I tried declaring a function reference but this is an otype only construct. We can pass Function objects in Java but this is not function reference.

=== Using the JsFuncRef in a Class ===

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JSR Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
//> public OType.doIt foo(OType.doIt f);
foo:function(f){}</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">public JsFunc<? extends MyOTypeJsr.doItJsr> foo(){}</source>

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">public MyOType.doIt foo() 
// This is using the native proxy 
//MyOType not the MyOTypeJsr
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|}

== Type References (JsTypeRef) ==
=== API for Type References ===

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JSR Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">//> public Type::X foo(Type::X f);</source>

foo:function(f){}
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public JsFunc<? extends JsTypeRef<FooJsr>> foo5(JsTypeRef<FooJsr> f){…}


public JsFunc<? extends JsTypeRef<FooJsr>> 
    foo5(IValueBinding<? extends JsTypeRef<FooJsr>> f){…}
</source>
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"|<source lang="java"> // currently not supported</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|}
TODO – fix the Java to Jsr for type references.

=== Access a Type Reference for any Type ===
A type reference property is added for all types except for:

# OType
# Mixin 

For nested types we support type references for 
# Static nested types.
# Nested type inside an interface.

<source lang="javascript">
public static JsTypeRef<NestedTypeExJsr> prototype = new JsTypeRef<NestedTypeExJsr>(S);
</source>

= Imports and Jsr =
* Imports are translated into a nested class resource spec that can be used in a view spec. 
* Inactive needs will not include the resource in the Jsr.
* Implicit types such as Date or HTMLSelectElement do not get included in the Jsr resource spec.

TODO example of needs/extends to resource spec inside outer type


= Java to JS Converters =
For any Java types used in Jsr APIs there is a converter registered. That will convert the Java object to a js object during runtime. There are default converters for the following Java types and literals:


== BooleanJsConverter ==
This converter converts Boolean literal from Java Boolean literal to Js Boolean literal


== BooleanWrapperConverter ==
This converter takes a java.lang.Boolean object and converts it to a JS Boolean object. In most cases this should not be used since developers mostly expect a Boolean literal not a 


== DateJsConverter ==
== StringArrayJsConverter ==
== StringJsConverter ==
== EnumJsConverter ==
== DsfMessageJsConverter ==
== DefaultJava2JsConverter ==
== JsContentGenJsConverter ==
== JsObjRefConverter ==
== JsVariableBindingConverter ==
== JsonObjectConverter ==
== VjoObjectConverter ==
= Js to Jsr Mappings =
In most cases JavaScript types will map XJsr types. In some cases for types that are similar to JavaScript native types and literals we use the Java data type rather than a Jsr. This is to provide Java developer a simple way to pass primitive information such as String literal or boolean literals without creating a Jsr. 

== Js Native Type mapping ==

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JavaScript Type used in JavaScript Language
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Notes

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Arguments
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Not supported
| style="border:1px solid #AAAAAA;padding: 0.2em;"| This type should not be used in API. Type is only available in function scope.

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Array
| style="border:1px solid #AAAAAA;padding: 0.2em;"| ArrayJsr.java
| style="border:1px solid #AAAAAA;padding: 0.2em;"| should not be abstract

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Boolean
| style="border:1px solid #AAAAAA;padding: 0.2em;"| java.lang.Boolean
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Converter is registered. Converts to js Boolean. Note you should not use this in your Js code instead use boolean (lower case b) and you will receive the literal.

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Date
| style="border:1px solid #AAAAAA;padding: 0.2em;"| java.util.Date
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Converter is registered. Converts to a Js date.

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Enumerator
| style="border:1px solid #AAAAAA;padding: 0.2em;"| EnumeratorJsr.java
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Maps to Jsr

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Error
| style="border:1px solid #AAAAAA;padding: 0.2em;"| ErrorJsr.java
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Maps to Jsr

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| EvalError
| style="border:1px solid #AAAAAA;padding: 0.2em;"| EvalErrorJsr.java
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Maps to Jsr

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Function
| style="border:1px solid #AAAAAA;padding: 0.2em;"| FunctionJsr.java
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Maps to Jsr

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Global
| style="border:1px solid #AAAAAA;padding: 0.2em;"| GlobalJsr.java
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Should not be used since this is implied type for global scope.

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Math
| style="border:1px solid #AAAAAA;padding: 0.2em;"| MathJsr.java
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Maps to Jsr

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Number
| style="border:1px solid #AAAAAA;padding: 0.2em;"| double
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Converter is registered. 

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Object
| style="border:1px solid #AAAAAA;padding: 0.2em;"| java.lang.Object
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Maps to vjo.ObjectJsr

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| ObjLiteral
| style="border:1px solid #AAAAAA;padding: 0.2em;"| java.lang.Object
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Should not be used in API. Use Object. We have mapping to Object for backwards compatibility

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| RangeError
| style="border:1px solid #AAAAAA;padding: 0.2em;"| RangeErrorJsr.java
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Maps to Jsr

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| ReferenceError
| style="border:1px solid #AAAAAA;padding: 0.2em;"| ReferenceErrorJsr.java
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Maps to Jsr

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| RegExp
| style="border:1px solid #AAAAAA;padding: 0.2em;"| RegExpJsr.java
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Maps to Jsr

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| String
| style="border:1px solid #AAAAAA;padding: 0.2em;"| java.lang.String
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Converter takes java string and converts to Js string literal

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| SyntaxError
| style="border:1px solid #AAAAAA;padding: 0.2em;"| SyntaxErrorJsr.java
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Maps to Jsr

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| TypeError
| style="border:1px solid #AAAAAA;padding: 0.2em;"| TypeErrorJsr.java
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Maps to Jsr

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| URIError
| style="border:1px solid #AAAAAA;padding: 0.2em;"| URIErrorJsr.java
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Maps to Jsr

|}

== Js / Java Literals to Jsr mappings ==

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java Literal used in JavaScript language
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Notes

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| float
| style="border:1px solid #AAAAAA;padding: 0.2em;"| float
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Not supported literal in Js but we add this literal to help declare precision. At Js runtime precision may be higher then Float.MAX_VALUE.

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| double
| style="border:1px solid #AAAAAA;padding: 0.2em;"| double
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Not supported literal in Js but we add this literal to help declare precision. At Js runtime precision may be higher then Double.MAX_VALUE.

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| byte
| style="border:1px solid #AAAAAA;padding: 0.2em;"| byte
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Not supported literal in Js but we add this literal to help declare precision. At Js runtime precision may be higher then Byte.MAX_VALUE.

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| void
| style="border:1px solid #AAAAAA;padding: 0.2em;"| void
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| char
| style="border:1px solid #AAAAAA;padding: 0.2em;"| char
| style="border:1px solid #AAAAAA;padding: 0.2em;"| should extend String

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| boolean
| style="border:1px solid #AAAAAA;padding: 0.2em;"| boolean
| style="border:1px solid #AAAAAA;padding: 0.2em;"| boolean represents a boolean literal and should never be Boolean object.

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| long
| style="border:1px solid #AAAAAA;padding: 0.2em;"| long
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| short
| style="border:1px solid #AAAAAA;padding: 0.2em;"| short
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 

|}

== VJO Type mappings in Jsr ==

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Vjo type
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Notes

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| vjo.Object
| style="border:1px solid #AAAAAA;padding: 0.2em;"| vjo.ObjectJsr
| style="border:1px solid #AAAAAA;padding: 0.2em;"| JsObj is currently base for all native objects and vjo objects but really user defined objects using VJO should extend from vjo.ObjectJsr not JsObj. 

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| vjo.Enum
| style="border:1px solid #AAAAAA;padding: 0.2em;"| vjo.EnumJsr
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| vjo.Class
| style="border:1px solid #AAAAAA;padding: 0.2em;"| vjo.ClassJsr
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Converter is registered

|}

== DOM Type mappings in Jsr ==
DOM types are used for the type name only. 



{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! colspan="2"  style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Browser Data Types

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOM JS Built-in Type
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Corresponding Jsr

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| ActiveXObject
| style="border:1px solid #AAAAAA;padding: 0.2em;"| ActiveXObjectJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Attr
| style="border:1px solid #AAAAAA;padding: 0.2em;"| AttrJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| CDATASection
| style="border:1px solid #AAAAAA;padding: 0.2em;"| CDATASectionJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| CharacterData
| style="border:1px solid #AAAAAA;padding: 0.2em;"| CharacterDataJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Comment
| style="border:1px solid #AAAAAA;padding: 0.2em;"| CommentJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DocumentEvent
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DocumentEventJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DocumentFragment
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DocumentFragmentJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Document
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DocumentJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DocumentType
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DocumentTypeJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMConfiguration
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMConfigurationJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMErrorHandler
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMErrorHandlerJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMError
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMErrorJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMException
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMExceptionJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMImplementation
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMImplementationJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMImplementationList
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMImplementationListJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMImplementationSource
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMImplementationSourceJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMLocator
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMLocatorJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMStringList
| style="border:1px solid #AAAAAA;padding: 0.2em;"| DOMStringListJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Element
| style="border:1px solid #AAAAAA;padding: 0.2em;"| ElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| ElementView
| style="border:1px solid #AAAAAA;padding: 0.2em;"| ElementViewJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Entity
| style="border:1px solid #AAAAAA;padding: 0.2em;"| EntityJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| EntityReference
| style="border:1px solid #AAAAAA;padding: 0.2em;"| EntityReferenceJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| EventException
| style="border:1px solid #AAAAAA;padding: 0.2em;"| EventExceptionJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Event
| style="border:1px solid #AAAAAA;padding: 0.2em;"| EventJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| EventListener
| style="border:1px solid #AAAAAA;padding: 0.2em;"| EventListenerJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| EventTarget
| style="border:1px solid #AAAAAA;padding: 0.2em;"| EventTargetJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| External
| style="border:1px solid #AAAAAA;padding: 0.2em;"| ExternalJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Frames
| style="border:1px solid #AAAAAA;padding: 0.2em;"| FramesJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| History
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HistoryJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLAbbrElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLAbbrElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLAcronymElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLAcronymElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLAddressElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLAddressElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLAnchorElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLAnchorElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLAppletElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLAppletElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLAreaElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLAreaElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLArticleElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLArticleElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLAsideElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLAsideElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLAudioElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLAudioElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBaseElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBaseElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBaseFontElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBaseFontElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBbElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBbElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBDOElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBDOElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBgsoundElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBgsoundElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBigElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBigElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBlockquoteElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBlockquoteElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBodyElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBodyElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBRElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLBRElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLButtonElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLButtonElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLCanvasElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLCanvasElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLCenterElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLCenterElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLCiteElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLCiteElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLCodeElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLCodeElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLColgroupElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLColgroupElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLCollection
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLCollectionJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLCommandElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLCommandElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDataGridElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDataGridElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDataListElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDataListElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDdElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDdElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDelElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDelElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDetailsElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDetailsElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDfnElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDfnElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDialogElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDialogElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDirectoryElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDirectoryElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDivElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDivElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDListElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDListElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDocument
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDocumentJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDOMImplementation
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDOMImplementationJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDtElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLDtElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLElementStyle
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLElementStyleJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLEmbedElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLEmbedElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLEmElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLEmElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLFieldSetElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLFieldSetElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLFigureElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLFigureElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLFontElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLFontElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLFooterElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLFooterElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLFormElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLFormElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLFrameElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLFrameElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLFrameSetElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLFrameSetElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLHeadElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLHeadElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLHeaderElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLHeaderElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLHeadingElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLHeadingElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLHGroupElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLHGroupElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLHRElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLHRElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLHtmlElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLHtmlElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLIElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLIElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLIFrameElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLIFrameElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLImageElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLImageElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLInputElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLInputElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLInsElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLInsElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLIsIndexElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLIsIndexElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLKbdElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLKbdElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLKeyGenElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLKeyGenElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLLabelElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLLabelElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLLegendElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLLegendElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLLIElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLLIElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLLinkElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLLinkElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLMapElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLMapElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLMarkElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLMarkElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLMarqueeElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLMarqueeElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLMenuElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLMenuElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLMetaElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLMetaElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLMeterElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLMeterElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLModElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLModElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLNavElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLNavElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLNoBrElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLNoBrElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLNoFramesElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLNoFramesElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLNoScriptElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLNoScriptElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLObjectElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLObjectElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLOListElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLOListElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLOptGroupElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLOptGroupElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLOptionElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLOptionElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLOptionsCollection
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLOptionsCollectionJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLOutputElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLOutputElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLParagraphElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLParagraphElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLParamElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLParamElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLPreElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLPreElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLProgressElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLProgressElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLQuoteElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLQuoteElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLRpElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLRpElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLRtElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLRtElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLRubyElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLRubyElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSampElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSampElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLScriptElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLScriptElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSectionElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSectionElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSelectElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSelectElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSmallElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSmallElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSourceElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSourceElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSpanElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSpanElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLStrikeElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLStrikeElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLStrongElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLStrongElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLStyleElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLStyleElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSubElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSubElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSupElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLSupElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTableCaptionElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTableCaptionElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTableCellElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTableCellElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTableColElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTableColElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTableElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTableElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTableRowElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTableRowElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTableSectionElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTableSectionElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTextAreaElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTextAreaElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLThElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLThElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTimeElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTimeElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTitleElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTitleElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTtElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLTtElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLUElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLUElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLUListElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLUListElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLUnknownElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLUnknownElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLVarElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLVarElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLVideoElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLVideoElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLWbrElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLWbrElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLXmlElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLXmlElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLXmpElement
| style="border:1px solid #AAAAAA;padding: 0.2em;"| HTMLXmpElementJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Image
| style="border:1px solid #AAAAAA;padding: 0.2em;"| ImageJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| KeyboardEvent
| style="border:1px solid #AAAAAA;padding: 0.2em;"| KeyboardEventJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Location
| style="border:1px solid #AAAAAA;padding: 0.2em;"| LocationJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| MimeType
| style="border:1px solid #AAAAAA;padding: 0.2em;"| MimeTypeJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| MouseEvent
| style="border:1px solid #AAAAAA;padding: 0.2em;"| MouseEventJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| NamedNodeMap
| style="border:1px solid #AAAAAA;padding: 0.2em;"| NamedNodeMapJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| NameList
| style="border:1px solid #AAAAAA;padding: 0.2em;"| NameListJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Navigator
| style="border:1px solid #AAAAAA;padding: 0.2em;"| NavigatorJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Node
| style="border:1px solid #AAAAAA;padding: 0.2em;"| NodeJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| NodeList
| style="border:1px solid #AAAAAA;padding: 0.2em;"| NodeListJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Notation
| style="border:1px solid #AAAAAA;padding: 0.2em;"| NotationJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Opera
| style="border:1px solid #AAAAAA;padding: 0.2em;"| OperaJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Option
| style="border:1px solid #AAAAAA;padding: 0.2em;"| OptionJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| PluginArray
| style="border:1px solid #AAAAAA;padding: 0.2em;"| PluginArrayJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Plugin
| style="border:1px solid #AAAAAA;padding: 0.2em;"| PluginJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| ProcessingInstruction
| style="border:1px solid #AAAAAA;padding: 0.2em;"| ProcessingInstructionJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Screen
| style="border:1px solid #AAAAAA;padding: 0.2em;"| ScreenJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Selection
| style="border:1px solid #AAAAAA;padding: 0.2em;"| SelectionJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| TextEvent
| style="border:1px solid #AAAAAA;padding: 0.2em;"| TextEventJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Text
| style="border:1px solid #AAAAAA;padding: 0.2em;"| TextJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| TextRange
| style="border:1px solid #AAAAAA;padding: 0.2em;"| TextRangeJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| TextRectangle
| style="border:1px solid #AAAAAA;padding: 0.2em;"| TextRectangleJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| TextRectangleList
| style="border:1px solid #AAAAAA;padding: 0.2em;"| TextRectangleListJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| TypeInfo
| style="border:1px solid #AAAAAA;padding: 0.2em;"| TypeInfoJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| UIEvent
| style="border:1px solid #AAAAAA;padding: 0.2em;"| UIEventJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| UserDataHandler
| style="border:1px solid #AAAAAA;padding: 0.2em;"| UserDataHandlerJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Window
| style="border:1px solid #AAAAAA;padding: 0.2em;"| WindowJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| XMLHttpRequest
| style="border:1px solid #AAAAAA;padding: 0.2em;"| XMLHttpRequestJsr.java

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 

|}

= JSR Built-in Convenience Extensions =
== Events Jsr Generation ==
=== Events Using Java Enum name (Js -> Jsr only) - deprecated ===
This way causes issues with code completion, searching and validation. We do not recommend using this and we need to clean this up. 


If the JsHandlerObjectEnum is the first argument then there will be 2 apis generated one with the object enum and one without. The native event object will be passed in by the EventDispatcher automatically. Since the browser passes the native event. 



{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
//> public boolean doIt(org.eclipse.vjet.resource.html.
//event.handler.JsHandlerObjectEnum);
 doIt : function (currentDsfMsg) {
     return true;
 }</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"|<source lang="java"> public JsFunc<Boolean> doIt(){

}


public JsFunc<Boolean> doIt(org.eclipse.vjet.resource.html.
event.handler.JsHandlerObjectEnum currentDsfMsg){

}</source>

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">// not supported</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|}

=== Events Using Native Event (not recommended due to portability issues) ===
In this case the Event object in Js is using the native event object. There are 4 apis generated. 

# One with the EventJsr to allow for passing of the EventJsr object from other method that returns the event object.
# One with the EventJsr IValueBinding. 
# One for backward compatibility with deprecated mode using JsHandlerObjectEnum
# One without any arguments to allow for the event object to be passed into by the event dispatcher automatically. No user defined code required to pass the event object.


{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
//> public boolean doIt(Event);
doIt2 : function (evt) {
    evt.cancelBubble = true;
    return false;
}
</source>

| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public JsFunc<Boolean> doIt2(EventJsr evt)

public JsFunc<Boolean> doIt2(IValueBinding<? extends EventJsr> evt)

public JsFunc<Boolean> doIt2(org.eclipse.vjet.resource.html
.event.handler.JsHandlerObjectEnum evt)

public JsFunc<Boolean> doIt2(){
    return call(Boolean.class, "doIt2").with(org.eclipse.vjet.resource.html.
                          event.handler.JsHandlerObjectEnum.nativeEvent);
}
</source>


|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public boolean doIt2(Event evt){
    evt.setCancelBubble(true);
    return false;
}
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 
|}
Note: Event.setCancelBubble needs to be added to make this work

=== Events using vjo.dsf.Event (preferred solution) ===
This is the preferred solution because the native event api is not standard across browsers where this object deals with these differences and you get consistent code completion, validation, and searching in VJET IDE.


There are 4 apis generated for this case. 


# One with the EventJsr to allow for passing of the EventJsr object from other method that returns the event object.
# One with the EventJsr IValueBinding to allow EventJsr to be passed from one reference to another.
# One for backward compatibility with deprecated mode using JsHandlerObjectEnum
# One without any arguments to allow for the event object to be passed into by the event dispatcher automatically. No user defined code required to pass the event object.


{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API

|- style="vertical-align:top" style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
//> needs(vjo.dsf.Event)
//> public boolean doIt(Event);
doIt2 : function (evt) {
    return true;
}</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
//note EventJsr is referring to 
//vjo.dsf.EventJsr not the native EventJsr. 
public JsFunc<Boolean> doIt2(EventJsr evt)

public JsFunc<Boolean> doIt2(IValueBinding<? 
extends EventJsr> evt)

public JsFunc<Boolean> doIt2(org.eclipse.vjet.resource.html.
event.handler.JsHandlerObjectEnum evt)

</source>
|- style="vertical-align:top" style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|

|- style="vertical-align:top" style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
// Event in this case is referring 
//to the native js proxy vjo.dsf.Event
public boolean doIt2(Event evt){
    evt.setCancelBubble(true); 
    return false;

}
</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 
|}

== Ajax Service Engine Message Generation ==
=== Using the JsHandlerObjEnum - Deprecated ===
Similar to the Event using the same type we do not want to support this going forward. This example has multiple issues:

# Doesn't declare needs correctly which causes an implicit dependency on vjo.dsf.Message 
# It is very verbose and difficult to read.
# Code completion, searching, validation doesn't work correctly. Causing workarounds in VJET JS. 

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API

|- style="vertical-align:top" style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"|  <source lang="javascript">//> public org.eclipse.vjet.resource.html.event.handler.JsHandlerObjectEnum
doIt(org.eclipse.vjet.resource.html.event.handler.JsHandlerObjectEnum);

doIt : function (message) {
    return message;
}
</source>
 
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public JsFunc<? extends org.eclipse.vjet.resource.
html.event.handler.JsHandlerObjectEnum> 
doIt(org.eclipse.vjet.resource.html.event.
handler.JsHandlerObjectEnum message)
</source>
|- style="vertical-align:top" style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| // not supported
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|}

=== Using vjo.dsf.Message in API – preferred solution ===

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API

|- style="vertical-align:top" style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">
//>needs(vjo.dsf.Message)
//> public Message doIt(Message)
doIt : function (message) {
    return message;
}</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">
public JsFunc<? extends MessageJsr> doIt(MessageJsr message)

public JsFunc<? extends MessageJsr> doIt(IValueBinding<? extends MessageJsr> message)

public JsFunc<? extends MessageJsr> doIt(){
    return call(MessageJsr.class, "doIt").with
           (org.eclipse.vjet.resource.html.event.handler.JsHandlerObjectEnum.message);
}
</source>
|- style="vertical-align:top" style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">public void doIt(Message message){}</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"|

|}
TODO – Currently there is a problem with 3<sup>rd</sup> API not being generated.

TODO – Add more tests here

Note – On the server side there is org.eclipse.vjet.service.Message but this class should not be passed into Jsr.

== Types supporting Java type and Java Jsr Type API ==
TODO – fix this on Zam currently broken after first iteration of Jsr fixes

ArrayList and HashMap are currently supported as types that support a native Java api as well as the ArrayListJsr and HashMapJsr respectively. 

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JS code
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Java API

|- style="vertical-align:top" style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"|<source lang="javascript">
//>public constructs(HashMap)
constructs : function(a){}</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="java">public FooJsr(HashMap a)

public FooJsr(HashMapJsr a)

public FooJsr(IValueBinding<HashMap> a)

public FooJsr(IValueBinding<HashMapJsr> a)
</source>
|- style="vertical-align:top" style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Java authored Js code
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|- style="vertical-align:top" style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| <source lang="javascript">public FooJ2J(HashMap a){}</source>
| style="border:1px solid #AAAAAA;padding: 0.2em;"|
|}
In order to support this HashMap api must have a converter registered or the default converter will take the HashMap and convert it to a JSON object.

A user can also define a Java type that supports this using the

= Using JSR =
== JSRs are Independent of the Source Language ==
Recall that there are no differences in JSR references whether they are generated from JavaScript or Java code''. ''


The following example creates two Buttons, and adds a Click event to each button. One button associates the Click event to a JSR generated from Java (JavaCommunicatorJsr); the other button associates the Click event with a JSR generated from JavaScript (CommunicatorJsr). 
<source lang="java">

public class CommExample {

    public DDiv div() {
        // CommunicatorJsr source of truth is .js (JavaScript)
        DButton b1 = getButton("Warn me").add(EventType.''CLICK'', CommunicatorJsr.''warn''("Will Robinson")) ;
        // JavaCommunicatorJsr source of truth is .java (Java)
        DButton b2 = getButton("Warn me again").add(EventType.''CLICK'', JavaCommunicatorJsr.''warn''("The Wolf")) ; 
        DDiv div = new DDiv().add(b1).addBr().add(b2) ;
        return div ;
    }

    private DButton getButton(String label) {
       return new DButton(label).setHtmlType(DButton.''TYPE_BUTTON'') ;
    }
}
</source>

= APPENDIX: VJET Sections and JSR  =

{| style="background-color:#F9F9F9;border:1px solid #AAAAAA;border-collapse:collapse;color:black; margin:1em 0;"
|- style="vertical-align:top"
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| VJET Section
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| JSR 
! style="background-color:#F2F2F2;text-align:center;border:1px solid #AAAAAA;padding:0.2em;"| Notes

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| .needs
| style="border:1px solid #AAAAAA;padding: 0.2em;"| import
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| .values
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Creates a JsProp member for each element

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| .inherits
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Extends, import
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| .satisfies
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Implements,import
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| .mixin
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 
| style="border:1px solid #AAAAAA;padding: 0.2em;"| mtype members are incorporated with the type that includes the mixin

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| .props
| style="border:1px solid #AAAAAA;padding: 0.2em;"| static
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Members defined in the props section become static members

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| .protos
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Instance members only public members
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Members defined in the protos section become instance members


|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| .constructs
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Creates JSR constructor(s) if the constructor is overloaded; otherwise a no-argument, default constructor is created. 

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| .options
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Not included
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| .inits
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Not included
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| .globals
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Not included
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| .expects
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Not included
| style="border:1px solid #AAAAAA;padding: 0.2em;"| 

|- style="vertical-align:top"
| style="border:1px solid #AAAAAA;padding: 0.2em;"| .defs
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Nested classes
| style="border:1px solid #AAAAAA;padding: 0.2em;"| Nested classes representing functions and object literals

|}

= Review #1 5/20/10 =
== Additions Requested ==
* MType isMixin api to be added
* Undefined type / Jsr do we want to add this?
* Utility to convert org.eclipse.vjet.service.Message to MessageJsr 
* Change spec so that all Jsrs that implement VJO extend vjo.ObjectJsr
* Do we want to add function references to Spec for each static method? Preferred we have some Jsr Utilities for this.
* After all definitions show usage example.
* Mention something about property setting last one in wins. 
* Look at having a way to hint that certain types need convenience APIs without changing code generator. 
* Add example of using the annotation @Package and getting a Jsr with a resource spec

* Add Note about Property gets reference not actual value.
* Add Hand coding show the call without the method name repeated but state there is a performance enhancement by using overloaded method.
* Flow diagram that shows Jsr usage during page construction and how the code is invoked on a browser.

== Changes Requested ==
* 13.1 – Number usage in JS should be double in Jsr – added to spec – code gen change needed
* Make VJET validation requirement for Jsr generation currently they are separate today.
* 6.4.2 missing required argument 
* Inner types – show differences between static, instance, interface, .. Usage of type references.
* EType mention that EType must be final
* Etype from reference perspective are static but internally the values are static instances. A small talk concept.
* OTYPE - Show usage of the JsFuncRef constructors show simple and complex examples.
* OTYPE show object literal first before function references. Since I am using object literal in function reference.
* 10.1.2 examples are wrong
* 10.2.1 Need to determine how to do a type reference in Java to Jsr or what is should be?
* Section 12 more examples of converters
* 13.1 – java.lang.Number should be vjo.java.lang.Number not js Number (do we want different mapping for Java to Jsr types.
* 13.2 – remove the extends Number comment
* Show function and type references before types
* Function references… Text is covering Function instance
* Remove section 11 already covered in resource spec info
* Remove the usage section and integrate into after each definition. Write test cases at the same time.
* Move the convenience extensions into another document. It is not part of the core Jsr. 

== Verification Required ==
* Does VJET validator error on foo(Foo? A, String ) – need to verify
* Hand coding examples - Reflection different between Java Sun vs IBM?? Need to confirm this.
* Is there a resource pattern document to refer to?

= Known Issues =
* Native types are names only and do not have their api's exposed. 
* Js developers who declare Boolean are not expecting a Boolean object in most cases but expecting the boolean literal or boolean. 
* Serialization feature was removed due to no documentation / support/ tests. More information is needed.
* Globals can not be referenced in Jsr
* Java 2 Jsr – type references do not generate correctly / same as Vjo to Jsr right now.
* JsObj is currently base for all native objects and vjo objects but really user defined objects using VJO should extend from vjo.ObjectJsr not JsObj. 
* VJET validation fixes were being added that used overloading for event and message. 
* When doing right click js to java generation I noticed that Event apis are missing zero argument signature. 14.5.1
* VjoObjectConverter is not added by default due to issues with JS code using HashMap, ArrayList but not using the VJO JDK classes. This issue needs to be addressed. There are currently validation errors on this code. 
* When auditing tests I found that Java to Js was not correctly using interfaces but using concrete classes which do not translate correctly to JSR or VJO. Biggest offender was using DapCtx to get the window or document rather than using VJ type.
* Native types should not have active or inactive needs in some cases I found that VJO code and Jsr was pulling 

Type Omissions

Jsr should not include imports for anything inside java.lang

Inactive Needs 

Should Object be in inactive needs?

.needs('Object','') active needs for Object?

.needs('Object','org.eclipse.vjet.jsnative.global.Object') – strange


* Also show an example of adding vjo.ctype to get a vjo type. Which one is preferred and do they both work in runtime?
* Issue with nested object literals in otypes Jsr do not generate correctly. Added note into language spec this is not supported.
* OType on RA and previous did not correctly serialize object literals that used any of the java types such as Date. On ZAM fixed this to use the Js converters to prevent a JSON deserialize api call 

* JFunction had utility method def which I moved to JFunctionX since we want JFunction to map to JFunction. DOM JSR apis were using Native proxies not Jsrs this was fixed on ZAM. Example:

From

HtmlDocument is not a Jsr

<source lang="java">
public JsFunc<String> getReferrer(HtmlDocument doc){
    return call(String.class, "getReferrer").with(doc);
}

public JsFunc<String> getReferrer(IValueBinding<? extends HtmlDocument> doc){
    return call(String.class, "getReferrer").with(doc);
}
</source>
HTMLDocumentJsr can be used here:

<source lang="java">
public JsFunc<String> getReferrer(HTMLDocumentJsr doc){
    return call(String.class, "getReferrer").with(doc);
}

public JsFunc<String> getReferrer(IValueBinding<? extends HTMLDocumentJsr> doc){
    return call(String.class, "getReferrer").with(doc);
}
</source>
[[Category:VJET|JsToJava]]