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