zhouxy108/hutool
1
0
Fork 0
mirror of https://gitee.com/chinabugotech/hutool.git synced 2025-07-21 15:09:48 +08:00
Code Issues Packages Projects Releases Wiki Activity

add code

Browse Source
This commit is contained in:
Looly
2020-11-13 17:54:42 +08:00
parent 1a0c9a3b51
commit 99eeb30ffe
13 changed files with 222 additions and 116 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
hutool-core/src/main/java/cn/hutool/core/io/FileUtil.java
View File

@@ -306,6 +306,7 @@ public class FileUtil extends PathUtil {
/**
* 创建File对象<br>
* 根据的路径构建文件，在Win下直接构建，在Linux下拆分路径单独构建
* 此方法会检查slip漏洞，漏洞说明见http://blog.nsfocus.net/zip-slip-2/
*
* @param parent 父文件对象
@@ -316,7 +317,7 @@ public class FileUtil extends PathUtil {
if (StrUtil.isBlank(path)) {
throw new NullPointerException("File path is blank!");
}
return checkSlip(parent, new File(parent, path));
return checkSlip(parent, buildFile(parent, path));
}
/**
@@ -3277,4 +3278,34 @@ public class FileUtil extends PathUtil {
public static void tail(File file, Charset charset) {
tail(file, charset, Tailer.CONSOLE_HANDLER);
}
/**
* 根据压缩包中的路径构建目录结构，在Win下直接构建，在Linux下拆分路径单独构建
*
* @param outFile 最外部路径
* @param fileName 文件名，可以包含路径
* @return 文件或目录
* @since 5.0.5
*/
private static File buildFile(File outFile, String fileName) {
// 替换Windows路径分隔符为Linux路径分隔符，便于统一处理
fileName = fileName.replace('\\', '/');
if (false == FileUtil.isWindows()
// 检查文件名中是否包含"/"，不考虑以"/"结尾的情况
&& fileName.lastIndexOf(CharUtil.SLASH, fileName.length() - 2) > 0) {
// 在Linux下多层目录创建存在问题，/会被当成文件名的一部分，此处做处理
// 使用/拆分路径（zip中无\），级联创建父目录
final List<String> pathParts = StrUtil.split(fileName, '/', false, true);
final int lastPartIndex = pathParts.size() - 1;//目录个数
for (int i = 0; i < lastPartIndex; i++) {
//由于路径拆分，slip不检查，在最后一步检查
outFile = new File(outFile, pathParts.get(i));
}
//noinspection ResultOfMethodCallIgnored
outFile.mkdirs();
// 最后一个部分如果非空，作为文件名
fileName = pathParts.get(lastPartIndex);
}
return new File(outFile, fileName);
}
}

32
hutool-core/src/main/java/cn/hutool/core/util/ZipUtil.java
View File

