網絡請求Request

appcan.ajax(options)

發起一個ajax請求,並獲取相應的內容

1. options:發起ajax的請求的參數，這個必須是一個對象
2. options.type:請求的類型，包括GET、POST等
3. options.appVerify:是否在請求頭中加入appVerify字段 true、false
4. options.certificate({password:'',path:'default'})添加證書信息
5. 　 password:數字證書密碼。當使用appcan默認證書時，此參數爲空(或」」)
6. 　 path:路徑，支持 file://,res://,wgt://等協議路徑，詳見CONSTANT中PathTypes。 當傳入‘default’時，本次請求將取appcan默認數字證書。
7. options.url:要請求的地址 注：get方式請求中攜帶中文參數，須要對參數進行encode編碼，具體函數：encodeURIComponent
8. options.data:要請求的URL的參數,若是要上傳文件則data數據中必須傳一個對象包含一個path的key 例如：data:{file:{path:'a.jpeg'},file2:{path:'b.jpeg'}}上傳a.jpeg,b.jpeg圖片
9. options.contentType:默認: false 要傳給服務端的數據內容的'content-Type'經過header,若是設置其餘content將會直接把data發送出去
10. options.dataType:服務端的響應類型，包括json, jsonp, script, xml, html, text中的一種
11. options.timeout:請求的超時時間
12. options.headers:要設置的請求頭
13. options.xhrFields:要重載的請求對象的字段
14. options.beforeSend(xhr, settings):請求發送以前的回調,返回false取消請求發送
15. options.success(data, status,,requestCode,response, xhr):請求發送成功後的回調
16. 　 requestCode: 服務器響應狀態碼,成功爲200，失敗爲404,-1等；
17. 　reponse: JSON格式字符串：
18. {
19. "responseHeaders": 「」,//請求頭
20. "responseStatusCode": 「」,//狀態碼
21. "responseStatusMessage": 「」,//狀態碼的信息
22. "responseError": 「」//錯誤信息
23. }
24. options.error(xhr, errorType, error,msg):請求若是出現錯誤後的回調;msg: 錯誤詳細信息，服務器返回的result信息
25. options.complete(xhr, status):請求完成後的回調，無論是否出錯
26. options.progress(progress, xhr):上傳的進度，只有包含上傳文件的時候纔會執行該回調
27. options.cache:是否緩存請求
28. options.offline:是否直接調用離線數據，包括true,false,undefined
29. 　　　**offline參數說明：**
30. 　　　　 true: 直接調用緩存數據，若是緩存數據不存在，執行ajax請求並離線緩存返回數據；
31. 　　　　 false: 直接請求ajax數據，並把請求到的數據離線緩存；
32. 　　　　undefined: 直接請求ajax數據，不緩存請求到的數據；
33. options.offlineDataPath:自定義離線數據文件存儲目錄
34. options.expires:離線緩存過時時間，支持類型：
35. 　1.number類型（單位：毫秒），緩存過時時長，
36. 　2.W3c IOS 8601 DateTime格式,詳見http://www.w3.org/TR/NOTE-datetime ，緩存過時時間點
37. options.crypto:true/false 離線緩存時是否加密
38. options.password: "string" 離線緩存加密密碼

例如：

1. appcan.ajax({
2. url : 'http://weixin.appcan.cn:8086/test/get',
3. type : 'GET',
4. data : {
5. a : 'hello word',
6. b : 'page'
7. },
8. offline : true,
9. offlineDataPath : 'wgt://aaa/',
10. success : function(data) {
11. alert(data);
12. },
13. error : function(e) {
14. alert(e);
15. }
16. });

例如：

1. A.number格式
4. appcan.ajax({
5. url : 'http://weixin.appcan.cn:8086/test/get',
6. type : 'GET',
7. data : {
8. a : 'hello word',
9. b : 'page'
10. },
11. offline : true,
12. expires:3000,
13. success : function(data) {
14. alert(data);
15. }, error : function(e) {
16. alert(e);
17. }
18. });
22. B.ISO 8601格式
24. appcan.ajax({
25. url : 'http://weixin.appcan.cn:8086/test/get',
26. type : 'GET',
27. data : {
28. a : 'hello word',
29. b : 'page'
30. },
31. offline : true,
32. expires : '2015-05-16 ',
33. success : function(data) {
34. alert(data);
35. },
36. error : function(e) {
37. alert(e);
38. }
39. });

