Deprecated API

Contents

• Deprecated Classes
• Deprecated Methods
• Deprecated Constructors

Deprecated Classes

Class and Description
cn.hutool.core.comparator.BaseFieldComparator 此类不再需要，使用FuncComparator代替更加灵活
cn.hutool.core.codec.BCD 由于对于ASCII的编码解码有缺陷，且这种BCD实现并不规范，因此会在6.0.0中移除
cn.hutool.core.net.URLEncoder 此类中的方法并不规范，请使用 RFC3986

Deprecated Methods

Method and Description
cn.hutool.core.lang.tree.TreeBuilder.append(List<T>, E, NodeParser<T, E>) rootId参数可以不提供，在root节点中直接获取，请使用TreeBuilder.append(List, NodeParser)
cn.hutool.core.net.url.UrlBuilder.appendPath(CharSequence) 方法重复，请使用UrlBuilder.addPath(CharSequence)
cn.hutool.core.img.ImgUtil.convert(Image, String, ImageOutputStream, boolean)
cn.hutool.core.net.url.UrlBuilder.create() 请使用 UrlBuilder.of()
cn.hutool.core.util.IdUtil.createSnowflake(long, long) 此方法容易产生歧义：多个Snowflake实例产生的ID会产生重复，此对象在单台机器上必须单例，请使用IdUtil.getSnowflake(long, long)
cn.hutool.core.util.ObjectUtil.defaultIfEmpty(String, Supplier<? extends T>, T) 当str为null时，handle使用了str相关的方法引用会导致空指针问题
cn.hutool.core.util.ObjectUtil.defaultIfNull(Object, Supplier<? extends T>, T) 当str为null时，handle使用了str相关的方法引用会导致空指针问题
cn.hutool.core.codec.Base64.encodeUrlSafe(byte[], boolean) 按照RFC2045规范，URL安全的Base64无需换行
cn.hutool.core.codec.Base64.encodeUrlSafe(CharSequence, String) 请使用 Base64.encodeUrlSafe(CharSequence, Charset)
cn.hutool.core.bean.BeanUtil.fillBeanWithMap(Map<?, ?>, T, boolean, boolean) isToCamelCase参数无效，请使用BeanUtil.fillBeanWithMap(Map, Object, boolean)
cn.hutool.core.bean.BeanUtil.fillBeanWithMap(Map<?, ?>, T, boolean, CopyOptions) isToCamelCase参数无效，请使用BeanUtil.fillBeanWithMap(Map, Object, CopyOptions)
cn.hutool.core.collection.CollUtil.getElementType(Iterable<?>) 请使用 IterUtil.getElementType(Iterable)
cn.hutool.core.collection.CollUtil.getElementType(Iterator<?>) 请使用 IterUtil.getElementType(Iterator)
cn.hutool.core.io.FileUtil.getReader(File, String) 请使用 FileUtil.getReader(File, Charset)
cn.hutool.core.io.IoUtil.getReader(InputStream, String) 请使用 IoUtil.getReader(InputStream, Charset)
cn.hutool.core.io.FileUtil.getReader(String, String) 请使用 FileUtil.getReader(String, Charset)
cn.hutool.core.io.FileUtil.getWriter(File, String, boolean) 请使用 FileUtil.getWriter(File, Charset, boolean)
cn.hutool.core.io.IoUtil.getWriter(OutputStream, String) 请使用 IoUtil.getWriter(OutputStream, Charset)
cn.hutool.core.io.FileUtil.getWriter(String, String, boolean) 请使用 FileUtil.getWriter(String, Charset, boolean)
cn.hutool.core.net.NetUtil.ipv6ToBitInteger(String) 拼写错误，请使用NetUtil.ipv6ToBigInteger(String)
cn.hutool.core.date.DateUtil.isExpired(Date, Date, Date) 使用isIn方法
cn.hutool.core.date.DateUtil.isExpired(Date, DateField, int, Date) 此方法存在一定的歧义，容易产生误导，废弃。
cn.hutool.core.io.FileUtil.isModifed(File, long) 拼写错误，请使用FileUtil.isModified(File, long)
cn.hutool.core.collection.CollUtil.join(Iterator<T>, CharSequence) 请使用IterUtil#join(Iterator, CharSequence)
cn.hutool.core.bean.BeanUtil.mapToBean(Map<?, ?>, Class<T>, boolean) 请使用 BeanUtil.toBean(Object, Class) 或 BeanUtil.toBeanIgnoreError(Object, Class)
cn.hutool.core.bean.BeanUtil.mapToBean(Map<?, ?>, Class<T>, boolean, CopyOptions) isToCamelCase参数无效，请使用 BeanUtil.toBean(Object, Class, CopyOptions)
cn.hutool.core.bean.BeanUtil.mapToBean(Map<?, ?>, Class<T>, CopyOptions) 请使用 BeanUtil.toBean(Object, Class, CopyOptions)
cn.hutool.core.bean.BeanUtil.mapToBeanIgnoreCase(Map<?, ?>, Class<T>, boolean) 请使用 BeanUtil.toBeanIgnoreCase(Object, Class, boolean)
cn.hutool.core.util.NumberUtil.null2Zero(BigDecimal) 请使用 NumberUtil.nullToZero(BigDecimal)
cn.hutool.core.map.MapUtil.of(Pair<K, V>...) 方法容易歧义，请使用 #ofEntries(Entry[])
cn.hutool.core.date.DateUtil.parseCST(CharSequence) 理解错误，请使用DateUtil.parseRFC2822(CharSequence)
cn.hutool.core.date.DateUtil.parseUTC(String) 方法歧义，带T的日期并不一定是UTC时间，请使用 DateUtil.parseISO8601(String)
cn.hutool.core.io.IoUtil.read(InputStream, String) 请使用 IoUtil.read(InputStream, Charset)
cn.hutool.core.io.IoUtil.readLines(InputStream, String, T) 请使用 IoUtil.readLines(InputStream, Charset, Collection)
cn.hutool.core.io.FileUtil.readLines(URL, String) 请使用 FileUtil.readLines(URL, Charset)
cn.hutool.core.io.FileUtil.readLines(URL, String, T) 请使用 FileUtil.readLines(URL, Charset, Collection)
cn.hutool.core.io.FileUtil.readString(File, String) 请使用 FileUtil.readString(File, Charset)
cn.hutool.core.io.FileUtil.readString(String, String) 请使用 FileUtil.readString(String, Charset)
cn.hutool.core.io.FileUtil.readString(URL, String) 请使用 FileUtil.readString(URL, Charset)
cn.hutool.core.text.CharSequenceUtil.replace(CharSequence, int, int, char) 歧义，请使用CharSequenceUtil.replaceByCodePoint(CharSequence, int, int, char)
cn.hutool.core.text.CharSequenceUtil.replace(CharSequence, int, int, CharSequence) 歧义，请使用CharSequenceUtil.replaceByCodePoint(CharSequence, int, int, CharSequence)
cn.hutool.core.collection.CollUtil.splitList(List<T>, int) 请使用 ListUtil.partition(List, int)
cn.hutool.core.util.StrUtil.str(Object, String) 请使用 StrUtil.str(Object, Charset)
cn.hutool.core.img.ImgUtil.toBufferedImage(Image) 改用 ImgUtil.castToBufferedImage(Image, String)
cn.hutool.core.date.DateUtil.toIntSecond(Date) 2022年后结果溢出，此方法废弃
cn.hutool.core.img.ImgUtil.toRenderedImage(Image) 改用 ImgUtil.castToRenderedImage(Image, String)
cn.hutool.core.io.IoUtil.toStream(String, String) 请使用 IoUtil.toStream(String, Charset)
cn.hutool.core.io.IoUtil.write(OutputStream, String, boolean, Object...) 请使用 IoUtil.write(OutputStream, Charset, boolean, Object...)
cn.hutool.core.util.ZipUtil.zip(ZipOutputStream, boolean, FileFilter, File...) 请使用 ZipUtil.zip(OutputStream, Charset, boolean, FileFilter, File...)

Deprecated Constructors

Constructor and Description
cn.hutool.core.io.resource.UrlResource(File) Please use FileResource