[java] 파일 필터링 및 마스킹 처리 오류 처리를 위한 Apache Commons IO 사용법

14 Nov 2023

java

파일을 필터링하거나 마스킹 처리하는 작업은 자바 프로그래밍에서 자주 발생하는 작업 중 하나입니다. 이러한 작업을 수행하기 위해 Apache Commons IO 라이브러리를 사용할 수 있습니다. 이 라이브러리는 파일 및 디렉토리 작업을 쉽게 처리할 수 있는 많은 유틸리티 클래스를 제공합니다.

Apache Commons IO 라이브러리 추가

먼저, Apache Commons IO 라이브러리를 사용하기 위해 프로젝트에 해당 라이브러리를 추가해야 합니다. 이를 위해 다음의 Maven 종속성을 pom.xml 파일에 추가합니다:

<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.11.0</version>
</dependency>

라이브러리를 직접 다운로드하여 프로젝트에 추가할 수도 있습니다. 이 경우에는 Apache Commons IO 공식 웹사이트에서 라이브러리를 다운로드하여 필요한 JAR 파일을 프로젝트 빌드 경로에 추가하면 됩니다.

파일 필터링

파일 필터링은 원하는 기준에 따라 특정 파일만 선택하는 작업입니다. Apache Commons IO 라이브러리는 FileFilter 인터페이스를 제공하여 파일 필터링을 수행할 수 있게 해줍니다.

다음은 예제 코드입니다:

import org.apache.commons.io.FileUtils;
import org.apache.commons.io.filefilter.WildcardFileFilter;

import java.io.File;
import java.io.FileFilter;
import java.util.Collection;

public class FileFilterExample {

    public static void main(String[] args) {
        // 필터링할 디렉토리 경로
        File directory = new File("/path/to/directory");

        // 파일 필터링
        FileFilter fileFilter = new WildcardFileFilter("*.txt");
        Collection<File> filteredFiles = FileUtils.listFiles(directory, fileFilter, null);

        // 필터링된 파일 목록 출력
        for (File file : filteredFiles) {
            System.out.println(file.getName());
        }
    }
}

위의 예제 코드에서는 "*.txt" 확장자를 가진 파일만 선택하여 출력합니다. 원하는 확장자나 조건에 따라 파일 필터를 설정할 수 있습니다.

파일 마스킹 처리

파일 마스킹은 파일의 내용을 숨기거나 일부분을 가리는 작업입니다. Apache Commons IO 라이브러리는 FileUtils 클래스를 통해 파일 마스킹을 수행할 수 있게 해줍니다.

다음은 예제 코드입니다:

import org.apache.commons.io.FileUtils;

import java.io.File;
import java.io.IOException;

public class FileMaskingExample {

    public static void main(String[] args) throws IOException {
        // 마스킹할 파일 경로
        File file = new File("/path/to/file.txt");

        // 파일 마스킹
        FileUtils.write(file, "This is sensitive information.");

        // 파일 마스킹 처리
        FileUtils.writeStringToFile(file, "************", "UTF-8", true);

        // 마스킹된 파일 내용 출력
        String maskedContent = FileUtils.readFileToString(file, "UTF-8");
        System.out.println(maskedContent);
    }
}

위의 예제 코드에서는 FileUtils 클래스를 사용하여 “This is sensitive information.” 라는 내용을 가진 파일을 마스킹하고, 마스킹된 파일 내용을 출력합니다.

예외 처리

Apache Commons IO 작업 중에는 파일이 존재하지 않거나 접근 권한이 없는 등의 예외가 발생할 수 있습니다. 이러한 예외를 적절히 처리해야 합니다.

다음은 예외 처리를 함께 적용한 예제 코드입니다:

import org.apache.commons.io.FileUtils;

import java.io.File;
import java.io.IOException;

public class ExceptionHandlingExample {

    public static void main(String[] args) {
        // 파일 경로
        File file = new File("/path/to/file.txt");

        try {
            // 파일 읽기 시도
            String fileContent = FileUtils.readFileToString(file, "UTF-8");
            System.out.println(fileContent);
        } catch (IOException e) {
            // 예외 처리
            System.out.println("파일을 읽을 수 없습니다.");
            e.printStackTrace();
        }
    }
}

위의 예제 코드에서는 파일을 읽는 작업 수행 시 IOException이 발생할 수 있습니다. 이때 try-catch 문을 사용하여 예외를 적절히 처리하고, 오류 메시지를 출력합니다.

결론

Apache Commons IO 라이브러리를 사용하면 파일 필터링 및 마스킹 처리와 같은 파일 관련 작업을 쉽게 처리할 수 있습니다. 이 라이브러리를 활용하여 자바 프로그램에서 파일 작업을 간편하게 처리할 수 있습니다.