filechannel.truncate(long size)用于裁剪文件至指定字节长度,要求通道以write权限打开,否则抛nonwritablechannelexception;size≥当前大小时无操作,0≤size<当前大小则删除后续数据,size<0抛illegalargumentexception。

在NIO.2中,FileChannel.truncate(long size) 方法可用于将文件截断(裁剪)为指定字节长度。该操作会丢弃超出 size 的所有数据,若原文件小于或等于指定大小,则不作任何修改。
确保文件通道可写且未只读打开
调用 truncate() 前,必须保证 FileChannel 是以写入权限打开的(如使用 StandardOpenOption.WRITE),否则会抛出 NonWritableChannelException。仅用 READ 模式打开的通道无法截断。
- 正确示例:
Files.newByteChannel(path, WRITE, TRUNCATE_EXISTING)或FileChannel.open(path, WRITE) - 错误示例:
Files.newByteChannel(path, READ)—— 此时调用truncate()会失败
理解 truncate 的行为边界
truncate(size) 不会改变当前文件位置(position),也不影响已映射的 MappedByteBuffer。它只修改底层文件的实际长度:
- 若
size ≥ 当前文件大小:操作无效果,返回原通道对象 - 若
0 ≤ size :从第 <code>size字节起的所有内容被删除 - 若
size :抛出 <code>IllegalArgumentException
典型使用步骤与注意事项
实际裁剪时推荐按以下方式操作,兼顾安全与清晰性:
- 先用
Files.size(path)获取原始大小,判断是否需要截断 - 通过
FileChannel.open(path, WRITE)获取可写通道(自动处理存在性) - 调用
channel.truncate(targetSize),建议检查返回值(虽然通常返回自身) - 务必显式调用
channel.close()或使用 try-with-resources 确保释放资源










