[java] Apache Commons Net과의 파일 전송 오류 처리

22 Dec 2023

java

Apache Commons Net은 Java에서 네트워크 프로토콜을 구현하기 위한 라이브러리입니다. 파일 전송 기능을 구현할 때 생기는 오류를 처리하는 방법을 알아보겠습니다.

에러 핸들링을 위한 Try-Catch 구문 활용

Apache Commons Net을 사용하여 파일을 전송하다 보면 여러 가지 오류가 발생할 수 있습니다. 이러한 오류를 처리하기 위해 Try-Catch 구문을 활용하여 각각의 오류 상황에 대한 적절한 처리를 구현할 수 있습니다.

import org.apache.commons.net.ftp.FTPClient;
import java.io.FileInputStream;
import java.io.IOException;

public class FileUploader {
    public static void main(String[] args) {
        FTPClient ftpClient = new FTPClient();
        FileInputStream inputStream = null;
        
        try {
            // FTP 연결 설정 및 파일 전송
            ftpClient.connect("ftp.example.com");
            ftpClient.login("username", "password");
            inputStream = new FileInputStream("localFile.txt");
            ftpClient.storeFile("remoteFile.txt", inputStream);
        } catch (IOException e) {
            // 오류 발생 시 처리
            e.printStackTrace();
        } finally {
            try {
                if (inputStream != null) {
                    inputStream.close();
                }
                ftpClient.logout();
                ftpClient.disconnect();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
}

위의 예제 코드는 FTPClient를 사용하여 파일을 FTP 서버에 업로드하는 과정에서 발생할 수 있는 오류를 Try-Catch 구문을 통해 처리하는 방법을 보여줍니다.

예외처리 및 로깅

Apache Commons Net을 사용하여 파일 전송 시에 발생하는 오류를 적절히 처리하기 위해 예외처리와 로깅을 함께 활용할 수 있습니다. 예외처리를 통해 오류 발생 시 적절한 조치를 취하고, 로깅을 통해 오류의 원인을 파악할 수 있습니다.

import org.apache.commons.net.ftp.FTPClient;
import org.apache.commons.net.ftp.FTPConnectionClosedException;
import org.apache.commons.net.ftp.FTPFile;
import org.apache.commons.net.ftp.FTPReply;
import java.io.IOException;

public class FTPFileList {
    public static void main(String[] args) {
        FTPClient ftp = new FTPClient();
        try {
            // FTP 연결 및 로그인
            ftp.connect("ftp.example.com");
            int reply = ftp.getReplyCode();
            if (!FTPReply.isPositiveCompletion(reply)) {
                ftp.disconnect();
                throw new IOException("FTP 서버 응답이 올바르지 않습니다: " + reply);
            }
            ftp.login("username", "password");

            // 파일 목록 가져오기
            FTPFile[] files = ftp.listFiles("/pub");
            if (files != null) {
                for (FTPFile file : files) {
                    System.out.println(file.getName());
                }
            }
        } catch (FTPConnectionClosedException e) {
            // FTP 연결이 닫힘
            System.err.println("FTP 서버 연결이 닫혔습니다.");
        } catch (IOException e) {
            // 기타 IO 오류
            e.printStackTrace();
        } finally {
            try {
                // FTP 연결 종료
                if (ftp.isConnected()) {
                    ftp.logout();
                    ftp.disconnect();
                }
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
}

위의 예제 코드에서는 FTP 서버와의 연결, 로그인, 파일 목록 가져오기 과정에서 발생할 수 있는 다양한 오류 상황에 대한 예외처리와 로깅을 함께 적용하고 있습니다.

마치며

Apache Commons Net을 사용하여 파일 전송 기능을 구현할 때 예외 상황에 대한 적절한 처리와 로깅은 중요합니다. Try-Catch 구문을 통한 예외처리와 로깅을 통해 외부 요인으로 인한 오류에 대비하여 안정적인 파일 전송 기능을 구현할 수 있습니다.

참고 문헌:

Apache Commons Net 공식 문서: https://commons.apache.org/proper/commons-net/
“Java Network Programming” - Elliotte Rusty Harold, O’Reilly Media

Apache Commons Net 라이브러리를 활용하여 파일 전송 과정에서 발생하는 다양한 예외에 대한 처리 방법을 익힌 후 안정적인 파일 전송 기능을 구현할 수 있습니다.