_ns

_ns= function( ns [, root [, obj]] )

Pre-define a name space or get an object by its name space.

ns
	name space string
root
	the relative obejct of the name space. If omit, use $esoe.ns
obj
	the obejct that is to map to the ns. If omit, create a new Object object.

return
	the existed or created object mapped to the ns

Ex
	_ns("MyPkg.sub.Class3");
	_ns("MyPkg.sub.Class3",myns);
	_ns("MyPkg.sub.Class3",myns,myobj);

	_package

same as _ns()

	_normalize

_normalize= function ( ns [, func [, bNonEsoe [, bObject [, bConflict]]]] )

Load a constructor to a name space item

ns
	name space string
func
	constructor/function, can be omitted if the func has pre-normalized to the ns.
bNonEsoe
	set 1 if normalizing a non-esoe function.
bObject
	set 1 if normalizing a non-esoe object.
bConflict
	set 1 if any keyword of c3 keywords conflict.

return
	the normalized object; if fail, return null.

Ex:
	If( !_normalize("MyPkg.Class1") ) return false;		// normalize esoe style class

	// normalize non-esoe style class
	_normalize( "com.yahoo.yui.widget.Node", YAHOO.widget.Node, 1 );

	// normalize non-esoe object
	_normalize( "com.yahoo.yui.widget.TVAnim", YAHOO.widget.TVAnim, 1, 1 );

	_derive

_derive= function ( ns [, func], nsBase )

Derive a class from a base class

ns
	name space string
func
	the constructor that is to be derived from the base class. It can be omitted if the constructor has pre-normalized.
nsBase
	name space string for base class

return
	return true if success, false if fail

Ex:
	if( !_derive("MyPkg.sub.Class3","MyPkg.Class2") ) return false;

	_derivex

_derivex= function ( ns, nsBase1 [, ... nsBaseN] )

copy the properties of multiple base classes.

ns
	name space string
nsBase1...nsBaseN
	name space string for base classes

return
	none

Ex:
	_derivex( "com.my.util.myclass", "com.my.util.class1", "com.my.util.class2" );

	_import

_import= function ( ns [, nsMap [, root [, bAlone] ]] )

Let constructor create its class and map it to a name space.

ns
	name space string
nsMap
	name space string for mapping to.
root
	the object to map into, if not set, map to the GLOBAL object/window.
bAlone
	Only for M5, if set 1, the class will only be loaded in local GLOBAL/ESOE environment.

Note:
If nsMap is set to null and obj is not set, just load the ns and don't map it to a name space item.
If nsMap is not set or set to "", use the last name space item of ns as nsMap.

Ex:
	_import("MyPkg.sub.Class3");	//map to window.Class3
	_import("MyPkg.sub.Class3","MyClass");	//map to window.MyClass
	_import("MyPkg.sub.Class3","myapp.MyClass");	//map to window.myapp.MyClass
	var ns={};
	_import("MyPkg.sub.Class3","",ns);	//map to ns.Class3

	_setpath (M2)

_setpath= function ( ns, path ) 

Set the ns path

ns
	name space string
path
	path name string

return
	none

Ex:
	_setpath("com","../lib/" );
	_setpath("com.mylib","../lib2/" );

	// "com.xtree.WebFXTree" will be loaded from ../lib/com/xtree/WebFXTree
	// "com.mylib.class1" will be loaded from ../lib2/ mylib/class1

	_getpath (M2)

_getpath= function ( ns [, subpath] )

Get the ns path

ns
	name space string
subpath
	the sub path that to be appended to the reault path

return
	the result path

Ex
	_getpath("com.mylib.myclass");
	_getpath("com.mylib.myclass","myss.css");

	_loadcss (M2)

_loadcss= function( [_global,] ns )
_loadcss= function( [_global,] ns, css1 [, css2, ... cssN]) )

load html style sheet file from ns path
Syntax 1: load default class css from [package path]/_res/[class name]/ [class name].css

_global
	the GLOBAL object
ns
	name space string
css1...cssN
	css file path retive to the package path.

Ex
	_loadcss( _global, "com.mycompany.util.myclass" );
	_loadcss( window, "com.my.util", "_res/myclass/style1.css", "_res/myclass/style2.css" );

	_update (M3)

_update= function()

If package loading need recursive process, call this to active it.

Note:
_update must be at the last place of a <script> tag enclosure.

Ex:
	<script>
	...
	_update();
	</script>

	_base Property

_base property is the prototype of the base class.

An esoe class/constructor or its instance can use _base to get the base class property.

Ex:
	alert( obj1._base.p1 );
	obj1._base.func1();
	obj1._base.func1.call(obj1);

	_pkg Property

_pkg property is the nearest upper package name space item.

An esoe constructor or its instance can use _pkg to get the reference to its nearest upper package name space item.

Ex:
	var a=new this._pkg.Class5;

	prototype._set

prototype._set= function( _this [, param1..., paramN] )

the initializing function of a class

_this
	the 'this' object.
param1..., paramN
	paremeters

ex
	//_set(), use '_this' instead of 'this' in the _set() body
	prototype._set= function( _this, param1, param2 )
	{
		//call base class _set()
		if( this._base._set ) this._base._set( _this, param1?param1:0, param2?param2:0 );

		//add initialization code here
	}

	prototype._destroy

prototype._destroy= function( _this )

the destroy function of a class

_this
	the 'this' object.

Ex
	//_destroy(), use '_this' instead of 'this' in the _destroy() body
	prototype._destroy= function( _this )
	{
		_this= _this?_this:this;

		if( !$esoe.CallBaseDestroy( this, _this ) ) return;	//destroy base class

		//add destruction code here
	}