https://zhuanlan.zhihu.com/p/53498914

 

 

Flutter中的單例以及網絡請求庫的封裝

ClassNotFound

程序員

25 人贊同了該文章

 

Why?為什么需要單例

在Android中我們經常使用OkHttp來進行網絡請求，但我們並不希望每次都創建一個OkHttpClient；亦或有些資源初始化非常麻煩，消耗性能，我們希望一次創建，處處使用。這時候就需要單例。Dio作為flutter中的OkHttp，我們也可以用單例模式對其進行封裝。

How?如何用dart實現單例

單例一般有這幾個特征：

1. 隱藏類的構造函數
2. 提供一個方法獲取該類的實例（Java中常常是一個靜態方法，通過DCL或靜態內部類等方法，返回一個實例）
3. 該實例只能被創建一次，內存中獨一份，任何地方通過調用特征2中所述方法獲取到的實例都應該是同一個

來看看《Dart Cookbook》中時如何實現單例模式的：

/*The singleton example shows how to do this (substitute your singleton class name for Immortal). Use a factory constructor to implement the  singleton pattern, as shown in the following code:*/ class Immortal { static final Immortal theOne = new Immortal._internal('Connor MacLeod'); String name; factory Immortal(name) => theOne; // private, named constructor  Immortal._internal(this.name); } main() { var im1 = new Immortal('Juan Ramirez'); var im2 = new Immortal('The Kurgan'); print(im1.name); print(im2.name); print(Immortal.theOne.name); assert(identical(im1, im2)); }

可以看到，他通過私有的具名構造方法_internal()隱藏了構造方法，提供了一個工廠方法來獲取該類的實例，並且用static final修飾了theOne，theOne會在編譯期被初始化，保證了特征3。至於theOne為什么會在編譯期初始化，參考 Static variable initialization opened up to any expression。

Singleton In Action!在項目中使用單例

Dio是flutterchina提供的一個網絡請求庫，可以說是Flutter中的OkHttp，支持攔截器，緩存等特性。具體使用參考Dio github。我在項目中使用單例模式對Dio庫進行了一層簡單封裝：

import "package:dio/dio.dart"; import 'dart:async';  class HttpUtil {  static final HttpUtil _instance = HttpUtil._internal();  Dio _client;   factory HttpUtil() => _instance;   HttpUtil._internal() {  if (null == _client) {  Options options = new Options();  options.baseUrl = "http://www.wanandroid.com";  options.receiveTimeout = 1000 * 10; //10秒  options.connectTimeout = 5000; //5秒  _client = new Dio(options); } } Future<Map<String, dynamic>> get(String path, [Map<String, dynamic> params]) async { Response<Map<String, dynamic>> response; if (null != params) { response = await _client.get(path, data: params); } else { response = await _client.get(path); } return response.data; } //...省略post等方法... }

One More Thing

App后端接口返回的數據格式一般都有固定結構，以wanandroid.com的開發Api為例：

{ "data": { "curPage": 1, "datas": [], "offset": 0, "over": true, "pageCount": 0, "size": 20, "total": 0 }, "errorCode": 0, "errorMsg": "" }

要解析這樣的json，Android中可以玩出花。但是flutter禁用反射，也就沒有類似Java中Gson這樣的庫。網上提供了flutter中，幾種根據json自動生成model的方式，如下：

• Json轉Model
• 一個在線的，類似As中的GsonFormat的工具

由於項目中的數據，結構固定，我采用范型+在線工具的的方式來實現我項目中json的解析，這種方法看起來有些笨拙（希望有同學可以提供更優雅的方式讓我學習下）：

1.定義一個抽象類，約定datas字段中model的行為：

abstract class JsonData{ JsonData fromJson(Map<String, dynamic> json,JsonData mySelf); }

2.抽象出data字段對應的model：

import 'package:flutter_app/bean/JsonData.dart'; import 'package:meta/meta.dart'; class PageData<T extends JsonData>{ List<T> datas; int curPage; int pageCount; //...省略size，total等字段  PageData.fromJson({@required Map<String, dynamic> json,@required JsonDataCreator beanCreator}) { // TODO: implement fromJson  curPage = json['curPage']; pageCount = json['pageCount']; print(json); if (json['datas'] != null) { datas = new List<T>(); json['datas'].forEach((v) { JsonData item = beanCreator(); item.fromJson(v,item); datas.add(item); }); } } } typedef JsonDataCreator = JsonData Function();

3.抽象出整個返回結果對應的model:

import 'package:flutter_app/bean/PageData.dart'; import 'package:flutter_app/bean/JsonData.dart'; import 'package:meta/meta.dart'; class BaseResult<T extends JsonData>{ int errorCode; String errorMsg; PageData<T> data; BaseResult.fromJson({@required Map<String, dynamic> json,@required JsonDataCreator beanCreator}) { // TODO: implement fromJson  errorCode = json['errorCode']; errorMsg = json['errorMsg']; data = PageData.fromJson(json:json['data'],beanCreator: beanCreator); } } 

4.在項目中使用時，拿到json，放到在線工具中生成model，copy一下，改成以上約定的格式。以wanandroid文章列表接口為例，其返回結果如下:

{ "data": { "curPage": 2, "datas": [ { "apkLink": "", "author": "鴻洋", "chapterId": 408, "chapterName": "鴻洋", "collect": false, "courseId": 13, "desc": "", "envelopePic": "", ...其他字段 "title": "一篇文本跳動控件，為你打開一扇大門，學會這兩點心得，控件你也會寫", "type": 0, "userId": -1, "visible": 1, "zan": 0 }, .... ], "errorCode":0, "errorMsg": } } 

封裝一個model對應datas中的一個數據:

import 'package:flutter_app/bean/JsonData.dart'; class ProjectBean extends JsonData{ String title; String envelopePic; @override JsonData fromJson(Map<String, dynamic> json, JsonData mySelf) { // TODO: implement fromJson  if(mySelf is ProjectBean){ mySelf.title = json['title']; mySelf.envelopePic = json['envelopePic']; //...省略其他字段  } return mySelf; } } 

請求數據，並解析:

class ApiService{ static Future<List<ProjectBean>> getProjectList() async{ String url = "/project/list/1/json"; Map<String,dynamic> response = await HttpUtil().get(url); BaseResult result = BaseResult<ProjectBean>.fromJson(json: response,beanCreator: ()=>ProjectBean()); print(result.data.datas.length); return result.data.datas; } } 

因為flutter中不能使用反射，我不知道有什么方法能夠獲得范型的實際類型，所以PageData的構造方法fromJson()需要傳入一個閉包，用來創建model。

Thanks

感謝這些分享知識的作者，讓我學習的過程中有資料可參考：

幫你整理一份快速入門Flutter的秘籍​mp.weixin.qq.com 8 篇文章，再學不會 Flutter 你來打我！​mp.weixin.qq.com Flutter基礎視頻免費教程 共25集完成​juejin.im 《Flutter實戰》開源電子書 - 掘金​juejin.im

 

 

https://blog.csdn.net/aau88497/article/details/102344984

 

 

地址：https://pub.flutter-io.cn/packages/common_utils#-readme-tab-

Dart常用工具類庫 common_utils

1、TimelineUtil : 時間軸.(新)
2、TimerUtil : 倒計時，定時任務.(新)
3、MoneyUtil : 精確轉換，元轉分，分轉元，支持格式輸出.(新)
4、LogUtil : 簡單封裝打印日志.(新)
5、DateUtil : 日期轉換格式化輸出.
6、RegexUtil : 正則驗證手機號，身份證，郵箱等等.
7、NumUtil : 保留x位小數, 精確加、減、乘、除, 防止精度丟失.
8、ObjectUtil : 判斷對象是否為空(String List Map),判斷兩個List是否相等.

Flutter工具類庫 flustars

1、DioUtil : Dio 工具類.
2、SpUtil : 單例"同步" SharedPreferences 工具類.
3、ScreenUtil : 屏幕適配，獲取屏幕寬、高、密度，AppBar高，狀態欄高度，屏幕方向.
4、WidgetUtil : Widget渲染監聽，獲取Widget寬高，在屏幕上的坐標.

Add dependency #

1.  
   dependencies:
2.  
   common_utils: x.x.x #latest version
3.  
    

APIs #

• TimelineUtil -> Example

1.  
   ///(xx)為可配置輸出
2.  
   enum DayFormat {
3.  
   ///(小於10s->剛剛)、x分鍾、x小時、(昨天)、x天.
4.  
   Simple,
5.  
   ///(小於10s->剛剛)、x分鍾、x小時、[今年: (昨天/1天前)、(2天前)、MM-dd],[往年: yyyy-MM-dd].
6.  
   Common,
7.  
   ///小於10s->剛剛)、x分鍾、x小時、[今年: (昨天 HH:mm/1天前)、(2天前)、MM-dd HH:mm],[往年: yyyy-MM-dd HH:mm].
8.  
   Full,
9.  
   }
10.  
    ///Timeline信息配置.
11.  
    abstract class TimelineInfo {
12.  
    String suffixAgo(); //suffix ago(后綴 后).
13.  
    String suffixAfter(); //suffix after(后綴 前).
14.  
    String lessThanTenSecond() => ''; //just now(剛剛).
15.  
    String customYesterday() => ''; //Yesterday(昨天).優先級高於keepOneDay
16.  
    bool keepOneDay(); //保持1天,example: true -> 1天前, false -> MM-dd.
17.  
    bool keepTwoDays(); //保持2天,example: true -> 2天前, false -> MM-dd.
18.  
    String oneMinute(int minutes); //a minute(1分鍾).
19.  
    String minutes(int minutes); //x minutes(x分鍾).
20.  
    String anHour(int hours); //an hour(1小時).
21.  
    String hours(int hours); //x hours(x小時).
22.  
    String oneDay(int days); //a day(1天).
23.  
    String days(int days); //x days(x天).
24.  
    DayFormat dayFormat(); //format.
25.  
    }
26.  
    setLocaleInfo : 自定義設置配置信息.
27.  
    formatByDateTime : 格式輸出時間軸信息 by DateTime .
28.  
    format : 格式輸出時間軸信息.
29.  
     

• TimerUtil -> Example

1.  
   setInterval : 設置 Timer間隔.
2.  
   setTotalTime : 設置倒計時總時間.
3.  
   startTimer() : 啟動定時 Timer.
4.  
   startCountDown : 啟動倒計時 Timer.
5.  
   updateTotalTime : 重設倒計時總時間.
6.  
   cancel : 取消計時器.
7.  
   setOnTimerTickCallback : 計時器回調.
8.  
   isActive : Timer是否啟動.

• MoneyUtil 精確轉換,防止精度丟失 -> Example

1.  
   changeF2Y : 分 轉 元, format格式輸出.
2.  
   changeFStr2YWithUnit : 分字符串 轉 元, format 與 unit 格式 輸出.
3.  
   changeF2YWithUnit : 分 轉 元, format 與 unit 格式 輸出.
4.  
   changeYWithUnit : 元, format 與 unit 格式 輸出.
5.  
   changeY2F : 元 轉 分.

• LogUtil #

1.  
   init(isDebug, tag) : isDebug: 模式, tag 標簽.
2.  
   e(object, tag) : 日志e
3.  
   v(object, tag) : 日志v，只在debug模式輸出.
4.  
    

• NumUtil -> Example

1.  
   getIntByValueStr : 數字字符串轉 int.
2.  
   getDoubleByValueStr : 數字字符串轉double.
3.  
   getNumByValueStr : 保留x位小數 by 數字字符串.
4.  
   getNumByValueDouble : 保留x位小數 by double.
5.  
   add : 加(精確相加,防止精度丟失).
6.  
   subtract : 減(精確相減,防止精度丟失).
7.  
   multiply : 乘(精確相乘,防止精度丟失).
8.  
   divide : 除(精確相除,防止精度丟失).
9.  
   remainder : 余.
10.  
    lessThan : < .
11.  
    thanOrEqual : <= .
12.  
    greaterThan : > .
13.  
    greaterOrEqual : >= .
14.  
     

• DateUtil -> Example

1.  
   enum DateFormat {
2.  
   DEFAULT, //yyyy-MM-dd HH:mm:ss.SSS
3.  
   NORMAL, //yyyy-MM-dd HH:mm:ss
4.  
   YEAR_MONTH_DAY_HOUR_MINUTE, //yyyy-MM-dd HH:mm
5.  
   YEAR_MONTH_DAY, //yyyy-MM-dd
6.  
   YEAR_MONTH, //yyyy-MM
7.  
   MONTH_DAY, //MM-dd
8.  
   MONTH_DAY_HOUR_MINUTE, //MM-dd HH:mm
9.  
   HOUR_MINUTE_SECOND, //HH:mm:ss
10.  
    HOUR_MINUTE, //HH:mm
11.  
     
12.  
    ZH_DEFAULT, //yyyy年MM月dd日 HH時mm分ss秒SSS毫秒
13.  
    ZH_NORMAL, //yyyy年MM月dd日 HH時mm分ss秒 / timeSeparate: ":" --> yyyy年MM月dd日 HH:mm:ss
14.  
    ZH_YEAR_MONTH_DAY_HOUR_MINUTE, //yyyy年MM月dd日 HH時mm分 / timeSeparate: ":" --> yyyy年MM月dd日 HH:mm
15.  
    ZH_YEAR_MONTH_DAY, //yyyy年MM月dd日
16.  
    ZH_YEAR_MONTH, //yyyy年MM月
17.  
    ZH_MONTH_DAY, //MM月dd日
18.  
    ZH_MONTH_DAY_HOUR_MINUTE, //MM月
19.  
    dd日 HH時mm分 / timeSeparate: ":" --> MM月dd日 HH:mm
20.  
    ZH_HOUR_MINUTE_SECOND, //HH時mm分ss秒
21.  
    ZH_HOUR_MINUTE, //HH時mm分
22.  
    }
23.  
    getNowDateMs : 獲取現在 毫秒.
24.  
    getNowDateStr : 獲取現在 日期字符串.(yyyy-MM-dd HH:mm:ss)
25.  
    getDateMsByTimeStr : 獲取毫秒 By 日期字符串(Format格式輸出).
26.  
    getDateStrByTimeStr : 獲取日期字符串 By 日期字符串(Format格式輸出).
27.  
    getDateStrByMs : 獲取日期字符串 By 毫秒(Format格式輸出).
28.  
    getDateStrByDateTime : 獲取日期字符串 By DateTime(Format格式輸出).
29.  
    getWeekDay : 獲取WeekDay By DateTime.
30.  
    getZHWeekDay : 獲取星期 By DateTime.
31.  
    getWeekDayByMs : 獲取WeekDay By 毫秒.
32.  
    getZHWeekDayByMs : 獲取星期 By 毫秒.
33.  
    isLeapYearByYear : 是否是閏年.
34.  
    yearIsEqual : 是否同年.
35.  
    getDayOfYear : 在今年的第幾天.
36.  
    isYesterday : 是否是昨天.
37.  
    isToday : 是否是今天.
38.  
     

• RegexUtil -> Example

1.  
   isMobileSimple : 簡單驗證手機號
2.  
   isMobileExact : 精確驗證手機號
3.  
   isTel : 驗證電話號碼
4.  
   isIDCard : 驗證身份證號碼
5.  
   isIDCard15 : 驗證身份證號碼 15 位
6.  
   isIDCard18 : 簡單驗證身份證號碼 18 位
7.  
   isIDCard18Exact : 精確驗證身份證號碼 18 位
8.  
   isEmail : 驗證郵箱
9.  
   isURL : 驗證 URL
10.  
    isZh : 驗證漢字
11.  
    isDate : 驗證 yyyy-MM-dd 格式的日期校驗，已考慮平閏年
12.  
    isIP : 驗證 IP 地址

• ObjectUtil -> Example

1.  
   isEmptyString : 判斷 String是否為空.
2.  
   isEmptyList : 判斷List是否為空.
3.  
   isEmptyMap : 判斷Map是否為空.
4.  
   isEmpty : 判斷對象是否為空.(String List Map).
5.  
   isNotEmpty : 判斷對象是否非空.(String List Map).
6.  
   twoListIsEqual : 判斷兩個List是否相等.
7.  
    

Example #

1.  
    
2.  
   // Import package
3.  
   import 'package:common_utils/common_utils.dart';
4.  
    
5.  
   //TimelineUtil
6.  
   DateTime xxxDateTime = DateTime(2018, 6, 16, 16, 16, 16);
7.  
   LogUtil.e("Timeline: " + TimelineUtil.formatByDateTime(xxxDateTime, locale: 'zh').toString());
8.  
    
9.  
   //MoneyUtil example
10.  
    String moneyTxt = MoneyUtil.changeFStr2YWithUnit("1160", format: MoneyFormat.NORMAL, unit: MoneyUnit.YUAN_ZH);
11.  
    String moneyTxt = MoneyUtil.changeYWithUnit("1.66", unit: MoneyUnit.YUAN_ZH);
12.  
     
13.  
    //TimerUtil example
14.  
    TimerUtil timerUtil;
15.  
    //定時任務test
16.  
    timerUtil = new TimerUtil(mInterval: 1000);
17.  
    //timerUtil.setInterval(1000);
18.  
    timerUtil.setOnTimerTickCallback((int value) {
19.  
    LogUtil.e("TimerTick: " + value.toString());
20.  
    });
21.  
    timerUtil.startTimer();
22.  
    //timerUtil.cancel();
23.  
     
24.  
    TimerUtil timerCountDown;
25.  
    //倒計時test
26.  
    timerCountDown = new TimerUtil(mInterval: 1000, mTotalTime: 3 * 1000);
27.  
    // timerCountDown.setInterval(1000);
28.  
    // timerCountDown.setTotalTime(3 * 1000);
29.  
    timerCountDown.setOnTimerTickCallback((int value) {
30.  
    double tick = (value / 1000);
31.  
    LogUtil.e("CountDown: " + tick.toInt().toString());
32.  
    });
33.  
    timerCountDown.startCountDown();
34.  
    //timerUtil.cancel();
35.  
     
36.  
    //LogUtil example
37.  
    LogUtil.init(isDebug: true, tag: "test");
38.  
    LogUtil.e("...log...", tag: "test");
39.  
    LogUtil.v("...log...", tag: "test");
40.  
     
41.  
    //DateUtil example
42.  
    String timeNow = DateUtil.getDateStrByDateTime(DateTime.now());//2018-09-16 23:14:56
43.  
    String timeNow = DateUtil.getDateStrByDateTime(DateTime.now(),format: DateFormat.ZH_NORMAL);//2018年09月16日 23時16分15秒
44.  
    String weekday = DateUtil.getWeekDay(DateTime.parse("2018-09-16"));//Sunday
45.  
    String weekdayZh = DateUtil.getZHWeekDay(DateTime.parse("2018-09-16"));//星期日
46.  
     
47.  
    //First Page init. Notice!!!
48.  
    ScreenUtil.getInstance().init(context);
49.  
     
50.  
    ScreenUtil.screenWidth
51.  
    ScreenUtil.screenHeight
52.  
    ScreenUtil.statusBarHeight
53.  
    ScreenUtil.screenDensity
54.  
     
55.  
    List listA = ["A", "B", "C"];
56.  
    List listB = ["A", "B", "C"];
57.  
    print("Two List Is Equal: " + ObjectUtil.twoListIsEqual(listA, listB).toString());
58.  
     
59.  
    // Global variable，Reference example
60.  
    WidgetUtil widgetUtil = new WidgetUtil();
61.  
     
62.  
    @override
63.  
    Widget build(BuildContext context) {
64.  
    widgetUtil.asyncPrepare(context, false, (Rect rect) {
65.  
    double width = rect.width;
66.  
    double height = rect.height;
67.  
    });
68.  
    return ;
69.  
    }
70.  
     
71.  
    //Widgets must be rendered completely. Otherwise return Rect.zero.
72.  
    Rect rect = WidgetUtil.getWidgetBounds(context);
73.  
    double width = rect.width;
74.  
    double height = rect.height;
75.  
     
76.  
    //Widgets must be rendered completely. Otherwise return Offset.zero.
77.  
    Offset offset = WidgetUtil.getWidgetLocalToGlobal(context);
78.  
    double dx = offset.dx
79.  
    double dx = offset.dy
80.  
     

轉載於:https://www.cnblogs.com/ckAng/p/10538612.html