Deprecated API

Contents

• Deprecated Classes
• Deprecated Methods
• Deprecated Constructors
• Deprecated Enum Constants

Deprecated Classes

Class and Description
cn.hutool.extra.template.engine.beetl.BeetlUtil 使用TemplateUtil替代
cn.hutool.core.date.BetweenFormater 拼写错误，请使用BetweenFormatter
cn.hutool.core.convert.impl.GenericEnumConverter 请使用EnumConverter
cn.hutool.core.convert.NumberChineseFormater 请使用 NumberChineseFormatter
cn.hutool.core.convert.NumberWordFormater 请使用 NumberWordFormatter
cn.hutool.db.SqlRunner 请使用Db
cn.hutool.extra.template.engine.velocity.VelocityUtil 使用TemplateUtil替代

Deprecated Methods

Method and Description
cn.hutool.core.thread.SyncFinisher.await() 使用start方法指定是否阻塞等待
cn.hutool.core.util.URLUtil.complateUrl(String, String) 拼写错误，请使用URLUtil.completeUrl(String, String)
cn.hutool.core.collection.IterUtil.countMap(Iterable<T>) 如果对象同时实现Iterable和Iterator接口会产生歧义，请使用CollUtil.countMap
cn.hutool.db.meta.Column.create(String, ResultSet) 请使用 Column.create(Table, ResultSet)
cn.hutool.poi.excel.WorkbookUtil.createBook(InputStream, boolean) 使用完毕无论是否closeAfterRead，poi会关闭流，此参数无意义，请使用WorkbookUtil.createBook(InputStream)
cn.hutool.poi.excel.WorkbookUtil.createBook(InputStream, String, boolean) 使用完毕无论是否closeAfterRead，poi会关闭流，此参数无意义，请使用WorkbookUtil.createBook(InputStream, String)
cn.hutool.poi.excel.ExcelWriter.createStyleForCell(int, int) 请使用 ExcelBase.createCellStyle(int, int)
cn.hutool.poi.excel.WorkbookUtil.createSXSSFBook(InputStream, String, boolean) 使用完毕无论是否closeAfterRead，poi会关闭流，此参数无意义，请使用WorkbookUtil.createSXSSFBook(InputStream, String)
cn.hutool.core.codec.Base64.decode(CharSequence, Charset) 编码参数无意义，作废
cn.hutool.core.codec.Base64.decode(CharSequence, String) 编码参数无意义，作废
cn.hutool.http.HttpUtil.decodeParamMap(String, String) 请使用 HttpUtil.decodeParamMap(String, Charset)
cn.hutool.cron.TaskExecutorManager.destroy() 作业执行器只是执行给定的定时任务线程，无法强制关闭，可通过deamon线程方式关闭之
cn.hutool.cron.TaskLauncherManager.destroy() 作业启动器只是调用定时任务检查，无法强制关闭，可通过deamon线程方式关闭之
cn.hutool.crypto.asymmetric.RSA.encryptStr(String, KeyType) 请使用 AbstractAsymmetricCrypto.encryptBcd(String, KeyType)
cn.hutool.crypto.asymmetric.RSA.encryptStr(String, KeyType, Charset) 请使用 AbstractAsymmetricCrypto.encryptBcd(String, KeyType, Charset)
cn.hutool.core.collection.IterUtil.fieldValueAsMap(Iterable<?>, String, String) 如果对象同时实现Iterable和Iterator接口会产生歧义，请使用CollUtil.fieldValueMap
cn.hutool.core.collection.IterUtil.fieldValueMap(Iterable<V>, String) 如果对象同时实现Iterable和Iterator接口会产生歧义，请使用CollUtil.fieldValueMap
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.crypto.asymmetric.AsymmetricCrypto.getClipher() 拼写错误，请使用AsymmetricCrypto.getCipher()
cn.hutool.db.ds.DSFactory.getCurrentDSFactory(Setting) 此方法容易引起歧义，应使用DSFactory.create(Setting) 方法代替之
cn.hutool.dfa.SensitiveUtil.getFindedAllSensitive(Object) 请使用 SensitiveUtil.getFoundAllSensitive(Object)
cn.hutool.dfa.SensitiveUtil.getFindedAllSensitive(Object, boolean, boolean) 请使用 SensitiveUtil.getFoundAllSensitive(Object, boolean, boolean)
cn.hutool.dfa.SensitiveUtil.getFindedAllSensitive(String) 请使用 SensitiveUtil.getFoundAllSensitive(String)
cn.hutool.dfa.SensitiveUtil.getFindedAllSensitive(String, boolean, boolean) 请使用 SensitiveUtil.getFoundAllSensitive(String, boolean, boolean)
cn.hutool.dfa.SensitiveUtil.getFindedFirstSensitive(Object) 请使用 SensitiveUtil.getFoundFirstSensitive(Object)
cn.hutool.dfa.SensitiveUtil.getFindedFirstSensitive(String) 请使用 SensitiveUtil.getFoundFirstSensitive(String)
cn.hutool.core.date.chinese.LunarInfo.getMaxYear() 使用 LunarInfo.MAX_YEAR
cn.hutool.db.PageResult.getNumPerPage() 请使用PageResult.getPageSize()
cn.hutool.db.Page.getNumPerPage() 使用 Page.getPageSize() 代替
cn.hutool.poi.excel.ExcelUtil.getReader(InputStream, int, boolean) 使用完毕无论是否closeAfterRead，poi会关闭流，此参数无意义。
cn.hutool.poi.excel.ExcelUtil.getReader(InputStream, String, boolean) 使用完毕无论是否closeAfterRead，poi会关闭流，此参数无意义。
cn.hutool.extra.template.engine.velocity.VelocityEngine.getRowEngine() 拼写错误了，请使用VelocityEngine.getRawEngine()
cn.hutool.core.util.TypeUtil.hasTypeVeriable(Type...) 拼写错误，请使用TypeUtil.hasTypeVariable(Type...)
cn.hutool.db.sql.SqlBuilder.having(LogicalOperator, Condition...) logicalOperator放在Condition中了，因此请使用 SqlBuilder.having(Condition...)
cn.hutool.core.convert.Convert.hexStrToStr(String, Charset) 请使用 Convert.hexToStr(String, Charset)
cn.hutool.db.meta.Column.init(String, ResultSet) 请使用 Column.init(Table, ResultSet)
cn.hutool.core.util.NumberUtil.isBlankChar(char) 请使用CharUtil.isBlankChar(char)
cn.hutool.core.util.NumberUtil.isBlankChar(int) 请使用CharUtil.isBlankChar(int)
cn.hutool.core.date.DateUtil.isExpired(Date, Date, Date) 使用isIn方法
cn.hutool.core.date.DateUtil.isExpired(Date, DateField, int, Date) 此方法存在一定的歧义，容易产生误导，废弃。
cn.hutool.json.JSONConfig.isIgnoreTransient() 此方法名称有二义性，请使用JSONConfig.isTransientSupport()
cn.hutool.core.lang.Validator.isMactchRegex(Pattern, CharSequence) 请使用 Validator.isMatchRegex(Pattern, CharSequence)
cn.hutool.core.lang.Validator.isMactchRegex(String, CharSequence) 拼写错误，请使用Validator.isMatchRegex(String, CharSequence)
cn.hutool.core.net.NetUtil.isUnknow(String) 拼写错误，请使用NetUtil.isUnknown(String)
cn.hutool.core.collection.IterUtil.join(Iterable<T>, CharSequence) 如果对象同时实现Iterable和Iterator接口会产生歧义，请使用CollUtil.join
cn.hutool.core.collection.IterUtil.join(Iterable<T>, CharSequence, String, String) 如果对象同时实现Iterable和Iterator接口会产生歧义，请使用CollUtil.join
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.date.DateTime.millsecond() 拼写错误，请使用DateTime.millisecond()
cn.hutool.core.date.DateUtil.millsecond(Date) 拼写错误，请使用DateUtil.millisecond(Date)
cn.hutool.db.DbUtil.newSqlRunner() 请使用 DbUtil.use()
cn.hutool.db.DbUtil.newSqlRunner(DataSource) 请使用 DbUtil.use(DataSource)
cn.hutool.db.DbUtil.newSqlRunner(DataSource, Dialect) 请使用 DbUtil.use(DataSource, Dialect)
cn.hutool.core.date.DateUtil.offsetDate(Date, DateField, int) please use DateUtil.offset(Date, DateField, int)
cn.hutool.db.sql.SqlBuilder.on(LogicalOperator, Condition...) logicalOperator放在Condition中了，因此请使用 SqlBuilder.on(Condition...)
cn.hutool.json.JSONUtil.parseFromMap(Map<?, ?>) 请直接使用 JSONUtil.parseObj(Object)
cn.hutool.json.JSONUtil.parseFromResourceBundle(ResourceBundle) 请直接使用 JSONUtil.parseObj(Object)
cn.hutool.json.JSONObject.put(String, Object) 此方法存在歧义，原Map接口返回的是之前的值，重写后返回this了，未来版本此方法会修改，请使用JSONObject.set(String, Object)
cn.hutool.setting.Setting.put(String, String, String) 此方法与getXXX参数顺序不一致容易造成问题，建议使用Setting.putByGroup(String, String, String)
cn.hutool.core.util.RandomUtil.randomColor() 使用ImgUtil.randomColor()
cn.hutool.core.util.RandomUtil.randomUUID() 请使用IdUtil.randomUUID()
cn.hutool.poi.excel.ExcelUtil.read03BySax(File, int, RowHandler) 请使用 ExcelUtil.readBySax(File, int, RowHandler)
cn.hutool.poi.excel.ExcelUtil.read03BySax(InputStream, int, RowHandler) 请使用 ExcelUtil.readBySax(InputStream, int, RowHandler)
cn.hutool.poi.excel.ExcelUtil.read03BySax(String, int, RowHandler) 请使用 ExcelUtil.readBySax(String, int, RowHandler)
cn.hutool.poi.excel.ExcelUtil.read07BySax(File, int, RowHandler) 请使用 ExcelUtil.readBySax(File, int, RowHandler)
cn.hutool.poi.excel.ExcelUtil.read07BySax(InputStream, int, RowHandler) 请使用 ExcelUtil.readBySax(InputStream, int, RowHandler)
cn.hutool.poi.excel.ExcelUtil.read07BySax(String, int, RowHandler) 请使用 ExcelUtil.readBySax(String, int, RowHandler)
cn.hutool.setting.Setting.set(String, String, String) 此方法与getXXX参数顺序不一致容易引起，请使用Setting.setByGroup(String, String, String)
cn.hutool.extra.qrcode.QrConfig.setBackColor(int) 请使用 QrConfig.setBackColor(Color)
cn.hutool.http.HttpRequest.setEncodeUrlParams(boolean) 编码自动完成，无需设置
cn.hutool.extra.qrcode.QrConfig.setForeColor(int) 请使用 QrConfig.setForeColor(Color)
cn.hutool.http.webservice.SoapClient.setHeader(QName) 为了和Http Hrader区分，请使用SoapClient.addSOAPHeader(QName)
cn.hutool.http.webservice.SoapClient.setHeader(QName, String, String, Boolean, Boolean) 为了和Http Header区分，请使用SoapClient.addSOAPHeader(QName, String, String, Boolean, Boolean)
cn.hutool.json.JSONConfig.setIgnoreTransient(boolean) 此方法名称有二义性，请使用JSONConfig.setTransientSupport(boolean)
cn.hutool.db.PageResult.setNumPerPage(int) 请使用 PageResult.setPageSize(int)
cn.hutool.db.Page.setNumPerPage(int) 使用 Page.setPageSize(int) 代替
cn.hutool.http.webservice.SoapClient.setSOAPHeader(QName) 为了便于设置子节点或者value值，请使用SoapClient.addSOAPHeader(QName)
cn.hutool.http.webservice.SoapClient.setSOAPHeader(QName, String, String, Boolean, Boolean) 为了便于设置子节点或者value值，请使用SoapClient.addSOAPHeader(QName, String, String, Boolean, Boolean)
cn.hutool.db.sql.StatementWrapper.setUnicodeStream(int, InputStream, int)
cn.hutool.core.util.RandomUtil.simpleUUID() 请使用IdUtil.simpleUUID()
cn.hutool.crypto.SecureUtil.simpleUUID() 请使用 IdUtil.simpleUUID()
cn.hutool.core.date.DateUtil.thisMillsecond() 拼写错误，请使用DateUtil.thisMillisecond()
cn.hutool.db.Session.trans(VoidFunc1<Session>) 请使用Session.tx(VoidFunc1)
cn.hutool.core.util.ObjectUtil.unserialize(byte[]) 请使用 ObjectUtil.deserialize(byte[])
cn.hutool.core.date.DateUtil.weekCount(Date, Date) 请使用 DateUtil.betweenWeek(Date, Date, boolean)
cn.hutool.db.sql.SqlBuilder.where(LogicalOperator, Condition...) logicalOperator放在Condition中了，因此请使用 SqlBuilder.where(Condition...)

Deprecated Constructors

Constructor and Description
cn.hutool.db.meta.Column(String, ResultSet) 请使用 Column.Column(Table, ResultSet)
cn.hutool.poi.excel.ExcelReader(InputStream, int, boolean) 使用完毕无论是否closeAfterRead，poi会关闭流，此参数无意义。
cn.hutool.poi.excel.ExcelReader(InputStream, String, boolean) 使用完毕无论是否closeAfterRead，poi会关闭流，此参数无意义。
cn.hutool.core.io.resource.UrlResource(File) Please use FileResource

Deprecated Enum Constants

Enum Constant and Description
cn.hutool.core.date.BetweenFormatter.Level.MILLSECOND 拼写错误，请使用BetweenFormatter.Level.MILLISECOND