0.6.x/js/01_core/11_XClass.js

   1 \r
   2 // ------------------------------------------------------------------------- //\r
   3 // ------------ local variables -------------------------------------------- //\r
   4 // ------------------------------------------------------------------------- //\r
   5 var\r
   6         /**\r
   7          * 全てのクラスのスーパークラスのようなもの。(ライブラリ内にカプセル化されているため、ユーザが触ることはありません)<br>\r
   8          * X.Class.create() で定義されたクラスのインスタンスが共通で備えるメソッド を確認してください。\r
   9          * @class __ClassBase__\r
  10          * @private\r
  11          * @abstract\r
  12          */\r
  13         __ClassBase__ = {\r
  14                         /**\r
  15                          * クラス名\r
  16                          * @type {string}\r
  17                          */\r
  18                         name         : ''\r
  19                 },\r
  20 \r
  21         X_Class_CLASS_LIST         = [],\r
  22         X_Class_DEF_LIST           = [],\r
  23         X_Class_PRIVATE_CLASS_LIST = [],\r
  24         X_Class_PRIVATE_DEF_LIST   = [],\r
  25         X_Class_CALLING_SUPER      = [],\r
  26         X_Class_CALL_SUPER_STACK   = [],\r
  27         X_Class_killPrivateFlag    = false,\r
  28         X_Class_traits             = null,\r
  29         X_Class_useObjectCreate    = false, // !!Object.create, http://jsperf.com/prototype-vs-object-create-perf\r
  30         X_Class_use_proto_         = !X_UA[ 'OperaMobile' ] && !X_UA[ 'OperaTablet' ] && !!X_emptyFunction.prototype.__proto__,\r
  31                 // Opera Mobile 12.10 Android11 IS01 でクラスのメンバが欠落する問題に遭遇。__proto__ を使わないと動作,,,\r
  32 \r
  33 X_Class_CommonMethods =\r
  34 /** @lends __ClassBase__.prototype */\r
  35 {\r
  36         /**\r
  37          * 全ての動的メンバを削除して、インスタンスを破棄する。<br>\r
  38          * インスタンスが X.EventDispatcher とそのサブクラスの場合、次の動作をする。\r
  39          * <ol>\r
  40          * <li>X.Event.BEFORE_KILL_INSTANCE を発火する。戻り値のビットフラグに X_Callback_PREVENT_DEFAULT が立つ場合、破棄をキャンセルし X.Event.KILL_INSTANCE_CANCELED を発火する。\r
  41          * <li>破棄に進む場合は、X.Event.KILL_INSTANCE を発火する。\r
  42          * <li>dispatch 中は、インスタンスの全ての dispatch が終了するまで実際の破棄を待つ。\r
  43          * <li>実際の破棄では、インスタンスのメンバの削除に加えて全てのイベントリスナを解除する。\r
  44          */\r
  45         // TODO kill したインスタンスのイベントが残っていないか？これは開発用のみ\r
  46         'kill' : function(){\r
  47                 var instance = this,\r
  48                         klass    = X_Class_getClass( instance ),\r
  49                         def      = X_Class_getClassDef( klass ),\r
  50                         data, p, i;\r
  51                 if( def.isPrivate && !X_Class_killPrivateFlag && ( !this[ '_listeners' ] || !this[ '_listeners' ][ X_Listeners_.KILL_RESERVED ] ) ){\r
  52                         X.Logger.critical( 'PrivateInstance.kill() work in PrivateUser.kill().' );\r
  53                         return;\r
  54                 };\r
  55                 X_Class_killPrivateFlag = false; // instance.kill() 内で PrivateInstance.kill() を防ぐため\r
  56                 \r
  57                 if( this[ 'instanceOf' ]( X_EventDispatcher ) ){\r
  58                         if( !def.isPrivate ){\r
  59                                 if( this[ 'dispatch' ]( X_EVENT_BEFORE_KILL_INSTANCE ) & X_Callback_PREVENT_DEFAULT ){\r
  60                                         this[ 'dispatch' ]( X_EVENT_KILL_INSTANCE_CANCELED );\r
  61                                         return;\r
  62                                 };\r
  63                                 if( this[ '_listeners' ] && this[ '_listeners' ][ X_Listeners_.DISPATCHING ] ){\r
  64                                         this[ '_listeners' ][ X_Listeners_.KILL_RESERVED ] = true;\r
  65                                         return;\r
  66                                 };\r
  67                         } else {\r
  68                                 this[ 'dispatch' ]( X_EVENT_BEFORE_KILL_INSTANCE );     \r
  69                         };\r
  70 \r
  71                         // asyncDispatch の削除\r
  72                         for( p in X_EventDispatcher_LAZY_TIMERS ){\r
  73                                 if( X_EventDispatcher_LAZY_TIMERS[ p ] === this ){\r
  74                                         delete X_EventDispatcher_LAZY_TIMERS[ p ]; // 削除が先！理由は X.Timer.removeを確認。\r
  75                                         X_Timer_remove( parseFloat( p ) );\r
  76                                 };\r
  77                         };\r
  78                         \r
  79                         this[ 'dispatch' ]( X_EVENT_KILL_INSTANCE );\r
  80                         this._listeners && X_EventDispatcher_systemUnlisten( this );\r
  81                 };\r
  82                 \r
  83                 for( p in instance ){\r
  84                         if( instance.hasOwnProperty && !instance.hasOwnProperty( p ) ) continue;\r
  85                         delete instance[ p ];\r
  86                 };\r
  87                 if( def.pool ){\r
  88                         def.live && def.live.splice( def.live.indexOf( instance ), 1 );\r
  89                         def.pool[ def.pool.length ] = instance;\r
  90                 };\r
  91                 if( def.privateClass ){\r
  92                         i = def.userList.indexOf( instance );\r
  93                         if( i !== -1 ){\r
  94                                 data = X_Class_getPrivate( instance );\r
  95                                 if( data[ '_listeners' ] && data[ '_listeners' ][ X_Listeners_.DISPATCHING ] && data[ 'instanceOf' ]( X.EventDispatcher ) ){\r
  96                                         data[ '_listeners' ][ X_Listeners_.KILL_RESERVED ] = true;\r
  97                                 } else {\r
  98                                         X_Class_killPrivateFlag = true;\r
  99                                         data[ 'kill' ]();\r
 100                                 };\r
 101                                 def.dataList.splice( i, 1 );\r
 102                                 def.userList.splice( i, 1 );\r
 103                         };\r
 104                 };\r
 105         },\r
 106         \r
 107         /**\r
 108          * 関数は Constructor 内で使用します。クラス定義を辿ってスーパークラスのコンストラクタを探します。<br>\r
 109          * 内部的には、呼び出したコンストラクタは配列に控え(X_Class_CALLING_SUPER)、呼び出したコンストラクタ内でさらに Super が呼ばれた場合、配列を元にさらにスーパーなコンストラクタを辿ります。\r
 110          * @example Constructor : function( arg1, arg2 ){\r
 111          *      this.Super( aeg1, arg2 );\r
 112          * }\r
 113          * @param var_args {...?} 親コンストラクタを呼ぶ際に渡す任意の数の引数\r
 114          * @return {*}\r
 115          */\r
 116         // TODO 現在 new しているインスタンスを保持してチェックする\r
 117         'Super' : function( var_args ){\r
 118                 var sClass = this,\r
 119                         i      = X_Class_CALLING_SUPER.indexOf( sClass ),\r
 120                         n      = -1,\r
 121                         l, sList, def, sConst, ret;\r
 122         \r
 123                 if( i === -1 ){\r
 124                         X_Class_CALLING_SUPER[ l = X_Class_CALLING_SUPER.length ] = sClass;\r
 125                         X_Class_CALL_SUPER_STACK[ l ] = sList = [];\r
 126                 } else {\r
 127                         sList = X_Class_CALL_SUPER_STACK[ i ];\r
 128                 };\r
 129                 \r
 130                 while( sClass ){\r
 131                         def    = X_Class_getClassDef( sClass );\r
 132                         sClass = def.SuperClass;\r
 133                         sConst = def.SuperConstructor;\r
 134                         if( sConst && sList[ ++n ] !== sConst ){\r
 135                                 sList[ n ] = sConst;\r
 136                                 ret = sConst.apply( this, arguments );\r
 137                                 --sList.length;\r
 138                                 if( !sList.length ){\r
 139                                         X_Class_CALLING_SUPER.splice( i, 1 );\r
 140                                         X_Class_CALL_SUPER_STACK.splice( i, 1 );\r
 141                                 };\r
 142                                 return ret;\r
 143                         };\r
 144                 };\r
 145                 console.log( 'スーパークラスのコンストラクタが見つかりません' );\r
 146         },\r
 147 \r
 148         /**\r
 149          * func について、親クラスで設定されている同名の関数メンバーを呼び出す。<br>\r
 150          * 第一引数に関数を指定し、2つ以上の異なる名前で同じ関数がメンバーがいた場合、動作が不確実になります。<br>\r
 151          * 参考:<a href="http://qiita.com/no22@github/items/d3bead2acbb7ff1fb86b" target="_blank">ES5なJavascriptでモダンなクラス的継承＆スーパー呼び出し </a>\r
 152          * @param funcNameOrFunc {Function|string} スーパークラスの関数名 または、オーバーライド済の自身の関数。\r
 153          * @param var_args {...*} オーバーライド元関数に渡す任意の数の引数\r
 154          * @example return this.superCall( arguments.callee, param0, param1, ... );\r
 155          * @return {*} オーバーライド元の関数を呼び出した戻り値。\r
 156          */\r
 157         'superCall' : function( funcNameOrFunc, var_args ){\r
 158                 var sClass = this,\r
 159                         args   = arguments,\r
 160                         name, p, sFunc, hit = false;\r
 161                 if( X_Type_isFunction( funcNameOrFunc ) ){\r
 162                         for( p in this.constructor.prototype ){\r
 163                                 if( this.constructor.prototype[ p ] === funcNameOrFunc ){\r
 164                                         name = p;\r
 165                                         break;\r
 166                                 };\r
 167                         };\r
 168                         if( !name ) return;\r
 169                 } else {\r
 170                         return;\r
 171                 };\r
 172                 \r
 173                 if( X_EMPTY_OBJECT[ name ] ) return;\r
 174                 \r
 175                 while( sClass ){\r
 176                         def    = X_Class_getClassDef( sClass );\r
 177                         sClass = def.SuperClass;\r
 178                         sFunc  = sClass.prototype[ name ];\r
 179                         if( sFunc === funcNameOrFunc ){\r
 180                                 hit = true; // 現在の関数にヒット\r
 181                         } else\r
 182                         if( hit && X_Object_inObject( name, this ) ){\r
 183                                 if( X_Type_isFunction( sFunc ) ){\r
 184                                         switch( args.length ){\r
 185                                                 case 1 :\r
 186                                                         return sFunc.call( this );\r
 187                                                 case 2 :\r
 188                                                         return sFunc.call( this, args[ 1 ] );\r
 189                                                 case 3 :\r
 190                                                         return sFunc.call( this, args[ 1 ], args[ 2 ] );\r
 191                                                 case 4 :\r
 192                                                         return sFunc.call( this, args[ 1 ], args[ 2 ], args[ 3 ] );\r
 193                                                 default :\r
 194                                                         args = X_Object_cloneArray( args );\r
 195                                                         args.shift();\r
 196                                                         return sFunc.apply( this, args );\r
 197                                         };\r
 198                                 };\r
 199                                 break;\r
 200                         };\r
 201                 };\r
 202         },\r
 203         \r
 204         /**\r
 205          * インスタンスのクラスか？またはスーパークラスか？調べる。<br>\r
 206          * instanceof 構文をサポートしない環境(IE4,Mac IE5)を想定する場合、必ずこのメソッドを使用すること。<br>\r
 207          * クラスのインスタンスか？だけ調べたい場合は this.constructor === klass が高速。\r
 208          * @param klass {__ClassBase__} クラス定義\r
 209          * @return {boolean}\r
 210          */\r
 211         // TODO instanceof に対応したブラウザはそちらを使用\r
 212         'instanceOf' : function( klass ){\r
 213                 var Super = this;\r
 214                 if( this.constructor === klass ) return true;\r
 215                 while( Super = X_Class_getClassDef( Super ).SuperClass ){\r
 216                         if( Super === klass ) return true;\r
 217                 };\r
 218                 return false;\r
 219         }\r
 220 };\r
 221 \r
 222 // ------------------------------------------------------------------------- //\r
 223 // --- interface ----------------------------------------------------------- //\r
 224 // ------------------------------------------------------------------------- //\r
 225 \r
 226 /**\r
 227  * <p>Class を定義し システムの管理下に置く。\r
 228  * <p>prototype 継承のブラウザ毎の差異も吸収し、 以下から最適な方法をしてくれる。\r
 229  * \r
 230  * <ol>\r
 231  * <li>Object.create はパフォーマンスが悪そうなので現在は使っていない。\r
 232  * <li>SubClass.prototype.__proto__ = SuperClass.prototype;\r
 233  * <li>SubClass.prototype = new SuperClass;\r
 234  * </ol>\r
 235  * \r
 236  * <ol>\r
 237  * <li>X.Class.create( opt_settings, opt_name, opt_privateClass, opt_props ) でクラスを登録．\r
 238  * <li>コンストラクタ となるメソッドは、opt_props 内の Constructor : function( arg ){ ... }, に書く．\r
 239  * <li>通常通り new で インスタンス生成\r
 240  * <li>kill() でオブジェクトをクリーンして削除、pool が有効の場合は pool される．\r
 241  * <li>pool が有効の場合、new で pool されたインスタンスが返される．\r
 242  * </ol>\r
 243  * @namespace X.Class\r
 244  * @alias X.Class\r
 245  */ \r
 246 X[ 'Class' ] = {\r
 247 \r
 248     /**\r
 249      * 設定なし。\r
 250      * @const\r
 251      */ \r
 252         'NONE'         : 0,\r
 253         \r
 254     /**\r
 255      * インスタンスは破棄時(this.kill())に回収され、次回の new MyClass() 時に再利用されます。\r
 256      * @const\r
 257      */\r
 258         'POOL_OBJECT'  :  1,\r
 259         \r
 260         /**\r
 261          * 定義するクラスは抽象クラスになります。new AbstractClass() とするとエラーになります。\r
 262          * @const\r
 263          */\r
 264         'ABSTRACT'     :  2,\r
 265 \r
 266         /**\r
 267          * クラスの継承を禁止する。\r
 268          * @const\r
 269          */\r
 270         'FINAL'        :  4,\r
 271 \r
 272         /**\r
 273          * 使用を中止。petanR ライブラリ使用プロジェクトから SUPER_ACCESS を消したらここも削除。\r
 274          * @const\r
 275          */\r
 276         'SUPER_ACCESS' :  8,\r
 277 \r
 278         /**\r
 279          * 内部コード、主に X.UI フレームワークに対して、フレーム外に露出するインスタンスとペアで動作する、シャドウなインスタンスの使用を宣言する。\r
 280          * Javascript はインスタンス毎のカプセル化がとてもコスト高。微妙なコスト増で隠蔽されたインスタンスを使う。\r
 281          * @const\r
 282          */\r
 283         'PRIVATE_DATA' : 16,\r
 284 \r
 285         /**\r
 286          * 未実装。でも目印になるので付けておきましょう。\r
 287          * @const\r
 288          */\r
 289         'SINGLETON'    : 32,\r
 290 \r
 291         'create'       : X_Class_create,\r
 292         \r
 293         // TODO collect\r
 294         \r
 295         '_newPrivate'  : X_Class_newPrivate,\r
 296         \r
 297         '_getPrivate'  : X_Class_getPrivate\r
 298         \r
 299 };\r
 300 \r
 301 \r
 302 \r
 303 // ------------------------------------------------------------------------- //\r
 304 // --- implements ---------------------------------------------------------- //\r
 305 // ------------------------------------------------------------------------- //\r
 306         /**\r
 307          * クラスを定義する。<br>\r
 308          * X.Class.create() によるクラス定義は必ずしもコンストラクタを必要としません。クラス定義時にコンストラクタが未設定の場合、スーパークラスがあればそのコンストラクタを使用します。\r
 309          * @alias X.Class.create\r
 310          * @param {string} [displayName] クラスの名前\r
 311          * @param {number} [classSetting=0] X.Class.POOL_OBJECT | X.Class.FINAL など\r
 312          * @param {__ClassBase__=} [privateClass] このクラスとペアで動作するシャドウクラス\r
 313          * @param {object} [props={}] このクラスのメンバと関数。コンストラクタは Constructor と書くこと\r
 314          * @return {__ClassBase__}\r
 315          */\r
 316         function X_Class_create( /* displayName, classSetting, privateClass, props */ ){\r
 317                 var args        = X_Object_cloneArray( arguments ),\r
 318                         displayName = args[ 0 ],\r
 319                         classSetting,\r
 320                         opt_pool, opt_abstract, opt_final, opt_private,\r
 321                         privateDef,\r
 322                         props,\r
 323                         klass,\r
 324                         classDef = {}, hash;\r
 325                 if( X_Type_isString( displayName ) === true ){\r
 326                         classDef.displayName = displayName;\r
 327                         args.shift();\r
 328                 };\r
 329                 \r
 330                 // クラス設定\r
 331                 classDef.setting = classSetting = args[ 0 ];\r
 332                 if( X_Type_isNumber( classSetting ) ){\r
 333                         opt_pool     = !!( classSetting & X.Class.POOL_OBJECT  );\r
 334                         opt_abstract = !!( classSetting & X.Class.ABSTRACT     );\r
 335                         opt_final    = !!( classSetting & X.Class.FINAL        );\r
 336                         opt_private  = !!( classSetting & X.Class.PRIVATE_DATA );\r
 337                         if( opt_final && opt_abstract ){\r
 338                                 X.Logger.critical( 'final & Abstract!' );\r
 339                                 return;\r
 340                         };      \r
 341                         args.shift();\r
 342                 } else {\r
 343                         classDef.setting = 0;\r
 344                 };\r
 345                 \r
 346                 // シャドウクラス\r
 347                 if( X_Class_PRIVATE_CLASS_LIST.indexOf( args[ 0 ] ) !== -1 ){\r
 348                         privateDef = X_Class_getClassDef( args[ 0 ] );\r
 349                         if( privateDef.isPrivate !== true ){\r
 350                                 X.Logger.critical( 'PrivateClass not found! please, X.Class.create( X.Class.PRIVATE, {...} ).' );\r
 351                                 return;\r
 352                         } else\r
 353                         if( privateDef.Abstract === true ){\r
 354                                 X.Logger.critical( 'PrivateClass is Abstract!' );\r
 355                                 return;\r
 356                         };\r
 357                         classDef.privateClass = args.shift();\r
 358                 };\r
 359                 \r
 360                 // インスタンスのメンバー\r
 361                 props = args[ 0 ];\r
 362                 if( !X_Type_isObject( props ) ){\r
 363                         // クラスメンバ用オブジェクトが無しでもクラスは作成可能\r
 364                         props = {};\r
 365                 } else\r
 366                 if( props[ 'Constructor' ] && X_Type_isFunction( props[ 'Constructor' ] ) ){\r
 367                         classDef.Constructor = props[ 'Constructor' ];\r
 368                 };\r
 369 \r
 370                 klass  = X_Callback_actualClosure( hash = { proxy : X_Class_actualConstructor } ); // TODO hash = classDef\r
 371                 hash.klass = klass;\r
 372                 klass[ 'superClassOf' ] = X_Class_superClassOf;\r
 373                 klass[ 'subClassOf' ]   = X_Class_subClassOf;\r
 374                 \r
 375                 if( X_Class_useObjectCreate ){\r
 376                         klass.prototype = X_Class_override( X_Class_override( X_Class_traits || klass.prototype, props, true ), X_Class_CommonMethods, false );\r
 377                         klass.prototype.constructor = klass;\r
 378                 } else\r
 379                 if( X_Class_use_proto_ ){\r
 380                         X_Class_override( klass.prototype, props, true );\r
 381                         if( X_Class_traits ){\r
 382                                 klass.prototype.__proto__ = X_Class_traits;\r
 383                         } else {\r
 384                                 X_Class_override( klass.prototype, X_Class_CommonMethods, false );\r
 385                         };\r
 386                 } else {\r
 387                         klass.prototype = X_Class_override( X_Class_override( X_Class_traits || klass.prototype, props, true ), X_Class_CommonMethods, false );\r
 388                         klass.prototype.constructor = klass;\r
 389                 };\r
 390                 \r
 391                 klass[ 'name' ] = displayName;\r
 392                 \r
 393                 if( opt_abstract ){\r
 394                         classDef.Abstract = true;\r
 395                 } else\r
 396                 if( opt_pool ){\r
 397                         classDef.pool = [];\r
 398                         if( opt_private === false ) classDef.live = [];\r
 399                 };                      \r
 400                 if( opt_final ){\r
 401                         classDef.Final = true;\r
 402                 } else {\r
 403                         klass[ 'inherits' ] = X_Class_inherits;\r
 404                 };                      \r
 405                 if( opt_private ){\r
 406                         if( classDef.privateClass ){\r
 407                                 X.Logger.critical( 'Private Data Class has no PrivateClass!' );\r
 408                                 return;\r
 409                         };\r
 410                         classDef.isPrivate = true;\r
 411                         X_Class_PRIVATE_CLASS_LIST.push( klass );\r
 412                         X_Class_PRIVATE_DEF_LIST.push( classDef );\r
 413                 } else {\r
 414                         X_Class_CLASS_LIST.push( klass );\r
 415                         X_Class_DEF_LIST.push( classDef );                              \r
 416                 };\r
 417                 return klass;\r
 418         };\r
 419 \r
 420 \r
 421 \r
 422 function X_Class_getClass( instance ){\r
 423         var cList    = X_Class_CLASS_LIST,\r
 424                 i        = cList.length,\r
 425                 klass;\r
 426         for( ; i; ){\r
 427                 klass = cList[ --i ];\r
 428                 if( instance.constructor === klass ) return klass;\r
 429         };\r
 430         cList = X_Class_PRIVATE_CLASS_LIST;\r
 431         i     = cList.length;\r
 432         for( ; i; ){\r
 433                 klass = cList[ --i ];\r
 434                 if( instance.constructor === klass ) return klass;\r
 435         };\r
 436         \r
 437         if( cList.indexOf( instance ) !== -1 ) return instance;\r
 438         if( X_Class_CLASS_LIST.indexOf( instance ) !== -1 ) return instance;\r
 439 };\r
 440 \r
 441 function X_Class_getClassDef( KlassOrInstance ){\r
 442         var i = X_Class_CLASS_LIST.indexOf( KlassOrInstance );\r
 443         if( i === -1 ) i = X_Class_CLASS_LIST.indexOf( X_Class_getClass( KlassOrInstance ) );\r
 444         if( i !== -1 ) return X_Class_DEF_LIST[ i ];\r
 445         \r
 446         i = X_Class_PRIVATE_CLASS_LIST.indexOf( KlassOrInstance );\r
 447         if( i === -1 ) i = X_Class_PRIVATE_CLASS_LIST.indexOf( X_Class_getClass( KlassOrInstance ) );\r
 448         if( i !== -1 ) return X_Class_PRIVATE_DEF_LIST[ i ];\r
 449         \r
 450         if( X_Class_DEF_LIST.indexOf( KlassOrInstance ) !== -1 ) return KlassOrInstance;\r
 451         if( X_Class_PRIVATE_DEF_LIST.indexOf( KlassOrInstance ) !== -1 ) return KlassOrInstance;\r
 452 };\r
 453 \r
 454 function X_Class_newPrivate( /* instance, args */ ){\r
 455         var args         = X_Object_cloneArray( arguments ),\r
 456                 user         = args.shift(),\r
 457                 def          = X_Class_getClassDef( user ),\r
 458                 privateClass = def.privateClass,\r
 459                 privateDef   = X_Class_getClassDef( privateClass ),\r
 460                 i            = -1;\r
 461         if( def.userList ){\r
 462                 i = def.userList.indexOf( user );\r
 463         } else {\r
 464                 def.userList = [];\r
 465                 def.dataList = [];\r
 466         };\r
 467         if( i !== -1 ){\r
 468                 X.Logger.critical( 'PrivateData already exist!' );\r
 469                 return;\r
 470         };\r
 471         if( privateDef._tempUser ){\r
 472                 X.Logger.critical( 'newPrivate を連続呼び出しされたところ破綻' );\r
 473                 return;\r
 474         };\r
 475         privateDef._tempUser = user;\r
 476         return X_Class_actualConstructor( privateClass( X_Closure_COMMAND_BACK ), args );// privateClass.__new( args );\r
 477 };\r
 478 \r
 479 function X_Class_getPrivate( instance ){\r
 480         var def = X_Class_getClassDef( instance ),\r
 481                 i   = def.userList.indexOf( instance );\r
 482         if( i !== -1 ) return def.dataList[ i ];\r
 483 };\r
 484 \r
 485 /* over のプロパティを target にコピーする．ただし target の プロパティが優先, force で解除 */\r
 486 function X_Class_override( target, src, force ){\r
 487         var p;\r
 488         for( p in src ){\r
 489                 if( p === 'Constructor' ) continue;\r
 490                 if( p === '__proto__' || p === 'prototype' || p === 'constructor' ){\r
 491                         X.Logger.critical( p + ' is reserved!' );\r
 492                         return;\r
 493                 };\r
 494                 if( force || target[ p ] === undefined ){\r
 495                         target[ p ] = src[ p ];\r
 496                 };\r
 497         };\r
 498         return target;\r
 499 };\r
 500 \r
 501 /**\r
 502  * スーパークラスか？調べます。\r
 503  * @alias __ClassBase__.superClassOf\r
 504  * @param klass {__ClassBase__}\r
 505  * @return {boolean}\r
 506  */\r
 507 function X_Class_superClassOf( klass ){\r
 508         var myDef      = X_Class_getClassDef( this ),\r
 509                 targetDef  = X_Class_getClassDef( klass ),\r
 510                 SuperClass = klass;\r
 511 \r
 512         if( !myDef || !targetDef || this === klass ) return false;\r
 513         \r
 514         while( SuperClass = X_Class_getClassDef( SuperClass ).SuperClass ){\r
 515                 if( SuperClass === this ) return true;\r
 516         };\r
 517         \r
 518         return false;\r
 519 };\r
 520 \r
 521 /**\r
 522  * サブクラスか？調べます。\r
 523  * @alias __ClassBase__.subClassOf\r
 524  * @type {Function}\r
 525  * @param klass {__ClassBase__}\r
 526  * @return {boolean}\r
 527  */\r
 528 function X_Class_subClassOf( klass ){\r
 529         return klass && X_Class_superClassOf.call( klass, this );\r
 530 };\r
 531                         \r
 532 /**\r
 533  * サブクラスを作ります。与える引数は X.Class.create と同じです。http://d.hatena.ne.jp/m-hiyama/20051018/1129605002\r
 534  * @alias __ClassBase__.inherits\r
 535  * @example var SubClass = SuperClass.inherits( 'Sub', X.Class.FINAL, { ... } );\r
 536  * @param {string} [displayName] クラスの名前\r
 537  * @param {number} [classSetting=0] X.Class.POOL_OBJECT | X.Class.FINAL など\r
 538  * @param {__ClassBase__=} [privateClass] このクラスとペアで動作するシャドウクラス\r
 539  * @param {object} [props={}] このクラスのメンバと関数。コンストラクタは Constructor と書くこと\r
 540  * @return {__ClassBase__}\r
 541  */\r
 542 function X_Class_inherits( /* displayName, classSetting, opt_PrivateClass, props */ ){\r
 543         var args        = X_Object_cloneArray( arguments ),\r
 544                 params      = [],\r
 545                 Super       = this,\r
 546                 superDef    = X_Class_getClassDef( Super ),\r
 547                 displayName = args[ 0 ],\r
 548                 classSetting,\r
 549                 //opt_super,\r
 550                 klass, def;\r
 551         if( superDef.Final ) X.Logger.critical( 'X.Class inherits, Class is final!' );\r
 552         \r
 553         // サブクラス名\r
 554         if( X_Type_isString( displayName ) ){\r
 555                 args.shift();\r
 556         } else {\r
 557                 displayName = 'SubClass of ' + superDef.displayName;\r
 558         };\r
 559         params.push( displayName );\r
 560         \r
 561         // サブクラス設定\r
 562         classSetting = args[ 0 ];\r
 563         if( X_Type_isNumber( classSetting ) ){\r
 564                 args.shift();\r
 565         } else {\r
 566                 // クラス設定がない場合、親からコピーして、Abstract flag は落とす??\r
 567                 classSetting = superDef.setting;// &= ~X.Class.ABSTRACT;\r
 568         };\r
 569         if( superDef.isPrivate ) classSetting = classSetting | X.Class.PRIVATE_DATA;\r
 570 \r
 571         params.push( classSetting );\r
 572 \r
 573         // サブクラスのシャドウ\r
 574         if( args[ 0 ] && X_Class_getClass( args[ 0 ] ) ){\r
 575                 params.push( args.shift() );\r
 576         } else\r
 577         if( superDef.privateClass ){\r
 578                 params.push( superDef.privateClass );\r
 579         };\r
 580         \r
 581         /* props 未定義でも可 */\r
 582         params.push( args[ 0 ] );\r
 583         \r
 584         // 継承クラスの作成\r
 585         if( X_Class_useObjectCreate ){\r
 586                 X_Class_traits = Object.create( Super.prototype );\r
 587         } else\r
 588         if( X_Class_use_proto_ ){\r
 589                 X_Class_traits = Super.prototype;\r
 590         } else {\r
 591                 X_Class_traits = new Super( X_Closure_COMMAND_DROP );\r
 592         };\r
 593         klass  = X.Class.create.apply( X.Class, params );\r
 594         X_Class_traits = null;\r
 595         \r
 596         def    = X_Class_getClassDef( klass );\r
 597         // 継承用プロパティを控える\r
 598         def.SuperClass       = Super;\r
 599         def.SuperProto       = Super.prototype;\r
 600         def.SuperConstructor = superDef.Constructor || superDef.SuperConstructor;\r
 601         \r
 602         return klass;\r
 603 };\r
 604         \r
 605 /*\r
 606  * new の実体．コンストラクタの機能は instance.Constructor に書く．\r
 607  * これにより pool された オブジェクト（破棄されたインスタンス） を再利用できる\r
 608  */\r
 609 function X_Class_actualConstructor( f, args ){\r
 610         var klass    = f.klass,\r
 611                 def      = X_Class_getClassDef( klass ),\r
 612                 dataUser = def._tempUser,\r
 613                 instance, obj,\r
 614                 userDef;\r
 615         if( def.Abstract ){\r
 616                 X.Logger.critical( 'AbstractClass!' );\r
 617                 return;\r
 618         };\r
 619         if( def.isPrivate && !dataUser ){\r
 620                 X.Logger.critical( 'use myClass.newPrivate( instance, ...args )!' );\r
 621                 return;\r
 622         };\r
 623         \r
 624         instance = def.pool && def.pool.length > 0 ?\r
 625                                         def.pool.pop() :\r
 626                                 X_Class_useObjectCreate ?\r
 627                                         Object.create( klass.prototype ) :\r
 628                                         new klass( X_Closure_COMMAND_DROP );\r
 629         \r
 630         if( def.isPrivate ){\r
 631                 userDef = X_Class_getClassDef( dataUser );\r
 632                 userDef.dataList.push( instance );\r
 633                 userDef.userList.push( dataUser );\r
 634                 instance.User = dataUser;\r
 635                 def._tempUser = null;\r
 636         } else {\r
 637                 def.live && def.live.push( instance );\r
 638         };\r
 639 \r
 640         obj = def.Constructor ?\r
 641                         def.Constructor.apply( instance, args ) :\r
 642                 def.SuperConstructor &&\r
 643                         def.SuperConstructor.apply( instance, args );\r
 644         if( ( X_Type_isObject( obj ) && obj !== instance ) || X_Type_isFunction( obj ) ){ // Class\r
 645                 instance[ 'kill' ]();\r
 646                 return obj;\r
 647         };\r
 648         return instance;\r
 649 };\r
 650 \r
 651 console.log( 'X.Core.Class' );\r