[PYTHON] 객체 지향 프로그래밍의 완성, Property 데코레이터로 Getter/Setter 구현하는 3가지 방법과 유지 보수 문제 해결

Property 데코레이터

 

파이썬으로 협업 프로젝트를 진행하거나 대규모 시스템을 설계할 때, 객체의 상태를 안전하게 관리하는 것은 매우 중요합니다. 자바(Java)나 C++ 같은 언어에 익숙한 개발자들은 get_value(), set_value()와 같은 메서드를 명시적으로 만드는 것에 익숙하지만, 파이썬은 더욱 우아하고 파이썬스러운(Pythonic) 방식인 @property 데코레이터를 제공합니다.

본 포스팅에서는 단순한 문법 설명을 넘어, 왜 실무에서 직접적인 멤버 변수 접근보다 @property를 선호하는지, 그리고 이를 통해 기존 코드의 하위 호환성을 깨지 않고 로직을 추가하는 실전 전략을 심층적으로 다룹니다.

---

1. 데이터 캡슐화와 파이썬의 철학

파이썬은 기본적으로 모든 멤버 변수가 공개(Public)되어 있습니다. 하지만 내부 로직을 보호하고 입력 데이터의 유효성을 검증하기 위해서는 '캡슐화'가 필수적입니다. @property는 사용자에게는 일반 변수처럼 보이지만, 내부적으로는 메서드를 실행시켜 데이터를 가공하거나 검증할 수 있게 해줍니다.

기존 Getter/Setter 방식 vs @property 방식 차이

항목	전통적인 메서드 방식 (Java 스타일)	Python @property 데코레이터 방식
호출 방식	obj.get_age() / obj.set_age(20)	obj.age / obj.age = 20
가독성	메서드 호출이 빈번하여 코드가 복잡해짐	속성 접근처럼 보여 직관적이고 깔끔함
유지보수	변수를 메서드로 바꿀 때 기존 호출 코드를 다 수정해야 함	필드 접근 방식 그대로 유지하면서 로직만 추가 가능
유효성 검사	Setter 메서드 내부에서 수행	Setter 데코레이터 내부에서 수행

---

2. @property 데코레이터 구현 방법 (Sample Example)

실제 온라인 쇼핑몰의 상품 가격 관리 클래스를 예로 들어보겠습니다. 가격은 절대 0보다 작을 수 없다는 제약 조건을 @property를 통해 해결하는 방법입니다.

class Product:
    def __init__(self, name, price):
        self.name = name
        # 내부 변수는 관례적으로 _를 붙여 private임을 표시합니다.
        self._price = price

    @property
    def price(self):
        """Getter: 가격을 조회할 때 호출됩니다."""
        print(f"{self.name}의 가격을 조회합니다.")
        return f"{self._price:,}원"

    @price.setter
    def price(self, value):
        """Setter: 가격을 설정할 때 유효성을 검증합니다."""
        if value < 0:
            raise ValueError("가격은 0원보다 작을 수 없습니다.")
        print(f"가격을 {value}로 변경합니다.")
        self._price = value

# 실행 예시
p1 = Product("노트북", 1500000)

# Getter 호출 (괄호 없이 속성처럼 사용)
print(p1.price) 

# Setter 호출 (값을 할당하듯 사용)
p1.price = 1200000
print(p1.price)

# 유효성 검사 작동
try:
    p1.price = -500
except ValueError as e:
    print(f"에러 발생: {e}")

---

3. Property 사용 시 얻을 수 있는 3가지 핵심 이점

첫째, 하위 호환성 유지 (Uniform Access Principle)

처음에는 단순하게 self.price로 설계했던 코드가 나중에 "가격 변경 시 로그를 남겨야 한다"는 요구사항을 받게 되었을 때, @property를 사용하면 해당 클래스를 사용하는 외부 코드(클라이언트 코드)를 단 한 줄도 수정하지 않고도 내부 로직을 확장할 수 있습니다.

둘째, 읽기 전용(Read-Only) 속성 구현

@setter를 정의하지 않고 @property만 작성하면 해당 속성은 외부에서 수정할 수 없는 읽기 전용 상태가 됩니다. 이는 객체의 불변성을 보장하고 예상치 못한 버그를 방지하는 데 효과적입니다.

셋째, 계산된 속성(Computed Attributes)의 효율적 관리

DB에 저장된 생년월일을 바탕으로 현재 나이를 계산해야 할 때, 매번 메서드를 호출하는 대신 속성으로 접근하게 함으로써 데이터의 성격에 맞는 직관적인 API를 제공할 수 있습니다.

---

4. 결론: 언제 @property를 사용해야 할까?

단순히 값을 저장하고 불러오는 경우에는 일반 속성을 사용해도 무방합니다. 하지만 1) 값에 대한 검증이 필요할 때, 2) 내부 데이터를 가공해서 보여줘야 할 때, 3) 기존 코드의 인터페이스를 유지하며 기능을 확장해야 할 때 @property는 파이썬 개발자에게 가장 강력한 무기가 됩니다. 전문적인 코드는 단순히 돌아가는 코드가 아니라, 변화에 유연하게 대응할 수 있는 코드입니다. 오늘부터 여러분의 프로젝트에 @property를 적극 활용해 보시기 바랍니다.

---

내용 출처 및 참고 문헌

• Python Software Foundation. "Built-in Functions: property". (docs.python.org)
• Luciano Ramalho. "Fluent Python: Clear, Concise, and Effective Programming". O'Reilly Media.
• Brett Slatkin. "Effective Python: 90 Specific Ways to Write Better Python". Pearson Education.