例如：

1. appcan.ajax({
2. url:http://115.29.138.150:8086/test/get,
3. type:"GET",
4. data:{}, dataType:"json",
5. timeout:30000,
6. success:function(data, status, requestCode, response, xhr) {
7. alert("status:" + status);
8. alert("result:" + data);
9. alert("requestCode:" + requestCode);
10. alert("response:" + JSON.stringify(response));
11. alert("xhr:" + JSON.stringify(xhr));
12. }, error:function(xhr,erroType,error,msg) {
13. alert("erroType:" + erroType);
14. alert("error:" + error);
15. alert("msg:" + msg);
16. alert("xhr:" + JSON.stringify(xhr));
17. }
19. });
22. //獲取appcan.cn頁面
23. appcan.ajax({
24. type : 'GET',
25. url : 'http://appcan.cn',
26. //添加參數
27. data : {
28. name : 'appcan'
29. },
30. //指望的返回類型
31. dataType : 'html',
32. timeout : 300, //超時時間
33. success : function(data) {
34. //獲取內容
35. alert('data');
36. },
37. error : function(xhr, type) {
38. alert('Ajax error!')
39. },
40. offline : true
41. })

離線緩存加解密例子：

1. appcan.ajax({
2. url : "http://weixin.appcan.cn:8086/test/get",
3. type : "GET",
4. data : {
5. a : 'hello word',
6. b : 'page'
7. },
8. dataType : "json",
9. timeout : 30000,
10. offline : true,
11. crypto : true,
12. password : "pwd",
13. success : function(data, status, requestCode, response, xhr) {
14. alert("status:" + status);
15. alert("result:" + data);
16. alert("requestCode:" + requestCode);
17. alert("response:" + JSON.stringify(response));
18. alert("xhr:" + JSON.stringify(xhr));
19. },
20. error : function(xhr, erroType, error, msg) {
21. alert("erroType:" + erroType);
22. alert("error:" + error);
23. alert("msg:" + msg);
24. alert("xhr:" + JSON.stringify(xhr));
25. }
26. });

appcan.request.ajax(options)

請參考 ：appcan.ajax(options)發起一個ajax請求,並獲取相應的內容

1. options:發起ajax的請求的參數，這個必須是一個對象
2. options.type:請求的類型，包括GET、POST等
3. options.appVerify:是否在請求頭中加入appVerify字段 true、false
4. options.url:要請求的地址 注：get方式請求中攜帶中文參數，須要對參數進行encode編碼，具體函數：encodeURIComponent
5. options.data:要請求的URL的參數,若是要上傳文件則data數據中必須傳一個對象包含一個path的key 例如：data:{file:{path:'a.jpeg'}}上傳a.jpeg圖片
6. options.contentType:默認: false 要傳給服務端的數據內容的'content-Type'經過header,若是設置其餘content將會直接把data發送出去
7. options.dataType:服務端的響應類型，包括json, jsonp, script, xml, html, text中的一種
8. options.timeout:請求的超時時間
9. options.headers:要設置的請求頭
10. options.xhrFields:要重載的請求對象的字段
11. options.beforeSend(xhr, settings):請求發送以前的回調,返回false取消請求發送
12. options.success(data, status,requestCode,response, xhr):請求發送成功後的回調　
13. 　　**requestCode、reponse說明：**　
14. 　　　 requestCode: 服務器響應狀態碼,成功爲200，失敗爲404,-1等；
15. 　　　 reponse: JSON格式字符串：
16. 　　　{
17. 　　　　"responseHeaders": 「」,//請求頭
18. 　　　　"responseStatusCode": 「」,//狀態碼
19. 　　　　"responseStatusMessage": 「」,//狀態碼的信息
20. 　　　　"responseError": 「」//錯誤信息
21. 　　　}
22. options.error(xhr, errorType, error,msg):請求若是出現錯誤後的回調;msg: 錯誤詳細信息，服務器返回的result信息
23. options.complete(xhr, status):請求完成後的回調，無論是否出錯
24. options.progress(progress, xhr):上傳的進度，只有包含上傳文件的時候纔會執行該回調
25. options.certificate:添加證書信息 {password:'',path:''}其中password是證書的密碼，path是證書的地址
26. options.cache:是否緩存請求
27. options.offline:是否直接調用離線數據，包括true,false,undefined
28. 　　**offline參數說明：**
29. 　　 true: 直接調用緩存數據，若是緩存數據不存在，執行ajax請求並離線緩存返回數據；
30. 　　false: 直接請求ajax數據，並把請求到的數據離線緩存；
31. 　　undefined: 直接請求ajax數據，不緩存請求到的數據；
32. options.offlineDataPath:自定義離線數據文件存儲目錄
33. options.expires:離線緩存過時時間，支持類型：
34. 　1.number類型（單位：毫秒），緩存過時時長，
35. 　2.W3c IOS 8601 DateTime格式,詳見http://www.w3.org/TR/NOTE-datetime ，緩存過時時間點
36. options.crypto:true/false 離線緩存時是否加密
37. options.password: "string" 離線緩存加密密碼

