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>busy() メソッドだけを持つ。通信用のプロパティは X.Pair によって隠蔽される。\r
  11  * <h4>通信のキャンセル</h4>\r
  12  * <p>kill() で通信待ち中はキャンセル&破棄、通信中の場合は通信の中断&破棄を行う。SUCCESS, ERROR, TIMEOUT イベント以降は 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>通信エラー\r
  18  * <dt>X.Event.TIMEOUT<dd>通信タイムアウト\r
  19  * <dt>X.Event.CANCELED<dd>通信のユーザー、プログラムによるキャンセル\r
  20  * <dt>X.Event.COMPLETE<dd>通信完了。SUCCESS, ERROR, TIMEOUT, CANCELED 後に発生。\r
  21  * </dl>\r
  22  * <p>X.Net インスタンスは COMPLETE 後に自動で破棄される。\r
  23  * <h4>必須プロパティ</h4>\r
  24  * <dl>\r
  25  * <dt>url<dd>URL\r
  26  * <dt>type<dd>'xhr', 'jsonp', 'image', 'img'\r
  27  * <dt>xhr<dd>URL { url : 'hoge', type : 'xhr' } の省略形\r
  28  * <dt>jsonp<dd>URL { url : 'hoge', type : 'jsonp' } の省略形\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>postdata<dd>string, object の場合は X.String.serialize される。\r
  35  * <dt>async<dd>boolean\r
  36  * <dt>username<dd>BASIC 認証\r
  37  * <dt>password<dd>BASIC 認証\r
  38  * <dt>headers<dd>object xhr.setRequestHeader する値\r
  39  * <dt>timeout<dd>タイムアウト ms\r
  40  * <dt>cache<dd>headers[ 'Pragma' ] = 'no-cache' 等を設定するか?\r
  41  * <dt>dataType<dd>'text', 'json', 'xml', 'blob', 'arraybuffer' 等。xhr.responseType に指定する値\r
  42  * <dt>mimeType<dd>'text/xml', 'audio/mpeg' 等。xhr.overrideMimeType する値\r
  43  * <dt>auth<dd>X.OAuth2 インスタンス(OAuth2 サービスの定義)\r
  44  * <dt>getFullHeaders<dd>getAllResponseHeaders() をパースしたハッシュを返す。値は配列になっている。\r
  45  * </dl>\r
  46  * \r
  47  * @alias X.Net\r
  48  * @class 各種ネットワーク機能をラップしインターフェイスを共通化する。\r
  49  * @constructs Net\r
  50  * @extends {EventDispatcher}\r
  51  * @example // XHR - GET\r
  52  * var net = X.Net( { xhr : urlString } )\r
  53  *              .listen( X.Event.PROGRESS )\r
  54  *              .listenOnce( [ X.Event.SUCCESS, X.Event.ERROR, X.Event.TIMEOUT, X.Event.CANCELED ] );\r
  55  * \r
  56  * // XHR - POST \r
  57  * var net = X.Net( { xhr : urlString, postdata : myData } );\r
  58  * \r
  59  * // JSONP\r
  60  * var net = X.Net( { jsonp : urlString, staticCallbackName : callbackName, useXDomainWall : false } );\r
  61  * \r
  62  * // Image preload & getSize\r
  63  * var net = X.Net( { image : src, sizeDetection : true } );\r
  64  * \r
  65  * // load &lt;script&gt;, &lt;link&gt;\r
  66  */\r
  67 X[ 'Net' ] = X_EventDispatcher[ 'inherits' ](\r
  68                 'X.Net',\r
  69                 X_Class.NONE,\r
  70                 {\r
  71                         'netType'    : '',\r
  72                         'netName'    : '',\r
  73                         'netVersion' : 0,\r
  74                         \r
  75                         'Constructor' : function( urlOrObject, opt_options ){\r
  76                                 var v, opt, url, type, auth;\r
  77                                 \r
  78                                 if( X_Type_isObject( opt = urlOrObject ) ){\r
  79                                         if( v = opt[ 'xhr' ] ){\r
  80                                                 url  = v;\r
  81                                                 type = X_NET_TYPE_XHR;\r
  82                                         } else\r
  83                                         if( v = opt[ 'jsonp' ] ){\r
  84                                                 url  = v;\r
  85                                                 type = X_NET_TYPE_JSONP;\r
  86                                         } else\r
  87                                         if( v = opt[ 'img' ] || opt[ 'image' ] ){\r
  88                                                 url  = v;\r
  89                                                 type = X_NET_TYPE_IMAGE;\r
  90                                         } else\r
  91                                         if( v = opt[ 'form' ] ){\r
  92                                                 url  = v;\r
  93                                                 type = X_NET_TYPE_FORM;\r
  94                                         } else\r
  95                                         if( v = opt[ 'type' ] ){\r
  96 \r
  97                                                 switch( v ){\r
  98                                                         case 'xhr' :\r
  99                                                                 type = X_NET_TYPE_XHR;\r
 100                                                                 break;\r
 101                                                         case 'jsonp' :\r
 102                                                                 type = X_NET_TYPE_JSONP;\r
 103                                                                 break;\r
 104                                                         case 'img' :\r
 105                                                         case 'image' :\r
 106                                                                 type = X_NET_TYPE_IMAGE;\r
 107                                                                 break;\r
 108                                                         case 'from' :\r
 109                                                                 type = X_NET_TYPE_FORM;\r
 110                                                                 break;\r
 111                                                         default :\r
 112                                                                 alert( 'X.Net args error' );\r
 113                                                                 return; \r
 114                                                 };\r
 115                                                 url = opt[ 'url'  ];\r
 116                                         };\r
 117                                         \r
 118                                         if( !X_Type_isString( url ) ){\r
 119                                                 alert( 'X.Net args error' );\r
 120                                                 return;\r
 121                                         };\r
 122                                         \r
 123                                 } else\r
 124                                 if( X_Type_isString( urlOrObject ) ){\r
 125                                         url = urlOrObject;\r
 126                                         \r
 127                                         if( X_Type_isObject( opt = opt_options ) ){\r
 128                                                 type = opt[ 'type' ] || X_NET_TYPE_XHR;\r
 129                                         } else {\r
 130                                                 type = X_NET_TYPE_XHR;\r
 131                                                 opt  = { 'url' : url, 'method' : 'GET' };\r
 132                                         };\r
 133                                         \r
 134                                 } else {\r
 135                                         alert( 'X.Net args error' );\r
 136                                         return;\r
 137                                 };\r
 138                                 \r
 139                                 if( auth = opt[ 'auth' ] ){\r
 140                                         delete opt[ 'auth' ];\r
 141                                 };\r
 142                                 opt = X_Object_deepCopy( opt );\r
 143                                 if( auth ){\r
 144                                         opt[ 'auth' ] = auth; // auth は deep copy されるとまずい\r
 145                                 };\r
 146                                 opt.netType   = type;\r
 147                                 opt[ 'url'  ] = url;                            \r
 148                                 \r
 149                                 if( type === X_NET_TYPE_XHR ){\r
 150                                         opt[ 'method' ] = opt[ 'method' ] || ( opt[ 'postdata' ] ? 'POST' : 'GET' );\r
 151                                         \r
 152                                         // XDomain 不可 -> Flash, Gears, Silverlight, canUseGadget なら gadget に切替?\r
 153                                         // PUT DELETE UPDATE 不可 -> Flash, Gears, Silverlight, canUseGadget なら gadget に切替?\r
 154                                         // xプロトコル な binary のロード -> gadget 内で proxyURL による XHR\r
 155                                         //  or X_EVENT_ERROR\r
 156                                         \r
 157                                         opt[ 'dataType' ] = opt[ 'dataType' ] || X_URL_getEXT( url );\r
 158                                 };\r
 159                                 \r
 160                                 X_Pair_create( this, opt );\r
 161                                 \r
 162                                 this[ 'listen' ]( [ X_EVENT_BEFORE_KILL_INSTANCE, X_EVENT_KILL_INSTANCE ], X_NET_proxyDispatch );\r
 163                                 \r
 164                                 X_NET_QUEUE_LIST[ X_NET_QUEUE_LIST.length ] = this;\r
 165                                 !X_NET_currentQueue && X_NET_shiftQueue();\r
 166                         },\r
 167                         \r
 168                 /**\r
 169                  * 現在通信中か？調べる。false の場合、通信の順番待ちか、通信が終了している。\r
 170                  * @alias Net.prototype.busy\r
 171                  */\r
 172                         'busy' : function(){\r
 173                                 return this === X_NET_currentQueue && X_NET_currentWrapper._busy;\r
 174                         }\r
 175                 }\r
 176         );\r
 177 /*\r
 178  * @interface\r
 179  */\r
 180 var X_NET_IWrapper = function(){};\r
 181         X_NET_IWrapper.prototype.load   = function(){};\r
 182         X_NET_IWrapper.prototype.cancel = function(){};\r
 183         X_NET_IWrapper.prototype.reset  = function(){};\r
 184 \r
 185 \r
 186 var X_NET_TYPE_XHR   = 1,\r
 187         X_NET_TYPE_JSONP = 2,\r
 188         X_NET_TYPE_FORM  = 3,\r
 189         X_NET_TYPE_IMAGE = 4,\r
 190 \r
 191         X_NET_QUEUE_LIST = [],\r
 192 \r
 193         X_NET_XHRWrapper,\r
 194         X_NET_JSONPWrapper,\r
 195         X_NET_FormWrapper,\r
 196         X_NET_ImageWrapper,\r
 197         X_NET_GIMRWrapper,\r
 198 \r
 199         X_NET_currentWrapper,\r
 200         X_NET_currentQueue,\r
 201         X_NET_currentData,\r
 202         X_NET_completePhase;\r
 203 \r
 204 function X_NET_proxyDispatch( e ){\r
 205         var i, flag, auth;\r
 206         \r
 207         switch( e.type ){\r
 208                 case X_EVENT_BEFORE_KILL_INSTANCE :\r
 209                         if( this === X_NET_currentQueue && X_NET_completePhase ) return X_Callback_PREVENT_DEFAULT;\r
 210                         break;\r
 211                 \r
 212                 case X_EVENT_KILL_INSTANCE :\r
 213                         i = X_NET_QUEUE_LIST.indexOf( this );\r
 214                         \r
 215                         if( i !== -1 ){\r
 216                                 X_NET_QUEUE_LIST.splice( i, 1 );\r
 217                                 flag = true;\r
 218                         } else\r
 219                         if( this === X_NET_currentQueue ){\r
 220                                 X_NET_currentWrapper.cancel();\r
 221                                 X_NET_shiftQueue();\r
 222                                 flag = true;\r
 223                         };\r
 224                         \r
 225                         if( flag ){ // flag が立つ場合、これは中断\r
 226                                 this[ 'dispatch' ]( X_EVENT_CANCELED );\r
 227                                 this[ 'dispatch' ]( { type : X_EVENT_COMPLETE, 'lastEventType' : X_EVENT_CANCELED } );\r
 228                                 X_Pair_release( this );\r
 229                         };\r
 230                         break;                  \r
 231                 case X_EVENT_PROGRESS :\r
 232                         this[ 'dispatch' ]( e );\r
 233                         break;\r
 234                 \r
 235                 case X_EVENT_ERROR :\r
 236                         if( e.status === 401 ){\r
 237                                 if( auth = X_Pair_get( this )[ 'auth' ] ){\r
 238                                         X_Pair_get( auth ).onAuthError( auth, e );\r
 239                                 };\r
 240                         };\r
 241                         \r
 242                 case X_EVENT_SUCCESS :\r
 243                 case X_EVENT_TIMEOUT :\r
 244                         X_NET_completePhase = true;\r
 245                         this\r
 246                                 [ 'listenOnce' ]( X_EVENT_COMPLETE, X_NET_proxyDispatch )\r
 247                                 [ 'unlisten' ]( [ X_EVENT_BEFORE_KILL_INSTANCE, X_EVENT_KILL_INSTANCE ], X_NET_proxyDispatch )\r
 248                                 [ 'asyncDispatch' ]( e );\r
 249                         this[ 'asyncDispatch' ]( 32, { type : X_EVENT_COMPLETE, 'lastEventType' : e.type } );\r
 250                         break;\r
 251                 case X_EVENT_COMPLETE :\r
 252                         X_Pair_release( this );\r
 253                         X_NET_shiftQueue();\r
 254                         X_NET_completePhase = false;\r
 255                         this[ 'kill' ]();\r
 256                         break;\r
 257         };\r
 258 };\r
 259 \r
 260 function X_NET_shiftQueue(){\r
 261         var auth, authSettings;\r
 262 \r
 263         if( X_NET_currentQueue ){\r
 264                 if( X_NET_currentWrapper._busy ) return;\r
 265                 X_NET_currentWrapper\r
 266                         [ 'unlisten' ]( [ X_EVENT_PROGRESS, X_EVENT_SUCCESS, X_EVENT_ERROR, X_EVENT_TIMEOUT ], X_NET_currentQueue, X_NET_proxyDispatch )\r
 267                         .reset();\r
 268                 X_NET_currentQueue = X_NET_currentWrapper = X_NET_currentData = null;\r
 269         };\r
 270         \r
 271         if( !X_NET_QUEUE_LIST.length ) return;\r
 272 \r
 273         X_NET_currentQueue = X_NET_QUEUE_LIST.shift();\r
 274         X_NET_currentData  = X_Pair_get( X_NET_currentQueue );\r
 275         \r
 276         switch( X_NET_currentData.netType ){\r
 277                 case X_NET_TYPE_XHR :\r
 278                         \r
 279                         // TODO (xProtocol |　method='update' | !cors) & canUse -> gadget.io.makeRequset, flash\r
 280                         // force 'gadget', 'flash'\r
 281                         switch( X_NET_currentData[ 'test' ] ){\r
 282                                 case 'gadget' :\r
 283                                         X_NET_currentWrapper = X_NET_GIMRWrapper || X_TEMP.X_Net_GIMR_init();\r
 284                                         break;\r
 285                                 case 'flash'  :\r
 286                                         break;\r
 287                                 \r
 288                                 default :\r
 289                                         X_NET_currentWrapper = X_NET_XHRWrapper || X_TEMP.X_Net_XHR_init();\r
 290                         };\r
 291                         \r
 292                         \r
 293                         // OAuth2\r
 294                         if( auth = X_NET_currentData[ 'auth' ] ){\r
 295                                 authSettings = X_Pair_get( auth );\r
 296                                 switch( auth[ 'state' ]() ){\r
 297                                         case 0 :\r
 298                                         case 1 :\r
 299                                         case 2 :\r
 300                                                 if( !( auth[ 'dispatch' ]( X_EVENT_NEED_AUTH ) & X_Callback_PREVENT_DEFAULT ) ){\r
 301                                                         authSettings.lazyReq = X_NET_currentQueue;\r
 302                                                 };\r
 303                                                 X_NET_currentQueue = null;\r
 304                                                 X_NET_shiftQueue();\r
 305                                                 break;\r
 306                                         case 3 : // refresh token\r
 307                                                 X_NET_QUEUE_LIST.push( X_NET_currentQueue );\r
 308                                                 X_NET_currentQueue = null;\r
 309                                                 X_NET_shiftQueue();\r
 310                                                 return;\r
 311                                 };\r
 312                                 authSettings.updateRequest( auth, X_NET_currentData );\r
 313                         };\r
 314                         break;\r
 315                 case X_NET_TYPE_JSONP :\r
 316                         X_NET_currentWrapper = X_NET_JSONPWrapper || X_TEMP.X_NET_JSONP_init();\r
 317                         break;\r
 318                 case X_NET_TYPE_FORM :\r
 319                         X_NET_currentWrapper = X_NET_FormWrapper;\r
 320                         break;\r
 321                 case X_NET_TYPE_IMAGE :\r
 322                         X_NET_currentWrapper = X_NET_ImageWrapper || X_TEMP.X_NET_Image_init();\r
 323                         break;\r
 324         };\r
 325         \r
 326         X_NET_currentWrapper[ 'listen' ]( [ X_EVENT_PROGRESS, X_EVENT_SUCCESS, X_EVENT_ERROR, X_EVENT_TIMEOUT ], X_NET_currentQueue, X_NET_proxyDispatch );\r
 327         \r
 328         X_NET_currentWrapper.load( X_NET_currentData );\r
 329 };\r
 330 \r