자바에서 일반 텍스트 파일 읽기: 자세한 설명

2024-08-04

왜 자바에서 파일을 읽어야 할까요?

자바 프로그램에서 파일을 읽는 이유는 다양합니다.

데이터 저장 및 불러오기: 프로그램 실행 중에 생성된 데이터를 파일에 저장하고, 필요할 때 다시 읽어와 사용할 수 있습니다.
외부 데이터 처리: CSV 파일, 로그 파일 등 다양한 형식의 외부 데이터를 읽어와 분석하거나 가공할 수 있습니다.
설정 파일 관리: 프로그램의 설정 정보를 파일에 저장하고, 프로그램 실행 시 이를 읽어와 설정을 적용할 수 있습니다.

자바에서 텍스트 파일을 읽는 방법

자바에서 텍스트 파일을 읽는 방법은 크게 다음과 같은 단계로 이루어집니다.

파일 객체 생성: 읽고자 하는 파일의 경로를 사용하여 File 클래스의 객체를 생성합니다.
스트림 생성: FileReader 클래스를 사용하여 파일을 읽기 위한 스트림을 생성합니다. 스트림은 파일과 프로그램 사이의 데이터 전달 통로 역할을 합니다.
데이터 읽기: BufferedReader 클래스를 사용하여 스트림에서 한 줄씩 데이터를 읽어옵니다.
스트림 닫기: 작업이 완료되면 close() 메소드를 호출하여 스트림을 닫아줍니다.

코드 예시

import java.io.*;

public class ReadTextFile {
    public static void main(String[] args) {
        String fileName = "myFile.txt"; // 읽을 파일 이름

        try (BufferedReader br = new BufferedReader(new FileReader(fileName))) {
            String line;
            while ((line = br.readLine()) != null) {
                System.out.println(line);
            }
        } catch (IOException e) {
            e.printStackTrac   e();
        }
    }
}

코드 설명

BufferedReader: 효율적인 텍스트 읽기를 위한 버퍼를 제공합니다.
FileReader: 텍스트 파일을 읽기 위한 스트림을 생성합니다.
readLine(): 스트림에서 한 줄씩 데이터를 읽어옵니다.
try-with-resources: 스트림을 자동으로 닫아주는 편리한 구문입니다.

주의할 점

파일 경로: 파일의 절대 경로 또는 상대 경로를 정확하게 지정해야 합니다.
파일 존재 유무: 파일이 존재하지 않으면 FileNotFoundException 예외가 발생합니다.
인코딩: 파일의 인코딩 방식을 고려해야 합니다. 기본적으로는 시스템의 기본 인코딩 방식을 사용하지만, 필요에 따라 다른 인코딩 방식을 지정할 수 있습니다.
예외 처리: 파일 읽기 중 예외가 발생할 수 있으므로 try-catch 블록을 사용하여 예외를 처리해야 합니다.

추가 기능

특정 문자열 찾기: String 클래스의 메소드를 사용하여 읽어온 문자열에서 특정 문자열을 찾을 수 있습니다.
데이터 가공: 읽어온 데이터를 원하는 형식으로 가공하여 사용할 수 있습니다.
다른 형식의 파일 읽기: FileInputStream 등 다른 스트림 클래스를 사용하여 바이너리 파일 등 다른 형식의 파일을 읽을 수 있습니다.

정리

자바에서 텍스트 파일을 읽는 것은 BufferedReader와 FileReader 클래스를 사용하여 간단하게 구현할 수 있습니다. 하지만 파일 경로, 인코딩, 예외 처리 등 주의해야 할 점들이 있으므로, 코드를 작성할 때 이러한 부분을 신중하게 고려해야 합니다.

자바에서 CSV 파일을 읽는 방법은 어떻게 되나요?
파일의 인코딩이 다를 때 어떻게 처리해야 하나요?
파일 읽기 성능을 향상시키는 방법은 무엇이 있나요?

자바 텍스트 파일 읽기 샘플 코드 심화 및 다양한 예시

다양한 인코딩 처리

import java.io.*;

public class ReadTextFileWithEncoding {
    public static void main(String[] args) {
        String fileName = "myFile.txt";
        String encoding = "UTF-8"; // 원하는 인코딩 지정

        try (BufferedReader br = new BufferedReader(new InputStreamReader(new FileInputStream(fileName), encoding))) {
            String line;
            while ((line = br.readLine()) != null) {
                Syste   m.out.println(line);
            }
        }    catch (IOException e) {
            e.printStackTrace();
        }
    }
}

InputStreamReader를 통해 인코딩을 지정하여 다양한 인코딩의 파일을 읽을 수 있습니다.
encoding 변수에 원하는 인코딩 (UTF-8, EUC-KR 등)을 설정합니다.

파일 내용 전체를 한 번에 읽기

import java.io.*;
import java.nio.file.Files;
import java.nio.file.Paths;

public class ReadTextFileAllAtOnce {
    public static void main(String[] args) throws IOException {
        String fileName = "myFile.txt";
        String content = new String(Files.readAllBytes(Paths.get(fileName)));
        System.out.println(content);
    }
}

