diff --git a/hutool-core/src/main/java/cn/hutool/core/io/file/FileAppender.java b/hutool-core/src/main/java/cn/hutool/core/io/file/FileAppender.java index d8875b5a9..4d2091c96 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/file/FileAppender.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/file/FileAppender.java @@ -14,7 +14,7 @@ import java.util.List; * 持有一个文件，在内存中积累一定量的数据后统一追加到文件
* 此类只有在写入文件时打开文件，并在写入结束后关闭之。因此此类不需要关闭
* 在调用append方法后会缓存于内存，只有超过容量后才会一次性写入文件，因此内存中随时有剩余未写入文件的内容，在最后必须调用flush方法将剩余内容刷入文件 - * + * * @author looly * @since 3.1.2 */ @@ -27,10 +27,10 @@ public class FileAppender implements Serializable{ /** 追加内容是否为新行 */ private final boolean isNewLineMode; private final List list = new ArrayList<>(100); - + /** * 构造 - * + * * @param destFile 目标文件 * @param capacity 当行数积累多少条时刷入到文件 * @param isNewLineMode 追加内容是否为新行 @@ -41,7 +41,7 @@ public class FileAppender implements Serializable{ /** * 构造 - * + * * @param destFile 目标文件 * @param charset 编码 * @param capacity 当行数积累多少条时刷入到文件 @@ -55,7 +55,7 @@ public class FileAppender implements Serializable{ /** * 追加 - * + * * @param line 行 * @return this */ @@ -69,7 +69,7 @@ public class FileAppender implements Serializable{ /** * 刷入到文件 - * + * * @return this */ public FileAppender flush() { diff --git a/hutool-core/src/main/java/cn/hutool/core/io/file/FileCopier.java b/hutool-core/src/main/java/cn/hutool/core/io/file/FileCopier.java index 534bb7ad4..fbdc4938f 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/file/FileCopier.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/file/FileCopier.java @@ -23,13 +23,13 @@ import java.util.ArrayList; * 3、目录复制到目录 * 4、目录下的文件和目录复制到另一个目录 * - * + * * @author Looly * @since 3.0.9 */ public class FileCopier extends SrcToDestCopier{ private static final long serialVersionUID = 1L; - + /** 是否覆盖目标文件 */ private boolean isOverride; /** 是否拷贝所有属性 */ @@ -38,7 +38,7 @@ public class FileCopier extends SrcToDestCopier{ private boolean isCopyContentIfDir; /** 当拷贝来源是目录时是否只拷贝文件而忽略子目录 */ private boolean isOnlyCopyFile; - + //-------------------------------------------------------------------------------------------------------- static method start /** * 新建一个文件复制器 @@ -49,7 +49,7 @@ public class FileCopier extends SrcToDestCopier{ public static FileCopier create(String srcPath, String destPath) { return new FileCopier(FileUtil.file(srcPath), FileUtil.file(destPath)); } - + /** * 新建一个文件复制器 * @param src 源文件 @@ -60,7 +60,7 @@ public class FileCopier extends SrcToDestCopier{ return new FileCopier(src, dest); } //-------------------------------------------------------------------------------------------------------- static method end - + //-------------------------------------------------------------------------------------------------------- Constructor start /** * 构造 @@ -72,7 +72,7 @@ public class FileCopier extends SrcToDestCopier{ this.dest = dest; } //-------------------------------------------------------------------------------------------------------- Constructor end - + //-------------------------------------------------------------------------------------------------------- Getters and Setters start /** * 是否覆盖目标文件 @@ -115,7 +115,7 @@ public class FileCopier extends SrcToDestCopier{ public boolean isCopyContentIfDir() { return isCopyContentIfDir; } - + /** * 当拷贝来源是目录时是否只拷贝目录下的内容 * @param isCopyContentIfDir 是否只拷贝目录下的内容 @@ -125,10 +125,10 @@ public class FileCopier extends SrcToDestCopier{ this.isCopyContentIfDir = isCopyContentIfDir; return this; } - + /** * 当拷贝来源是目录时是否只拷贝文件而忽略子目录 - * + * * @return 当拷贝来源是目录时是否只拷贝文件而忽略子目录 * @since 4.1.5 */ @@ -138,7 +138,7 @@ public class FileCopier extends SrcToDestCopier{ /** * 设置当拷贝来源是目录时是否只拷贝文件而忽略子目录 - * + * * @param isOnlyCopyFile 当拷贝来源是目录时是否只拷贝文件而忽略子目录 * @return this * @since 4.1.5 @@ -161,7 +161,7 @@ public class FileCopier extends SrcToDestCopier{ * 6、源为目录，目标为文件，抛出IO异常 * 7、源路径和目标路径相同时，抛出IO异常 * - * + * * @return 拷贝后目标的文件或目录 * @throws IORuntimeException IO异常 */ @@ -187,7 +187,7 @@ public class FileCopier extends SrcToDestCopier{ if(FileUtil.isSub(src, dest)) { throw new IORuntimeException("Dest is a sub directory of src !"); } - + final File subTarget = isCopyContentIfDir ? dest : FileUtil.mkdir(FileUtil.file(dest, src.getName())); internalCopyDirContent(src, subTarget); } else {// 复制文件 @@ -200,7 +200,7 @@ public class FileCopier extends SrcToDestCopier{ /** * 拷贝目录内容，只用于内部，不做任何安全检查
* 拷贝内容的意思为源目录下的所有文件和目录拷贝到另一个目录下，而不拷贝源目录本身 - * + * * @param src 源目录 * @param dest 目标目录 * @throws IORuntimeException IO异常 @@ -218,7 +218,7 @@ public class FileCopier extends SrcToDestCopier{ } else if (false == dest.isDirectory()) { throw new IORuntimeException(StrUtil.format("Src [{}] is a directory but dest [{}] is a file!", src.getPath(), dest.getPath())); } - + final String[] files = src.list(); if(ArrayUtil.isNotEmpty(files)){ File srcFile; @@ -243,7 +243,7 @@ public class FileCopier extends SrcToDestCopier{ * 1、如果目标是一个不存在的路径，则目标以文件对待（自动创建父级目录）比如：/dest/aaa，如果aaa不存在，则aaa被当作文件名 * 2、如果目标是一个已存在的目录，则文件拷贝到此目录下，文件名与原文件名一致 * - * + * * @param src 源文件，必须为文件 * @param dest 目标文件，如果非覆盖模式必须为目录 * @throws IORuntimeException IO异常 @@ -253,14 +253,14 @@ public class FileCopier extends SrcToDestCopier{ //被过滤的文件跳过 return; } - + // 如果已经存在目标文件，切为不覆盖模式，跳过之 if (dest.exists()) { if(dest.isDirectory()) { //目标为目录，目录下创建同名文件 dest = new File(dest, src.getName()); } - + if(dest.exists() && false == isOverride) { //非覆盖模式跳过 return; @@ -270,7 +270,7 @@ public class FileCopier extends SrcToDestCopier{ //noinspection ResultOfMethodCallIgnored dest.getParentFile().mkdirs(); } - + final ArrayList optionList = new ArrayList<>(2); if(isOverride) { optionList.add(StandardCopyOption.REPLACE_EXISTING); @@ -278,7 +278,7 @@ public class FileCopier extends SrcToDestCopier{ if(isCopyAttributes) { optionList.add(StandardCopyOption.COPY_ATTRIBUTES); } - + try { Files.copy(src.toPath(), dest.toPath(), optionList.toArray(new CopyOption[0])); } catch (IOException e) { diff --git a/hutool-core/src/main/java/cn/hutool/core/io/file/FileMode.java b/hutool-core/src/main/java/cn/hutool/core/io/file/FileMode.java index 3b1958c29..a58020b92 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/file/FileMode.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/file/FileMode.java @@ -2,7 +2,7 @@ package cn.hutool.core.io.file; /** * 文件读写模式，常用于RandomAccessFile - * + * * @author looly * @since 4.5.2 */ diff --git a/hutool-core/src/main/java/cn/hutool/core/io/file/FileReader.java b/hutool-core/src/main/java/cn/hutool/core/io/file/FileReader.java index a29fd6419..355b45a7c 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/file/FileReader.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/file/FileReader.java @@ -20,13 +20,13 @@ import java.util.List; /** * 文件读取器 - * + * * @author Looly * */ public class FileReader extends FileWrapper { private static final long serialVersionUID = 1L; - + /** * 创建 FileReader * @param file 文件 @@ -36,7 +36,7 @@ public class FileReader extends FileWrapper { public static FileReader create(File file, Charset charset){ return new FileReader(file, charset); } - + /** * 创建 FileReader, 编码：{@link FileWrapper#DEFAULT_CHARSET} * @param file 文件 @@ -45,7 +45,7 @@ public class FileReader extends FileWrapper { public static FileReader create(File file){ return new FileReader(file); } - + // ------------------------------------------------------- Constructor start /** * 构造 @@ -106,7 +106,7 @@ public class FileReader extends FileWrapper { /** * 读取文件所有数据
* 文件的长度不能超过 {@link Integer#MAX_VALUE} - * + * * @return 字节码 * @throws IORuntimeException IO异常 */ @@ -136,7 +136,7 @@ public class FileReader extends FileWrapper { /** * 读取文件内容 - * + * * @return 内容 * @throws IORuntimeException IO异常 */ @@ -146,7 +146,7 @@ public class FileReader extends FileWrapper { /** * 从文件中读取每一行数据 - * + * * @param 集合类型 * @param collection 集合 * @return 文件中的每行内容的集合 @@ -171,10 +171,10 @@ public class FileReader extends FileWrapper { IoUtil.close(reader); } } - + /** * 按照行处理文件内容 - * + * * @param lineHandler 行处理器 * @throws IORuntimeException IO异常 * @since 3.0.9 @@ -188,10 +188,10 @@ public class FileReader extends FileWrapper { IoUtil.close(reader); } } - + /** * 从文件中读取每一行数据 - * + * * @return 文件中的每行内容的集合 * @throws IORuntimeException IO异常 */ @@ -201,7 +201,7 @@ public class FileReader extends FileWrapper { /** * 按照给定的readerHandler读取文件中的数据 - * + * * @param 读取的结果对象类型 * @param readerHandler Reader处理类 * @return 从文件中read出的数据 @@ -223,7 +223,7 @@ public class FileReader extends FileWrapper { /** * 获得一个文件读取器 - * + * * @return BufferedReader对象 * @throws IORuntimeException IO异常 */ @@ -233,7 +233,7 @@ public class FileReader extends FileWrapper { /** * 获得输入流 - * + * * @return 输入流 * @throws IORuntimeException IO异常 */ @@ -255,10 +255,10 @@ public class FileReader extends FileWrapper { public long writeToStream(OutputStream out) throws IORuntimeException { return writeToStream(out, false); } - + /** * 将文件写入流中 - * + * * @param out 流 * @param isCloseOut 是否关闭输出流 * @return 写出的流byte数 @@ -280,7 +280,7 @@ public class FileReader extends FileWrapper { // -------------------------------------------------------------------------- Interface start /** * Reader处理接口 - * + * * @author Luxiaolei * * @param Reader处理返回结果类型 @@ -289,10 +289,10 @@ public class FileReader extends FileWrapper { T handle(BufferedReader reader) throws IOException; } // -------------------------------------------------------------------------- Interface end - + /** * 检查文件 - * + * * @throws IORuntimeException IO异常 */ private void checkFile() throws IORuntimeException { diff --git a/hutool-core/src/main/java/cn/hutool/core/io/file/FileWrapper.java b/hutool-core/src/main/java/cn/hutool/core/io/file/FileWrapper.java index 8620d2e89..cb5fb628b 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/file/FileWrapper.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/file/FileWrapper.java @@ -10,16 +10,16 @@ import cn.hutool.core.util.CharsetUtil; /** * 文件包装器，扩展文件对象 - * + * * @author Looly * */ public class FileWrapper implements Serializable{ private static final long serialVersionUID = 1L; - + protected File file; protected Charset charset; - + /** 默认编码：UTF-8 */ public static final Charset DEFAULT_CHARSET = StandardCharsets.UTF_8; diff --git a/hutool-core/src/main/java/cn/hutool/core/io/file/FileWriter.java b/hutool-core/src/main/java/cn/hutool/core/io/file/FileWriter.java index ff7230867..66edf01bc 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/file/FileWriter.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/file/FileWriter.java @@ -27,7 +27,7 @@ import java.util.Map.Entry; */ public class FileWriter extends FileWrapper{ private static final long serialVersionUID = 1L; - + /** * 创建 FileWriter * @param file 文件 @@ -37,7 +37,7 @@ public class FileWriter extends FileWrapper{ public static FileWriter create(File file, Charset charset){ return new FileWriter(file, charset); } - + /** * 创建 FileWriter, 编码：{@link FileWrapper#DEFAULT_CHARSET} * @param file 文件 @@ -46,7 +46,7 @@ public class FileWriter extends FileWrapper{ public static FileWriter create(File file){ return new FileWriter(file); } - + // ------------------------------------------------------- Constructor start /** * 构造 @@ -103,10 +103,10 @@ public class FileWriter extends FileWrapper{ this(filePath, DEFAULT_CHARSET); } // ------------------------------------------------------- Constructor end - + /** * 将String写入文件 - * + * * @param content 写入的内容 * @param isAppend 是否追加 * @return 目标文件 @@ -125,10 +125,10 @@ public class FileWriter extends FileWrapper{ } return file; } - + /** * 将String写入文件，覆盖模式 - * + * * @param content 写入的内容 * @return 目标文件 * @throws IORuntimeException IO异常 @@ -139,7 +139,7 @@ public class FileWriter extends FileWrapper{ /** * 将String写入文件，追加模式 - * + * * @param content 写入的内容 * @return 写入的文件 * @throws IORuntimeException IO异常 @@ -150,7 +150,7 @@ public class FileWriter extends FileWrapper{ /** * 将列表写入文件，覆盖模式 - * + * * @param 集合元素类型 * @param list 列表 * @return 目标文件 @@ -162,7 +162,7 @@ public class FileWriter extends FileWrapper{ /** * 将列表写入文件，追加模式 - * + * * @param 集合元素类型 * @param list 列表 * @return 目标文件 @@ -174,7 +174,7 @@ public class FileWriter extends FileWrapper{ /** * 将列表写入文件 - * + * * @param 集合元素类型 * @param list 列表 * @param isAppend 是否追加 @@ -184,10 +184,10 @@ public class FileWriter extends FileWrapper{ public File writeLines(Collection list, boolean isAppend) throws IORuntimeException { return writeLines(list, null, isAppend); } - + /** * 将列表写入文件 - * + * * @param 集合元素类型 * @param list 列表 * @param lineSeparator 换行符枚举（Windows、Mac或Linux换行符） @@ -208,10 +208,10 @@ public class FileWriter extends FileWrapper{ } return this.file; } - + /** * 将Map写入文件，每个键值对为一行，一行中键与值之间使用kvSeparator分隔 - * + * * @param map Map * @param kvSeparator 键和值之间的分隔符，如果传入null使用默认分隔符" = " * @param isAppend 是否追加 @@ -222,10 +222,10 @@ public class FileWriter extends FileWrapper{ public File writeMap(Map map, String kvSeparator, boolean isAppend) throws IORuntimeException { return writeMap(map, null, kvSeparator, isAppend); } - + /** * 将Map写入文件，每个键值对为一行，一行中键与值之间使用kvSeparator分隔 - * + * * @param map Map * @param lineSeparator 换行符枚举（Windows、Mac或Linux换行符） * @param kvSeparator 键和值之间的分隔符，如果传入null使用默认分隔符" = " @@ -249,10 +249,10 @@ public class FileWriter extends FileWrapper{ } return this.file; } - + /** * 写入数据到文件 - * + * * @param data 数据 * @param off 数据开始位置 * @param len 数据长度 @@ -262,10 +262,10 @@ public class FileWriter extends FileWrapper{ public File write(byte[] data, int off, int len) throws IORuntimeException { return write(data, off, len, false); } - + /** * 追加数据到文件 - * + * * @param data 数据 * @param off 数据开始位置 * @param len 数据长度 @@ -278,7 +278,7 @@ public class FileWriter extends FileWrapper{ /** * 写入数据到文件 - * + * * @param data 数据 * @param off 数据开始位置 * @param len 数据长度 @@ -314,7 +314,7 @@ public class FileWriter extends FileWrapper{ /** * 将流的内容写入文件 - * + * * @param in 输入流，不关闭 * @param isCloseIn 是否关闭输入流 * @return dest @@ -339,7 +339,7 @@ public class FileWriter extends FileWrapper{ /** * 获得一个输出流对象 - * + * * @return 输出流对象 * @throws IORuntimeException IO异常 */ @@ -353,7 +353,7 @@ public class FileWriter extends FileWrapper{ /** * 获得一个带缓存的写入对象 - * + * * @param isAppend 是否追加 * @return BufferedReader对象 * @throws IORuntimeException IO异常 @@ -368,7 +368,7 @@ public class FileWriter extends FileWrapper{ /** * 获得一个打印写入对象，可以有print - * + * * @param isAppend 是否追加 * @return 打印对象 * @throws IORuntimeException IO异常 @@ -376,10 +376,10 @@ public class FileWriter extends FileWrapper{ public PrintWriter getPrintWriter(boolean isAppend) throws IORuntimeException { return new PrintWriter(getWriter(isAppend)); } - + /** * 检查文件 - * + * * @throws IORuntimeException IO异常 */ private void checkFile() throws IORuntimeException { @@ -388,7 +388,7 @@ public class FileWriter extends FileWrapper{ throw new IORuntimeException("File [{}] is not a file !", this.file.getAbsoluteFile()); } } - + /** * 打印新行 * @param writer Writer diff --git a/hutool-core/src/main/java/cn/hutool/core/io/file/LineReadWatcher.java b/hutool-core/src/main/java/cn/hutool/core/io/file/LineReadWatcher.java index 7f0238302..7178e665f 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/file/LineReadWatcher.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/file/LineReadWatcher.java @@ -13,7 +13,7 @@ import java.nio.file.WatchEvent; /** * 行处理的Watcher实现 - * + * * @author looly * @since 4.5.2 */ @@ -25,7 +25,7 @@ public class LineReadWatcher extends SimpleWatcher implements Runnable { /** * 构造 - * + * * @param randomAccessFile {@link RandomAccessFile} * @param charset 编码 * @param lineHandler 行处理器{@link LineHandler}实现 diff --git a/hutool-core/src/main/java/cn/hutool/core/io/file/LineSeparator.java b/hutool-core/src/main/java/cn/hutool/core/io/file/LineSeparator.java index 0512ee647..9bb72afed 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/file/LineSeparator.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/file/LineSeparator.java @@ -8,7 +8,7 @@ package cn.hutool.core.io.file; * Linux系统换行符："\n" * Windows系统换行符："\r\n" * - * + * * @see #MAC * @see #LINUX * @see #WINDOWS @@ -19,7 +19,7 @@ public enum LineSeparator { /** Mac系统换行符："\r" */ MAC("\r"), /** Linux系统换行符："\n" */ - LINUX("\n"), + LINUX("\n"), /** Windows系统换行符："\r\n" */ WINDOWS("\r\n"); diff --git a/hutool-core/src/main/java/cn/hutool/core/io/file/package-info.java b/hutool-core/src/main/java/cn/hutool/core/io/file/package-info.java index 297a34739..53c289fe4 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/file/package-info.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/file/package-info.java @@ -1,6 +1,6 @@ /** * 对文件读写的封装，包括文件拷贝、文件读取、文件写出、行处理等 - * + * * @author looly * */ diff --git a/hutool-core/src/main/java/cn/hutool/core/io/file/visitor/package-info.java b/hutool-core/src/main/java/cn/hutool/core/io/file/visitor/package-info.java index 5f2c17144..d58d04979 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/file/visitor/package-info.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/file/visitor/package-info.java @@ -1,6 +1,6 @@ /** * FileVisitor功能性实现，包括递归删除、拷贝等 - * + * * @author looly * */ diff --git a/hutool-core/src/main/java/cn/hutool/core/io/package-info.java b/hutool-core/src/main/java/cn/hutool/core/io/package-info.java index 758e57b00..13ff868d5 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/package-info.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/package-info.java @@ -1,6 +1,6 @@ /** * IO相关封装和工具类，包括Inputstream和OutputStream实现类，工具包括流工具IoUtil、文件工具FileUtil和Buffer工具BufferUtil - * + * * @author looly * */ diff --git a/hutool-core/src/main/java/cn/hutool/core/io/resource/BytesResource.java b/hutool-core/src/main/java/cn/hutool/core/io/resource/BytesResource.java index 664cf12fe..91c1041a3 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/resource/BytesResource.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/resource/BytesResource.java @@ -12,7 +12,7 @@ import java.nio.charset.Charset; /** * 基于byte[]的资源获取器
* 注意：此对象中getUrl方法始终返回null - * + * * @author looly * @since 4.0.9 */ @@ -24,16 +24,16 @@ public class BytesResource implements Resource, Serializable { /** * 构造 - * + * * @param bytes 字节数组 */ public BytesResource(byte[] bytes) { this(bytes, null); } - + /** * 构造 - * + * * @param bytes 字节数组 * @param name 资源名称 */ @@ -41,7 +41,7 @@ public class BytesResource implements Resource, Serializable { this.bytes = bytes; this.name = name; } - + @Override public String getName() { return this.name; diff --git a/hutool-core/src/main/java/cn/hutool/core/io/resource/CharSequenceResource.java b/hutool-core/src/main/java/cn/hutool/core/io/resource/CharSequenceResource.java index 75de851b3..cf0d851d5 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/resource/CharSequenceResource.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/resource/CharSequenceResource.java @@ -14,7 +14,7 @@ import java.nio.charset.Charset; /** * {@link CharSequence}资源，字符串做为资源 - * + * * @author looly * @since 5.5.2 */ diff --git a/hutool-core/src/main/java/cn/hutool/core/io/resource/ClassPathResource.java b/hutool-core/src/main/java/cn/hutool/core/io/resource/ClassPathResource.java index 08b479d0d..d1de60a40 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/resource/ClassPathResource.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/resource/ClassPathResource.java @@ -13,7 +13,7 @@ import cn.hutool.core.util.URLUtil; * ClassPath单一资源访问类
* 传入路径path必须为相对路径，如果传入绝对路径，Linux路径会去掉开头的“/”，而Windows路径会直接报错。
* 传入的path所指向的资源必须存在，否则报错 - * + * * @author Looly * */ @@ -27,7 +27,7 @@ public class ClassPathResource extends UrlResource { // -------------------------------------------------------------------------------------- Constructor start /** * 构造 - * + * * @param path 相对于ClassPath的路径 */ public ClassPathResource(String path) { @@ -36,7 +36,7 @@ public class ClassPathResource extends UrlResource { /** * 构造 - * + * * @param path 相对于ClassPath的路径 * @param classLoader {@link ClassLoader} */ @@ -46,7 +46,7 @@ public class ClassPathResource extends UrlResource { /** * 构造 - * + * * @param path 相对于给定Class的路径 * @param clazz {@link Class} 用于定位路径 */ @@ -56,7 +56,7 @@ public class ClassPathResource extends UrlResource { /** * 构造 - * + * * @param pathBaseClassLoader 相对路径 * @param classLoader {@link ClassLoader} * @param clazz {@link Class} 用于定位路径 @@ -64,11 +64,11 @@ public class ClassPathResource extends UrlResource { public ClassPathResource(String pathBaseClassLoader, ClassLoader classLoader, Class clazz) { super((URL) null); Assert.notNull(pathBaseClassLoader, "Path must not be null"); - + final String path = normalizePath(pathBaseClassLoader); this.path = path; this.name = StrUtil.isBlank(path) ? null : FileUtil.getName(path); - + this.classLoader = ObjectUtil.defaultIfNull(classLoader, ClassUtil.getClassLoader()); this.clazz = clazz; initUrl(); @@ -77,7 +77,7 @@ public class ClassPathResource extends UrlResource { /** * 获得Path - * + * * @return path */ public final String getPath() { @@ -87,7 +87,7 @@ public class ClassPathResource extends UrlResource { /** * 获得绝对路径Path
* 对于不存在的资源，返回拼接后的绝对路径 - * + * * @return 绝对路径path */ public final String getAbsolutePath() { @@ -100,7 +100,7 @@ public class ClassPathResource extends UrlResource { /** * 获得 {@link ClassLoader} - * + * * @return {@link ClassLoader} */ public final ClassLoader getClassLoader() { @@ -130,7 +130,7 @@ public class ClassPathResource extends UrlResource { /** * 标准化Path格式 - * + * * @param path Path * @return 标准化后的path */ diff --git a/hutool-core/src/main/java/cn/hutool/core/io/resource/FileResource.java b/hutool-core/src/main/java/cn/hutool/core/io/resource/FileResource.java index a4efb96a0..3c44d8d50 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/resource/FileResource.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/resource/FileResource.java @@ -11,7 +11,7 @@ import java.nio.file.Path; /** * 文件资源访问对象，支持{@link Path} 和 {@link File} 访问 - * + * * @author looly */ public class FileResource implements Resource, Serializable { @@ -22,7 +22,7 @@ public class FileResource implements Resource, Serializable { // ----------------------------------------------------------------------- Constructor start /** * 构造 - * + * * @param path 文件 * @since 4.4.1 */ @@ -32,7 +32,7 @@ public class FileResource implements Resource, Serializable { /** * 构造 - * + * * @param file 文件 */ public FileResource(File file) { @@ -41,7 +41,7 @@ public class FileResource implements Resource, Serializable { /** * 构造 - * + * * @param file 文件 * @param fileName 文件名，如果为null获取文件本身的文件名 */ @@ -51,7 +51,7 @@ public class FileResource implements Resource, Serializable { /** * 构造 - * + * * @param path 文件绝对路径或相对ClassPath路径，但是这个路径不能指向一个jar包中的文件 */ public FileResource(String path) { diff --git a/hutool-core/src/main/java/cn/hutool/core/io/resource/InputStreamResource.java b/hutool-core/src/main/java/cn/hutool/core/io/resource/InputStreamResource.java index 686caf205..887bc763d 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/resource/InputStreamResource.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/resource/InputStreamResource.java @@ -7,7 +7,7 @@ import java.net.URL; /** * 基于{@link InputStream}的资源获取器
* 注意：此对象中getUrl方法始终返回null - * + * * @author looly * @since 4.0.9 */ @@ -19,16 +19,16 @@ public class InputStreamResource implements Resource, Serializable { /** * 构造 - * + * * @param in {@link InputStream} */ public InputStreamResource(InputStream in) { this(in, null); } - + /** * 构造 - * + * * @param in {@link InputStream} * @param name 资源名称 */ @@ -36,7 +36,7 @@ public class InputStreamResource implements Resource, Serializable { this.in = in; this.name = name; } - + @Override public String getName() { return this.name; diff --git a/hutool-core/src/main/java/cn/hutool/core/io/resource/MultiFileResource.java b/hutool-core/src/main/java/cn/hutool/core/io/resource/MultiFileResource.java index 457de62e7..4abe22c90 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/resource/MultiFileResource.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/resource/MultiFileResource.java @@ -6,34 +6,34 @@ import java.util.Collection; /** * 多文件组合资源
* 此资源为一个利用游标自循环资源，只有调用{@link #next()} 方法才会获取下一个资源，使用完毕后调用{@link #reset()}方法重置游标 - * + * * @author looly * */ public class MultiFileResource extends MultiResource{ private static final long serialVersionUID = 1L; - + /** * 构造 - * + * * @param files 文件资源列表 */ public MultiFileResource(Collection files) { add(files); } - + /** * 构造 - * + * * @param files 文件资源列表 */ public MultiFileResource(File... files) { add(files); } - + /** * 增加文件资源 - * + * * @param files 文件资源 * @return this */ @@ -43,10 +43,10 @@ public class MultiFileResource extends MultiResource{ } return this; } - + /** * 增加文件资源 - * + * * @param files 文件资源 * @return this */ @@ -56,7 +56,7 @@ public class MultiFileResource extends MultiResource{ } return this; } - + @Override public MultiFileResource add(Resource resource) { return (MultiFileResource)super.add(resource); diff --git a/hutool-core/src/main/java/cn/hutool/core/io/resource/MultiResource.java b/hutool-core/src/main/java/cn/hutool/core/io/resource/MultiResource.java index 22cc38e9c..8464aa808 100644 --- a/hutool-core/src/main/java/cn/hutool/core/io/resource/MultiResource.java +++ b/hutool-core/src/main/java/cn/hutool/core/io/resource/MultiResource.java @@ -16,7 +16,7 @@ import java.util.List; /** * 多资源组合资源
* 此资源为一个利用游标自循环资源，只有调用{@link #next()} 方法才会获取下一个资源，使用完毕后调用{@link #reset()}方法重置游标 - * + * * @author looly * @since 4.1.0 */ @@ -25,10 +25,10 @@ public class MultiResource implements Resource, Iterable, Iterator resources; private int cursor; - + /** * 构造 - * + * * @param resources 资源数组 */ public MultiResource(Resource... resources) { @@ -37,7 +37,7 @@ public class MultiResource implements Resource, Iterable, Iterator resources) { @@ -113,7 +113,7 @@ public class MultiResource implements Resource, Iterable, Iterator * 路径用/分隔，例如: - * + * * 
 	 * config/a/db.config
 	 * spring/xml/test.xml
 	 *
- * + * * @param resource 资源（相对Classpath的路径） * @return 资源URL */ @@ -129,12 +129,12 @@ public class ResourceUtil { /** * 获取指定路径下的资源列表
* 路径格式必须为目录格式,用/分隔，例如: - * + * * 
 	 * config/a
 	 * spring/xml
 	 *
- * + * * @param resource 资源路径 * @return 资源列表 */ @@ -151,12 +151,12 @@ public class ResourceUtil { /** * 获取指定路径下的资源Iterator
* 路径格式必须为目录格式,用/分隔，例如: - * + * * 
 	 * config/a
 	 * spring/xml
 	 *
- * + * * @param resource 资源路径 * @return 资源列表 * @since 4.1.5 @@ -173,7 +173,7 @@ public class ResourceUtil { /** * 获得资源相对路径对应的URL - * + * * @param resource 资源相对路径 * @param baseClass 基准Class，获得的相对路径相对于此Class所在路径，如果为{@code null}则相对ClassPath * @return {@link URL} @@ -185,7 +185,7 @@ public class ResourceUtil { /** * 获取{@link Resource} 资源对象
* 如果提供路径为绝对路径或路径以file:开头，返回{@link FileResource}，否则返回{@link ClassPathResource} - * + * * @param path 路径，可以是绝对路径，也可以是相对路径（相对ClassPath） * @return {@link Resource} 资源对象 * @since 3.2.1