OSDN Git Service

Version 0.6.134, add comments for closure compiler.
[pettanr/clientJs.git] / 0.6.x / js / 01_core / 11_XClass.js
index 815e4c1..52207a5 100644 (file)
@@ -27,7 +27,7 @@ var
        X_Class_killPrivateFlag    = false,\r
        X_Class_traits             = null,\r
        X_Class_useObjectCreate    = false, // !!Object.create, http://jsperf.com/prototype-vs-object-create-perf\r
-       X_Class_use_proto_         = !X_UA[ 'OperaMobile' ] && !X_UA[ 'OperaTablet' ] && !!X.emptyFunction.prototype.__proto__,\r
+       X_Class_use_proto_         = !X_UA[ 'OperaMobile' ] && !X_UA[ 'OperaTablet' ] && !!X_emptyFunction.prototype.__proto__,\r
                // Opera Mobile 12.10 Android11 IS01 でクラスのメンバが欠落する問題に遭遇。__proto__ を使わないと動作,,,\r
 \r
 X_Class_CommonMethods =\r
@@ -37,13 +37,13 @@ X_Class_CommonMethods =
         * 全ての動的メンバを削除して、インスタンスを破棄する。<br>\r
         * インスタンスが X.EventDispatcher とそのサブクラスの場合、次の動作をする。\r
         * <ol>\r
-        * <li>X.Event.BEFORE_KILL_INSTANCE を発火する。戻り値のビットフラグに X.Callback.PREVENT_DEFAULT が立つ場合、破棄をキャンセルし X.Event.KILL_INSTANCE_CANCELED を発火する。\r
+        * <li>X.Event.BEFORE_KILL_INSTANCE を発火する。戻り値のビットフラグに X_Callback_PREVENT_DEFAULT が立つ場合、破棄をキャンセルし X.Event.KILL_INSTANCE_CANCELED を発火する。\r
         * <li>破棄に進む場合は、X.Event.KILL_INSTANCE を発火する。\r
         * <li>dispatch 中は、インスタンスの全ての dispatch が終了するまで実際の破棄を待つ。\r
         * <li>実際の破棄では、インスタンスのメンバの削除に加えて全てのイベントリスナを解除する。\r
         */\r
        // TODO kill したインスタンスのイベントが残っていないか?これは開発用のみ\r
