🧑‍💻 개인 프로젝트 - 주소록 만들기 (JAVA)

---

JAVA 주소록 관리 프로그램

Project code - BackEnd

---

1. 프로젝트 소개

ㅤ이 프로젝트는 JAVA로 구현된 주소록 관리 프로그램입니다.

ㅤ사용자 정보를 입, 출력할 수 있으며 수정, 삭제, 조회가 가능합니다.

개발환경 Eclipse / JDK 17

---

2. 프로젝트 구조

상세 구조는 페이지 상단의 깃허브 링크를 참고해주세요

📁src
  └──📁common.utils - 📄문자열 처리, 날짜 계산, 한글 초성 추출 유틸리티
  └──📁console.academy - 📄주소록 메뉴 , CRUD 로직

---

3. 주요 코드

CommonUtils.java

아래 코드는 공통 유틸리티 메소드들을 포함하고 있습니다.

주요 기능으로는 문자열이 숫자인지 체크, 두 날짜의 차이를 구하는 메소드, 문자열을 int 배열로 변환하는 메소드, 한글 초성을 추출하는 메소드 등이 포함되어 있습니다.

      
      
      
  public class CommonUtils {
  
    // 문자열이 숫자 형식이면 true, 아니면 false 반환 메소드
    public static boolean isNumber(String value) {		
      for(int i=0; i < value.length(); i++) {
        int code = Character.codePointAt(value, i);
        if(!(code >= '0' && code <= '9')) return false; // 숫자가 아닌 문자가 있으면 false
      }		
      return true; // 모든 문자가 숫자일 경우 true 반환
    }
  
    // 두 날짜 차이를 반환하는 메소드
    // 매개변수: String 타입의 두 날짜, 날짜 패턴, 구분자(단위)
    public static long getDiffBetweenDates(String stFDate, String stSDate, String pattern, char delim) throws ParseException {
      // 1. 매개변수에 전달된 pattern으로 SimpleDateFormat 객체 생성
      SimpleDateFormat dateFormat = new SimpleDateFormat(pattern);
      // 2. 날짜 형식의 String -> Date : parse()
      Date fDate = dateFormat.parse(stFDate);
      Date sDate = dateFormat.parse(stSDate);
      // 3. 시간차 구하기: getTime()
      long fTime = fDate.getTime();
      long sTime = sDate.getTime();
      long diff = Math.abs(fTime - sTime);
      // 4. 매개변수 delim에 따른 날짜 차이 반환
      switch(Character.toUpperCase(delim)) {
        case 'D': return diff / 1000 / 60 / 60 / 24; // 날짜 차이
        case 'H': return diff / 1000 / 60 / 60; // 시간 차이
        case 'M': return diff / 1000 / 60; // 분 차이
        default: return diff / 1000; // 기본적으로 초 차이
      }
    }
  
    // 문자열을 int[] 배열로 변환
    public static int[] toIntArray(String value) {
      int[] intArray = new int[value.length()];
      for(int i = 0; i < value.length(); i++)
        intArray[i] = (int)value.charAt(i); // 각 문자에 대한 유니코드 값으로 변환
      return intArray;
    }
  
    // 주어진 문자의 초성을 추출하는 메소드
    public static char getInitialConsonant(String value) {
      // 유효한 한글인지 체크
      if(!Pattern.matches("^[가-힣]{2,}$", value.trim())) return '0'; // 한글이 아니면 '0' 반환
      char lastName = value.trim().charAt(0); // 첫 번째 문자 가져오기
      // 초성의 인덱스 계산
      int index = (lastName - '가') / 28 / 21;
      char[] initialConsonant = {'ㄱ','ㄲ','ㄴ','ㄷ','ㄸ','ㄹ','ㅁ','ㅂ','ㅃ','ㅅ','ㅆ','ㅇ','ㅈ','ㅉ','ㅊ','ㅋ','ㅌ','ㅍ','ㅎ'};
      return initialConsonant[index]; // 해당 초성 반환
    }
  
  }

  

AddressApp.java