例如：

1. appcan.ajax({
2. url : 'http://weixin.appcan.cn:8086/test/get',
3. type : 'GET',
4. data : {
5. a : 'hello word',
6. b : 'page'
7. },
8. offline : true,
9. offlineDataPath : 'wgt://aaa/',
10. success : function(data) {
11. alert(data);
12. },
13. error : function(e) {
14. alert(e);
15. }
16. });
17. 例如:
18. A.number格式
20. appcan.ajax({
21. url : 'http://weixin.appcan.cn:8086/test/get',
22. type : 'GET',
23. data : {
24. a : 'hello word',
25. b : 'page'
26. },
27. offline : true,
28. expires:3000,
29. success : function(data) {
30. alert(data);
31. }, error : function(e) {
32. alert(e);
33. }
34. });
36. B.ISO 8601格式
38. appcan.request.ajax({
39. url : 'http://weixin.appcan.cn:8086/test/get',
40. type : 'GET',
41. data : {
42. a : 'hello word',
43. b : 'page'
44. },
45. offline : true,
46. expires : '2015-05-16 ',
47. success : function(data) {
48. alert(data);
49. },
50. error : function(e) {
51. alert(e);
52. }
53. });

例如：

1. appcan.request.ajax({
2. url:http://115.29.138.150:8086/test/get,
3. type:"GET",
4. data:{}, dataType:"json",
5. timeout:30000,
6. success:function(data, status, requestCode, response, xhr) {
7. alert("status:" + status);
8. alert("result:" + data);
9. alert("requestCode:" + requestCode);
10. alert("response:" + JSON.stringify(response));
11. alert("xhr:" + JSON.stringify(xhr));
12. }, error:function(xhr,erroType,error,msg) {
13. alert("xhr:" + JSON.stringify(xhr));
14. alert("erroType:" + erroType);
15. alert("error:" + error);
16. alert("msg:" + msg);
17. }
19. });
22. //獲取appcan.cn頁面
24. appcan.request.ajax({
25. type : 'GET',
26. url : 'http://appcan.cn',
27. //添加參數
28. data : {
29. name : 'appcan'
30. },
31. //指望的返回類型
32. dataType : 'html',
33. timeout : 300, //超時時間
34. success : function(data) {
35. //獲取內容
36. alert('data');
37. },
38. error : function(xhr, type) {
39. alert('Ajax error!')
40. },
41. offline : true
42. })
45. //另一種使用方式
47. var request = appcan.require('request');
48. request.ajax({
49. type : 'POST',
50. url : 'http://appcan.cn/reg',
51. data : {
52. name : 'appcan'
53. },
54. contentType : 'application/json',
55. success : function() {
57. }
58. })
61. //獲取appcan.cn頁面
63. appcan.request.ajax({
64. type : 'GET',
65. url : 'http://appcan.cn',
66. //添加參數
67. data : {
68. name : 'appcan'
69. },
70. //指望的返回類型
71. dataType : 'html',
72. timeout : 300, //超時時間
73. success : function(data) {
74. //獲取內容
75. alert('data');
76. },
77. error : function(xhr, type) {
78. alert('Ajax error!')
79. }
80. })
83. //例如發送一個post請求,地址爲模擬用
85. request.ajax({
86. type : 'POST',
87. url : 'http://appcan.cn/reg',
88. data : {
89. name : 'appcan'
90. },
91. contentType : 'application/json',
92. success : function() {
94. }
95. })

離線緩存加解密例子：