Files.readAllBytes를 이용하여 파일 전체를 바이트 배열로 읽어온 후, 문자열로 변환합니다.
파일이 작을 때 효율적이며, 큰 파일의 경우 메모리 부족 문제가 발생할 수 있습니다.

특정 문자열 찾기

import java.io.*;

public class FindStringInFile {
    public static void main(String[] args) throws IOException {
        String fileName = "myFile.txt";
        String searchString = "찾고 싶은 문자열";

        try (BufferedReader br = new BufferedReader(new FileReader(fileName))) {
            String line;
            int lineNumber = 1;
            while ((line = br.readLine()) != null) {
                if    (line.contains(searchString)) {
                    System.out.println("문자열 발견: 라인 " + lineNumber + ", 내용: " + line);
                }
                lineNumber++;
            }
        }
    }
}

contains 메소드를 이용하여 각 라인에서 특정 문자열을 검색합니다.
라인 번호를 함께 출력하여 찾은 위치를 확인할 수 있습니다.

파일 쓰기와 함께 사용하기

import java.io.*;

public class ReadWriteTextFile {
    public static void main(String[] args) throws IOException {
        String fileName = "myFile.txt";

        // 파일 읽기
        try (BufferedReader br = new BufferedReader(new FileReader(fileName))) {
            String line;
            while ((line = br.readLine()) != null) {
                System.out.prin   tln(line);
            }
        }

        // 파일 쓰기
        try (BufferedWriter bw = new BufferedWriter(new FileWriter(fileName, true))) {
            bw.write("새로운 내용 추가");
            bw.newLine();
        }
    }
}

FileWriter를 이용하여 파일을 쓰고, true 옵션을 주면 기존 내용 뒤에 추가됩니다.

예외 처리 강화

import java.io.*;

public class ReadTextFileWithExceptionHandling {
    public static void main(String[] args) {
        try {
            // 파일 읽기 코드
        } catch (FileNotFoundException e) {
            System.out.println("파일이 없습니다.");
        } catch (IOException e) {
            System.out.println("입출력 오류 발생: " + e.getMessage());
        }
    }
}

FileNotFoundException, IOException 등 다양한 예외를 처리하여 프로그램의 안정성을 높입니다.

주의:

파일 경로: 정확한 파일 경로를 지정해야 합니다.
인코딩: 파일의 인코딩을 정확히 파악하여 적절한 인코딩을 사용해야 합니다.
메모리: 파일이 매우 클 경우 OutOfMemoryError가 발생할 수 있으므로 주의해야 합니다.
자원 해제: try-with-resources 문을 사용하여 스트림을 자동으로 닫아주는 것이 좋습니다.

다양한 추가 기능:

정규 표현식: 복잡한 패턴 검색
JSON, XML 파싱: 라이브러리를 이용하여 구조화된 데이터 처리
데이터베이스 연동: JDBC를 이용하여 데이터베이스와 연동

자바 텍스트 파일 읽기: 다양한 방법과 선택 가이드

지금까지 다양한 자바 텍스트 파일 읽기 방법을 살펴보았습니다. 어떤 방법을 선택해야 할지는 파일 크기, 처리 속도, 데이터 형식, 추가 기능 등 다양한 요소에 따라 달라집니다.

각 방법의 특징 및 적합한 상황

BufferedReader:
- 장점: 라인 단위로 효율적으로 읽기, 다양한 보조 스트림과 조합 가능
- 단점: 큰 파일을 한 번에 읽기에는 비효율적일 수 있음
- 적합한 상황: 일반적인 텍스트 파일 읽기, 라인 단위 처리, 추가적인 가공이 필요한 경우
Scanner:
- 장점: 다양한 형식의 데이터(정수, 실수, 문자열 등)를 간편하게 읽기
- 단점: BufferedReader에 비해 다소 느릴 수 있음
- 적합한 상황: 다양한 형식의 데이터를 혼합하여 저장된 파일, 간단한 파싱이 필요한 경우
Files.readAllBytes:
- 장점: 파일 전체를 한 번에 메모리에 로드하여 빠른 처리 가능
- 단점: 큰 파일의 경우 메모리 부족 문제 발생 가능
- 적합한 상황: 파일 전체를 한 번에 처리해야 할 때, 파일 크기가 작은 경우
InputStreamReader:
- 장점: 다양한 인코딩 지원, 저수준 입출력 제어 가능
- 단점: 사용법이 다소 복잡함
- 적합한 상황: 특정 인코딩을 사용하는 파일, 저수준 입출력이 필요한 경우

선택 가이드

파일 크기:
- 작은 파일: 어떤 방법을 사용해도 무방
- 큰 파일: BufferedReader를 사용하거나, 파일을 분할하여 처리
처리 속도:
데이터 형식:
- 다양한 형식: Scanner
- 텍스트: BufferedReader
추가 기능:
- 특정 문자열 찾기, 정규 표현식: BufferedReader와 String 클래스 메소드 조합
- JSON, XML 파싱: Jackson, JAXB 등 라이브러리 사용