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.http.ssl.SSLSocketFactoryBuilder 请使用 SSLContextBuilder
cn.hutool.core.net.URLEncoder 此类中的方法并不规范，请使用 RFC3986

Deprecated Methods

Method and Description
cn.hutool.core.net.url.UrlBuilder.appendPath(CharSequence) 方法重复，请使用UrlBuilder.addPath(CharSequence)
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.crypto.asymmetric.AsymmetricDecryptor.decryptFromBcd(String, KeyType, Charset) 由于对于ASCII的编码解码有缺陷，且这种BCD实现并不规范，因此会在6.0.0中移除
cn.hutool.crypto.asymmetric.AsymmetricDecryptor.decryptStrFromBcd(String, KeyType) 由于对于ASCII的编码解码有缺陷，且这种BCD实现并不规范，因此会在6.0.0中移除
cn.hutool.crypto.asymmetric.AsymmetricDecryptor.decryptStrFromBcd(String, KeyType, Charset) 由于对于ASCII的编码解码有缺陷，且这种BCD实现并不规范，因此会在6.0.0中移除
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.crypto.asymmetric.AsymmetricEncryptor.encryptBcd(String, KeyType) 由于对于ASCII的编码解码有缺陷，且这种BCD实现并不规范，因此会在6.0.0中移除
cn.hutool.crypto.asymmetric.AsymmetricEncryptor.encryptBcd(String, KeyType, Charset) 由于对于ASCII的编码解码有缺陷，且这种BCD实现并不规范，因此会在6.0.0中移除
cn.hutool.db.sql.SqlExecutor.executeBatch(Connection, String, Object[]...) 重载导致编译器无法区分
cn.hutool.db.AbstractDb.executeBatch(String, Object[]...) 编译器无法区分重载
cn.hutool.log.StaticLog.get() 请使用 Log.get()
cn.hutool.log.StaticLog.get(Class<?>) 请使用 Log.get(Class)
cn.hutool.log.StaticLog.get(String) 请使用 Log.get(String)
cn.hutool.db.meta.MetaUtil.getCataLog(Connection) 拼写错误，请使用MetaUtil.getCatalog(Connection)
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.bloomfilter.BitSetBloomFilter.init(String, String) 请使用 BitSetBloomFilter.init(String, Charset)
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.system.JavaInfo.isJava1_1()
cn.hutool.system.JavaInfo.isJava1_2()
cn.hutool.system.JavaInfo.isJava1_3()
cn.hutool.system.JavaInfo.isJava1_4()
cn.hutool.system.JavaInfo.isJava1_5()
cn.hutool.system.JavaInfo.isJava1_6()
cn.hutool.system.JavaInfo.isJava1_7()
cn.hutool.json.JSONUtil.isJson(String) 方法名称有歧义，请使用 JSONUtil.isTypeJSON(String)
cn.hutool.json.JSONUtil.isJsonArray(String) 方法名称有歧义，请使用 JSONUtil.isTypeJSONArray(String)
cn.hutool.json.JSONUtil.isJsonObj(String) 方法名称有歧义，请使用 JSONUtil.isTypeJSONObject(String)
cn.hutool.core.io.FileUtil.isModifed(File, long) 拼写错误，请使用FileUtil.isModified(File, long)
cn.hutool.json.JSONConfig.isOrder() 始终返回 true
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>, 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.json.JSONUtil.parseObj(Object, boolean, boolean) isOrder参数不再有效
cn.hutool.json.JSONObject.put(String, Object) 此方法存在歧义，原Map接口返回的是之前的值，重写后返回this了，未来版本此方法会修改，请使用JSONObject.set(String, Object)
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.crypto.PemUtil.readSm2PemPrivateKey(InputStream) 请使用 PemUtil.readPemPrivateKey(InputStream)
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.extra.qrcode.QrConfig.setBackColor(int) 请使用 QrConfig.setBackColor(Color)
cn.hutool.extra.qrcode.QrConfig.setForeColor(int) 请使用 QrConfig.setForeColor(Color)
cn.hutool.json.JSONConfig.setOrder(boolean) 始终有序，无需设置
cn.hutool.db.sql.StatementWrapper.setUnicodeStream(int, InputStream, int)
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.json.JSON.toBean(Type, boolean) 请使用 JSON.toBean(Type), ignoreError在JSONConfig中生效
cn.hutool.core.date.DateUtil.toIntSecond(Date) 2022年后结果溢出，此方法废弃
cn.hutool.http.HttpUtil.toParams(Map<String, Object>, String) 请使用 HttpUtil.toParams(Map, Charset)
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.json.serialize.JSONWriter.writeField(String, Object) 请使用 JSONWriter.writeField(MutablePair, Filter)
cn.hutool.core.util.ZipUtil.zip(ZipOutputStream, boolean, FileFilter, File...) 请使用 ZipUtil.zip(OutputStream, Charset, boolean, FileFilter, File...)

Deprecated Constructors

Constructor and Description
cn.hutool.http.HttpRequest(String) 请使用 HttpRequest.of(String)
cn.hutool.json.JSONObject(CharSequence, boolean) isOrder无效
cn.hutool.json.JSONObject(int, boolean, boolean) isOrder无效
cn.hutool.json.JSONObject(Object, boolean, boolean) isOrder参数不再需要，JSONObject默认有序！
cn.hutool.core.io.resource.UrlResource(File) Please use FileResource