1. appcan.ajax({
2. url : "http://weixin.appcan.cn:8086/test/get",
3. type : "GET",
4. data : {
5. a : 'hello word',
6. b : 'page'
7. },
8. dataType : "json",
9. timeout : 30000,
10. offline : true,
11. crypto : true,
12. password : "pwd",
13. success : function(data, status, requestCode, response, xhr) {
14. alert("status:" + status);
15. alert("result:" + data);
16. alert("requestCode:" + requestCode);
17. alert("response:" + JSON.stringify(response));
18. alert("xhr:" + JSON.stringify(xhr));
19. },
20. error : function(xhr, erroType, error, msg) {
21. alert("erroType:" + erroType);
22. alert("error:" + error);
23. alert("msg:" + msg);
24. alert("xhr:" + JSON.stringify(xhr));
25. }
26. });

appcan.request.get(url,[data],success,[dataType])

發一個http Get請求，這是appcan.request.ajax的簡寫

1. url:要請求的地址
2. data:該參數不是必須的，要傳遞的參數
3. success:成功後的回調函數，參考appcan.request.ajax參數中的success
4. dataType:返回的響應結果的數據類型

例如：

1. //請求appcan.cn頁面的內容
3. appcan.request.get('http://appcan.cn', function(data, status, xhr) {
4. //數據內容
5. console.log(data);
6. });
7. //另一種使用方式
8. var request = appcan.require('request');
9. request.get('http://appcan.cn', function(data, status, xhr) {
10. //數據內容
11. console.log(data);
12. });
14. appcan.request.post(url, [data], success,[dataType])
15. 發起一個http Post請求
16. url:要請求的地址
17. data:要發出的請求的參數
18. success:請求的成功的回調
19. dataType:返回的響應結果的數據類型
20. 例如:
21. //發送一個簡單的post數據到appcan.cn
23. appcan.request.post('http://appcan.cn', {
24. name : 'appcan'
25. }, function(data, status, xhr) {
26. //打印結果
27. console.log(data);
28. });
30. //另一種使用方式
32. var request = appcan.require('request');
33. request.post('http://appcan.cn', {
34. name : 'appcan'
35. }, function(data, status, xhr) {
36. //打印結果
37. console.log(data);
38. });

appcan.request.getJSON(url,[data],success)

發起一個http get請求來獲取json數據

1. url:要獲取的json數據的地址
2. data:要發送請求的參數
3. success:成功後的回調

例如：

1. //獲取一個json數據
3. appcan.request.getJSON('http://appcan.cn/a.json', function(data) {
4. //打印json數據
5. console.log(data);
6. });
8. //另外一種使用方式
10. var request = appcan.require('request');
11. request.getJSON('http://appcan.cn/a.json', function(data) {
12. //打印json數據
13. console.log(data);
14. });

appcan.request.postForm(selector,success,error)

序列化表單內容並提交表單

1. selector:表單的css選擇器，或者是form元素
2. success(data):表單提交成功後的回調,data服務器端的返回值
3. error(err):表單提交失敗的時候的回調,err錯誤對象

例如：

1. //獲取一個json數據
3. $('form').on('submit', function() {
4. var form = $('from');
5. appcan.request.postForm(form);
6. return false;
7. });
9. //另外一種使用方式
11. var request = appcan.require('request');
12. $('form').on('submit', function() {
13. var form = $('from');
14. request.postForm(form);
15. return false;
16. });

appcan.request.clearOffline(url,callback,data)

1. url:須要清除離線數據的url
2. callback(err,data,dataType,optId) : 執行成功後的回調函數
3. data:與appcan.request.ajax參數中的data相同

例如：

1. //清除指定url的離線緩存數據
3. appcan.request.clearOffline({
4. url : 'http://weixin.appcan.cn:8086/test/get',
5. callback : function(err, data, dataType, optId) {
6. if (err) {
7. //清除緩存錯誤
8. return;
9. }
10. if (data == 0) {
11. //清除緩存成功
12. } else {
13. //清除緩存失敗
14. }
15. }
16. });

例如：

1. //清除指定url的離線緩存數據
3. appcan.request.clearOffline({
4. url : 'http://weixin.appcan.cn:8086/test/get',
5. callback : function(err, data, dataType, optId) {
6. if (err) {
7. //清除緩存錯誤
8. return;
9. }
10. if (data == 0) {
11. //清除緩存成功
12. } else {
13. //清除緩存失敗
14. }
15. },
16. data:{
17. a : 'hello word',
18. b : 'page'
19. }
20. });
21. a