아래 코드는 주소 관리 애플리케이션의 메인 로직을 구현한 것입니다.

사용자는 메뉴를 선택하여 주소 관련 작업을 수행할 수 있습니다.

메인 메뉴에서는 주소 추가, 삭제, 수정 등의 기능을 제공합니다.

      
      
      
  public class AddressApp {

    public static void main(String[] args) {
        
      // AddressLogic 객체 생성
      AddressLogic logic = new AddressLogic();
      
      while(true) {
          // 1. 메인 메뉴 출력
          logic.printMainMenu();
          
          // 2. 메인 메뉴 번호 입력 받기
          int mainMenu = logic.getMenuNumber();
          
          // 3. 메인 메뉴에 따른 분기
          logic.seperateMainMenu(mainMenu);
      }
    }
  }
      
    

AddressLogic.java

아래 코드는 주소록 관리 상세 기능을 담당합니다.

주소록에 사람을 추가, 수정, 삭제, 검색 및 출력할 수 있으며 사용자에게 기능에 맞는 적절한 메세지를 전달합니다.

      
      
      
  public class AddressLogic {
    //멤버변수
    List<Person> person;
    
    //생성자
    public AddressLogic() {
        person = new Vector<>();
    }

    //멤버 메소드

    // 1.메뉴 출력용 메소드
    public void printMainMenu() {
        System.out.println("====================주소록 메뉴====================");
        System.out.println(" 1.입력 2.출력 3.수정 4.삭제 5.검색 9.종료");
        System.out.println("===============================================");
        System.out.println("메뉴 번호를 입력하세요?");
    }

    //2.메뉴 번호 입력용 메소드
    public int getMenuNumber() {
        Scanner sc = new Scanner(System.in);
        int menu = -1;
        while(true) {
            try {
                String menuStr = sc.nextLine().trim();
                menu = Integer.parseInt(menuStr);
                break;
            } catch(Exception e) {
                System.out.println("숫자만 입력하세요");
            }
        } // while
        return menu;
    }

    // 3.메뉴 번호에 따른 분기용 메소드
    public void seperateMainMenu(int mainMenu) {
        switch(mainMenu) {
            case 1://입력
                setPerson();
                break;
            case 2://출력
                printPersonByInitial();
                break;
            case 3://수정
                updatePerson();
                break;
            case 4://삭제
                deletePerson();
                break;
            case 5://검색
                searchPerson();
                break;
            case 9://종료
                System.out.println("프로그램을 종료합니다");
                System.exit(0);
            default:
                System.out.println("메뉴에 없는 번호입니다");
        } // switch
    }

    public void setPerson() {
        Scanner sc = new Scanner(System.in);
        System.out.println(">>>이름을 입력하세요?");
        String name = sc.nextLine().trim();
        System.out.println(">>>나이를 입력하세요?");
        int age = -1;
        while(true) {
            try {
                age = Integer.parseInt(sc.nextLine().trim());
                break;
            } catch(NumberFormatException e) {
                System.out.println("나이는 숫자로만 입력하세요");
            }
        }
        System.out.println(">>사는곳을 입력하세요");
        String place = sc.nextLine().trim();
        System.out.println(">>>연락처를 입력하세요");
        String PhoneNumber = sc.nextLine().trim();
        person.add(new Person(name, age, place, PhoneNumber));
        System.out.println("입력되었습니다\r\n");
    }

    private void printPersonByInitial() {
        Map<Character, List<Person>> personMap = new HashMap<>();

        // 이름의 초성에 따라 사람을 그룹화
        for (Person p : person) {
            char initialConsonant = CommonUtils.getInitialConsonant(p.name);
            List<Person> group = personMap.getOrDefault(initialConsonant, new ArrayList<>());
            group.add(p);
            personMap.put(initialConsonant, group);
        }

        // 초성별로 그룹화된 사람들을 출력
        boolean isEmpty = true; // 명단이 비어있는지 여부를 확인하기 위한 플래그
        for (char consonant = 'ㄱ'; consonant <= 'ㅎ'; consonant++) {
            List<Person> group = personMap.get(consonant);
            if (group != null && !group.isEmpty()) {
                isEmpty = false; // 비어있지 않은 그룹이 존재하면 플래그를 false로 변경
                System.out.println("[" + consonant + " 으로 시작하는 명단]");
                for (Person p : group) {
                    p.print();
                }
            }
        }

        // 명단이 비어있을 때 메시지 출력
        if (isEmpty) {
            System.out.println("출력할 명단이 없습니다");
        }
    }

    //7.검색용 메소드
    private void searchPerson() {
        Person findPerson = findPersonByName("검색");
        if (findPerson != null) {
            System.out.println(String.format("[%s로 검색한 결과]", findPerson.name));
            findPerson.print();
        }
    }

    public Person findPersonByName(String message) {
        System.out.println(message + "할 사람의 이름을 입력하세요?");
        Scanner sc = new Scanner(System.in);
        String name = sc.nextLine().trim();

        for (Person p : person)
            if (p.name.equals(name))
                return p;
        System.out.println(name + "로(으로) 검색된 정보가 없어요");
        return null;
    }

    //9.수정용 메소드
    private void updatePerson() {
        Person findPerson = findPersonByName("수정");
        if (findPerson != null) {
            Scanner sc = new Scanner(System.in);
            System.out.printf("(현재 나이 %s) 몇 살로 수정하시겠습니까?%n", findPerson.age);
            while(true) {
                try {
                    findPerson.age = Integer.parseInt(sc.nextLine().trim());
                    break;
                } catch(Exception e) {
                    System.out.println("나이는 숫자만 입력하세요");
                }
            } // while
            System.out.printf("(현재 주소 %s) 어느 주소로 수정하시겠습니까?%n", findPerson.place);
            findPerson.place = sc.nextLine().trim();
            System.out.printf("(현재 연락처 %s) 어떤 번호로 수정하시겠습니까?%n", findPerson.PhoneNumber);
            findPerson.PhoneNumber = sc.nextLine().trim();

            System.out.printf("[%s가(이) 아래와 같이 수정되었습니다]%n", findPerson.name);
            findPerson.print(); // 수정 내용을 확인하기 위한 출력
        }
    }

    //10.삭제용
    private void deletePerson() {
        Person findPerson = findPersonByName("삭제");
        if (findPerson != null) {
            for (Person p : person)
                if (findPerson.equals(p)) {
                    person.remove(p);
                    System.out.printf("[%s가(이) 삭제 되었습니다]%n", findPerson.name);
                    break;
                }
        }
    }
}
      
    

