모듈화Modularity
시스템을 인터페이스로만 이어지는 모듈로 나누어, 바뀔 가능성이 큰 설계 결정 하나를 모듈 하나 안에 감추고 한 모듈의 변경이 다른 모듈로 번지지 않게 하는 설계 원리다.
1요약
- 모듈화는 ISO/IEC 25010:2023 이 유지보수성의 하위 특성으로 두는 모듈성을 설계에서 만드는 일로, 그 위에서 팀별 분업 · 모듈 단위 시험 · Java 9 모듈 시스템(JEP 261) 같은 언어 수준의 공개 · 차단이 돈다.
- 나누는 기준이 틀리면 모듈이 많아도 변경이 번진다 — Mozilla 는 1998년 재설계로 파일 하나를 고칠 때 영향받을 수 있는 파일 비율인 전파 비용을 17.35% 에서 2.78% 로 낮췄다(MacCormack 외 2006 표 2).
- 「작은 수정이 여러 모듈로 번진다」는 번진 변경이 인터페이스를 넘었는가로 가른다 — 바뀐 결정이 인터페이스에 드러나 있었으면 은닉 실패, 인터페이스는 그대로인데 의존하는 모듈이 많아 시험이 넓게 깨지면 팬인 과다, 한 모듈 안에서 서로 다른 결정이 함께 바뀌면 낮은 응집이다.
2등장 배경
1960년대 말 어셈블러와 분리 컴파일로 모듈을 따로 짜고 갈아 끼울 수는 있었지만, 큰 시스템의 수정 비용은 줄지 않았다. 모듈이 처리 단계마다 나뉘어 있어 메모리 속 표의 형식 하나를 바꾸면 그 표를 읽는 모든 모듈을 다시 짜야 했기 때문이다.
1971년 8월 Parnas 는 카네기멜런 대학 기술 보고서(CMU-CS-71-101)에서, 1972년 12월 CACM 논문에서 같은 KWIC 색인 시스템을 두 가지로 나눠 견주고 정보 은닉을 분해 기준으로 내놓았다. 순서도 기준은 5,000 ~ 10,000 명령어 규모까지는 쓸 만했지만 그보다 큰 시스템에는 모자라다는 것이 그의 판단이었다(Parnas 1971 17쪽). 같은 시기 Stevens · Myers · Constantine(1974)은 모듈 사이 · 안의 연결 세기를 결합도 · 응집도로 이름 붙였다.
1994년 Martin 은 패키지 사이 의존을 셈하는 불안정도 지표를, 2006년 MacCormack 등은 의존 행렬로 시스템 전체의 전파 비용을 재는 방법을 냈다. 2017년 Java 9 는 공개할 패키지만 exports 로 내놓는 모듈 시스템을 언어에 넣었고, ISO/IEC 25010 은 2011년 판에 이어 2023년 판에서도 모듈성을 유지보수성의 하위 특성으로 둔다.
3쉽게 이해하기 — 주문대만 보이는 푸드코트
푸드코트에 국수 · 김밥 · 튀김 가게가 나란히 있다. 손님은 주문대 메뉴판의 이름과 가격만 보고 주문하고, 주방 안 레시피와 화구는 보지 못한다. 그래서 김밥 가게가 화구를 바꿔도 손님과 이웃 가게는 아무것도 고칠 일이 없다. 그런데 세 가게가 공용 냉장고 하나를 칸 배치까지 맞춰 쓰고 있어서, 냉장고 칸을 바꾸는 날에는 세 가게가 모두 일을 멈추고 손을 본다.
그림 1 · 손님은 주문대만 보고 주문하므로 가게 안 화구를 바꿔도 아무도 모르지만, 세 가게가 함께 아는 냉장고 칸 배치를 바꾸면 세 가게가 모두 고친다.
그림 2 · 창구 위에 걸린 것은 약속이라 바꾸면 손님이 따라 바뀌고, 창구 아래는 가게 사정이라 마음대로 바꾼다 — 실제 모듈도 함수 이름 · 인자만 내놓고 저장 방식을 감춘다.
| 비유 속 역할 | 실제 이름 | 실제로 하는 일 |
|---|---|---|
| 가게 하나 | 모듈 | 한 팀이 맡아 따로 만들고 고치는 작업 배정 단위다 |
| 메뉴판 · 주문대 | 인터페이스 | 함수 이름 · 인자 · 오류 약속처럼 밖에서 기대해도 되는 것만 내놓는다 |
| 주방 안 레시피 · 화구 | 감춘 설계 결정(비밀) | 자료 구조 · 알고리즘 · 저장 형식처럼 바뀌기 쉬운 결정을 모듈 안에 둔다 |
| 손님 | 호출하는 모듈 | 인터페이스만 써서 다른 모듈의 기능을 얻는다 |
| 많은 손님이 찾는 가게 | 팬인 | 이 모듈을 쓰는 모듈 수 — 많을수록 인터페이스를 바꾸기 어렵다 |
| 공용 냉장고 칸 배치 | 공유 자료 형식(공통 결합) | 여러 모듈이 같은 자료 형식을 직접 읽고 써서 형식 변경이 모두에게 번진다 |
| 화구 교체 | 감춘 결정의 변경 | 인터페이스가 그대로면 그 모듈 하나만 고치고 다시 시험한다 |
⚠ 비유가 맞지 않는 곳: 가게는 메뉴가 달라 나뉘지만, 실제 모듈은 «하는 일»이 아니라 «감추는 설계 결정»으로 나뉜다(Parnas 1972). 그래서 줄 저장 모듈처럼 거의 모든 처리 단계에서 불리는 모듈도 생긴다.
4구조 — 인터페이스 · 비밀 · 의존
모듈 하나는 밖에 내놓는 인터페이스와 그 뒤에 감춘 비밀로 이루어지고, 모듈 사이는 «쓴다(uses)» 관계의 화살로 이어진다(Parnas 1971 22쪽). 결합의 세기는 화살 수보다 화살이 무엇을 싣는가 — 함수 이름 · 인자인가, 표 형식 그 자체인가 — 로 정해진다.
그림 3 · 모듈은 인터페이스 띠로만 바깥과 이어지고, 들어오는 화살 수가 팬인 · 나가는 화살 수가 팬아웃이며, 비밀은 띠 아래에 있어 바뀌어도 화살을 타고 번지지 않는다.
| 요소 | 무엇 | 역할 | 값 · 근거 |
|---|---|---|---|
| 모듈 | 작업 배정 단위 | 한 팀이 따로 만들고 고침 | 서브루틴 단위가 아님(Parnas 1971 2쪽) |
| 인터페이스 | 밖에 내놓는 약속 | 다른 모듈이 기대해도 되는 것만 공개 | 함수 이름 · 인자 수와 형(Parnas 1971 16쪽) · Java 는 exports 한 패키지만(JEP 261) |
| 비밀 | 감춘 설계 결정 | 바뀌기 쉬운 결정 하나를 가둠 | 저장 형식 · 알고리즘 · 처리 시점(Parnas 1972) |
| 결합도 | 모듈 사이 연결 세기 | 변경이 화살을 타고 넘는가 | 자료 결합(약함) ~ 내용 결합(강함)(Stevens 외 1974) |
| 응집도 | 모듈 안 요소의 관련 세기 | 한 모듈 = 한 결정인가 | 우연적(약함) ~ 기능적(강함)(Stevens 외 1974) |
| 팬인 · 팬아웃 | 들어오는 · 나가는 의존 수 | 변경 영향 · 복잡도의 측정 값 | 정보 흐름 지표의 바탕(Henry · Kafura 1981) |
| 불안정도 I | Ce ÷ (Ca + Ce) | 모듈이 바뀌기 쉬운 정도 | 0 = 가장 안정 · 1 = 가장 불안정(Martin 1994) |
| 전파 비용 | 가시성 행렬 밀도 | 한 요소 변경이 닿을 수 있는 비율 | 의존 행렬 거듭제곱 합 · 자기 자신 포함(MacCormack 외 2006) |
모듈 크기에는 줄 수 기준이 없다. Parnas 의 기준은 «한 사람이 충분히 이해하고 잘 짤 만큼 작게»이고, 크기보다 «감춘 결정이 하나인가»를 먼저 본다.
5동작 — KWIC 색인을 두 가지로 나눠 저장 방식을 바꾸는 사례
Parnas(1971 · 1972)의 KWIC 색인 시스템이다. 줄 여러 개를 받아 각 줄의 첫 단어를 끝으로 옮기는 순환 이동을 모두 만들고, 그 전부를 알파벳 순으로 찍는다. 그는 숙련 프로그래머가 1 ~ 2주에 만들 규모라고 적었다. 의존 화살 수와 전파 비용은 원문의 모듈 설명으로 의존 관계를 그린 뒤 MacCormack 외(2006)의 식으로 직접 계산한 값이다.
- 바뀔 가능성이 큰 설계 결정 다섯을 먼저 적는다 — 입력 형식 · 모든 줄을 메모리에 둠 · 한 워드에 네 글자씩 묶음 · 순환 이동을 저장하지 않고 색인으로 둠 · 한 번에 다 정렬함(Parnas 1971 14 ~ 15쪽).
- 분해 1(처리 단계 기준)은 입력 · 순환 이동 · 정렬 · 출력 · 주 제어 다섯 모듈이고, 모듈 사이 인터페이스는 메모리 속 배열 형식(네 글자 묶음 · 줄 시작 주소 색인 · 「원래 줄 번호, 시작 주소」 쌍)이다.
- 분해 2(정보 은닉 기준)는 줄 저장 · 입력 · 순환 이동기 · 정렬기 · 출력 · 주 제어 여섯 모듈이고, 인터페이스는
WORD(l,w,c)·CSWORD·ITH(i)같은 함수 이름과 인자다. - 의존 그래프를 그린다 — 분해 1 은 화살 9개로 입력 모듈의 배열을 네 모듈이 읽어 팬인 4, 분해 2 는 화살 8개로 순환 이동기의 팬인이 3 · 줄 저장의 팬인이 2 이고, 두 분해 모두 주 제어의 팬아웃이 4 다.
- 「모든 줄을 메모리에 둔다」를 「줄 일부를 디스크에 둔다」로 바꾼다 — 분해 1 은 배열 형식을 모든 모듈이 쓰므로 다섯 모듈을 고치고, 분해 2 는 저장 방식을 아는 줄 저장 모듈 하나만 고친다(Parnas 1971 15쪽).
- 다섯 결정을 모두 바꿔 본다 — 고칠 모듈 수의 합은 분해 1 이 1 + 5 + 5 + 3 + 2 = 16, 분해 2 가 결정마다 1개씩 5 다.
- 전파 비용을 잰다 — 가시성 행렬에서 닿는 셀이 분해 1 은 셀 25개 중 15개(60%), 분해 2 는 셀 36개 중 17개(47%)로 차이가 작다. 분해 2 는 줄 저장 모듈에 다섯 모듈이 직간접으로 기대지만, 함수 이름 · 인자가 그대로면 저장 방식 변경은 그 화살을 타고 넘지 않는다.
- 인터페이스를 다시 검토한다 — 순환 이동기 정의가 이동 결과의 «순서»까지 내놓아, 알파벳 순으로 만들어 정렬을 생략하는 구현을 막았다. Parnas 는 이를 설계 오류로 분류했다(Parnas 1971 17 ~ 18쪽).
그림 4 · 같은 KWIC 시스템이 분해 1 에서는 배열 형식을 함께 알아 저장 방식 변경이 다섯 모듈을 고치게 하고, 분해 2 에서는 줄 저장 모듈 하나에서 멈춘다.
그림 5 · 결정마다 고칠 모듈을 칠하면 분해 1 은 다섯 결정에 셀 16개, 분해 2 는 셀 5개다 — 정보 은닉은 결정 하나를 모듈 하나에 가두어 행마다 셀 하나만 남긴다.
🔑 의존 화살의 수가 아니라 화살이 싣는 것이 변경 반경을 정한다 — 줄 저장 모듈은 다섯 모듈이 기대는데도 저장 방식 변경을 혼자 받는다.
6비교 — 처리 단계 기준과 정보 은닉 기준
| 기준 | 처리 단계 기준(분해 1) | 정보 은닉 기준(분해 2) |
|---|---|---|
| 나누는 축 | 순서도의 큰 단계 하나 = 모듈 하나 | 바뀌기 쉬운 결정 하나 = 모듈 하나 |
| 인터페이스 내용 | 표 형식 · 포인터 규약 — 팀이 함께 설계 | 함수 이름 · 인자 수와 형 — 일찍 확정(Parnas 1971 16쪽) |
| 결정 다섯 변경 시 고칠 모듈 | 16개 | 5개 |
| 한 모듈 이해에 필요한 것 | 출력 모듈을 알려면 정렬 · 순환 이동 · 입력도 알아야 함 | 모듈 하나씩 읽어 이해 |
| 실행 효율 | 모듈 사이 제어 이동이 드묾 | 함수 호출이 잦아 느려질 수 있음 — 인라인 등 구현 기법으로 메움(Parnas 1971 18쪽) |
| 계층 구조 | 가질 수 있음 | 가질 수 있음 — 계층과 깨끗한 분해는 서로 독립인 성질(Parnas 1971 23쪽) |
분석요구가 굳어 있고 실행 속도가 앞서는 작은 프로그램은 처리 단계 기준도 되지만, 여러 팀이 오래 고칠 시스템은 정보 은닉 기준이 맞다. 근거는 표의 「결정 다섯 변경 시 고칠 모듈」 행 — 같은 알고리즘이라도 나누는 축만으로 수정 범위가 16 대 5 로 갈린다.
언어 수준의 모듈 시스템(Java module-info.java 의 requires · exports · JEP 261)은 공개하지 않은 패키지를 컴파일 · 실행 때 막아 정보 은닉을 강제하는 도구다 — 무엇을 감출지는 여전히 설계가 정한다.
7실무 진단 — 변경이 번지는 원인 가르기
분석저장소의 변경 이력으로 «함께 바뀌는 모듈»을 먼저 셈하고, 그다음 의존 그래프를 본다. 의존 그래프는 번질 수 있는 상한(전파 비용)만 보여 주고, 실제로 번졌는지는 함께 바뀐 이력이 보여 주기 때문이다(MacCormack 외 2006 · 사례 7단계).
| # | 증상 | 의심 원인 | 구분 | 확인 자료 | 판정 기준(근거) |
|---|---|---|---|---|---|
| 1 | 기능 하나 고치는 커밋마다 여러 모듈 파일이 함께 바뀜 | 감춘 결정이 인터페이스(공유 형식)에 드러남 | 정보 은닉 | git log --name-only 로 같은 커밋에 함께 바뀐 모듈 쌍 셈 | 결정 하나 변경 = 모듈 하나가 목표(Parnas 1972) |
| 2 | 한 모듈을 고치면 다른 모듈의 시험이 넓게 깨짐 | 많이 의존되는 모듈이 자주 바뀜 | 팬인 · 안정도 | jdeps -summary 로 들어오는 의존 수(Ca) 셈 | I = Ce ÷ (Ca + Ce) 가 0 에 가까운 모듈은 바꾸지 않는 쪽으로 설계(Martin 1994) |
| 3 | 모듈을 따로 빌드 · 배포하지 못함 | 순환 의존 | 계층 구조 | jdeps --check <모듈> · 모듈 해석 오류 | 순환 requires 는 ResolutionException(Java SE 21 Configuration) · uses 관계는 부분 순서여야 함(Parnas 1971 22쪽) |
| 4 | 릴리스마다 고칠 때 손대는 파일 수가 늘어남 | 의존이 쌓여 결합이 강해짐 | 측정 | 파일 의존 행렬의 전파 비용 추세 | 직전 판보다 오르면 재설계 신호 — Mozilla 17.35% → 2.78%(MacCormack 외 2006 표 2) |
가려내는 순서는 변경 이력 → 들어오는 의존 → 순환 → 전파 비용 추세다. 함께 바뀐 모듈 쌍이 특정 공유 형식에 몰려 있으면 그 형식을 맡을 모듈 하나를 새로 세워 인터페이스 뒤로 옮기는 것이 첫 조치다. Go 는 go mod graph, Maven 은 mvn dependency:tree 가 같은 의존 목록을 낸다.
8시험 대비
www.q-net.or.kr시험에서는 모듈화의 개념과 결합도 · 응집도 · 정보 은닉을 묻는 정의 · 특징형, 분해 기준과 측정 지표로 좋은 모듈 구조를 설명하는 구조 · 구성형이 나올 수 있다. 단계별 세부는 하위 토픽 결합도 · 응집도가 맡고, 모듈화에서는 «변경 영향을 무엇으로 줄이고 무엇으로 재는가»를 축으로 쓴다.
- 개요 — 정의 · ISO/IEC 25010:2023 유지보수성의 하위 특성 모듈성 · 목적 셋(분업 · 변경 유연성 · 이해)
- 구성 요소 — 그림 3 구조(인터페이스 · 비밀 · 팬인 · 팬아웃) + 요소 표
- 분해 기준 — 그림 4 KWIC 두 분해 · 처리 단계 기준과 정보 은닉 기준 비교표
- 정보 은닉의 효과 — 그림 5 결정 × 모듈 행렬(16 ↔ 5) · 감춘 결정이 새는 사례(순환 이동기의 순서)
- 측정 — 결합도 · 응집도 단계 이름 · 팬인 · 팬아웃 · 불안정도 I = Ce ÷ (Ca + Ce) · 전파 비용(Mozilla 17.35% → 2.78%)
- 적용 · 한계 — 언어 모듈 시스템(JEP 261) · 호출 비용 · 모듈 크기보다 결정 수
꼭 쓸 키워드
정보 은닉인터페이스설계 결정결합도응집도팬인팬아웃불안정도의존 행렬전파 비용
다른 답안과 차이를 내는 한 가지 — 결합도 · 응집도 단계표만 쓰지 않고, 같은 시스템의 두 분해에서 «결정 하나를 바꿀 때 고칠 모듈 수»를 행렬로 그려 정보 은닉을 수치로 보인다.
9오해와 사실
- 오해모듈을 작게 많이 나눌수록 모듈화가 잘된 것이다.사실KWIC 분해 1 도 작은 모듈 다섯이었지만 저장 방식 변경 하나가 다섯 모듈을 모두 고치게 했다 — 개수가 아니라 나누는 기준이 수정 범위를 정한다(Parnas 1971 15쪽).
- 오해정보 은닉은 필드를 private 으로 두는 것이다.사실감추는 대상은 설계 결정이며, 접근 제한을 걸어도 인터페이스가 내부 순서 · 형식을 약속하면 그 결정은 새어 나간다(Parnas 1971 17 ~ 18쪽 순환 이동기 사례).
- 오해의존 화살이 적으면 변경이 덜 번진다.사실KWIC 분해 2 의 전파 비용은 47% 로 분해 1 의 60% 와 큰 차이가 없지만, 고칠 모듈 합은 5 대 16 이다 — 화살이 싣는 내용이 반경을 정한다.
10핵심 정리
| 개념 | 묻는 질문 | 재는 값 · 단위 | 좋은 방향 | 근거 |
|---|---|---|---|---|
| 정보 은닉 | 바뀔 결정이 모듈 하나 안에 있는가 | 결정 하나당 고칠 모듈 수 | 1 | Parnas 1972 |
| 인터페이스 | 밖에 무엇을 약속하는가 | 공개 함수 · 패키지 | 필요한 것만 | Parnas 1971 · JEP 261 |
| 결합도 | 모듈 사이에 무엇이 오가는가 | 자료 ~ 내용 결합 단계 | 약하게 · 자료 결합 | Stevens 외 1974 |
| 응집도 | 모듈 안 요소가 한 목적인가 | 우연적 ~ 기능적 단계 | 강하게 · 기능적 | Stevens 외 1974 |
| 팬인 · 팬아웃 | 몇 모듈이 쓰고 몇 모듈을 쓰는가 | 들어오는 · 나가는 의존 수 | 팬인 큰 모듈은 안정되게 | Henry · Kafura 1981 |
| 불안정도 | 바뀌기 쉬운 모듈인가 | I = Ce ÷ (Ca + Ce) · 0 ~ 1 | 안정한 쪽에 의존 | Martin 1994 |
| 전파 비용 | 한 변경이 얼마나 닿을 수 있는가 | 가시성 행렬 밀도(%) | 낮게 · 추세 감시 | MacCormack 외 2006 |
| 모듈성 | 변경이 한 구성 요소에 머무는가 | 유지보수성 하위 특성 | 높게 | ISO/IEC 25010:2023 |
11참고 문헌
- 먼저 볼 문헌
- ★ On the Criteria To Be Used in Decomposing Systems into Modules · Communications of the ACM 15(12) pp.1053-1058 — 처리 단계로 나눈 분해와 정보 은닉으로 나눈 분해를 KWIC 사례로 견줄 때
- ★ Exploring the Structure of Complex Software Designs: An Empirical Study of Open Source and Proprietary Code · Management Science 52(7) — 의존 행렬 · 가시성 행렬로 전파 비용을 재는 방법과 Mozilla 재설계 수치를 볼 때
- ★ OO Design Quality Metrics - An Analysis of Dependencies — 들어오는 결합 · 나가는 결합 · 불안정도 I 의 정의를 볼 때
- ★ ISO/IEC 25010:2023 Systems and software engineering - Systems and software Quality Requirements and Evaluation (SQuaRE) - Product quality model — 유지보수성의 하위 특성으로서 모듈성의 정의를 볼 때
- 본문 근거
- On the criteria to be used in decomposing systems into modules (Technical Report CMU-CS-71-101) — Carnegie Mellon University · 1971-08 ·
prl.khoury.northeastern.edu/img/p-tr-1971.pdf· 확인 2026-11-04 - Software Structure Metrics Based on Information Flow · IEEE Transactions on Software Engineering SE-7(5) pp.510-518 — S. Henry · D. Kafura · 1981-09 ·
doi.org/10.1109/TSE.1981.231113· 확인 2026-11-04 - Structured design · IBM Systems Journal 13(2) pp.115-139 — W. P. Stevens · G. J. Myers · L. L. Constantine · 1974-05 ·
doi.org/10.1147/sj.132.0115· 확인 2026-11-04 - JEP 261: Module System — OpenJDK · 2017-09 ·
openjdk.org/jeps/261· 확인 2026-11-04 - java.lang.module.Configuration (Java SE 21 API) — Oracle · 2026-11 ·
docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/module/Configuration.html· 확인 2026-11-04 - jdeps - Java class dependency analyzer (Java SE 21 Tool Specifications) — Oracle · 2026-11 ·
docs.oracle.com/en/java/javase/21/docs/specs/man/jdeps.html· 확인 2026-11-04 - git-log Documentation — Git Project · 2026-11 ·
git-scm.com/docs/git-log· 확인 2026-11-04