1. 文件操作
Flutter中的文件操作一般使用Dart IO庫來進行蜜暑,而由于 Android 和 iOS 的應(yīng)用存儲目錄不同,PathProvider
插件提供了一種平臺透明的方式來訪問設(shè)備文件系統(tǒng)上的常用位置冤议。該類當(dāng)前支持訪問兩個文件系統(tǒng)位置:
-
臨時目錄: 可以使用
getTemporaryDirectory()
來獲取臨時目錄; 系統(tǒng)可隨時清除的臨時目錄(緩存)。在iOS上瓮顽,這對應(yīng)于NSTemporaryDirectory()
返回的值疟羹。在Android上主守,這是getCacheDir()
返回的值。 -
文檔目錄: 可以使用
getApplicationDocumentsDirectory()
來獲取應(yīng)用程序的文檔目錄榄融,該目錄用于存儲只有自己可以訪問的文件参淫。只有當(dāng)應(yīng)用程序被卸載時,系統(tǒng)才會清除該目錄愧杯。在iOS上涎才,這對應(yīng)于NSDocumentDirectory
。在Android上力九,這是AppData
目錄耍铜。 -
外部存儲目錄:可以使用
getExternalStorageDirectory()
來獲取外部存儲目錄,如SD卡跌前;由于iOS不支持外部目錄棕兼,所以在iOS下調(diào)用該方法會拋出UnsupportedError
異常,而在Android下結(jié)果是android SDK中getExternalStorageDirectory
的返回值抵乓。
一旦你的Flutter應(yīng)用程序有一個文件位置的引用伴挚,你可以使用dart:io API 來執(zhí)行對文件系統(tǒng)的讀/寫操作。有關(guān)使用Dart處理文件和目錄的詳細內(nèi)容可以參考Dart語言文檔灾炭,下面我們看一個簡單示例:
import 'dart:io';
import 'dart:async';
import 'package:flutter/material.dart';
import 'package:path_provider/path_provider.dart';
class FileOperationRoute extends StatefulWidget {
FileOperationRoute({Key key}) : super(key: key);
@override
_FileOperationRouteState createState() => new _FileOperationRouteState();
}
class _FileOperationRouteState extends State<FileOperationRoute> {
int _counter;
@override
void initState() {
super.initState();
//從文件讀取點擊次數(shù)
_readCounter().then((int value) {
setState(() {
_counter = value;
});
});
}
Future<File> _getLocalFile() async {
// 獲取應(yīng)用目錄
String dir = (await getApplicationDocumentsDirectory()).path;
return new File('$dir/counter.txt');
}
Future<int> _readCounter() async {
try {
File file = await _getLocalFile();
// 讀取點擊次數(shù)(以字符串)
String contents = await file.readAsString();
return int.parse(contents);
} on FileSystemException {
return 0;
}
}
Future<Null> _incrementCounter() async {
setState(() {
_counter++;
});
// 將點擊次數(shù)以字符串類型寫到文件中
await (await _getLocalFile()).writeAsString('$_counter');
}
@override
Widget build(BuildContext context) {
return new Scaffold(
appBar: new AppBar(title: new Text('文件操作')),
body: new Center(
child: new Text('點擊了 $_counter 次'),
),
floatingActionButton: new FloatingActionButton(
onPressed: _incrementCounter,
tooltip: 'Increment',
child: new Icon(Icons.add),
),
);
}
}
2. 網(wǎng)絡(luò)請求 HttpClient
在實際開發(fā)中茎芋,我們免不了要跟網(wǎng)絡(luò)請求打交道,此時我們可以使用HttpClient
來發(fā)起請求蜈出。
2.1 HttpClient配置
HttpClient
有很多屬性可以配置田弥,常用的屬性列表如下:
屬性 | 含義 |
---|---|
idleTimeout | 對應(yīng)請求頭中的keep-alive字段值,為了避免頻繁建立連接掏缎,httpClient在請求結(jié)束后會保持連接一段時間皱蹦,超過這個閾值后才會關(guān)閉連接。 |
connectionTimeout | 和服務(wù)器建立連接的超時眷蜈,如果超過這個值則會拋出SocketException異常沪哺。 |
maxConnectionsPerHost | 同一個host,同時允許建立連接的最大數(shù)量酌儒。 |
autoUncompress | 對應(yīng)請求頭中的Content-Encoding辜妓,如果設(shè)置為true,則請求頭中Content-Encoding的值為當(dāng)前HttpClient支持的壓縮算法列表,目前只有"gzip" |
userAgent | 對應(yīng)請求頭中的User-Agent字段籍滴。 |
可以發(fā)現(xiàn)酪夷,有些屬性只是為了更方便的設(shè)置請求頭,對于這些屬性孽惰,你完全可以通過HttpClientRequest
直接設(shè)置header晚岭,不同的是通過HttpClient
設(shè)置的對整個httpClient
都生效,而通過HttpClientRequest
設(shè)置的只對當(dāng)前請求生效勋功。
2.2 HttpClient使用
使用HttpClient
發(fā)起請求分為五步:
-
創(chuàng)建一個
HttpClient
:HttpClient httpClient = new HttpClient();
-
打開Http連接坦报,設(shè)置請求頭:
HttpClientRequest request = await httpClient.getUrl(uri);
這一步可以使用任意Http Method,如
httpClient.post(...)
狂鞋、httpClient.delete(...)
等片择。如果包含Query參數(shù),可以在構(gòu)建uri時添加骚揍,如:Uri uri=Uri(scheme: "https", host: "flutterchina.club", queryParameters: { "xx":"xx", "yy":"dd" });
通過
HttpClientRequest
可以設(shè)置請求header字管,如:request.headers.add("user-agent", "test");
如果是post或put等可以攜帶請求體方法,可以通過HttpClientRequest對象發(fā)送request body信不,如:
String payload="..."; request.add(utf8.encode(payload)); //request.addStream(_inputStream); //可以直接添加輸入流
-
等待連接服務(wù)器:
HttpClientResponse response = await request.close();
這一步完成后嘲叔,請求信息就已經(jīng)發(fā)送給服務(wù)器了,返回一個
HttpClientResponse
對象浑塞,它包含響應(yīng)頭(header)和響應(yīng)流(響應(yīng)體的Stream)借跪,接下來就可以通過讀取響應(yīng)流來獲取響應(yīng)內(nèi)容。 -
讀取響應(yīng)內(nèi)容:
String responseBody = await response.transform(utf8.decoder).join();
我們通過讀取響應(yīng)流來獲取服務(wù)器返回的數(shù)據(jù)酌壕,在讀取時我們可以設(shè)置編碼格式,這里是utf8歇由。
-
請求結(jié)束卵牍,關(guān)閉
HttpClient
:httpClient.close();
關(guān)閉client后,通過該client發(fā)起的所有請求都會中止沦泌。
使用示例:
class HttpTestRoute extends StatefulWidget {
@override
_HttpTestRouteState createState() => new _HttpTestRouteState();
}
class _HttpTestRouteState extends State<HttpTestRoute> {
bool _loading = false;
String _text = "";
@override
Widget build(BuildContext context) {
return ConstrainedBox(
constraints: BoxConstraints.expand(),
child: SingleChildScrollView(
child: Column(
children: <Widget>[
RaisedButton(
child: Text("獲取掘金首頁", style: TextStyle(color: Colors.red,fontSize: 13),),
onPressed: _loading ? null : () async {
setState(() {
_loading = true;
_text = "正在請求...";
});
try {
//創(chuàng)建一個HttpClient
HttpClient httpClient = new HttpClient();
//打開Http連接
HttpClientRequest request = await httpClient.getUrl(
Uri.parse("https://juejin.im/"));
//使用iPhone的UA
request.headers.add("user-agent", "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_1 like Mac OS X) AppleWebKit/603.1.30 (KHTML, like Gecko) Version/10.0 Mobile/14E304 Safari/602.1");
//等待連接服務(wù)器(會將請求信息發(fā)送給服務(wù)器)
HttpClientResponse response = await request.close();
//讀取響應(yīng)內(nèi)容
_text = await response.transform(utf8.decoder).join();
//輸出響應(yīng)頭
print(response.headers);
//關(guān)閉client后糊昙,通過該client發(fā)起的所有請求都會中止。
httpClient.close();
} catch (e) {
_text = "請求失斝磺:$e";
} finally {
setState(() {
_loading = false;
});
}
}
),
Container(
width: MediaQuery.of(context).size.width-50.0,
child: Text(_text.replaceAll(new RegExp(r"\s"), ""))
)
],
),
),
);
}
}
2.3 證書校驗
Https中為了防止通過偽造證書而發(fā)起的中間人攻擊释牺,客戶端應(yīng)該對自簽名或非CA頒發(fā)的證書進行校驗。HttpClient
對證書校驗的邏輯如下:
如果請求的Https證書是可信CA頒發(fā)的回挽,并且訪問host包含在證書的domain列表中(或者符合通配規(guī)則)并且證書未過期没咙,則驗證通過。
如果第一步驗證失敗千劈,但在創(chuàng)建HttpClient時祭刚,已經(jīng)通過SecurityContext將證書添加到證書信任鏈中,那么當(dāng)服務(wù)器返回的證書在信任鏈中的話,則驗證通過涡驮。
如果1暗甥、2驗證都失敗了,如果用戶提供了
badCertificateCallback
回調(diào)捉捅,則會調(diào)用它撤防,如果回調(diào)返回true
,則允許繼續(xù)鏈接棒口,如果返回false
即碗,則終止鏈接。
3. 網(wǎng)絡(luò)請求 dio
Dart社區(qū)有一些第三方http請求庫陌凳,用它們來發(fā)起http請求將會簡單的多剥懒,其中的dio庫人氣較高,用戶SDK示例中選用的也是這一庫合敦。
dio支持Restful API初橘、FormData、攔截器充岛、請求取消保檐、Cookie管理、文件上傳/下載崔梗、超時等夜只,下面我們來看一些??
發(fā)起 GET
請求 :
Response response;
response=await dio.get("/test?id=12&name=wendu")
print(response.data.toString());
對于GET
請求我們可以將query參數(shù)通過對象來傳遞,上面的代碼等同于:
response=await dio.get("/test",queryParameters:{"id":12,"name":"wendu"})
print(response);
發(fā)起一個 POST
請求:
response=await dio.post("/test",data:{"id":12,"name":"wendu"})
發(fā)起多個并發(fā)請求:
response= await Future.wait([dio.post("/info"),dio.get("/token")]);
下載文件:
response=await dio.download("https://www.google.com/",_savePath);
發(fā)送 FormData:
FormData formData = new FormData.from({
"name": "wendux",
"age": 25,
});
response = await dio.post("/info", data: formData)
如果發(fā)送的數(shù)據(jù)是FormData蒜魄,則dio會將請求header的contentType
設(shè)為“multipart/form-data”扔亥。當(dāng)然你也可以自行設(shè)置contentType的類型:
Options options = Options(headers: t.getExtHeaders(), contentType: ContentType.parse("application/x-www-form-urlencoded"));
var response = await dio.post(t.getRequestUrl(), data: FormData.from(t.getBody()), options: options);
dio內(nèi)部實際上仍然使用HttpClient發(fā)起請求,另外一個dio實例可以發(fā)起多個http請求谈为,一般來說旅挤,APP只有一個http數(shù)據(jù)源時,dio應(yīng)該使用單例模式伞鲫。通過上述介紹可以看出dio的封裝能夠讓我們更便捷的使用 HttpClient 進行網(wǎng)絡(luò)請求粘茄。