发布网友 发布时间:2022-04-23 12:50
共12个回答
懂视网 时间:2022-04-22 18:01
本篇文章给大家带来的内容是关于util.promisify的相关内容讲解,有一定的参考价值,有需要的朋友可以参考一下,希望对你有所帮助。util.promisify是在node.js 8.x版本中新增的一个工具,用于将老式的Error first callback转换为Promise对象,让老项目改造变得更为轻松。
在官方推出这个工具之前,民间已经有很多类似的工具了,比如es6-promisify、thenify、bluebird.promisify。
以及很多其他优秀的工具,都是实现了这样的功能,帮助我们在处理老项目的时候,不必费神将各种代码使用Promise再重新实现一遍。
工具实现的大致思路
首先要解释一下这种工具大致的实现思路,因为在Node中异步回调有一个约定:Error first,也就是说回调函数中的第一个参数一定要是Error对象,其余参数才是正确时的数据。
知道了这样的规律以后,工具就很好实现了,在匹配到第一个参数有值的情况下,触发reject,其余情况触发resolve,一个简单的示例代码:
function util (func) { return (...arg) => new Promise((resolve, reject) => { func(...arg, (err, arg) => { if (err) reject(err) else resolve(arg) }) }) }
调用工具函数返回一个匿名函数,匿名函数接收原函数的参数。
匿名函数被调用后根据这些参数来调用真实的函数,同时拼接一个用来处理结果的callback。
检测到err有值,触发reject,其他情况触发resolve
resolve 只能传入一个参数,所以callback中没有必要使用...arg获取所有的返回值
常规的使用方式
拿一个官方文档中的示例
const { promisify } = require('util') const fs = require('fs') const statAsync = promisify(fs.stat) statAsync('.').then(stats => { // 拿到了正确的数据 }, err => { // 出现了异常 })
以及因为是Promise
,我们可以使用await
来进一步简化代码:
const { promisify } = require('util') const fs = require('fs') const statAsync = promisify(fs.stat) // 假设在 async 函数中 try { const stats = await statAsync('.') // 拿到正确结果 } catch (e) { // 出现异常 }
用法与其他工具并没有太大的区别,我们可以很轻易的将回调转换为Promise
,然后应用于新的项目中。
自定义的 Promise 化
有那么一些场景,是不能够直接使用promisify来进行转换的,有大概这么两种情况:
1、没有遵循Error first callback约定的回调函数
2、返回多个参数的回调函数
首先是第一个,如果没有遵循我们的约定,很可能导致reject的误判,得不到正确的反馈。
而第二项呢,则是因为Promise.resolve只能接收一个参数,多余的参数会被忽略。
所以为了实现正确的结果,我们可能需要手动实现对应的Promise函数,但是自己实现了以后并不能够确保使用方不会针对你的函数调用promisify。
所以,util.promisify还提供了一个Symbol类型的key,util.promisify.custom。
Symbol类型的大家应该都有了解,是一个唯一的值,这里是util.prosimify用来指定自定义的Promise化的结果的,使用方式如下:
const { promisify } = require('util') // 比如我们有一个对象,提供了一个返回多个参数的回调版本的函数 const obj = { getData (callback) { callback(null, 'Niko', 18) // 返回两个参数,姓名和年龄 } } // 这时使用promisify肯定是不行的 // 因为Promise.resolve只接收一个参数,所以我们只会得到 Niko promisify(obj.getData)().then(console.log) // Niko // 所以我们需要使用 promisify.custom 来自定义处理方式 obj.getData[promisify.custom] = async () => ({ name: 'Niko', age: 18 }) // 当然了,这是一个曲线救国的方式,无论如何 Promise 不会返回多个参数过来的 promisify(obj.getData)().then(console.log) // { name: 'Niko', age: 18 }
关于Promise为什么不能resolve多个值,我有一个大胆的想法,一个没有经过考证,强行解释的理由:如果能resolve多个值,你让async函数怎么return(当个乐子看这句话就好,不要当真)
不过应该确实跟return有关,因为Promise是可以链式调用的,每个Promise中执行then以后都会将其返回值作为一个新的Promise对象resolve的值,在JavaScript中并没有办法return多个参数,所以即便第一个Promise可以返回多个参数,只要经过return的处理就会丢失
在使用上就是很简单的针对可能会被调用promisify的函数上添加promisify.custom对应的处理即可。
当后续代码调用promisify时就会进行判断:
如果目标函数存在promisify.custom属性,则会判断其类型:
如果不是一个可执行的函数,抛出异常
如果是可执行的函数,则直接返回其对应的函数
如果目标函数不存在对应的属性,按照Error first callback的约定生成对应的处理函数然后返回
添加了这个custom属性以后,就不用再担心使用方针对你的函数调用promisify了。
而且可以验证,赋值给custom的函数与promisify返回的函数地址是一处:
obj.getData[promisify.custom] = async () => ({ name: 'Niko', age: 18 }) // 上边的赋值为 async 函数也可以改为普通函数,只要保证这个普通函数会返回 Promise 实例即可 // 这两种方式与上边的 async 都是完全相等的 obj.getData[promisify.custom] = () => Promise.resolve({ name: 'Niko', age: 18 }) obj.getData[promisify.custom] = () => new Promise(resolve({ name: 'Niko', age: 18 })) console.log(obj.getData[promisify.custom] === promisify(obj.getData)) // true
一些内置的 custom 处理
在一些内置包中,也能够找到promisify.custom的踪迹,比如说最常用的child_process.exec就内置了promisify.custom的处理:
const { exec } = require('child_process') const { promisify } = require('util') console.log(typeof exec[promisify.custom]) // function
因为就像前边示例中所提到的曲线救国的方案,官方的做法也是将函数签名中的参数名作为key,将其所有参数存放到一个Object对象中进行返回,比如child_process.exec的返回值抛开error以外会包含两个,stdout和stderr,一个是命令执行后的正确输出,一个是命令执行后的错误输出:
promisify(exec)('ls').then(console.log) // -> { stdout: 'XXX', stderr: '' }
或者我们故意输入一些错误的命令,当然了,这个只能在catch模块下才能够捕捉到,一般命令正常执行stderr都会是一个空字符串:
promisify(exec)('lss').then(console.log, console.error) // -> { ..., stdout: '', stderr: 'lss: command not found' }
包括像setTimeout
、setImmediate
也都实现了对应的promisify.custom
。
之前为了实现sleep
的操作,还手动使用Promise
封装了setTimeout
:
const sleep = promisify(setTimeout) console.log(new Date()) await sleep(1000) console.log(new Date())
内置的 promisify 转换后函数
如果你的Node版本使用10.x以上的,还可以从很多内置的模块中找到类似.promises的子模块,这里边包含了该模块中常用的回调函数的Promise版本(都是async函数),无需再手动进行promisify转换了。
而且我本人觉得这是一个很好的指引方向,因为之前的工具实现,有的选择直接覆盖原有函数,有的则是在原有函数名后边增加Async进行区分,官方的这种在模块中单独引入一个子模块,在里边实现Promise版本的函数,其实这个在使用上是很方便的,就拿fs模块进行举例:
// 之前引入一些 fs 相关的 API 是这样做的 const { readFile, stat } = require('fs') // 而现在可以很简单的改为 const { readFile, stat } = require('fs').promises // 或者 const { promises: { readFile, stat } } = require('fs')
后边要做的就是将调用promisify相关的代码删掉即可,对于其他使用API的代码来讲,这个改动是无感知的。
所以如果你的node版本够高的话,可以在使用内置模块之前先去翻看文档,有没有对应的promises支持,如果有实现的话,就可以直接使用。
promisify 的一些注意事项
一定要符合Error first callback的约定
不能返回多个参数
注意进行转换的函数是否包含this的引用
前两个问题,使用前边提到的promisify.custom都可以解决掉。
但是第三项可能会在某些情况下被我们所忽视,这并不是promisify独有的问题,就一个很简单的例子:
const obj = { name: 'Niko', getName () { return this.name } } obj.getName() // Niko const func = obj.getName func() // undefined
类似的,如果我们在进行Promise转换的时候,也是类似这样的操作,那么可能会导致生成后的函数this指向出现问题。
修复这样的问题有两种途径:
使用箭头函数,也是推荐的做法
在调用promisify之前使用bind绑定对应的this
不过这样的问题也是建立在promisify转换后的函数被赋值给其他变量的情况下会发生。
如果是类似这样的代码,那么完全不必担心this指向的问题:
const obj = { name: 'Niko', getName (callback) { callback(null, this.name) } } // 这样的操作是不需要担心 this 指向问题的 obj.XXX = promisify(obj.getName) // 如果赋值给了其他变量,那么这里就需要注意 this 的指向了 const func = promisify(obj.getName) // 错误的 this
小结
个人认为Promise作为当代javaScript异步编程中最核心的一部分,了解如何将老旧代码转换为Promise是一件很有意思的事儿。
而我去了解官方的这个工具,原因是在搜索Redis相关的Promise版本时看到了这个readme:This package is no longer maintained. node_redis now includes support for promises in core, so this is no longer needed.
然后跳到了node_redis里边的实现方案,里边提到了util.promisify,遂抓过来研究了一下,感觉还挺有意思,总结了下分享给大家。
热心网友 时间:2022-04-22 15:09
Util是utiliy的缩写,是一个多功能、基于工具的包。
java.util是包含集合框架、遗留的 collection 类、事件模型、日期和时间设施、国际化和各种实用工具类(字符串标记生成器、随机数生成器和位数组、日期Date类、堆栈Stack类、向量Vector类等)。集合类、时间处理模式、日期时间工具等各类常用工具包。
Java的实用工具类库java.util包。在这个包中,Java提供了一些实用的方法和数据结构。例如,Java提供日期(Data)类、日历(Calendar)类来产生和获取日期及时间,提供随机数(Random)类产生各种类型的随机数,还提供了堆栈(Stack)、向量(Vector) 、位集合(Bitset)以及哈希表(Hashtable)等类来表示相应的数据结构。
Java是一门面向对象编程语言,不仅吸收了C++语言的各种优点,还摒弃了C++里难以理解的多继承、指针等概念,因此Java语言具有功能强大和简单易用两个特征。Java语言作为静态面向对象编程语言的代表,极好地实现了面向对象理论,允许程序员以优雅的思维方式进行复杂的编程 。
Java具有简单性、面向对象、分布式、健壮性、安全性、平*立与可移植性、多线程、动态性等特点。Java可以编写桌面应用程序、Web应用程序、分布式系统和嵌入式系统应用程序等。
扩展资料
1、JDK(Java Development Kit)称为Java开发包或Java开发工具,是一个编写Java的Applet小程序和应用程序的程序开发环境。JDK是整个Java的核心,包括了Java运行环境(Java Runtime Envirnment),一些Java工具和Java的核心类库(Java API)。
2、不论什么Java应用服务器实质都是内置了某个版本的JDK。主流的JDK是Sun公司发布的JDK,除了Sun之外,还有很多公司和组织都开发了自己的JDK,例如,IBM公司开发的JDK,BEA公司的Jrocket,还有GNU组织开发的JDK。
3、另外,可以把Java API类库中的Java SE API子集和Java虚拟机这两部分统称为JRE(JAVA Runtime Environment),JRE是支持Java程序运行的标准环境 。
4、JRE是个运行环境,JDK是个开发环境。因此写Java程序的时候需要JDK,而运行Java程序的时候就需要JRE。而JDK里面已经包含了JRE,因此只要安装了JDK,就可以编辑Java程序,也可以正常运行Java程序。但由于JDK包含了许多与运行无关的内容,占用的空间较大,因此运行普通的Java程序无须安装JDK,而只需要安装JRE即可。
参考资料:百度百科——java.util
热心网友 时间:2022-04-22 16:27
Util是utiliy的缩写,是一个多功能、基于工具的包。
这个包主要存储:集合类,随机数生成类,属性文件读取类,计时器类等。
Java实用程序库java.util包。 在这个包中,Java提供了一些实用的方法和数据结构。
例如,Java提供日期(数据)类,用于生成和检索日期和时间的日历类,用于生成各种类型的随机数的随机类,以及诸如Stack,Vector,Bitset和Hashtable之类的类。
扩展资料:
java.util
包含集合框架、遗留的 collection 类、事件模型、日期和时间设施、国际化和各种实用工具类(字符串标记生成器、随机数生成器和位数组、日期Date类、堆栈Stack类、向量Vector类等)。集合类、时间处理模式、日期时间工具等各类常用工具包。
参考资料:百度百科-java.util
热心网友 时间:2022-04-22 18:02
util是utiliy的缩写,意为多用途的,工具性质的包
这个包中主要存放了:集合类(如ArrayList,HashMap等),随机数产生类,属性文件读取类,定时器类等类。
扩展资料
java.util包含集合框架、遗留的 collection 类、事件模型、日期和时间设施、国际化和各种实用工具类(字符串标记生成器、随机数生成器和位数组、日期Date类、堆栈Stack类、向量Vector类等)。集合类、时间处理模式、日期时间工具等各类常用工具包
集合框架集合
java的集合框架为程序提供了一种处理对象组的标准方式。设计了一系列标准泛型接口:
⑴Collection ()接口,扩展了Iterable接口,位于集合层次结构的顶部,因此所有的集合都实现Collection接口,并提供了iterator()方法来返回一个迭代器。用add()方法添加对象,remove()方法删除元素,clear()删除集合所有元素(size=0),contains()方法查看集合是否包含对象,toArray()方法返回集合元素数组,equals()方法比较两个集合是否相等,size()方法返回集合中元素的数目,isEmpty()判断集合是否为空,hashCode()返回调用集合的散列码,iterator()返回调用集合的迭代器。
⑵List()接口,扩展了Collection接口,存储一个序列的元素(列表基于0的索引),可以包含重复的元素,但不能有null值。获得特定位置的对象调用get()方法,用set()方法给特定位置元素赋值,用indexOf()或lastIndexOf()方法分别获得对象的第一个实例或最后一个实例所在的位置,subList()方法取子列表,listIterator()返回一个迭代器。
⑶Set接口,扩展了Collection接口,该集合不允许存在相同的元素(包括唯一null值)。SortedSet接口,扩展了Set接口并声明自已是升序的集合。First()或Last()方法分别获得第一或最后一个对象,subSet()获得子集,headSet()和tailSet()方法分别获得从头开始或直到末尾的子集。
⑷Queue(队列)接口,扩展了Collection接口,并声明一个队列行为(FIFO,先进先出列表)。Offer()方法在队列尾插入元素。element()和peek()方法获得但不移除队列的第一个元素,如果队列为空,element()抛出NoSuchElementException异常,peek()返回null。poll()和remove()方法获得并移除队列的第一个元素,如果队列为空,poll()返回null,remove()抛出异常。
⑸Comparator(比较器)接口,定义了两个方法:compare()和equals()方法,通过改写compare()方法,能够改变对象排序的方式。
⑹Iterator(迭代器)接口、ListIterator(列表迭代器,可进行双向遍历)接口,一般来说,使用迭代器在集合中遍历时应遵循下面的步骤:一通过集合的iterator()得到一个指向集合开始处的迭代器:Iterator itr=collectionObject.iterator();二设置一个判断是否有下一个元素的循环:如while(itr.hasNext()){。三在循环中取出下一个元素:如Object element=itr.next();
⑺RandomAccess(随机访问)接口。被ArrayList类和遗留的Vector类实现。
⑻Map(映射)接口、Map.Entry (Map的嵌套类、内部类)接口、SortedMap(默认按key键升序排列的映射)接口。映射是将键映射到值的对象,一个映射不能包含重复的键;每个键最多只能映射一个值。Map接口提供三种collection 视图:键集、值集合或键-值映射关系集。映射不是集合,因为它们不实现Collection接口,但是可以通过使用entrySet()方法获得键-值映射关系的集合视图跟效果,或使用keySet()方法获得键的集合视图,使用values()方法获得值的集合视图。put()方法将值放入映射中,get()得到与键k相关联的值。SortedMap接口增加了获取子映射的headMap()、tailMap()、subMap()方法和获取首尾键的firstKey()、lastKey()方法。Map.Entry接口定义了获取键值的getKey()、getValue()方法和替换值的setValue()方法。
Collection集合的有序是Set,Map的有序是TreeMap。
异常:试图增加一个不兼容的对象到集合或映射中,将抛出ClassCastException;如果使用无效索引,抛出IndexOutOfBoundException;null不允许存在于集合或映射中,如果试图使用null对象,抛出NullPointException;当修改不可改变的集合或映射时,抛出UnsupportedOperationException;当调用下一个对象不存在时,抛出NoSuchElementException;集合框架接口示意(父类∈子类):1、Collection∈⑴List,⑵Set∈SortedSet。2、Map∈SortedMap。
Java的实用工具类库java.util包。在这个包中,Java提供了一些实用的方法和数据结构。例如,Java提供日期(Data)类、日历(Calendar)类来产生和获取日期及时间,提供随机数(Random)类产生各种类型的随机数,还提供了堆栈(Stack)、向量(Vector) 、位集合(Bitset)以及哈希表(Hashtable)等类来表示相应的数据结构。
参考资料:百度百科
热心网友 时间:2022-04-22 19:53
util是utiliy的缩写,是java中多用途的,工具性质的包。
这个包中主要存放了:集合类(如ArrayList,HashMap等),随机数产生类,属性文件读取类,定时器类等类。
这些类极大方便了Java编程,日常java编程中,经常要用到这些类。
扩展资料:
包含集合框架、遗留的 collection 类、事件模型、日期和时间设施、国际化和各种实用工具类(字符串标记生成器、随机数生成器和位数组、日期Date类、堆栈Stack类、向量Vector类等)。集合类、时间处理模式、日期时间工具等各类常用工具包。
Java的实用工具类库java.util包。在这个包中,Java提供了一些实用的方法和数据结构。例如,Java提供日期(Data)类、日历(Calendar)类来产生和获取日期及时间,提供随机数(Random)类产生各种类型的随机数,还提供了堆栈(Stack)、向量(Vector) 、位集合(Bitset)以及哈希表(Hashtable)等类来表示相应的数据结构。
参考资料:java.util_百度百科
热心网友 时间:2022-04-22 22:01
java.util是一个包名,就跟你自己定义的包的性质是一样的,只是里面放的是sun公司已经写好的Java类
热心网友 时间:2022-04-23 00:26
util是utiliy的缩写,意为多用途的,工具性质的包 这个包中主要存放了:集合类(如ArrayList,HashMap等),随机数产生类,属性文件读取类,定时器类等类。 这些类极大方便了Java编程,日常java编程中,经常要用到这些类。
热心网友 时间:2022-04-23 03:07
In java - util :stands for utility and contains utility classes.
上面粘贴都不看一下有没有拼写错误么?Utility除了一个回答没有一个拼对单词的!!!
来自Quora 网页链接
热心网友 时间:2022-04-23 09:20
util是utiliy的缩写,意为多用途的,工具性质的包
这个包中主要存放了:集合类(如ArrayList,HashMap等),随机数产生类,属性文件读取类,定时器类等类。
这些类极大方便了Java编程,日常java编程中,经常要用到这些类。
热心网友 时间:2022-04-23 12:51
java.util
热心网友 时间:2022-04-23 16:39
utility
热心网友 时间:2022-04-23 20:44
问一下这个钟有什么意思呢我也不太清楚我给你查到后来告诉你