@@ -471,7 +471,7 @@ public class ZipUtil {
while (em.hasMoreElements()) {
zipEntry = em.nextElement();
// FileUtil.file会检查slip漏洞，漏洞说明见http://blog.nsfocus.net/zip-slip-2/
outItemFile = buildFile(outFile, zipEntry.getName());
outItemFile = FileUtil.file(outFile, zipEntry.getName());
if (zipEntry.isDirectory()) {
// 创建对应目录
//noinspection ResultOfMethodCallIgnored
@@ -1106,36 +1106,6 @@ public class ZipUtil {
throw new IORuntimeException(e);
}
}
/**
* 根据压缩包中的路径构建目录结构，在Win下直接构建，在Linux下拆分路径单独构建
*
* @param outFile 最外部路径
* @param fileName 文件名，可以包含路径
* @return 文件或目录
* @since 5.0.5
*/
private static File buildFile(File outFile, String fileName) {
// 替换Windows路径分隔符为Linux路径分隔符，便于统一处理
fileName = fileName.replace('\\', '/');
if (false == FileUtil.isWindows()
// 检查文件名中是否包含"/"，不考虑以"/"结尾的情况
&& fileName.lastIndexOf(CharUtil.SLASH, fileName.length() - 2) > 0) {
// 在Linux下多层目录创建存在问题，/会被当成文件名的一部分，此处做处理
// 使用/拆分路径（zip中无\），级联创建父目录
final List<String> pathParts = StrUtil.split(fileName, '/', false, true);
final int lastPartIndex = pathParts.size() - 1;//目录个数
for (int i = 0; i < lastPartIndex; i++) {
//由于路径拆分，slip不检查，在最后一步检查
outFile = new File(outFile, pathParts.get(i));
}
//noinspection ResultOfMethodCallIgnored
outFile.mkdirs();
// 最后一个部分如果非空，作为文件名
fileName = pathParts.get(lastPartIndex);
}
return FileUtil.file(outFile, fileName);
}
// ---------------------------------------------------------------------------------------------- Private method end
}

4
hutool-extra/src/main/java/cn/hutool/extra/compress/Extractor.java
View File

@@ -1,4 +0,0 @@
package cn.hutool.extra.compress;
public class Extractor {
}

2
hutool-extra/src/main/java/cn/hutool/extra/compress/archiver/Archiver.java
View File

@@ -7,7 +7,7 @@ import java.io.File;
import java.io.FileFilter;
/**
* 数据归档封装，归档即将几个文件或目录打成一个压缩包<br>
* 数据归档封装，归档即将几个文件或目录打成一个压缩包
*
* @author looly
*/

2
hutool-extra/src/main/java/cn/hutool/extra/compress/archiver/StreamArchiver.java
View File

@@ -56,7 +56,7 @@ public class StreamArchiver implements Archiver {
return new StreamArchiver(charset, archiverName, out);
}
private ArchiveOutputStream out;
private final ArchiveOutputStream out;
/**
* 构造

11
hutool-extra/src/main/java/cn/hutool/extra/compress/archiver/package-info.java Normal file
View File

@@ -0,0 +1,11 @@
/**
* 基于commons-compress的打包（压缩）封装
*
* <p>
* 见：https://commons.apache.org/proper/commons-compress/
* </p>
*
* @author looly
*
*/
package cn.hutool.extra.compress.archiver;

11
hutool-extra/src/main/java/cn/hutool/extra/compress/extractor/Extractor.java Normal file
View File

@@ -0,0 +1,11 @@
package cn.hutool.extra.compress.extractor;
/**
* 数据解包封装，用于将zip、tar等包解包为文件
*
* @author looly
* @since 5.5.0
*/
public interface Extractor {
}

69
hutool-extra/src/main/java/cn/hutool/extra/compress/extractor/StreamExtractor.java Normal file
View File

@@ -0,0 +1,69 @@
package cn.hutool.extra.compress.extractor;
import cn.hutool.core.io.FileUtil;
import cn.hutool.core.io.IORuntimeException;
import cn.hutool.core.lang.Assert;
import cn.hutool.extra.compress.CompressException;
import org.apache.commons.compress.archivers.ArchiveEntry;
import org.apache.commons.compress.archivers.ArchiveException;
import org.apache.commons.compress.archivers.ArchiveInputStream;
import org.apache.commons.compress.archivers.ArchiveStreamFactory;
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.nio.charset.Charset;
public class StreamExtractor {
private final ArchiveInputStream in;
public StreamExtractor(Charset charset, InputStream in) {
final ArchiveStreamFactory factory = new ArchiveStreamFactory(charset.name());
try {
this.in = factory.createArchiveInputStream(in);
} catch (ArchiveException e) {
throw new CompressException(e);
}
}
/**
* 释放（解压）到指定目录
*
* @param targetDir 目标目录
*/
public void extract(File targetDir) {
try {
extractInternal(targetDir);
} catch (IOException e) {
throw new IORuntimeException(e);
}
}
/**
* 释放（解压）到指定目录
*
* @param targetDir 目标目录
* @throws IOException IO异常
*/
private void extractInternal(File targetDir) throws IOException {
Assert.isTrue(null != targetDir && targetDir.isDirectory(), "target must be dir.");
final ArchiveInputStream in = this.in;
ArchiveEntry entry;
File outItemFile;
while(null != (entry = this.in.getNextEntry())){
if(false == in.canReadEntryData(entry)){
// 无法读取的文件直接跳过
continue;
}
outItemFile = FileUtil.file(targetDir, entry.getName());
if(entry.isDirectory()){
// 创建对应目录
//noinspection ResultOfMethodCallIgnored
outItemFile.mkdirs();
} else {
FileUtil.writeFromStream(in, outItemFile);
}
}
}
}

11
hutool-extra/src/main/java/cn/hutool/extra/compress/extractor/package-info.java Normal file
View File

@@ -0,0 +1,11 @@
/**
* 基于commons-compress的解包（解压缩）封装
*
* <p>
* 见：https://commons.apache.org/proper/commons-compress/
* </p>
*
* @author looly
*
*/
package cn.hutool.extra.compress.extractor;

12
hutool-extra/src/main/java/cn/hutool/extra/template/engine/freemarker/FreemarkerEngine.java
View File

@@ -1,7 +1,5 @@
package cn.hutool.extra.template.engine.freemarker;
import java.io.IOException;
import cn.hutool.core.io.FileUtil;
import cn.hutool.core.io.IORuntimeException;
import cn.hutool.core.util.ClassUtil;
@@ -13,8 +11,11 @@ import freemarker.cache.ClassTemplateLoader;
import freemarker.cache.FileTemplateLoader;
import freemarker.template.Configuration;
import java.io.IOException;
/**
* Beetl模板引擎封装
* FreeMarker模板引擎封装<br>
* 见：https://freemarker.apache.org/
*
* @author looly
*/
@@ -23,10 +24,12 @@ public class FreemarkerEngine implements TemplateEngine {
private Configuration cfg;
// --------------------------------------------------------------------------------- Constructor start
/**
* 默认构造
*/
public FreemarkerEngine() {}
public FreemarkerEngine() {
}
/**
* 构造
@@ -58,6 +61,7 @@ public class FreemarkerEngine implements TemplateEngine {
/**
* 初始化引擎
*
* @param freemarkerCfg Configuration
*/
private void init(Configuration freemarkerCfg) {

4
hutool-extra/src/main/java/cn/hutool/extra/template/engine/freemarker/package-info.java
View File

@@ -1,7 +1,7 @@
/**
* Freemarker实现
* Freemarker实现<br>
* 见：https://freemarker.apache.org/
*
* @author looly
*
*/
package cn.hutool.extra.template.engine.freemarker;

9
hutool-extra/src/main/java/cn/hutool/extra/template/engine/velocity/VelocityEngine.java
View File

@@ -7,10 +7,10 @@ import cn.hutool.extra.template.TemplateEngine;
import org.apache.velocity.app.Velocity;
/**
* Velocity模板引擎
* Velocity模板引擎<br>
* 见：http://velocity.apache.org/
*
* @author looly
*
*/
public class VelocityEngine implements TemplateEngine {
@@ -18,10 +18,12 @@ public class VelocityEngine implements TemplateEngine {
private TemplateConfig config;
// --------------------------------------------------------------------------------- Constructor start
/**
* 默认构造
*/
public VelocityEngine() {}
public VelocityEngine() {
}
/**
* 构造
@@ -54,6 +56,7 @@ public class VelocityEngine implements TemplateEngine {
/**
* 初始化引擎
*
* @param engine 引擎
*/
private void init(org.apache.velocity.app.VelocityEngine engine) {

4
hutool-extra/src/main/java/cn/hutool/extra/template/engine/velocity/package-info.java
View File

@@ -1,7 +1,7 @@
/**
* Velocity实现
* Velocity实现<br>
* 见：http://velocity.apache.org/
*
* @author looly
*
*/
package cn.hutool.extra.template.engine.velocity;