모든 인사이트

기술과 교육 기록

좋은 설계는 변하지 않는 것을 퍼뜨리는 대신 자주 바뀌는 것을 한곳에 숨긴다

데이비드 파나스의 정보 은닉 원칙에 따라 결제 연동·수치 테이블·저장 형식처럼 자주 바뀌는 결정을 모듈 경계 안에 모으고, 변경 시나리오로 그 경계가 실제로 작동하는지 확인하는 방법을 정리한다.

좋은 설계는 변하지 않는 것을 퍼뜨리는 대신 자주 바뀌는 것을 한곳에 숨긴다

소프트웨어 설계를 어렵게 만드는 이유는 지금 필요한 기능만으로는 미래 변경 지점을 완전히 알 수 없기 때문이다. 그래도 한 가지는 분명하다. 어떤 시스템이든 더 자주 바뀌는 결정과 덜 바뀌는 결정이 있다. 좋은 설계는 이 둘을 구분하고, 자주 바뀌는 것을 한곳에 숨기려 한다.

소프트웨어 공학자 데이비드 파나스가 1972년 논문에서 제안한 정보 은닉 원칙도 이 구분에서 출발한다. 모듈을 처리 단계별로 나누기보다, 바뀔 가능성이 있는 설계 결정을 하나씩 감추는 경계로 나누자는 생각이다.

변동성은 기능보다 결정에 붙어 있다

예를 들어 결제 시스템을 생각해 보면, 결제라는 기능 자체보다 외부 전자결제대행사(PG) 연동 방식, 실패 재시도 규칙, 정산 형식 같은 것이 더 자주 바뀔 수 있다. 게임에서도 전투 시스템보다 수치 테이블, 입력 장치, 렌더링 백엔드, 저장 포맷이 더 자주 바뀌는 경우가 많다.

이런 결정을 여러 모듈에 흩뿌리면 변경은 곧 연쇄 수정이 된다. 반대로 경계 안에 숨겨 두면 변경 영향은 줄어든다.

리팩터링이 중요한 이유도 결국 변동성 때문이다

소프트웨어 설계 저자 마틴 파울러는 리팩터링을 동작을 유지한 채 구조를 바꾸는 작업으로 설명한다. 다음 변경을 더 안전하게 만들기 위한 작업이다. 그래서 리팩터링이 가장 힘을 발휘하는 순간도 자주 바뀌는 것이 퍼져 있는 걸 발견했을 때다.

좋은 리팩터링은 대개 이런 방향으로 간다.

  • 중복된 변경 지점을 한곳으로 모은다
  • 경계 밖에서 내부 세부를 몰라도 되게 만든다
  • 인터페이스에는 덜 바뀌는 약속만 남긴다

변경 시나리오로 경계가 실제로 작동하는지 확인하기

파나스의 모듈 분해 논문은 처리 순서를 나누는 방식과 내부 설계 결정을 숨기는 방식을 비교한다. 함수나 파일이 많이 생겼다는 사실만으로 변경의 영향이 줄었다고 판단할 수는 없다.

다음은 저장 기능을 대상으로 만든 자체 설계 점검 예시다.

바뀔 수 있는 결정 경계 안에 둘 내용 밖에 남길 약속 확인할 변경 실험
저장 파일 형식 필드 이름, 직렬화, 버전 변환 게임 상태를 저장·복원하는 요청과 결과 형식을 바꿔도 플레이 화면을 수정하지 않는가
저장 위치 경로와 파일 접근 같은 저장·복원 요청 위치 변경이 전투 규칙까지 번지지 않는가
실패 처리 접근 실패의 분류 호출자가 판단할 수 있는 오류 종류 화면이 내부 예외 문자열을 해석하지 않는가

여기서 저장 결과와 오류는 외부 약속이므로 문서와 검증이 필요하다. 내부 구현을 숨긴다는 이유로 실패까지 감춰서는 안 된다. 기존 저장 자료를 읽는 호환성 확인도 별도 과제다.

반대로 저장 위치가 바뀔 근거가 전혀 없는데 모든 저장 기술을 지원하는 거대한 구조부터 만들 필요도 없다. 최근 변경 이력이나 확정된 다음 요구를 하나 골라, 어느 파일을 고쳐야 하는지 먼저 확인한다. 변경이 같은 곳에 반복해서 퍼질 때 경계를 조정하면 추상화의 이유를 설명하기 쉽다.

파울러의 컬렉션 캡슐화 설명도 경계 점검에 도움이 된다. 내부 목록을 그대로 내주면 외부 코드가 정해진 변경 절차를 우회할 수 있다. 예를 들어 인벤토리의 보관 순서를 바꾸려는데 화면들이 내부 배열을 직접 고치고 있다면, 조회 결과와 변경 요청의 책임부터 분리할 수 있다. 다만 읽기 전용 목록이라고 해서 그 안의 객체까지 모두 불변이 되는 것은 아니므로, 반환값이 허용하는 수정 범위를 확인해야 한다.

참고 자료

모든 인사이트로 돌아가기