Version 0.6.149, fix X.Audio & X.UI.

[pettanr/clientJs.git] / 0.6.x / js / 06_net / 00_XNet.js

diff --git a/0.6.x/js/06_net/00_XNet.js b/0.6.x/js/06_net/00_XNet.js
index 709f177..a97d45e 100644 (file)
--- a/0.6.x/js/06_net/00_XNet.js
+++ b/0.6.x/js/06_net/00_XNet.js
@@ -7,9 +7,42 @@
 \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
@@ -34,6 +67,10 @@ X[ 'Net' ] = X_EventDispatcher[ 'inherits' ](
                '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
@@ -231,8 +268,8 @@ function X_NET_shiftQueue(){
        switch( X_NET_currentData.netType ){\r
                case X_NET_TYPE_XHR :\r
                        \r
-                       // TODO xProtocol,　method -> gadget.io.makeRequset, flash\r
-                       \r
+                       // TODO (xProtocol |　method) & canUse -> gadget.io.makeRequset, flash\r
+                       // force 'gadget', 'flash'\r
                        X_NET_currentWrapper = X_NET_XHRWrapper || X_TEMP.X_Net_XHR_init();\r
                        \r
                        // OAuth2\r