class Class

JavaScript class that allows introspection of the JSX class hierarchy.

You may obtain an instance of jsx3.lang.Class in one of the following ways:

• var c = jsx3.Class.forName("jsx3.Object");
• var c = jsx3.Object.jsxclass;

This class is also used for defining classes. Use one of defineClass and defineInterface to define a class in the JSX class hierarchy. Note that any class defined in the package jsx3.lang is aliased into the jsx3 package. Therefore jsx3.lang.Object may also be referenced as jsx3.Object.

The following are class nomenclature definitions using jsx3.lang.Object as an example:

• jsx3.lang — the package, an instance of (JavaScript, not JSX) Object
• jsx3.lang.Object — the class constructor, instance of Function
• jsx3.lang.Object.jsxclass — the class, instance of jsx3.lang.Class
• jsx3.lang.Object.prototype — the class prototype, instance of Object

The following is an example of how to define a new class called Example in package eg:

jsx3.lang.Class.defineClass(
  "eg.Example",                   // the full name of the class to create
  eg.Base,                        // the class extends eg.Base
  [eg.Comparable, eg.Testable],   // the class implements interfaces eg.Comparable and eg.Testable
  function(Example) {             // name the argument of this function "Example"
    
    // every class must define an init method since it is called automatically by the constructor
    Example.prototype.init = function(arg1) {
      this.arg1 = arg1;
    };
    // define an instance method like this:
    Example.prototype.instanceMethod = function() {
      ...
    };
    // define an abstract method like this:
    Example.prototype.abstractMethod = jsx3.Method.newAbstract();
    // define a static method like this:
    Example.staticMethod = function() {
      ...
    };
    // define a static field like this:
    Example.STATIC_FIELD = "...";
    // define an instance field like this:
    Example.prototype.instanceField = "...";
  }
);

jsx3.Class.defineClass("eg.ContainingClass", null, null, function(){});
jsx3.Class.defineClass("eg.ContainingClass.InnerClass", null, null, function(){});

var aClass = eg.Testable.jsxclass;       // get jsx3.lang.Class instance
var innerClass = aClass.newInnerClass(); // create inner class instance
innerClass.test = function() {};         // implement the eg.Testable interface
innerClass instanceof eg.Testable;       // evaluates to true