-/**\r
- * Class を定義し システムの管理下に置く．\r
- * 全てのクラスと pool が有効の場合インスタンスへの参照が保持される．\r
- * 1. X.Class.create( opt_settings, opt_name, opt_privateClass, opt_props ) でクラスを登録．\r
- * 2. コンストラクタ となるメソッドは、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
+ X_Class_use_proto_ = !X_UA.OperaMobile && !X_UA.OperaTablet && !!X.emptyFunction.prototype.__proto__,\r
+ // Opera Mobile 12.10 Android11 IS01 でクラスのメンバが欠落する問題に遭遇。__proto__ を使わないと動作,,,\r
\r
-/* \r
- * X.Class.create で作られたクラスのインスタンスが共通で備えるメソッド \r
- */\r
-var X_Class_CommonProps = {\r
+X_Class_CommonMethods =\r
+/** @lends __ClassBase__.prototype */\r
+{\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
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
- 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
return;\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
};\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 ); //.unlisten();\r
- } else\r
- if( X.Type.isFunction( instance.onKill ) && instance.onKill() === false && !def.isPrivate ){\r
- return;\r
+ this._listeners && X_EventDispatcher_systemUnlisten( this );\r
};\r
\r
for( p in 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
data.kill();\r
};\r
};\r
},\r
\r
- // TODO Super\r
- // superCall\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
+ // TODO 現在 new しているインスタンスを保持してチェックする\r
+ Super : function( var_args ){\r
+ var sClass = this,\r
+ i = X_Class_CALLING_SUPER.indexOf( sClass ),\r
+ n = -1,\r
+ l, sList, def, sConst, ret;\r
\r
+ if( i === -1 ){\r
+ X_Class_CALLING_SUPER[ l = X_Class_CALLING_SUPER.length ] = sClass;\r
+ X_Class_CALL_SUPER_STACK[ l ] = sList = [];\r
+ } else {\r
+ sList = X_Class_CALL_SUPER_STACK[ i ];\r
+ };\r
+ \r
+ while( sClass ){\r
+ def = X_Class_getClassDef( sClass );\r
+ sClass = def.SuperClass;\r
+ sConst = def.SuperConstructor;\r
+ if( sConst && sList[ ++n ] !== sConst ){\r
+ sList[ n ] = sConst;\r
+ ret = sConst.apply( this, arguments );\r
+ --sList.length;\r
+ if( !sList.length ){\r
+ X_Class_CALLING_SUPER.splice( i, 1 );\r
+ X_Class_CALL_SUPER_STACK.splice( i, 1 );\r
+ };\r
+ return ret;\r
+ };\r
+ };\r
+ console.log( 'スーパークラスのコンストラクタが見つかりません' );\r
+ },\r
+\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( funcNameOrFunc, var_args ){\r
+ var sClass = this,\r
+ args = arguments,\r
+ name, p, sFunc, hit = false;\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
+ };\r
+ if( !name ) return;\r
+ } else {\r
+ return;\r
+ };\r
+ \r
+ if( X_EMPTY_OBJECT[ name ] ) return;\r
+ \r
+ while( sClass ){\r
+ def = X_Class_getClassDef( sClass );\r
+ sClass = def.SuperClass;\r
+ sFunc = sClass.prototype[ name ];\r
+ if( sFunc === funcNameOrFunc ){\r
+ hit = true; // 現在の関数にヒット\r
+ } else\r
+ if( hit && X_Object_inObject( name, this ) ){\r
+ if( X.Type.isFunction( sFunc ) ){\r
+ switch( args.length ){\r
+ case 1 :\r
+ return sFunc.call( this );\r
+ case 2 :\r
+ return sFunc.call( this, args[ 1 ] );\r
+ case 3 :\r
+ return sFunc.call( this, args[ 1 ], args[ 2 ] );\r
+ case 4 :\r
+ return sFunc.call( this, args[ 1 ], args[ 2 ], args[ 3 ] );\r
+ default :\r
+ args = X.Object.cloneArray( args );\r
+ args.shift();\r
+ return sFunc.apply( this, args );\r
+ };\r
+ };\r
+ break;\r
+ };\r
+ };\r
+ },\r
+ \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
return false;\r
}\r
};\r
+\r
// ------------------------------------------------------------------------- //\r
// --- interface ----------------------------------------------------------- //\r
// ------------------------------------------------------------------------- //\r
+\r
+/**\r
+ * Class を定義し システムの管理下に置く．<br>\r
+ * 全てのクラスと pool が有効の場合インスタンスへの参照が保持される．\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
+ * @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
+ */\r
POOL_OBJECT : 1,\r
+ \r
+ /**\r
+ * 定義するクラスは抽象クラスになります。new AbstractClass() とするとエラーになります。\r
+ */\r
ABSTRACT : 2,\r
+\r
+ /**\r
+ * クラスの継承を禁止する。\r
+ */\r
FINAL : 4,\r
+\r
+ /**\r
+ * 使用を中止。petanR ライブラリ使用プロジェクトから SUPER_ACCESS を消したらここも削除。\r
+ */\r
SUPER_ACCESS : 8,\r
+\r
+ /**\r
+ * 内部コード、主に X.UI フレームワークに対して、フレーム外に露出するインスタンスとペアで動作する、シャドウなインスタンスの使用を宣言する。\r
+ * Javascript はインスタンス毎のカプセル化がとてもコスト高。微妙なコスト増で隠蔽されたインスタンスを使う。\r
+ */\r
PRIVATE_DATA : 16,\r
- \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
classDef.Constructor = props.Constructor;\r
};\r
\r
- // TODO use X.Function\r
- klass = X_Closure_actualClosure( hash = { _ : X_Class_actualConstructor } );//new Function( 'var a=arguments,f=a.callee;if(f.__new)return f.__new(a)' );\r
+ klass = X_Callback_actualClosure( hash = { _ : X_Class_actualConstructor } ); // TODO hash = classDef\r
hash.c = klass;\r
- //klass.__new = X_Class_actualConstructor;\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_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
return klass;\r
},\r
\r
- _getClass : X_Class_getClass,\r
- \r
- _getClassDef : X_Class_getClassDef,\r
- \r
_newPrivate : X_Class_newPrivate,\r
\r
- _getPrivate : X_Class_getPrivate,\r
- \r
- _override : X_Class_override\r
+ _getPrivate : X_Class_getPrivate\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 === 'Super' || p === 'SuperConstructor' || p === '__proto__' || p === 'prototype' || p === 'constructor' ){\r
- X.Logger.critical( 'Super & SuperConstructor is reserved!' );\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
superDef = X_Class_getClassDef( Super ),\r
displayName = args[ 0 ],\r
classSetting,\r
- opt_super,\r
+ //opt_super,\r
klass, def;\r
if( superDef.Final ) X.Logger.critical( 'X.Class inherits, Class is final!' );\r
\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
if( superDef.privateClass ){\r
params.push( superDef.privateClass );\r
};\r
- params.push( args[ 0 ] ); /* props サブクラスでは未定義でも可 */\r
+ \r
+ /* props 未定義でも可 */\r
+ params.push( args[ 0 ] );\r
\r
// 継承クラスの作成\r
if( X_Class_useObjectCreate ){\r
if( X_Class_use_proto_ ){\r
X_Class_traits = Super.prototype;\r
} else {\r
- //Super.__new = null;\r
X_Class_traits = new Super( X_Closure_COMMAND_DROP );\r
- //Super.__new = X_Class_actualConstructor; \r
};\r
klass = X.Class.create.apply( X.Class, params );\r
X_Class_traits = null;\r
\r
def = X_Class_getClassDef( klass );\r
// 継承用プロパティを控える\r
- if( opt_super === true ){\r
- def.superAccess = true;\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
+ // else {\r
+ // def.SuperClass = Super; // instanceOf() で親クラスを調べる！\r
+ //};\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
X.Logger.critical( 'use myClass.newPrivate( instance, ...args )!' );\r
return;\r
};\r
- //klass.__new = null;\r
+ \r
instance = def.pool && def.pool.length > 0 ?\r
def.pool.pop() :\r
X_Class_useObjectCreate ?\r
Object.create( klass.prototype ) :\r
new klass( X_Closure_COMMAND_DROP );\r
- //klass.__new = X_Class_actualConstructor;\r
\r
if( def.isPrivate ){\r
userDef = X_Class_getClassDef( dataUser );\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
};\r
return instance;\r
};\r
-/* クラス定義を辿ってスーパークラスのコンストラクタを探す。\r
- * 呼び出したコンストラクタは配列に控える。\r
- * さらに呼ばれた場合、配列を元にさらに奥のコンストラクタを取得\r
- * TODO 現在 new しているインスタンスを保持してチェックする\r
- */\r
-function X_Class_superConstructor(){\r
- var sClass = this,\r
- i = X_Class_CALLING_SUPER.indexOf( sClass ),\r
- n = -1,\r
- l, sList, def, sConst, ret;\r
-\r
- if( i === -1 ){\r
- X_Class_CALLING_SUPER[ l = X_Class_CALLING_SUPER.length ] = sClass;\r
- X_Class_CALL_SUPER_STACK[ l ] = sList = [];\r
- } else {\r
- sList = X_Class_CALL_SUPER_STACK[ i ];\r
- };\r
- \r
- while( sClass ){\r
- def = X_Class_getClassDef( sClass );\r
- sClass = def.SuperClass;\r
- sConst = def.SuperConstructor;\r
- if( sConst && sList[ ++n ] !== sConst ){\r
- sList[ n ] = sConst;\r
- ret = sConst.apply( this, arguments );\r
- --sList.length;\r
- if( !sList.length ){\r
- X_Class_CALLING_SUPER.splice( i, 1 );\r
- X_Class_CALL_SUPER_STACK.splice( i, 1 );\r
- };\r
- return ret;\r
- };\r
- };\r
-};\r
\r
console.log( 'X.Core.Class' );\r
OSDN Git Service
