0.6.x/js/06_net/00_XNet.js

   1 // TODO  onlineevent offlineevent, netspeed\r
   2 // local への通信に対しては、netspeed を更新しない\r
   3 \r
   4 // http://bugs.jquery.com/ticket/2709\r
   5 // <head><base> がある場合、<script>の追加に失敗する\r
   6 \r
   7 \r
   8 \r
   9 /**\r
  10  * <p>state() メソッドだけを持つ。通信用のプロパティは X.Pair によって隠蔽されています。\r
  11  * <h4>通信のキャンセル</h4>\r
  12  * <p>kill() で通信待ち中はキャンセル&破棄、通信中の場合は通信の中断&破棄を行う。\r
  13  * <h4>イベント</h4>\r
  14  * <dl>\r
  15  * <dt>X.Event.PROGRESS<dd>通信進行状況\r
  16  * <dt>X.Event.SUCCESS<dd>通信成功\r
  17  * <dt>X.Event.ERROR<dd>通信エラー　タイムアウトの場合、e.timeout == true で分かる。\r
  18  * <dt>X.Event.CANCELED<dd>通信のユーザー、プログラムによるキャンセル。SUCCESS, ERROR, COMPLETE 後に kill()してもCANCELEDは呼ばれません。\r
  19  * <dt>X.Event.COMPLETE<dd>通信完了。SUCCESS, ERROR, CANCELED 後に発生。\r
  20  * </dl>\r
  21  * <p>X.Net インスタンスは COMPLETE 後に自動で破棄される。\r
  22  * <h4>必須プロパティ</h4>\r
  23  * <dl>\r
  24  * <dt>url<dd>URL\r
  25  * <dt>type<dd>'xhr', 'jsonp', 'form', 'image', 'img'\r
  26  * <dt>xhr<dd>URL { url : 'hoge', type : 'xhr' } の省略形\r
  27  * <dt>jsonp<dd>URL { url : 'hoge', type : 'jsonp' } の省略形\r
  28  * <dt>form<dd>URL { url : 'hoge', type : 'form' } の省略形\r
  29  * <dt>image, img<dd>URL { url : 'hoge', type : 'image' } の省略形\r
  30  * </dl>\r
  31  * <h4>XHR 用プロパティ</h4>\r
  32  * <dl>\r
  33  * <dt>method<dd>'GET', 'POST' 未指定かつ postdata を設定している場合、'POST' になる。\r
  34  * <dt>params<dd>url パラメータを object で渡すことが出来る。\r
  35  * <dt>postdata<dd>string, object の場合は X.String.serialize される。\r
  36  * <dt>async<dd>boolean\r
  37  * <dt>username<dd>BASIC 認証\r
  38  * <dt>password<dd>BASIC 認証\r
  39  * <dt>headers<dd>object xhr.setRequestHeader する値\r
  40  * <dt>timeout<dd>タイムアウト ms\r
  41  * <dt>cache<dd>headers[ 'Pragma' ] = 'no-cache' 等を設定するか?\r
  42  * <dt>dataType<dd>'text', 'json', 'xml', 'blob', 'arraybuffer' 等。xhr.responseType に指定する値\r
  43  * <dt>mimeType<dd>'text/xml', 'audio/mpeg' 等。xhr.overrideMimeType する値\r
  44  * <dt>auth<dd>X.OAuth2 インスタンス(OAuth2 サービスの定義)\r
  45  * <dt>getFullHeaders<dd>getAllResponseHeaders() をパースしたハッシュを返す。値は配列になっている。XDR は Content-Type しか取得でいない。\r
  46  * <dt>canUse<dd>未実装。gadget proxy, YQL, <del>YPipes</del> 等のマッシュアップの許可。現在は test : 'gadget' としている\r
  47  * </dl>\r
  48  * \r
  49  * <h4>JSONP 用プロパティ</h4>\r
  50  * <dl>\r
  51  * <dt>params<dd>url パラメータを object で渡すことが出来る。\r
  52  * <dt>callbackName<dd>callback(json) コールバック名が固定されている際に指定。または &callback=hoge 以外の名前でコールバックを指定する場合に params と callbackName に書いておく。url パラメータに callback が無く、callbackName もない場合、フレームワーク内で自動で設定される\r
  53  * <dt>charset<dd>ページと異なるjsonpを読み込む場合に指定 'EUC-JP', 'Shift-JIS' 等 script タグの charset に入る。https://code.google.com/p/ajaxzip3/issues/detail?id=5\r
  54  * <dt>useFireWall<dd>異なるドメインに jsonp を読み込んだ後、xdomain iframe 通信を使ってデータを受け取る。不正なコードの実行を防ぐことが出来る(はず)、未実装\r
  55  * </dl>\r
  56  * \r
  57  * <h4>Form 用プロパティ</h4>\r
  58  * <dl>\r
  59  * <dt>method<dd>'GET' or 'POST'\r
  60  * <dt>params<dd>パラメータ object は input タグの name & value に展開される。object を入れ子にすることはできない。\r
  61  * <dt>target<dd>'_self', '_parent', '_top' の場合、ページから離脱する。target を指定せず同一ドメインの場合 response に body.innerHTML が返る。TODO X.Window\r
  62  * <dt>timeout<dd>ms タイムアウト時間、省略可能\r
  63  * <dt>charset<dd>未実装\r
  64  * </dl>\r
  65  * \r
  66  * @alias X.Net\r
  67  * @class 各種ネットワーク機能をラップしインターフェイスを共通化する。\r
  68  * @constructs Net\r
  69  * @extends {EventDispatcher}\r
  70  * @example // XHR - GET\r
  71  * var net = X.Net( { xhr : urlString } )\r
  72  *              .listen( X.Event.PROGRESS )\r
  73  *              .listenOnce( [ X.Event.SUCCESS, X.Event.ERROR, X.Event.TIMEOUT, X.Event.CANCELED ] );\r
  74  * \r
  75  * // XHR - GET \r
  76  * var net = X.Net( urlString );\r
  77  * \r
  78  * // XHR - POST \r
  79  * var net = X.Net( { xhr : urlString, postdata : myData } );\r
  80  * \r
  81  * // JSONP\r
  82  * var net = X.Net( { jsonp : urlString, params : params, callbackName : callbackName, charset : charset, useFireWall : false } );\r
  83  * \r
  84  * // Form\r
  85  * var net = X.Net( { form : urlString, method : 'POST', target : '_self', params : {} } );\r
  86  * \r
  87  * // Image preload & getSize\r
  88  * var net = X.Net( { image : src, sizeDetection : true } );\r
  89  * \r
  90  * // load &lt;script&gt;, &lt;link&gt;\r
  91  */\r
  92 X[ 'Net' ] = X_EventDispatcher[ 'inherits' ](\r
  93                 'X.Net',\r
  94                 X_Class.NONE,\r
  95                 {\r
  96                         \r
  97                         'Constructor' : function( urlOrObject, opt_options ){\r
  98                                 var opt, url, type, auth;\r
  99                                 \r
 100                                 if( X_Type_isObject( opt = urlOrObject ) ){\r
 101                                         //{+xhr\r
 102                                         if( X_Type_isString( url = opt[ 'xhr' ] ) ){\r
 103                                                 type = X_NET_TYPE_XHR;\r
 104                                         } else\r
 105                                         //}+xhr\r
 106                                         //{+jsonp\r
 107                                         if( X_Type_isString( url = opt[ 'jsonp' ] ) ){\r
 108                                                 type = X_NET_TYPE_JSONP;\r
 109                                         } else\r
 110                                         //}+jsonp\r
 111                                         //{+netimage\r
 112                                         if( X_Type_isString( url = opt[ 'img' ] || opt[ 'image' ] ) ){\r
 113                                                 type = X_NET_TYPE_IMAGE;\r
 114                                         } else\r
 115                                         //}+netimage\r
 116                                         //{+netform\r
 117                                         if( X_Type_isString( url = opt[ 'form' ] ) ){\r
 118                                                 type = X_NET_TYPE_FORM;\r
 119                                         } else\r
 120                                         //}+netform\r
 121                                         if( !( type = X_NET_NAME_TO_ID[ opt[ 'type' ] ] ) ){\r
 122                                                 //{+dev\r
 123                                                 alert( 'X.Net args error' );\r
 124                                                 //}+dev\r
 125                                                 return;\r
 126                                         } else {\r
 127                                                 url = opt[ 'url' ];\r
 128                                         };\r
 129                                         //{+dev\r
 130                                         if( !X_Type_isString( url ) ){\r
 131                                                 alert( 'X.Net args error' );\r
 132                                                 return;\r
 133                                         };\r
 134                                         //}+dev\r
 135                                 } else\r
 136                                 if( X_Type_isString( urlOrObject ) ){\r
 137                                         url = urlOrObject;\r
 138                                         \r
 139                                         if( X_Type_isObject( opt = opt_options ) ){\r
 140                                                 type = opt[ 'type' ] || X_NET_TYPE_XHR;\r
 141                                         } else {\r
 142                                                 type = X_NET_TYPE_XHR;\r
 143                                                 opt  = { 'url' : url, 'method' : 'GET' };\r
 144                                         };\r
 145                                 //{+dev \r
 146                                 } else {\r
 147                                         alert( 'X.Net args error' );\r
 148                                         return;\r
 149                                 //}+dev\r
 150                                 };\r
 151                                 \r
 152                                 // auth の退避\r
 153                                 if( auth = opt[ 'auth' ] ){\r
 154                                         delete opt[ 'auth' ];\r
 155                                 };\r
 156                                 opt = X_Object_deepCopy( opt );\r
 157                                 if( auth ){\r
 158                                         opt[ 'auth' ] = auth; // auth は deep copy されるとまずい\r
 159                                 };\r
 160                                 \r
 161                                 // params を url に追加 但し form は除く\r
 162                                 if( opt[ 'params' ] && type !== X_NET_TYPE_FORM ){\r
 163                                         url = X_URL_create( url, opt[ 'params' ] );\r
 164                                         delete opt[ 'params' ];\r
 165                                 };                              \r
 166                                 \r
 167                                 if( type === X_NET_TYPE_XHR ){\r
 168                                         opt[ 'method' ] = opt[ 'method' ] || ( opt[ 'postdata' ] ? 'POST' : 'GET' );\r
 169 \r
 170                                         // XDomain 不可 -> Flash, Gears, Silverlight, canUseGadget なら gadget に切替?\r
 171                                         // PUT DELETE UPDATE 不可 -> Flash, Gears, Silverlight, canUseGadget なら gadget に切替?\r
 172                                         // xプロトコル(X_URL_isSameProtocol) な binary のロード -> gadget 内で proxyURL による XHR\r
 173                                         //  or X_EVENT_ERROR\r
 174                                         \r
 175                                         opt[ 'dataType' ] = opt[ 'dataType' ] || X_URL_getEXT( url );\r
 176                                 };\r
 177                                 \r
 178                                 opt.netType   = type;\r
 179                                 opt[ 'url'  ] = url;\r
 180                                 \r
 181                                 X_Pair_create( this, opt );\r
 182                                 \r
 183                                 this[ 'listen' ]( X_EVENT_KILL_INSTANCE, X_NET_proxyDispatch );\r
 184                                 \r
 185                                 X_NET_QUEUE_LIST[ X_NET_QUEUE_LIST.length ] = this;\r
 186                                 !X_NET_currentQueue && X_NET_shiftQueue();\r
 187                         },\r
 188 \r
 189                 /**\r
 190                  * 現在の状態。1:順番待ち, 2:通信中, 3:通信完了フェーズ\r
 191                  * @alias Net.prototype.state\r
 192                  */\r
 193                         'state' : function(){\r
 194                                 return this === X_NET_currentQueue ?\r
 195                                         ( X_NET_completePhase ? 3 : 2 ) :\r
 196                                         0 <= X_NET_QUEUE_LIST.indexOf( this ) ? 1 : 0;\r
 197                         }\r
 198                 }\r
 199         );\r
 200 /*\r
 201  * @interface\r
 202  */\r
 203 var X_NET_IWrapper = function(){};\r
 204         X_NET_IWrapper.prototype.load   = function(){};\r
 205         X_NET_IWrapper.prototype.cancel = function(){};\r
 206         X_NET_IWrapper.prototype.reset  = function(){};\r
 207 \r
 208 \r
 209 var X_NET_TYPE_XHR   = 1,\r
 210         X_NET_TYPE_JSONP = 2,\r
 211         X_NET_TYPE_FORM  = 3,\r
 212         X_NET_TYPE_IMAGE = 4,\r
 213 \r
 214         X_NET_NAME_TO_ID = {\r
 215                 'xhr'   : X_NET_TYPE_XHR,\r
 216                 'jsonp' : X_NET_TYPE_JSONP,\r
 217                 'form'  : X_NET_TYPE_FORM,\r
 218                 'img'   : X_NET_TYPE_IMAGE,\r
 219                 'image' : X_NET_TYPE_IMAGE\r
 220         },\r
 221 \r
 222         X_NET_QUEUE_LIST = [],\r
 223 \r
 224         X_XHR,\r
 225         X_JSONP,\r
 226         X_FormSender,\r
 227         X_ImgLoader,\r
 228         X_GadgetXHR,\r
 229 \r
 230         X_NET_currentWrapper,\r
 231         X_NET_currentQueue,\r
 232         X_NET_currentData,\r
 233         X_NET_completePhase;\r
 234 \r
 235 function X_NET_proxyDispatch( e ){\r
 236         var i, flag, auth;\r
 237         \r
 238         switch( e.type ){\r
 239                 case X_EVENT_KILL_INSTANCE :\r
 240                         if( this === X_NET_currentQueue && X_NET_completePhase ){\r
 241                                 if( X_NET_completePhase === 1 ){\r
 242                                         this[ 'unlisten' ]( X_EVENT_COMPLETE, X_NET_proxyDispatch )\r
 243                                                 [ 'dispatch' ]( X_EVENT_COMPLETE );\r
 244                                 };\r
 245                                 X_NET_shiftQueue( true );\r
 246                                 X_Pair_release( this );\r
 247                                 X_NET_completePhase = 0;\r
 248                         } else\r
 249                         if( this === X_NET_currentQueue ){\r
 250                                 X_NET_currentWrapper.cancel();\r
 251                                 X_NET_shiftQueue( true );\r
 252                                 flag = true;\r
 253                         } else\r
 254                         if( ( i = X_NET_QUEUE_LIST.indexOf( this ) ) !== -1 ){\r
 255                                 X_NET_QUEUE_LIST.splice( i, 1 );\r
 256                                 flag = true;\r
 257                         };\r
 258                         \r
 259                         if( flag ){ // flag が立つ場合、これは中断\r
 260                                 this[ 'dispatch' ]( X_EVENT_CANCELED );\r
 261                                 this[ 'dispatch' ]( { type : X_EVENT_COMPLETE, 'lastEventType' : X_EVENT_CANCELED } );\r
 262                                 X_Pair_release( this );\r
 263                         };\r
 264                         break;                  \r
 265                 case X_EVENT_PROGRESS :\r
 266                         this[ 'dispatch' ]( e );\r
 267                         break;\r
 268                 \r
 269                 case X_EVENT_ERROR :\r
 270                         if( e.status === 401 ){\r
 271                                 if( auth = X_Pair_get( this )[ 'auth' ] ){\r
 272                                         X_Pair_get( auth ).onAuthError( auth, e );\r
 273                                         // TODO 破棄しないで待機。\r
 274                                 };\r
 275                         };\r
 276                         \r
 277                 case X_EVENT_SUCCESS :\r
 278                         X_NET_completePhase = 1;\r
 279                         this[ 'listenOnce' ]( X_EVENT_COMPLETE, X_NET_proxyDispatch )\r
 280                                 [ 'asyncDispatch' ]( 32, { type : X_EVENT_COMPLETE, 'lastEventType' : e.type } );\r
 281 \r
 282                         // target を上書き X_NET_currentWrapper -> X_NET_currentQueue\r
 283                         e[ 'target' ] = e[ 'currentTarget' ] = this;\r
 284                         this[ 'asyncDispatch' ]( e );\r
 285                         break;\r
 286 \r
 287                 case X_EVENT_COMPLETE :\r
 288                         X_NET_completePhase = 2;\r
 289                         this[ 'kill' ]();\r
 290                         break;\r
 291         };\r
 292 };\r
 293 \r
 294 // TODO _busy は X.Net で触る.\r
 295 function X_NET_shiftQueue( currentKilled ){\r
 296         var q, auth, authSettings;\r
 297 \r
 298         if( X_NET_currentQueue ){\r
 299                 if( !currentKilled ) return;\r
 300                 \r
 301                 X_NET_currentWrapper\r
 302                         [ 'unlisten' ]( [ X_EVENT_PROGRESS, X_EVENT_SUCCESS, X_EVENT_ERROR ], X_NET_currentQueue, X_NET_proxyDispatch )\r
 303                         .reset();\r
 304 \r
 305                 X_NET_currentQueue = X_NET_currentWrapper = X_NET_currentData = null;\r
 306         };\r
 307         \r
 308         console.log( '■■------------ X_NET_shiftQueue ' + X_NET_QUEUE_LIST.length );\r
 309         \r
 310         if( !X_NET_QUEUE_LIST.length ) return;\r
 311 \r
 312 \r
 313         X_NET_currentQueue = q = X_NET_QUEUE_LIST.shift();\r
 314         X_NET_currentData  = X_Pair_get( X_NET_currentQueue );\r
 315         \r
 316         switch( X_NET_currentData.netType ){\r
 317                 case X_NET_TYPE_XHR :\r
 318                         \r
 319                         // TODO (xProtocol |　method='update' | !cors) & canUse -> gadget.io.makeRequset, flash\r
 320                         // force 'gadget', 'flash'\r
 321                         switch( X_NET_currentData[ 'test' ] ){\r
 322                                 case 'gadget' :\r
 323                                         X_NET_currentWrapper = X_GadgetXHR || X_TEMP.X_GadgetXHR_init();\r
 324                                         break;\r
 325                                 case 'flash'  :\r
 326                                         break;\r
 327                                 \r
 328                                 default :\r
 329                                         X_NET_currentWrapper = X_XHR || X_TEMP.X_XHR_init();\r
 330                         };\r
 331                         \r
 332                         \r
 333                         // OAuth2\r
 334                         if( auth = X_NET_currentData[ 'auth' ] ){\r
 335                                 authSettings = X_Pair_get( auth );\r
 336                                 switch( auth[ 'state' ]() ){\r
 337                                         case 0 :\r
 338                                         case 1 :\r
 339                                         case 2 :\r
 340                                                 if( !( auth[ 'dispatch' ]( X_EVENT_NEED_AUTH ) & X_CALLBACK_PREVENT_DEFAULT ) ){\r
 341                                                         // event 内で kill されていないことを確認\r
 342                                                         if( X_NET_currentQueue === q ){\r
 343                                                                 authSettings.lazyRequests = authSettings.lazyRequests || [];\r
 344                                                                 authSettings.lazyRequests.indexOf( q ) === -1 && authSettings.lazyRequests.push( q );\r
 345                                                                 X_NET_currentQueue = null;\r
 346                                                                 X_NET_shiftQueue();                                                                     \r
 347                                                         };\r
 348                                                 } else {\r
 349                                                         X_NET_currentQueue === q && q[ 'kill' ]();\r
 350                                                 };\r
 351                                                 return;\r
 352                                         case 3 : // refresh token\r
 353                                                 X_NET_QUEUE_LIST.push( X_NET_currentQueue );\r
 354                                                 X_NET_currentQueue = null;\r
 355                                                 X_NET_shiftQueue();\r
 356                                                 return;\r
 357                                 };\r
 358                                 authSettings.updateRequest( auth, X_NET_currentData );\r
 359                         };\r
 360                         break;\r
 361                 case X_NET_TYPE_JSONP :\r
 362                         X_NET_currentWrapper = X_JSONP || X_TEMP.X_JSONP_init();\r
 363                         break;\r
 364                 case X_NET_TYPE_FORM :\r
 365                         X_NET_currentWrapper = X_FormSender  || X_TEMP.X_FormSender_init();\r
 366                         break;\r
 367                 case X_NET_TYPE_IMAGE :\r
 368                         X_NET_currentWrapper = X_ImgLoader || X_TEMP.X_ImgLoader_init();\r
 369                         break;\r
 370         };\r
 371         \r
 372         X_NET_currentWrapper[ 'listen' ]( [ X_EVENT_PROGRESS, X_EVENT_SUCCESS, X_EVENT_ERROR ], X_NET_currentQueue, X_NET_proxyDispatch );\r
 373         \r
 374         X_NET_currentWrapper.load( X_NET_currentData );\r
 375 };\r
 376 \r