FlutterUtils
目录介绍
- 01.事件告诉bus工具类
- 02.色彩Color工具类
- 03.日期转化工具类
- 04.File文件工具类
- 05.Sql数据库工具类
- 06.Json转化工具类
- 07.Log日志打印工具类
- 08.屏幕参数工具类
- 09.Sp轻量存储工具类
- 10.辅助计算工具类
- 11.加密和解密工具类
- 12.Num格局解决工具类
- 13.设施参数获取工具类
- 14.图片解决工具类
- 15.网络解决工具类
- 16.罕用正则工具类
- 17.Object常用工具类
- 18.验证相干工具类
- 19.路由管理工具类
- 20.Bus事件工具类
- 21.Text文本工具类
- 22.i18拓展工具类
- 23.Time工夫工具类
- 24.SPI帮忙工具类
- 25.计时器辅助工具类
- 26.常见拓展工具类
- 27.内存缓存工具类
- 28.革除操作工具类
- 29.编解码相干工具类
- 30.反射相干工具类
- 31.资源相干工具类
- 32.Snackbar工具类
- 33.转化相干工具类
- 34.全局异样捕捉工具
- 35.解析数据工具类
- 36.字节转化工具类
- 40.其余相干工具类
00.该库阐明
00.1 该库工具类汇总
| 工具类 | 性能阐明 |
|---|---|
| EventBusService | bus事件告诉工具类，实现了订阅者模式。用于组件之间通信 |
| CalculateUtils | 计算文本的宽，高 |
| ColorUtils | 次要是将RGB/ARGB转化为16进制字符串色彩或者Color |
| DateFormats | 常见中文，英文的日期工夫转化的格局。蕴含绝大多数的日期格局 |
| DateUtils | 日期工具类，获取日期工夫，各种工夫之间的转换操作 |
| EncryptUtils | 加解密工具类，次要是md5加密，base64加密和解密，异或加解密等 |
| ExtensionXxx | 拓展类，蕴含int，list，map，set，num，string等拓展类，有大多数常见操作方法 |
| TransformUtils | 转化工具类，蕴含int，string转化二进制，字母大小写转化等等 |
| ValidatorUtils | 校验工具类，蕴含常见类型，图片，url，邮箱，电话，资源文件，驼峰命名等校验 |
| ExtensionXxx | 拓展类，蕴含int，list，map，set，num，string等拓展类，有大多数常见操作方法 |
| TransformUtils | 转化工具类，蕴含int，string转化二进制，字母大小写转化等等 |
| FileUtils | 文件缓存类，次要是存储和获取字符串，Map，Json等数据，写到本地file文件 |
| TransformUtils | 转化工具类，蕴含int，string转化二进制，字母大小写转化等等 |
| AppLocalizations | i18相干，能够设置locale，获取语言中字符串 |
| ImageUtils | 图片工具类，次要是负责图片和base64转化，加载网络图片，切换圆角，圆形等 |
| JsonUtils | json转化工具类，次要是负责list，map，对象和json之间转化等 |
| get_it | spi接口实现，将接口（形象基类）与具体实现拆散和解耦合 |
| LogUtils | 日志工具类，设置日志开关，长度，以及能够过滤标签，打印5种类型日志 |
| NumUtils | Num格局工具类，次要是负责num相干解决和转化操作 |
| ObjectUtils | Object超类工具类，负责各种对象判断，获取长度等操作 |
| RegexConstants | 常见正则表达式的规定常量，这部分次要参考AndroidUtils |
| RegexUtils | 正则表达式工具类，次要是电话，身份证，邮箱，ip，网络等校验 |
| ScreenUtils | 屏幕工具类，获取屏幕的宽高，以及像素密度比等 |
| SpUtils | sp存储工具类，适宜存储轻量级数据，不倡议存储json长字符串 |
| TextUtils | 文本工具类，次要解决字符串缩略，*，比拟，移除等操作 |
| TimerUtils | 倒计时器工具类，设置倒计时总工夫，间隔时间，开始暂停等 |
| UrlUtils | url工具类，获取url的host，参数，校验等操作 |
| SystemUtils | 零碎工具类，复制内容到剪切板，弹出和敞开软键盘，革除数据等 |
| OtherUtils | RandomUtils随机工具类，SnackUtils，PlatformUtils平台工具类 |
| MVP | Flutter版本的MVP架构模版，待欠缺中…… |
00.2 如何应用该库
- 具体文档能够demo
01.事件告诉bus工具类
事件总线
- 通常实现了订阅者模式，订阅者模式蕴含发布者和订阅者两种角色。
第一种形式：应用map汇合存储key为事件eventName，value为EventCallback实现bus
//注册监听bus_subscription = EventBusService.instance.eventBus.on<EventMessage>().listen((event) { String name = event.eventName; //前后台切换产生了变动 if (name == "eventBus1") { var busMessage = event.arguments["busMessage"]; setState(() { message1 = busMessage; }); } });//发送音讯EventBusService.instance.eventBus.fire(EventMessage( "eventBus1", arguments: {"busMessage": "发送bus音讯1"},));//页面销毁革除busif (_subscription != null) { _subscription.cancel(); _subscription = null;}第二种形式：应用StreamController实现bus事件告诉
//注册监听音讯bus.on("eventBus2", (arg) { var busMessage = arg; setState(() { message2 = "接管音讯：" + busMessage; });});//发送音讯var arg = "发送bus音讯1";bus.emit("eventBus2", arg);//移除音讯bus.off("eventBus2", (arg) {});
02.色彩Color工具类
色彩Color工具类。次要是将RGB或者ARGB色彩转化为Color对象，16进制色彩字符串等等。
hexToColor : 将#A357D6色彩转化为16进制的ColortoColor : 将#FF6325色彩或者#50A357D6转化为16进制的ColorcolorString : 将color色彩转变为字符串colorString : 查看字符串是否为十六进制
03.日期转化工具类
日期转化工具类。次要是获取以后日期，按指定格局格式化工夫，以及多种格式化日期工具办法
getNowDateTime : 获取以后日期返回DateTimegetYesterday : 获取昨天日期返回DateTimegetNowUtcDateTime : 获取以后日期返回DateTime(utc)getNowDateTimeFormat : 获取以后日期，返回指定格局getUtcDateTimeFormat : 获取以后日期，返回指定格局isYesterday : 依据工夫判断是否是昨天getNowDateMs : 将#获取以后毫秒值，返回intgetNowDateString : 获取当初日期字符串，默认是：yyyy-MM-dd HH:mm:ss，返回字符串formatDate : 格式化工夫，第一个字段是dateTime，第二个可选项示意格局formatDateString : 格式化日期字符串，第一个字段例如：'2021-07-18 16:03:10'，第二个字段例如："yyyy/M/d HH:mm:ss"formatDateMilliseconds : 格式化日期毫秒工夫，第一个字段例如：1213423143312，第二个字段例如："yyyy/M/d HH:mm:ss"getWeekday : 获取dateTime是星期几getWeekdayByMilliseconds : 获取毫秒值对应是星期几isToday : 依据工夫戳判断是否是明天isYesterday : 依据工夫判断是否是昨天
04.File文件工具类
4.1 文件存储工具类
文件存储工具类。次要是存储和获取String，Json等文件，这个是存储到file本地文件
getTempDir : 获取一个长期目录(缓存)，零碎能够随时革除getAppDocDir : 获取应用程序的目录，用于存储只有它能够拜访的文件。只有当应用程序被删除时，零碎才会革除目录。getAppFile : 初始化文件门路，默认选中应用程序的目录readStringDir : 获取存在文件中的数据，默认读到应用程序的目录writeJsonFileDir : 写入json文件，默认写到应用程序的目录writeStringDir : 利用文件存储字符串，默认写到应用程序的目录clearFileDataDir : 革除缓存数据deleteFileDataDir : 删除缓存文件writeJsonCustomFile : 写入json文件，自定义门路writeStringFile : 利用文件存储字符串，自定义门路readStringCustomFile : 获取自定义门路文件存中的数据
4.2 文件管理工具类
文件管理工具类。次要是创立不同的目录门路，创立文件，或者目录门路等操作。
getTempPath : 获取设施上长期目录的门路，该目录没有备份，适宜存储下载文件的缓存。getAppDocPath : 获取应用程序的目录，用于存储只有它能够拜访的文件。只有当应用程序被删除时，零碎才会革除目录。getStoragePath : 应用程序能够拜访顶层存储的目录的门路createDirSync : 异步创立文件createDir : 同步创立文件createTempDir : 创立长期目录createAppDocDir : 创立获取应用程序的目录
05.Sql数据库工具类
- 待欠缺
06.Json转化工具类
Json转化工具类。json转化常见的操作，逐步完善list，map和json字符串互转等。
printJson : 单纯的Json格局输入打印printJsonEncode : 单纯的Json格局输入打印encodeObj : 将对象[值]转换为JSON字符串getObj : 转换JSON字符串到对象getObject : 转换JSON字符串或JSON映射[源]到对象getObjList : 转换JSON字符串列表[源]到对象列表getObjectList : 转换JSON字符串或JSON映射列表[源]到对象列表
07.Log日志打印工具类
Log日志打印工具类。五种不同类型日志，还能够增加tag标签过滤。
init : 初始化日志，自定义tag，是否是debug环境，日志最大长度，这几个字段都是非必选d : 打印debug日志e : 打印error日志v : 打印v日志i : 打印info日志w : 打印ware正告日志
08.屏幕参数工具类
屏幕参数工具类。获取屏幕的宽，高，像素密度，状态栏等属性。前期欠缺适配工作……
screenWidthDp : 以后设施宽度 dpscreenHeightDp : 以后设施高度 dppixelRatio : 设施的像素密度screenWidth : 以后设施宽度 px = dp * 密度screenHeight : 以后设施高度 px = dp * 密度statusBarHeight : 状态栏高度 dp 刘海屏会更高bottomBarHeight : 底部安全区间隔 dptextScaleFactory : 像素的字体像素数，字体的缩放比例
09.Sp轻量存储工具类
sp轻量级存储工具。次要是sp存储和获取int，String，list，map等数据操作。
init : 初始化，必须要初始化hasKey : 判断是否存在key的数据putObject : 存储object类型数据getObject : 获取sp中key的map数据putObjectList : 存储sp中key的list汇合getObjectList : 获取sp中key的list汇合getString : 获取sp中key的字符串putString : 存储sp中key的字符串getBool : 获取sp中key的布尔值putBool : 存储sp中key的布尔值getInt : 获取sp中key的int值putInt : 存储sp中key的int值getDouble : 获取sp中key的double值putDouble : 存储sp中key的double值getStringList : 获取sp中key的list<String>值putStringList : 存储sp中key的list<String>值getStringMap : 获取sp中key的map值putStringMap : 存储sp中key的map值getDynamic : 获取sp中key的dynamic值getKeys : 获取sp中所有的keyremove : 移除sp中key的值clear : 革除spisInitialized : 查看初始化forEach : 遍历打印sp的key和value
11.加密和解密工具类
加密和解密工具类。目前反对base64加解密，md5加密。前期逐步完善更多加密办法……
encodeMd5 : md5 加密字符串，这种是不可逆的encodeBase64 : Base64加密字符串decodeBase64 : Base64解密字符串xorBase64Encode : 异或对称 Base64 加密xorBase64Decode : 异或对称 Base64 解密
12.Num格局解决工具类
格局解决工具类。次要是解决num格局转化相干操作。
isNum : 查看字符串是int还是doublegetIntByValueString : 将数字字符串转int。如果字符串不是数字，则转化为0getDoubleByValueString : 数字字符串转double。如果字符串不是数字，则转化为0getNumByValueString : 将数字字符串转num，数字保留x位小数getNumByValueDouble : 浮点数字保留x位小数addNum : 两个数相加（避免精度失落）subtractNum : 两个数相减（避免精度失落）multiplyNum : 两个数相乘（避免精度失落）divideNum : 两个数相除（避免精度失落）addDecString : 两个数相加（避免精度失落）subtractDecString : 两个数相减（避免精度失落）multiplyDecString : 两个数相乘（避免精度失落）divideDecString : 两个数相除（避免精度失落）
14.图片解决工具类
其余待欠缺，补充圆角，圆形切割图片，以及解决本地等图片的办法。前期欠缺获取图片属性，图片压缩，各种切圆角办法。
base64ToImage : 将base64流转化为图片fileToBase64 : 将图片file转化为base64networkImageToBase64 : 将网络链接图片转化为base64assetImageToBase64 : 将asset图片转化为base64showNetImageWh : 加载网络图片，并且指定宽高大小。应用默认预加载loading和谬误视图showNetImageWhError : 加载网络图片，并且指定宽高大小。传入谬误视图showNetImageWhPlaceError : 加载网络图片，并且指定宽高大小。传入预加载，谬误视图showNetImageWhClip : 加载网络图片，并且指定宽高大小，切割圆角showNetImageCircle : 加载网络图片，切割圆形图片
15.网络解决工具类
15.1 网络申请工具类
15.2 Url解析工具类
解决url解析相干工具类
containsTarget : 判断url链接是否蕴含参数getFirstPath : 获取url中第一个参数getUrlHost : 获取url链接中hostgetUrlScheme : 获取url链接中schemegetFirstPath : 获取url中第一个参数isURL : 返回输出是否匹配url的正则表达式
16.罕用正则工具类
罕用正则表达式，借鉴AndroidUtils工具类，将java转为dart
isMobileSimple : 简略验证手机号isMobileExact : 准确验证手机号isTel : 验证电话号码isIDCard15 : 验证身份证号码 15 位isIDCard18 : 简略验证身份证号码 18 位isIDCard18Exact : 准确验证身份证号码 18 位isEmail : 验证邮箱isURL : 验证 URLisZh : 验证汉字isUsername : 验证用户名isDate : 验证 yyyy-MM-dd 格局的日期校验，已思考平平年isIP : 验证 IP 地址match : 判断是否匹配正则RegexConstants.REGEX_DOUBLE_BYTE_CHAR : 双字节RegexConstants.REGEX_BLANK_LINE : 空行RegexConstants.REGEX_QQ_NUM : QQ 号RegexConstants.REGEX_CHINA_POSTAL_CODE : 邮编RegexConstants.REGEX_INTEGER : 整数RegexConstants.REGEX_POSITIVE_INTEGER : 正整数RegexConstants.REGEX_NEGATIVE_INTEGER : 负整数RegexConstants.REGEX_NOT_NEGATIVE_INTEGER: 非负整数RegexConstants.REGEX_NOT_POSITIVE_INTEGER: 非正整数RegexConstants.REGEX_FLOAT : 浮点数RegexConstants.REGEX_POSITIVE_FLOAT : 正浮点数RegexConstants.REGEX_NEGATIVE_FLOAT : 负浮点数RegexConstants.REGEX_NOT_NEGATIVE_FLOAT : 非负浮点数RegexConstants.REGEX_NOT_POSITIVE_FLOAT : 非正浮点数
17.Object常用工具类
Object相干工具类如下：
isNull : 判断对象是否为nullisNullOrBlank : 检查数据是否为空或空(空或只蕴含空格)isEmptyString : 判断字符串是否为空isEmptyList : 判断汇合是否为空isEmptyMap : 判断字典是否为空isEmpty : 判断object对象是否为空isNotEmpty : 判断object是否不为空compareListIsEqual : 比拟两个汇合是否雷同getLength : 获取object的长度
18.验证相干工具类
验证相干工具类
isNumericOnly : 查看字符串是否只蕴含数字isAlphabetOnly : 查看字符串是否只蕴含字母。(没有空格)isBool : 查看字符串是否为布尔值isVector : 查看string是否为vector文件isImage : 查看字符串是否为图像文件isAudio : 查看字符串是否为音频文件isVideo : 查看字符串是否为视频文件isTxt : 查看字符串是否为txt文本文件isDocument : 查看字符串是否为doc文件isExcel : 查看字符串是否为excel文件isPPT : 查看字符串是否为ppt文件isAPK : 查看字符串是否为apk文件isPDF : 查看字符串是否为pdf文件isHTML : 查看字符串是否为html文件isURL : 查看字符串是否为url文件isEmail : 查看字符串是否为email文件isDateTime : 查看字符串是否为工夫isMD5 : 查看字符串是否为md5isSHA1 : 查看字符串是否为sha1isSHA256 : 查看字符串是否为sha256isIPv4 : 查看字符串是否为ipv4isIPv6 : 查看字符串是否为ipv6isPalindrome : 查看字符串是否为回文isCaseInsensitiveContains : 查看a是否蕴含b(将大小写字母视为雷同或解释)。isCaseInsensitiveContainsAny : 查看a中是否蕴含b或b中是否蕴含a(将大小写字母视为雷同)。isCamelCase : 查看字符串值是否驼峰大小写isCapitalize : 查看字符串值是否大写
19.路由管理工具类
21.Text文本工具类
文本相干工具类如下：
isEmpty : 判断文本内容是否为空isNotEmpty : 判断文本内容是否不为空startsWith : 判断字符串是以xx结尾contains : 判断字符串中是否蕴含xxabbreviate : 应用点缩写字符串compare : 比拟两个字符串是否雷同hammingDistance : 比拟两个长度一样的字符串有几个字符不同formatDigitPattern : 每隔 x位 加 pattern。比方用来格式化银行卡formatSpace4 : 每隔4位加空格hideNumber : 暗藏手机号两头n位，比方暗藏手机号 13667225184 为 136****5184replace : 替换字符串中的数据split : 依照规定切割字符串，返回数组reverse : 反转字符串
22.i18拓展工具类
LocatizationExtensionState类中：String getString(String id)
- 获取不同Locales渠道语言内容。举例：应用：var name = context.getString("name");
LocatizationExtensionContext类中：String getString(String id)
- 获取不同Locales渠道语言内容
如何增加不同渠道语言内容。写在 main 函数中 runApp 之前
AppLocalizations.supportedLocales = [ const Locale('en', 'US'), const Locale('pt', 'BR'), const Locale('ja', 'JP'), const Locale('zh', 'CN'),];
23.Time工夫工具类
24.SPI帮忙工具类
spi简略介绍
Service Locator能够将接口（形象基类）与具体实现拆散和解耦合，同时容许通过接口从App中的任何地位拜访具体实现。
//第一步注册GetIt serviceLocator = GetIt.instance;getIt.registerSingleton<BusinessService>(new BusinessServiceImpl());//第二步应用BusinessService businessService = serviceLocator<BusinessService>();businessService.noneBusinessPattern();//第三步解绑serviceLocator.resetLazySingleton<BusinessService>();
25.计时器辅助工具类
计时器辅助工具类
TimerUtils : 创立倒计时器setTotalTime : 设置倒计时总工夫setInterval : 设置Timer距离startTimer : 启动定时TimerupdateTotalTime : 重设倒计时总工夫isActive : 判断Timer是否启动pauseTimer : 暂停倒计时器cancel : 勾销计时器setOnTimerTickCallback : 设置倒计时器的监听
26.常见拓展工具类
26.1 int拓展类：ExtensionInt
ExtensionInt拓展类
isPalindrome : 查看int是否为回文isOneAKind : 查看所有数据是否具备雷同的值toBinary : 转换int值为二进制toBinaryInt : 转换int值为二进制intfromBinary : 转换int值为二进制字符串
26.2 List拓展类：ExtensionList
ExtensionList拓展类
toJsonString : 将list转化为json字符串getJsonPretty : 将list转化为json字符串，换行valueTotal : 获取num列表的总值(int/double)isNull : 判断对象是否为nullisNullOrBlank : 检查数据是否为空或空(空或只蕴含空格)
26.3 Map拓展类：ExtensionMap
ExtensionMap拓展类【set拓展类同理】
toJsonString : 将map转化为json字符串getJsonPretty : 将map转化为json字符串换行isNull : 判断对象是否为nullisNullOrBlank : 检查数据是否为空或空(空或只蕴含空格)
26.4 String拓展类：ExtensionString
ExtensionString拓展类
isNull : 判断对象是否为nullisNullOrBlank : 检查数据是否为空或空(空或只蕴含空格)isNumericOnly : 查看字符串是否只蕴含数字isAlphabetOnly : 查看字符串是否只蕴含字母。(没有空格)isBool : 查看字符串是否为布尔值isVector : 查看string是否为vector文件isImage : 查看字符串是否为图像文件isAudio : 查看字符串是否为音频文件isVideo : 查看字符串是否为视频文件isTxt : 查看字符串是否为txt文本文件isDocument : 查看字符串是否为doc文件isExcel : 查看字符串是否为excel文件isPPT : 查看字符串是否为ppt文件isAPK : 查看字符串是否为apk文件isPDF : 查看字符串是否为pdf文件isHTML : 查看字符串是否为html文件isURL : 查看字符串是否为url文件isEmail : 查看字符串是否为email文件isDateTime : 查看字符串是否为工夫isMD5 : 查看字符串是否为md5isSHA1 : 查看字符串是否为sha1isSHA256 : 查看字符串是否为sha256isIPv4 : 查看字符串是否为ipv4isIPv6 : 查看字符串是否为ipv6isPalindrome : 查看字符串是否为回文isCaseInsensitiveContains : 查看a是否蕴含b(将大小写字母视为雷同或解释)。isCaseInsensitiveContainsAny : 查看a中是否蕴含b或b中是否蕴含a(将大小写字母视为雷同)。isCamelCase : 查看字符串值是否驼峰大小写isCapitalize : 查看字符串值是否大写
33.转化相干工具类
转化相干的操作工具类
toBinary : 转换int值为二进制，比方：15 => 1111toBinaryInt : 转换int值为二进制fromBinary : 转换二进制为int值capitalize : 字符串内的每个单词都要大写capitalizeFirst : 字符串的首字母大写，其余字母小写removeAllWhitespace : 删除字符串内的所有空格numericOnly : 提取字符串的数值
34.全局异样捕捉工具
针对flutter全局异样捕捉，能够应用：handle_exception
//如果应用，在main办法中，如下所示：hookCrash(() { runApp(MainApp());});捕捉一场打印输出：
I/flutter ( 9506): yc e — — — — — — — — — — st — — — — — — — — — — — — —I/flutter ( 9506): yc e | handle_exception : e---->MissingPluginException(No implementation found for method getAll on channel plugins.flutter.io/shared_I/flutter ( 9506): yc e | preferences)I/flutter ( 9506): yc e — — — — — — — — — — ed — — — — — — — — — ---— —I/flutter ( 9506): yc e handle_exception : stack---->
35.解析数据工具类
- 解析xml/html数据工具类
36.字节转化工具类
ByteUtils转化相干的操作工具类
toBinary : 转换int值为二进制toReadable : 将字节数组转换为可读字符串toBase64 : 将字节数组转换为base64字符串fromBase64 : 转换base64字符串到字节数组clone : 克隆字节数组same : 判断两个字节是否雷同extract : 从字节序列中提取数据combine : 将两个字节拼接insert : 在字节某个索引处插入字节remove : 在字节某个索引处移除字节
40.其余相干工具类
40.2 随机工具类
RandomUtils
randomColor : 生成一个示意十六进制色彩的随机整数randomString : 生成指定长度或随机长度的随机字符串randInt : 在开始和完结之间生成一个随机数randomElement : 从列表中返回一个随机元素
40.3 获取平台工具类
PlatformUtils。该工具类能够通过获取平台，而后设置一个value区别平台信息。
final value = PlatformUtils.select( ios: "ios", android: "android", web: "web", fuchsia: "fuchsia", macOS: () => "macOS", windows: () => "windows", linux: () => "linux",);//后果，在Android设施上，value就是：android
40.4 剪切板工具类
零碎工具类，次要是软键盘操作和复制内容到剪切板
copyToClipboard : 拷贝文本内容到剪切板hideKeyboard : 暗藏软键盘，具体可看：TextInputChannelshowKeyboard : 展现软键盘clearClientKeyboard : 革除数据