HOWTO · Java
Java에서 파일에 바이트 쓰기
이 기사에서는 Java에서 파일에 바이트를 쓰는 방법을 보여줍니다.
이 페이지의 내용
이 튜토리얼에서는 Java에서 바이트 배열을 파일에 쓰는 방법을 보여줍니다. 표준 라이브러리는 두 가지 실용적인 옵션을 제공합니다. 스트림 방식으로 쓰는 FileOutputStream과 한 번의 호출로 처리하는 NIO Files.write() 메서드이며, Apache Commons IO는 이미 해당 종속성을 사용 중인 프로젝트를 위해 FileUtils.writeByteArrayToFile()을 편의 메서드로 제공합니다. 모든 예제는 StandardCharsets.UTF_8로 텍스트를 바이트로 변환하므로 저장된 파일이 시스템의 기본 문자 집합에 의존하지 않습니다.
FileOutputStream으로 바이트 배열 쓰기
FileOutputStream은 java.io의 고전적인 바이트 기반 스트림입니다. 파일 이름으로 생성하면 파일이 없을 때 파일을 만들고, 이미 있는 파일의 내용은 대체합니다. 대신 이어 쓰려면 두 번째 생성자 인수로 true를 전달하세요. 이 스트림은 운영 체제 핸들을 보유하므로 쓰기가 끝나면 닫아야 하며, try-with-resources를 사용하면 자동으로 닫힙니다.
다음 예제를 실행해 보세요:
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
import java.io.FileOutputStream;
import java.nio.charset.StandardCharsets;
class ByteToFile {
public static void main(String[] args) throws Throwable {
byte[] data = "DelftStack writes bytes".getBytes(StandardCharsets.UTF_8);
try (FileOutputStream out = new FileOutputStream("stream-demo.bin")) {
out.write(data);
}
System.out.println("Wrote " + data.length + " bytes to stream-demo.bin");
}
}
Wrote 23 bytes to stream-demo.bin
getBytes(StandardCharsets.UTF_8)은 문자열을 결정적으로 인코딩합니다. 인수 없이 getBytes()를 호출하면 플랫폼 기본 문자 집합을 사용하므로 다른 컴퓨터에서는 다른 바이트가 생성될 수 있습니다. write(data)는 배열 전체를 저장하고, write(data, offset, length)는 필요할 때 배열의 일부만 저장합니다. 생성자 자체가 실패하는 경우, 즉 경로가 디렉토리를 가리키거나 상위 디렉토리가 없거나 쓰기 권한이 없는 경우 Java는 FileNotFoundException을 발생시키므로 스트림을 열기 전에 쓰기 가능한 대상을 선택하세요. 코드 블록 안의 문자열 리터럴과 출력 레이블은 모든 로캘에서 바이트 단위로 동일하게 유지되므로 영어로 표시됩니다.
Files.write()로 바이트 배열 쓰기
java.nio.file API는 전체 작업을 한 번의 호출로 압축합니다. Files.write()는 경로를 열고 모든 바이트를 쓴 다음 파일을 닫습니다. 기본적으로 파일이 없으면 생성하고, 있으면 내용을 잘라냅니다. 이어 쓰려면 StandardOpenOption.APPEND를, 파일이 이미 있을 때 실패하게 하려면 StandardOpenOption.CREATE_NEW와 같은 열기 옵션을 전달하세요.
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
class ByteToFileNio {
public static void main(String[] args) throws Throwable {
byte[] data = "NIO write sample data".getBytes(StandardCharsets.UTF_8);
Path target = Paths.get("nio-demo.bin");
Files.write(target, data);
System.out.println("Wrote " + data.length + " bytes to nio-demo.bin");
}
}
Wrote 21 bytes to nio-demo.bin
이 메서드는 IOException을 선언하며, 일반적인 실패 원인은 구체적으로 구분됩니다. 상위 디렉토리가 없으면 NoSuchFileException, 프로세스에 권한이 없으면 AccessDeniedException, 기존 파일에 CREATE_NEW를 전달하면 FileAlreadyExistsException이 발생합니다. 가장 짧은 표준 라이브러리 형태를 원하고 FileOutputStream처럼 열린 스트림을 제어할 필요가 없다면 Files.write()를 선택하세요. 코드 블록 안의 문자열 리터럴과 출력 레이블은 모든 로캘에서 바이트 단위로 동일하게 유지되므로 영어로 표시됩니다.
Apache Commons IO로 바이트 배열 쓰기
이미 Apache Commons IO에 의존하는 프로젝트는 대신 FileUtils.writeByteArrayToFile()을 호출할 수 있습니다. 빌드에 고정된 버전으로 Maven 좌표 commons-io:commons-io를 선언하세요. 이 기사의 원래 버전에는 2.6이 표시되어 있었지만, 이는 현재 권장 버전이 아니라 제공된 예제 버전이므로 사용하려는 릴리스 라인을 확인하세요.
org.apache.commons.io.FileUtils를 임포트하면 호출은 FileUtils.writeByteArrayToFile(new File("doc.txt"), data)이며, 여기서 data는 "text".getBytes(StandardCharsets.UTF_8)과 같은 임의의 byte[]입니다. 이 메서드는 대상 파일이 없으면 생성하고, 없는 상위 디렉토리도 함께 만듭니다. 이는 Files.write()가 수행하지 않는 단계입니다. 또한 기존 파일은 쓰기 전에 잘라냅니다. 스트림을 내부적으로 관리하므로 호출자가 닫아야 할 핸들도 남지 않습니다. 이 클래스는 서드파티 jar에 있으므로 이 스니펫은 실행 가능한 예제가 아닌 소스로 표시되며, 안의 문자열과 출력 레이블은 영어로 유지됩니다. 종속성이 없는 새 코드라면 Files.write()가 같은 작업을 한 줄로 처리합니다.