Person.java

아래 코드는 사람의 정보를 나타내는 클래스로, 이름, 나이, 거주지, 연락처를 필드로 가집니다.

기본 생성자와 인자 생성자를 제공하며, 사람의 정보를 문자열 형식으로 반환하는 메소드와 출력하는 메소드를 가지고 있습니다.

      
      
      
  public class Person implements Serializable {

    //[필드] 클래스의 속성 정의
    public String name;  // 사람의 이름
    public int age;      // 사람의 나이
    public String place; // 사람의 거주지
    public String PhoneNumber; // 사람의 연락처

    // 기본 생성자 - 필드를 초기화하지 않고 객체를 생성하는 생성자
    public Person() {}

    // 인자 생성자 - 필드를 초기화하는 생성자
    public Person(String name, int age, String place, String PhoneNumber) {        
        this.name = name;  // 이름 초기화
        this.age = age;    // 나이 초기화
        this.place = place;  // 거주지 초기화
        this.PhoneNumber = PhoneNumber;  // 연락처 초기화
    }

    //멤버 메소드
    
    // 1.사람의 정보를 반환하는 메소드
    String get() {
        return String.format("이름:%s, 나이:%d, 사는 곳:%s, 연락처:%s", name, age, place, PhoneNumber);
    }

    // 2.사람의 정보를 출력하는 메소드
    void print() {
        System.out.println(get());  // get() 메소드를 호출하여 출력
    }
  }
      
    

---

4. 실행 결과

입력 / 출력

수정 / 출력

삭제 / 검색