Decorator คืออะไร และคุณเขียนมันอย่างไร

Question

Accepted Answer

A **decorator** คือฟังก์ชันที่ **ห่อหุ้มฟังก์ชันอื่น** เพื่อเพิ่มพฤติกรรม โดยไม่เปลี่ยนแปลงโค้ดดั้งเดิม มันถูกนำไปใช้กับไวยากรณ์ `@decorator` เหนือฟังก์ชัน — วิธีที่สะอาดในการเพิ่มความกังวลข้ามตัด เช่น การบันทึก การกำหนดเวลา การแคช หรือการควบคุมการเข้าถึง

## Decorator ทำงานอย่างไร

```python
def my_decorator(func):
    def wrapper(*args, **kwargs):       # wraps the original function
        print("before")
        result = func(*args, **kwargs)  # call the original
        print("after")
        return result
    return wrapper                       # return the wrapped version

@my_decorator
def greet(name):
    print(f"Hello {name}")

greet("Ann")
# Output: before / Hello Ann / after
```

ไวยากรณ์ `@my_decorator` คือน้ำตาลสำหรับ `greet = my_decorator(greet)` — มันแทนที่ `greet` ด้วย `wrapper` ซึ่งเรียกใช้โค้ดเพิ่มเติมรอบการเรียกดั้งเดิม `*args, **kwargs` ทำให้ wrapper ทำงานสำหรับลายเซ็นฟังก์ชันใด ๆ

## ตัวอย่างเชิงปฏิบัติ: การกำหนดเวลา

```python
import time, functools

def timed(func):
    @functools.wraps(func)        # preserves func's name/docstring (important!)
    def wrapper(*args, **kwargs):
        start = time.perf_counter()
        result = func(*args, **kwargs)
        print(f"{func.__name__} took {time.perf_counter() - start:.3f}s")
        return result
    return wrapper

@timed
def slow_task():
    time.sleep(1)
```

`@functools.wraps(func)` มีความสำคัญ — หากไม่มี ฟังก์ชันที่ห่อหุ้มจะสูญเสียชื่อและ docstring ดั้งเดิม

## Decorator ที่มีอาร์กิวเมนต์

```python
def repeat(times):               # outer takes the decorator's argument
    def decorator(func):
        @functools.wraps(func)
        def wrapper(*args, **kwargs):
            for _ in range(times):
                func(*args, **kwargs)
        return wrapper
    return decorator

@repeat(times=3)
def hello(): print("hi")  # prints "hi" three times
```

Decorator ที่มีพารามิเตอร์ต้องการชั้นเพิ่มเติม (ฟังก์ชันที่คืน decorator)

## Decorator ที่มีอยู่ในตัว / ไลบรารี่ทั่วไป

```text
@property            → turn a method into a computed attribute
@staticmethod / @classmethod → method types
@functools.lru_cache → memoize results
@app.route("/")      → web framework routing (Flask)
@pytest.fixture      → test fixtures
```

## ทำไมมันถึงสำคัญ

Decorator เป็นคุณลักษณะที่มีประสิทธิภาพ แตกต่างกัน-Python สำหรับ **การเพิ่มพฤติกรรมที่สามารถนำกลับมาใช้ใหม่ได้** (การบันทึก การกำหนดเวลา การแคช การตรวจสอบสิทธิ์ การตรวจสอบความถูกต้อง การกำหนดเส้นทาง) ไปยังฟังก์ชันอย่างสะอาดและประกาศ — การแยกความกังวลข้ามตัดออกจากตรรกะหลัก

พวกเขาอยู่ทั่วไป Python จริง: เฟรมเวิร์กเว็บ (`@app.route`), แคช (`@lru_cache`), คลาส (`@property`) และการทดสอบ

การเข้าใจวิธีเขียนมัน (ฟังก์ชัน wrapper `*args/**kwargs` `functools.wraps`) และรูปแบบที่มีพารามิเตอร์ช่วยให้คุณทั้งใช้ decorator ของอีโคซิสเต็มอย่างถูกต้องและสร้างนามธรรมที่สามารถนำกลับมาใช้ใหม่ของคุณเอง