-       kill : function(){\r
+       'kill' : function(){\r
                var instance = this,\r
                        klass    = X_Class_getClass( instance ),\r
                        def      = X_Class_getClassDef( klass ),\r
@@ -54,10 +54,10 @@ X_Class_CommonMethods =
                };\r
                X_Class_killPrivateFlag = false; // instance.kill() 内で PrivateInstance.kill() を防ぐため\r
                \r
-               if( this.instanceOf( X.EventDispatcher ) ){\r
+               if( this[ 'instanceOf' ]( X_EventDispatcher ) ){\r
                        if( !def.isPrivate ){\r
-                               if( this.dispatch( X_Event.BEFORE_KILL_INSTANCE ) & X.Callback.PREVENT_DEFAULT ){\r
-                                       this.dispatch( X_Event.KILL_INSTANCE_CANCELED );\r
+                               if( this[ 'dispatch' ]( X_EVENT_BEFORE_KILL_INSTANCE ) & X_Callback_PREVENT_DEFAULT ){\r
+                                       this[ 'dispatch' ]( X_EVENT_KILL_INSTANCE_CANCELED );\r
                                        return;\r
                                };\r
                                if( this[ '_listeners' ] && this[ '_listeners' ][ X_Listeners_.DISPATCHING ] ){\r
@@ -65,18 +65,18 @@ X_Class_CommonMethods =
                                        return;\r
                                };\r
                        } else {\r
-                               this.dispatch( X_Event.BEFORE_KILL_INSTANCE );  \r
+                               this[ 'dispatch' ]( X_EVENT_BEFORE_KILL_INSTANCE );     \r
                        };\r
 \r
                        // asyncDispatch の削除\r
                        for( p in X_EventDispatcher_LAZY_TIMERS ){\r
                                if( X_EventDispatcher_LAZY_TIMERS[ p ] === this ){\r
                                        delete X_EventDispatcher_LAZY_TIMERS[ p ]; // 削除が先!理由は X.Timer.removeを確認。\r
-                                       X.Timer.remove( parseFloat( p ) );\r
+                                       X_Timer_remove( parseFloat( p ) );\r
                                };\r
                        };\r
                        \r
-                       this.dispatch( X_Event.KILL_INSTANCE );\r
+                       this[ 'dispatch' ]( X_EVENT_KILL_INSTANCE );\r
                        this._listeners && X_EventDispatcher_systemUnlisten( this );\r
                };\r
                \r
@@ -92,11 +92,11 @@ X_Class_CommonMethods =
                        i = def.userList.indexOf( instance );\r
                        if( i !== -1 ){\r
                                data = X_Class_getPrivate( instance );\r
-                               if( data[ '_listeners' ] && data[ '_listeners' ][ X_Listeners_.DISPATCHING ] && data.instanceOf( X.EventDispatcher ) ){\r
+                               if( data[ '_listeners' ] && data[ '_listeners' ][ X_Listeners_.DISPATCHING ] && data[ 'instanceOf' ]( X.EventDispatcher ) ){\r
                                        data[ '_listeners' ][ X_Listeners_.KILL_RESERVED ] = true;\r
                                } else {\r
                                        X_Class_killPrivateFlag = true;\r
-                                       data.kill();\r
+                                       data[ 'kill' ]();\r
                                };\r
                                def.dataList.splice( i, 1 );\r
                                def.userList.splice( i, 1 );\r
@@ -114,7 +114,7 @@ X_Class_CommonMethods =
         * @return {*}\r
         */\r
        // TODO 現在 new しているインスタンスを保持してチェックする\r
-       Super : function( var_args ){\r
+       'Super' : function( var_args ){\r
                var sClass = this,\r
                        i      = X_Class_CALLING_SUPER.indexOf( sClass ),\r
                        n      = -1,\r
@@ -154,7 +154,7 @@ X_Class_CommonMethods =
         * @example return this.superCall( arguments.callee, param0, param1, ... );\r
         * @return {*} オーバーライド元の関数を呼び出した戻り値。\r
         */\r
-       superCall : function( funcNameOrFunc, var_args ){\r
+       'superCall' : function( funcNameOrFunc, var_args ){\r
                var sClass = this,\r
                        args   = arguments,\r
                        name, p, sFunc, hit = false;\r
@@ -191,7 +191,7 @@ X_Class_CommonMethods =
                                                case 4 :\r
                                                        return sFunc.call( this, args[ 1 ], args[ 2 ], args[ 3 ] );\r
                                                default :\r
-                                                       args = X.Object.cloneArray( args );\r
+                                                       args = X_Object_cloneArray( args );\r
                                                        args.shift();\r
                                                        return sFunc.apply( this, args );\r
                                        };\r
@@ -209,7 +209,7 @@ X_Class_CommonMethods =
         * @return {boolean}\r
         */\r
        // TODO instanceof に対応したブラウザはそちらを使用\r
-       instanceOf : function( klass ){\r
+       'instanceOf' : function( klass ){\r
                var Super = this;\r
                if( this.constructor === klass ) return true;\r
                while( Super = X_Class_getClassDef( Super ).SuperClass ){\r
@@ -243,54 +243,77 @@ X_Class_CommonMethods =
  * @namespace X.Class\r
  * @alias X.Class\r
  */ \r
-X.Class = {\r
+X[ 'Class' ] = {\r
 \r
     /**\r
      * 設定なし。\r
+     * @const\r
      */        \r
-       NONE         : 0,\r
+       'NONE'         : 0,\r
        \r
     /**\r
      * インスタンスは破棄時(this.kill())に回収され、次回の new MyClass() 時に再利用されます。\r
+     * @const\r
      */\r
-       POOL_OBJECT  :  1,\r
+       'POOL_OBJECT'  :  1,\r
        \r
        /**\r
         * 定義するクラスは抽象クラスになります。new AbstractClass() とするとエラーになります。\r
+        * @const\r
         */\r
-       ABSTRACT     :  2,\r
+       'ABSTRACT'     :  2,\r
 \r
        /**\r
         * クラスの継承を禁止する。\r
+        * @const\r
         */\r
-       FINAL        :  4,\r
+       'FINAL'        :  4,\r
 \r
        /**\r
         * 使用を中止。petanR ライブラリ使用プロジェクトから SUPER_ACCESS を消したらここも削除。\r
+        * @const\r
         */\r
-       SUPER_ACCESS :  8,\r
+       'SUPER_ACCESS' :  8,\r
 \r
        /**\r
         * 内部コード、主に X.UI フレームワークに対して、フレーム外に露出するインスタンスとペアで動作する、シャドウなインスタンスの使用を宣言する。\r
         * Javascript はインスタンス毎のカプセル化がとてもコスト高。微妙なコスト増で隠蔽されたインスタンスを使う。\r
+        * @const\r
         */\r
-       PRIVATE_DATA : 16,\r
+       'PRIVATE_DATA' : 16,\r
 \r
        /**\r
         * 未実装。でも目印になるので付けておきましょう。\r
+        * @const\r
         */\r
-       SINGLETON    : 32,\r
+       'SINGLETON'    : 32,\r
 \r
+       'create'       : X_Class_create,\r
+       \r
+       // TODO collect\r
+       \r
+       '_newPrivate'  : X_Class_newPrivate,\r
+       \r
+       '_getPrivate'  : X_Class_getPrivate\r
+       \r
+};\r
+\r
+\r
+\r
+// ------------------------------------------------------------------------- //\r
+// --- implements ---------------------------------------------------------- //\r
+// ------------------------------------------------------------------------- //\r
        /**\r
         * クラスを定義する。<br>\r
         * X.Class.create() によるクラス定義は必ずしもコンストラクタを必要としません。クラス定義時にコンストラクタが未設定の場合、スーパークラスがあればそのコンストラクタを使用します。\r
+        * @alias X.Class.create\r
         * @param {string} [displayName] クラスの名前\r
         * @param {number} [classSetting=0] X.Class.POOL_OBJECT | X.Class.FINAL など\r
         * @param {__ClassBase__=} [privateClass] このクラスとペアで動作するシャドウクラス\r
         * @param {object} [props={}] このクラスのメンバと関数。コンストラクタは Constructor と書くこと\r
         * @return {__ClassBase__}\r
         */\r
-       create : function( /* displayName, classSetting, privateClass, props */ ){\r
+       function X_Class_create( /* displayName, classSetting, privateClass, props */ ){\r
                var args        = X_Object_cloneArray( arguments ),\r
                        displayName = args[ 0 ],\r
                        classSetting,\r
@@ -340,14 +363,14 @@ X.Class = {
                        // クラスメンバ用オブジェクトが無しでもクラスは作成可能\r
                        props = {};\r
                } else\r
-               if( props.Constructor && X_Type_isFunction( props.Constructor ) ){\r
-                       classDef.Constructor = props.Constructor;\r
+               if( props[ 'Constructor' ] && X_Type_isFunction( props[ 'Constructor' ] ) ){\r
+                       classDef.Constructor = props[ 'Constructor' ];\r
                };\r
 \r
-               klass  = X_Callback_actualClosure( hash = { _ : X_Class_actualConstructor } ); // TODO hash = classDef\r
-               hash.c = klass;\r
-               klass.superClassOf = X_Class_superClassOf;\r
-               klass.subClassOf   = X_Class_subClassOf;\r
+               klass  = X_Callback_actualClosure( hash = { proxy : X_Class_actualConstructor } ); // TODO hash = classDef\r
+               hash.klass = klass;\r
+               klass[ 'superClassOf' ] = X_Class_superClassOf;\r
+               klass[ 'subClassOf' ]   = X_Class_subClassOf;\r
                \r
                if( X_Class_useObjectCreate ){\r
                        klass.prototype = X_Class_override( X_Class_override( X_Class_traits || klass.prototype, props, true ), X_Class_CommonMethods, false );\r
@@ -365,7 +388,7 @@ X.Class = {
                        klass.prototype.constructor = klass;\r
                };\r
                \r
-               klass.name = displayName;\r
+               klass[ 'name' ] = displayName;\r
                \r
                if( opt_abstract ){\r
                        classDef.Abstract = true;\r
@@ -377,7 +400,7 @@ X.Class = {
                if( opt_final ){\r
                        classDef.Final = true;\r
                } else {\r
-                       klass.inherits = X_Class_inherits;\r
+                       klass[ 'inherits' ] = X_Class_inherits;\r
                };                      \r
                if( opt_private ){\r
                        if( classDef.privateClass ){\r
@@ -392,19 +415,10 @@ X.Class = {
                        X_Class_DEF_LIST.push( classDef );                              \r
                };\r
                return klass;\r
-       },\r
-       \r
-       _newPrivate  : X_Class_newPrivate,\r
-       \r
-       _getPrivate  : X_Class_getPrivate\r
-       \r
-};\r
+       };\r
 \r
 \r
 \r
-// ------------------------------------------------------------------------- //\r
-// --- implements ---------------------------------------------------------- //\r
-// ------------------------------------------------------------------------- //\r
 function X_Class_getClass( instance ){\r
        var cList    = X_Class_CLASS_LIST,\r
                i        = cList.length,\r
@@ -593,7 +607,7 @@ function X_Class_inherits( /* displayName, classSetting, opt_PrivateClass, props
  * これにより pool された オブジェクト(破棄されたインスタンス) を再利用できる\r
  */\r
 function X_Class_actualConstructor( f, args ){\r
-       var klass    = f.c,\r
+       var klass    = f.klass,\r
                def      = X_Class_getClassDef( klass ),\r
                dataUser = def._tempUser,\r
                instance, obj,\r
@@ -628,7 +642,7 @@ function X_Class_actualConstructor( f, args ){
                def.SuperConstructor &&\r
                        def.SuperConstructor.apply( instance, args );\r
        if( ( X_Type_isObject( obj ) && obj !== instance ) || X_Type_isFunction( obj ) ){ // Class\r
-               instance.kill();\r
+               instance[ 'kill' ]();\r
                return obj;\r
        };\r
        return instance;\r