Classing{js}: API Summery

Notes:

• In non-typed overloading, the overloads array is an array of functions.
• In typed overloading, an instance takes two elements in the overloads array : the first is for the type list (using types), and the second is for the function itself.
• Instead of passing true or false to the mode parameter, you can pass xTyped or xNonTyped.

Example:

var Add = Function.create(xNonTyped , [
	function(a,b){return a + b;},
	function(a,b,c){return a + b + c;}
]);
						

Notes:

• Native, custom constructor functions with a name and Classes are recognized.
• Custom anonymous constructor function must be stamped to be recognized.
• In copy constructors, use xSelf to point to the class being created.

Example:

var Add = Function.create(xTyped , [
	types(Number,Number),
	function(a,b) { return a + b}
]);
						

Example:

var Complex = function(re , img) {
	this.re = re; this.img = img;}
classing.xStamp(Complex);
var Add = Function.create(xTyped , [
	types(Complex,Complex),function(Z,W){
		return new Complex(Z.re + W.re,Z.img + W.img);
	}
]);
						

Notes:

• The proprties names of the defintion object are one, two or all of the following: private,protected and public(which are the access modifiers).
• Each access modifier is itself an object whose proprties are the class components having that accces level.

Example:

var Person = classing.Class({
	public : { name : "John Doe"}
});
						

Example:

var Person = Class({
	public: {
		counter : Static(0),
		Construct: function(){Person.counter++;}
	}
})
						

Example:

var Visitor  = Class({
	private : { id : null},
	public: {
		Construct : function() { this.id = Date.now();},
		getId : Final(function(){return this.id;})
	}
})
						

Notes:

• This marks the class final (unextensible).

Example:

var Infertile = classing.Final.Class({
	public : {name : null}
})
						

Notes:

• An abstract function must be inside an abstract class
• The body of the argumnt method must be empty. if it's an overloaded function, all the instances must have empty bodies.

Example:

var Child = classing.Abstract.Class({
	public: { Play : Abstract(function(){}) }
});
						

Notes:

• Marks the class as abstract. It must have at least one Abstract function.

Example:

var Shape = classing.Abstract.Class({
	public : { Area : Abstract(function(){})}
});
						

Notes:

Example:

var Child = classing.Class.Extends(Parent)({
	public : {
		newFunc : function(){ return "function of child"; }
	}
});
						

Notes:

• Each proprty in the defintion object is a function with empty body. if it's an overloaded function, all the instances must have empty bodies.
• All methods of an interface are public.

Example:

var IPayable = classing.Interface({
	getPaid : function()
})
						

Notes:

Class.Extends(...).Implements(...)

Example:

var Employee = classing.Class.Implements(IPayable)({
	public: {getPaid : function(){return "$5000.00"}}
})
						

Notes:

Eaxmple:

var IVoid = classing.Interface({ func : function(){} });
var Parent = classing.Class({});
var Child = classing.Class.Extends(Parent).Implements(IVoid)({
	public : { func : function(){return "void";} }
});
var obj = new Child();
obj.instanceOf(Child); //true
obj.instanceOf(Parent); //true
obj.instanceOf(IVoid); //true;
obj.instanceOf(Object); //true;