-/**\r
- * Class を定義し システムの管理下に置く.\r
- * 全てのクラスと pool が有効の場合インスタンスへの参照が保持される.\r
- * 1. X.Class.create( opt_settings, opt_name, opt_privateClass, opt_props ) でクラスを登録.\r
- * 2. コンストラクタ となるメソッドは、opt_props 内の Constructor : function( arg ){ ... }, に書く.\r
- * 3. 通常通り new で インスタンス生成\r
- * 4. kill() でオブジェクトをクリーンして削除、pool が有効の場合は pool される.\r
- * 5. pool が有効の場合、new で pool されたインスタンスが返される.\r
- * 6. \r
- * \r
- */\r
\r
// ------------------------------------------------------------------------- //\r
// ------------ local variables -------------------------------------------- //\r
// ------------------------------------------------------------------------- //\r
-var X_Class_CLASS_LIST = [],\r
+var\r
+ /**\r
+ * 全てのクラスのスーパークラスのようなもの。(ライブラリ内にカプセル化されているため、ユーザが触ることはありません)<br>\r
+ * X.Class.create() で定義されたクラスのインスタンスが共通で備えるメソッド を確認してください。\r
+ * @class __ClassBase__\r
+ * @private\r
+ * @abstract\r
+ */\r
+ __ClassBase__ = {\r
+ /**\r
+ * クラス名\r
+ * @type {string}\r
+ */\r
+ name : ''\r
+ },\r
+\r
+ X_Class_CLASS_LIST = [],\r
X_Class_DEF_LIST = [],\r
X_Class_PRIVATE_CLASS_LIST = [],\r
X_Class_PRIVATE_DEF_LIST = [],\r
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.emptyFunction.prototype.__proto__,\r
-\r
-/** \r
- * X.Class.create で定義されたクラスのインスタンスが共通で備えるメソッド を格納\r
- *\r
- * @class\r
- */ \r
-X_Class_CommonProps =\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
+/** @lends __ClassBase__.prototype */\r
{\r
- /*\r
- * インスタンスの破棄。\r
- * TODO kill したインスタンスのイベントが残っていないか?これは開発用のみ\r
+ /**\r
+ * 全ての動的メンバを削除して、インスタンスを破棄する。<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.KILL_INSTANCE を発火する。\r
+ * <li>dispatch 中は、インスタンスの全ての dispatch が終了するまで実際の破棄を待つ。\r
+ * <li>実際の破棄では、インスタンスのメンバの削除に加えて全てのイベントリスナを解除する。\r
*/\r
+ // TODO kill したインスタンスのイベントが残っていないか?これは開発用のみ\r
kill : function(){\r
var instance = this,\r
klass = X_Class_getClass( instance ),\r
def = X_Class_getClassDef( klass ),\r
data, p, i;\r
- if( def.isPrivate && !X_Class_killPrivateFlag ){\r
+ if( def.isPrivate && !X_Class_killPrivateFlag && ( !this[ '_listeners' ] || !this[ '_listeners' ][ X_Listeners_.KILL_RESERVED ] ) ){\r
X.Logger.critical( 'PrivateInstance.kill() work in PrivateUser.kill().' );\r
return;\r
};\r
- X_Class_killPrivateFlag = false; // onKill 内で PrivateInstance.kill() を防ぐため\r
- \r
- // onKill() === false の場合、kill のキャンセル\r
- // private は false での キャンセル は無視される\r
+ X_Class_killPrivateFlag = false; // instance.kill() 内で PrivateInstance.kill() を防ぐため\r
\r
if( this.instanceOf( X.EventDispatcher ) ){\r
- //console.log( 'this.instanceOf( X.EventDispatcher )! ' + this._dispatching );\r
if( !def.isPrivate ){\r
- if( this._dispatching ){\r
- this.dispatch( X.Event.BEFORE_KILL_INSTANCE );\r
- this._killReserved = true;\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
- } else\r
- if( this.dispatch( X.Event.BEFORE_KILL_INSTANCE ) & X.Callback.PREVENT_DEFAULT ){\r
- this.dispatch( X.Event.KILL_INSTANCE_CANCELED );\r
+ };\r
+ if( this[ '_listeners' ] && this[ '_listeners' ][ X_Listeners_.DISPATCHING ] ){\r
+ this[ '_listeners' ][ X_Listeners_.KILL_RESERVED ] = true;\r
return;\r
};\r
} else {\r
- this.dispatch( X.Event.BEFORE_KILL_INSTANCE ); \r
+ this.dispatch( X_Event.BEFORE_KILL_INSTANCE ); \r
};\r
- this.dispatch( X.Event.KILL_INSTANCE );\r
- this._listeners && X_EventDispatcher_systemUnlisten( this ); //.unlisten();\r
- } else\r
- if( X.Type.isFunction( instance.onKill ) && instance.onKill() === false && !def.isPrivate ){\r
- return;\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
+ };\r
+ };\r
+ \r
+ this.dispatch( X_Event.KILL_INSTANCE );\r
+ this._listeners && X_EventDispatcher_systemUnlisten( this );\r
};\r
\r
for( p in instance ){\r
i = def.userList.indexOf( instance );\r
if( i !== -1 ){\r
data = X_Class_getPrivate( instance );\r
- X_Class_killPrivateFlag = true;\r
- if( data._dispatching && data.instanceOf( X.EventDispatcher ) ){\r
- data._killReserved = true;\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
};\r
def.dataList.splice( i, 1 );\r
};\r
},\r
\r
- /* クラス定義を辿ってスーパークラスのコンストラクタを探す。\r
- * 呼び出したコンストラクタは配列に控える。\r
- * さらに呼ばれた場合、配列を元にさらに奥のコンストラクタを取得\r
- * TODO 現在 new しているインスタンスを保持してチェックする\r
+ /**\r
+ * 関数は Constructor 内で使用します。クラス定義を辿ってスーパークラスのコンストラクタを探します。<br>\r
+ * 内部的には、呼び出したコンストラクタは配列に控え(X_Class_CALLING_SUPER)、呼び出したコンストラクタ内でさらに Super が呼ばれた場合、配列を元にさらにスーパーなコンストラクタを辿ります。\r
+ * @example Constructor : function( arg1, arg2 ){\r
+ * this.Super( aeg1, arg2 );\r
+ * }\r
+ * @param var_args {...?} 親コンストラクタを呼ぶ際に渡す任意の数の引数\r
+ * @return {*}\r
*/\r
- Super : function(){\r
+ // TODO 現在 new しているインスタンスを保持してチェックする\r
+ Super : function( var_args ){\r
var sClass = this,\r
i = X_Class_CALLING_SUPER.indexOf( sClass ),\r
n = -1,\r
return ret;\r
};\r
};\r
- console.log( 'ã\82¹ã\83¼ã\83\91ã\83¼ã\82¯ã\83©ã\82¹ã\81®ã\82³ã\83³ã\82¹ã\83\88ã\83©ã\82¯ã\82¿ã\81\8cè¦\8bã\81¤ã\81\8bã\81\84ません' );\r
+ console.log( 'ã\82¹ã\83¼ã\83\91ã\83¼ã\82¯ã\83©ã\82¹ã\81®ã\82³ã\83³ã\82¹ã\83\88ã\83©ã\82¯ã\82¿ã\81\8cè¦\8bã\81¤ã\81\8bã\82\8aません' );\r
},\r
\r
- /*\r
- * func について、親クラスで設定されている同名の関数メンバーを呼び出す\r
- * 2つ以上の異なる名前で同じ関数がメンバーだった場合、失敗します\r
- * 例) this.superCall( arguments.callee, param0, param1, ... )\r
+ /**\r
+ * func について、親クラスで設定されている同名の関数メンバーを呼び出す。<br>\r
+ * 第一引数に関数を指定し、2つ以上の異なる名前で同じ関数がメンバーがいた場合、動作が不確実になります。<br>\r
+ * 参考:<a href="http://qiita.com/no22@github/items/d3bead2acbb7ff1fb86b" target="_blank">ES5なJavascriptでモダンなクラス的継承&スーパー呼び出し </a>\r
+ * @param funcNameOrFunc {Function|string} スーパークラスの関数名 または、オーバーライド済の自身の関数。\r
+ * @param var_args {...*} オーバーライド元関数に渡す任意の数の引数\r
+ * @example return this.superCall( arguments.callee, param0, param1, ... );\r
+ * @return {*} オーバーライド元の関数を呼び出した戻り値。\r
*/\r
- superCall : function( func /* ...args */ ){\r
+ superCall : function( funcNameOrFunc, var_args ){\r
var sClass = this,\r
args = arguments,\r
name, p, sFunc, hit = false;\r
- if( X.Type.isFunction( func ) ){\r
- for( p in this ){\r
- if( this[ p ] === func ){\r
+ if( X_Type_isFunction( funcNameOrFunc ) ){\r
+ for( p in this.constructor.prototype ){\r
+ if( this.constructor.prototype[ p ] === funcNameOrFunc ){\r
name = p;\r
break;\r
};\r
def = X_Class_getClassDef( sClass );\r
sClass = def.SuperClass;\r
sFunc = sClass.prototype[ name ];\r
- if( sFunc === func ){\r
+ if( sFunc === funcNameOrFunc ){\r
hit = true; // 現在の関数にヒット\r
} else\r
if( hit && X_Object_inObject( name, this ) ){\r
- if( X.Type.isFunction( sFunc ) ){\r
+ if( X_Type_isFunction( sFunc ) ){\r
switch( args.length ){\r
case 1 :\r
return sFunc.call( this );\r
};\r
},\r
\r
- /*\r
- * TODO instanceof に対応したブラウザはそちらを使用\r
+ /**\r
+ * インスタンスのクラスか?またはスーパークラスか?調べる。<br>\r
+ * instanceof 構文をサポートしない環境(IE4,Mac IE5)を想定する場合、必ずこのメソッドを使用すること。<br>\r
+ * クラスのインスタンスか?だけ調べたい場合は this.constructor === klass が高速。\r
+ * @param klass {__ClassBase__} クラス定義\r
+ * @return {boolean}\r
*/\r
+ // TODO instanceof に対応したブラウザはそちらを使用\r
instanceOf : function( klass ){\r
var Super = this;\r
if( this.constructor === klass ) return true;\r
}\r
};\r
\r
-\r
// ------------------------------------------------------------------------- //\r
// --- interface ----------------------------------------------------------- //\r
// ------------------------------------------------------------------------- //\r
\r
-/** @namespace */ \r
+/**\r
+ * <p>Class を定義し システムの管理下に置く。\r
+ * <p>prototype 継承のブラウザ毎の差異も吸収し、 以下から最適な方法をしてくれる。\r
+ * \r
+ * <ol>\r
+ * <li>Object.create はパフォーマンスが悪そうなので現在は使っていない。\r
+ * <li>SubClass.prototype.__proto__ = SuperClass.prototype;\r
+ * <li>SubClass.prototype = new SuperClass;\r
+ * </ol>\r
+ * \r
+ * <ol>\r
+ * <li>X.Class.create( opt_settings, opt_name, opt_privateClass, opt_props ) でクラスを登録.\r
+ * <li>コンストラクタ となるメソッドは、opt_props 内の Constructor : function( arg ){ ... }, に書く.\r
+ * <li>通常通り new で インスタンス生成\r
+ * <li>kill() でオブジェクトをクリーンして削除、pool が有効の場合は pool される.\r
+ * <li>pool が有効の場合、new で pool されたインスタンスが返される.\r
+ * </ol>\r
+ * @namespace X.Class\r
+ * @alias X.Class\r
+ */ \r
X.Class = {\r
+\r
+ /**\r
+ * 設定なし。\r
+ */ \r
+ NONE : 0,\r
+ \r
/**\r
* インスタンスは破棄時(this.kill())に回収され、次回の new MyClass() 時に再利用されます。\r
- * @memberof X.Class */\r
+ */\r
POOL_OBJECT : 1,\r
\r
/**\r
* 定義するクラスは抽象クラスになります。new AbstractClass() とするとエラーになります。\r
- * @memberof X.Class */\r
+ */\r
ABSTRACT : 2,\r
- \r
- \r
- /** @memberof X.Class */\r
+\r
+ /**\r
+ * クラスの継承を禁止する。\r
+ */\r
FINAL : 4,\r
- /** @memberof X.Class */\r
+\r
+ /**\r
+ * 使用を中止。petanR ライブラリ使用プロジェクトから SUPER_ACCESS を消したらここも削除。\r
+ */\r
SUPER_ACCESS : 8,\r
- /** @memberof X.Class */\r
+\r
+ /**\r
+ * 内部コード、主に X.UI フレームワークに対して、フレーム外に露出するインスタンスとペアで動作する、シャドウなインスタンスの使用を宣言する。\r
+ * Javascript はインスタンス毎のカプセル化がとてもコスト高。微妙なコスト増で隠蔽されたインスタンスを使う。\r
+ */\r
PRIVATE_DATA : 16,\r
- /** @memberof X.Class */\r
- SINGLETON : 32, // 未実装\r
- \r
- create : function( /* displayName, classSetting, opt_PrivateClass, props */ ){\r
+\r
+ /**\r
+ * 未実装。でも目印になるので付けておきましょう。\r
+ */\r
+ SINGLETON : 32,\r
+\r
+ /**\r
+ * クラスを定義する。<br>\r
+ * 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
var args = X_Object_cloneArray( arguments ),\r
displayName = args[ 0 ],\r
classSetting,\r
props,\r
klass,\r
classDef = {}, hash;\r
- if( X.Type.isString( displayName ) === true ){\r
+ if( X_Type_isString( displayName ) === true ){\r
classDef.displayName = displayName;\r
args.shift();\r
};\r
\r
// クラス設定\r
classDef.setting = classSetting = args[ 0 ];\r
- if( X.Type.isNumber( classSetting ) ){\r
+ if( X_Type_isNumber( classSetting ) ){\r
opt_pool = !!( classSetting & X.Class.POOL_OBJECT );\r
opt_abstract = !!( classSetting & X.Class.ABSTRACT );\r
opt_final = !!( classSetting & X.Class.FINAL );\r
\r
// インスタンスのメンバー\r
props = args[ 0 ];\r
- if( !X.Type.isObject( props ) ){\r
- // サブクラスの場合、クラス定義の上書きがなくても作成可能\r
- // サブクラスでなくても、クラスメンバ用オブジェクトが無しでも作成可能\r
- //if( !X_Class_traits ){\r
- // X.Logger.critical( 'No Class Def!' );\r
- // return;\r
- //};\r
+ if( !X_Type_isObject( props ) ){\r
+ // クラスメンバ用オブジェクトが無しでもクラスは作成可能\r
props = {};\r
} else\r
- if( props.Constructor && X.Type.isFunction( props.Constructor ) ){\r
+ if( props.Constructor && X_Type_isFunction( props.Constructor ) ){\r
classDef.Constructor = props.Constructor;\r
};\r
\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_CommonProps, false );\r
+ klass.prototype = X_Class_override( X_Class_override( X_Class_traits || klass.prototype, props, true ), X_Class_CommonMethods, false );\r
klass.prototype.constructor = klass;\r
} else\r
if( X_Class_use_proto_ ){\r
if( X_Class_traits ){\r
klass.prototype.__proto__ = X_Class_traits;\r
} else {\r
- X_Class_override( klass.prototype, X_Class_CommonProps, false );\r
+ X_Class_override( klass.prototype, X_Class_CommonMethods, false );\r
};\r
} else {\r
- klass.prototype = X_Class_override( X_Class_override( X_Class_traits || klass.prototype, props, true ), X_Class_CommonProps, false );\r
+ klass.prototype = X_Class_override( X_Class_override( X_Class_traits || klass.prototype, props, true ), X_Class_CommonMethods, false );\r
klass.prototype.constructor = klass;\r
};\r
+ \r
klass.name = displayName;\r
\r
if( opt_abstract ){\r
\r
};\r
\r
+\r
+\r
// ------------------------------------------------------------------------- //\r
// --- implements ---------------------------------------------------------- //\r
// ------------------------------------------------------------------------- //\r
function X_Class_override( target, src, force ){\r
var p;\r
for( p in src ){\r
+ if( p === 'Constructor' ) continue;\r
if( p === '__proto__' || p === 'prototype' || p === 'constructor' ){\r
X.Logger.critical( p + ' is reserved!' );\r
return;\r
};\r
- if( force || target[ p ] === void 0 ){\r
+ if( force || target[ p ] === undefined ){\r
target[ p ] = src[ p ];\r
};\r
};\r
return target;\r
};\r
\r
+/**\r
+ * スーパークラスか?調べます。\r
+ * @alias __ClassBase__.superClassOf\r
+ * @param klass {__ClassBase__}\r
+ * @return {boolean}\r
+ */\r
function X_Class_superClassOf( klass ){\r
var myDef = X_Class_getClassDef( this ),\r
targetDef = X_Class_getClassDef( klass ),\r
return false;\r
};\r
\r
+/**\r
+ * サブクラスか?調べます。\r
+ * @alias __ClassBase__.subClassOf\r
+ * @type {Function}\r
+ * @param klass {__ClassBase__}\r
+ * @return {boolean}\r
+ */\r
function X_Class_subClassOf( klass ){\r
- return X_Class_superClassOf.call( klass, this );\r
+ return klass && X_Class_superClassOf.call( klass, this );\r
};\r
- \r
-/* サブクラスを作るメソッド \r
- * var subClass = superClass.inherits( ... ) \r
- * http://d.hatena.ne.jp/m-hiyama/20051018/1129605002\r
+ \r
+/**\r
+ * サブクラスを作ります。与える引数は X.Class.create と同じです。http://d.hatena.ne.jp/m-hiyama/20051018/1129605002\r
+ * @alias __ClassBase__.inherits\r
+ * @example var SubClass = SuperClass.inherits( 'Sub', X.Class.FINAL, { ... } );\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
function X_Class_inherits( /* displayName, classSetting, opt_PrivateClass, props */ ){\r
var args = X_Object_cloneArray( arguments ),\r
if( superDef.Final ) X.Logger.critical( 'X.Class inherits, Class is final!' );\r
\r
// サブクラス名\r
- if( X.Type.isString( displayName ) ){\r
+ if( X_Type_isString( displayName ) ){\r
args.shift();\r
} else {\r
displayName = 'SubClass of ' + superDef.displayName;\r
\r
// サブクラス設定\r
classSetting = args[ 0 ];\r
- if( X.Type.isNumber( classSetting ) ){\r
+ if( X_Type_isNumber( classSetting ) ){\r
args.shift();\r
} else {\r
// クラス設定がない場合、親からコピーして、Abstract flag は落とす??\r
classSetting = superDef.setting;// &= ~X.Class.ABSTRACT;\r
};\r
if( superDef.isPrivate ) classSetting = classSetting | X.Class.PRIVATE_DATA;\r
- //opt_super = !!( classSetting & X.Class.SUPER_ACCESS );\r
+\r
params.push( classSetting );\r
\r
// サブクラスのシャドウ\r
\r
def = X_Class_getClassDef( klass );\r
// 継承用プロパティを控える\r
- //if( opt_super === true ){\r
- //def.superAccess = true;\r
- def.SuperClass = Super;\r
- def.SuperProto = Super.prototype;\r
- def.SuperConstructor = superDef.Constructor || superDef.SuperConstructor;\r
- // else {\r
- // def.SuperClass = Super; // instanceOf() で親クラスを調べる!\r
- //};\r
+ def.SuperClass = Super;\r
+ def.SuperProto = Super.prototype;\r
+ def.SuperConstructor = superDef.Constructor || superDef.SuperConstructor;\r
\r
return klass;\r
};\r
* new の実体.コンストラクタの機能は instance.Constructor に書く.\r
* これにより pool された オブジェクト(破棄されたインスタンス) を再利用できる\r
*/\r
-function X_Class_actualConstructor( obj, args ){\r
- var klass = obj.c,//this,\r
+function X_Class_actualConstructor( f, args ){\r
+ var klass = f.c,\r
def = X_Class_getClassDef( klass ),\r
dataUser = def._tempUser,\r
instance, obj,\r
} else {\r
def.live && def.live.push( instance );\r
};\r
- //if( def.superAccess ){\r
- // TODO klass.prototype に移動\r
- //instance.Super = def.SuperProto;\r
- //instance.SuperConstructor = X_Class_superConstructor;\r
- //};\r
+\r
obj = def.Constructor ?\r
def.Constructor.apply( instance, args ) :\r
def.SuperConstructor &&\r
def.SuperConstructor.apply( instance, args );\r
- if( ( X.Type.isObject( obj ) && obj !== instance ) || X.Type.isFunction( obj ) ){ // Class\r
+ if( ( X_Type_isObject( obj ) && obj !== instance ) || X_Type_isFunction( obj ) ){ // Class\r
instance.kill();\r
return obj;\r
};\r