\r
\r
/**\r
- * 通信のキャンセル 通信中の場合は停止&破棄する kill(), busy() メソッドだけを持つ。X.Pair によって、プライベートメンバは隠蔽される。X_EVENT_PROGRESS, X_EVENT_SUCCESS, X_EVENT_ERROR, X_EVENT_TIMEOUT, X_EVENT_CANCELED\r
- * 通信待ち中はキャンセル&破棄、通信中の場合は通信の中断&破棄を行う。\r
- * SUCCESS, ERROR, TIMEOUT イベント以降は kill() は無視される。X.Net インスタンスは COMPLETE で自動で破棄される。\r
+ * <p>busy() メソッドだけを持つ。通信用のプロパティは X.Pair によって隠蔽される。\r
+ * <h4>通信のキャンセル</h4>\r
+ * <p>kill() で通信待ち中はキャンセル&破棄、通信中の場合は通信の中断&破棄を行う。SUCCESS, ERROR, TIMEOUT イベント以降は kill() は無視される。\r
+ * <h4>イベント</h4>\r
+ * <dl>\r
+ * <dt>X.Event.PROGRESS<dd>通信進行状況\r
+ * <dt>X.Event.SUCCESS<dd>通信成功\r
+ * <dt>X.Event.ERROR<dd>通信エラー\r
+ * <dt>X.Event.TIMEOUT<dd>通信タイムアウト\r
+ * <dt>X.Event.CANCELED<dd>通信のユーザー、プログラムによるキャンセル\r
+ * <dt>X.Event.COMPLETE<dd>通信完了。SUCCESS, ERROR, TIMEOUT, CANCELED 後に発生。\r
+ * </dl>\r
+ * <p>X.Net インスタンスは COMPLETE 後に自動で破棄される。\r
+ * <h4>必須プロパティ</h4>\r
+ * <dl>\r
+ * <dt>url<dd>URL\r
+ * <dt>type<dd>'xhr', 'jsonp', 'image', 'img'\r
+ * <dt>xhr<dd>URL { url : 'hoge', type : 'xhr' } の省略形\r
+ * <dt>jsonp<dd>URL { url : 'hoge', type : 'jsonp' } の省略形\r
+ * <dt>image, img<dd>URL { url : 'hoge', type : 'image' } の省略形\r
+ * </dl>\r
+ * <h4>XHR 用プロパティ</h4>\r
+ * <dl>\r
+ * <dt>method<dd>'GET', 'POST' 未指定かつ postdata を設定している場合、'POST' になる。\r
+ * <dt>postdata<dd>string, object の場合は X.String.serialize される。\r
+ * <dt>async<dd>boolean\r
+ * <dt>username<dd>BASIC 認証\r
+ * <dt>password<dd>BASIC 認証\r
+ * <dt>headers<dd>object xhr.setRequestHeader する値\r
+ * <dt>timeout<dd>タイムアウト ms\r
+ * <dt>cache<dd>headers[ 'Pragma' ] = 'no-cache' 等を設定するか?\r
+ * <dt>dataType<dd>'text', 'json', 'xml', 'blob', 'arraybuffer' 等。xhr.responseType に指定する値\r
+ * <dt>mimeType<dd>'text/xml', 'audio/mpeg' 等。xhr.overrideMimeType する値\r
+ * <dt>auth<dd>X.OAuth2 インスタンス(OAuth2 サービスの定義)\r
+ * </dl>\r
+ * \r
* @alias X.Net\r
* @class 各種ネットワーク機能をラップしインターフェイスを共通化する。\r
* @constructs Net\r
'X.Net',\r
X_Class.NONE,\r
{\r
+ 'netType' : '',\r
+ 'netName' : '',\r
+ 'netVersion' : 0,\r
+ \r
'Constructor' : function( urlOrObject, opt_options ){\r
var v, opt, url, type;\r
\r
return;\r
};\r
\r
+ opt = X_Object_deepCopy( opt );\r
+ opt.netType = type;\r
+ opt[ 'url' ] = url; \r
+ \r
if( type === X_NET_TYPE_XHR ){\r
opt[ 'method' ] = opt[ 'method' ] || ( opt[ 'postdata' ] ? 'POST' : 'GET' );\r
\r
// XDomain 不可 -> Flash, Gears, Silverlight, canUseGadget なら gadget に切替?\r
// PUT DELETE UPDATE 不可 -> Flash, Gears, Silverlight, canUseGadget なら gadget に切替?\r
+ // xプロトコル な binary のロード -> gadget 内で proxyURL による XHR\r
// or X_EVENT_ERROR\r
\r
- }; \r
- \r
- opt = X_Object_deepCopy( opt );\r
- opt.netType = type;\r
- opt[ 'url' ] = url;\r
+ opt[ 'dataType' ] = opt[ 'dataType' ] || X_URL_getEXT( url );\r
+ };\r
\r
X_Pair_create( this, opt );\r
\r
if( flag ){ // flag が立つ場合、これは中断\r
this[ 'dispatch' ]( X_EVENT_CANCELED );\r
this[ 'dispatch' ]( { type : X_EVENT_COMPLETE, 'lastEventType' : X_EVENT_CANCELED } );\r
- X_Pair_release( this ); \r
+ X_Pair_release( this );\r
};\r
break; \r
case X_EVENT_PROGRESS :\r
\r
case X_EVENT_ERROR :\r
if( e.status === 401 ){\r
- auth = X_Pair_get( this )[ 'auth' ];\r
- if( auth ){\r
+ if( auth = X_Pair_get( this )[ 'auth' ] ){\r
X_Pair_get( auth ).onAuthError( auth );\r
};\r
};\r
\r
switch( X_NET_currentData.netType ){\r
case X_NET_TYPE_XHR :\r
- X_NET_currentWrapper = X_NET_XHRWrapper || X_TEMP.X_Net_XHR_init();\r
- // TODO OAuth2\r
- // oauth2.authState() -> NEED_AUTH -> COMPLETE, refresh 中なら後回し。\r
\r
+ // TODO (xProtocol | method) & canUse -> gadget.io.makeRequset, flash\r
+ // force 'gadget', 'flash'\r
+ switch( X_NET_currentData[ 'test' ] ){\r
+ case 'gadget' :\r
+ X_NET_currentWrapper = X_NET_GIMRWrapper || X_TEMP.X_Net_GIMR_init();\r
+ break;\r
+ case 'flash' :\r
+ break;\r
+ default :\r
+ X_NET_currentWrapper = X_NET_XHRWrapper || X_TEMP.X_Net_XHR_init();\r
+ };\r
+ \r
+ \r
+ // OAuth2\r
if( auth = X_NET_currentData[ 'auth' ] ){\r
authSettings = X_Pair_get( auth );\r
switch( auth.state() ){\r
OSDN Git Service
