TypeScript의 데코레이터 이해: 첫 번째 원칙 접근 방식

TypeScript의 데코레이터는 클래스, 메서드, 속성 및 매개변수의 동작을 수정하기 위한 강력한 메커니즘을 제공합니다. 현대적인 편리함처럼 보일 수도 있지만 데코레이터는 객체 지향 프로그래밍에서 발견되는 잘 확립된 데코레이터 패턴에 뿌리를 두고 있습니다. 데코레이터를 사용하면 로깅, 유효성 검사, 액세스 제어 등의 일반적인 기능을 추상화하여 개발자가 더 깔끔하고 유지 관리하기 쉬운 코드를 작성할 수 있습니다.

이 기사에서는 데코레이터를 첫 번째 원칙부터 살펴보고, 핵심 기능을 분석하고, 처음부터 구현해 보겠습니다. 그 과정에서 일상적인 TypeScript 개발에서 데코레이터의 유용성을 보여주는 몇 가지 실제 애플리케이션을 살펴보겠습니다.

데코레이터란 무엇입니까?

TypeScript에서 데코레이터는 단순히 클래스, 메서드, 속성 또는 매개변수에 연결할 수 있는 함수입니다. 이 함수는 디자인 타임에 실행되므로 코드가 실행되기 전에 코드의 동작이나 구조를 변경할 수 있습니다. 데코레이터를 사용하면 메타 프로그래밍이 가능하므로 원래 논리를 수정하지 않고도 추가 기능을 추가할 수 있습니다.

메서드가 호출될 때 기록하는 메소드 데코레이터의 간단한 예부터 시작해 보겠습니다.

function log(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
  const originalMethod = descriptor.value;

  descriptor.value = function (...args: any[]) {
    console.log(`Calling ${propertyKey} with arguments: ${args}`);
    return originalMethod.apply(this, args);
  };

  return descriptor;
}

class Example {
  @log
  greet(name: string) {
    return `Hello, ${name}`;
  }
}

const example = new Example();
example.greet('John');

여기서 로그 데코레이터는 Greeting 메소드를 래핑하여 실행하기 전에 해당 호출과 매개변수를 기록합니다. 이 패턴은 핵심 로직에서 로깅과 같은 교차 문제를 분리하는 데 유용합니다.

데코레이터의 작동 방식

TypeScript의 데코레이터는 꾸미고 있는 항목과 관련된 메타데이터를 가져오는 함수입니다. 이 메타데이터(예: 클래스 프로토타입, 메서드 이름, 속성 설명자)를 기반으로 데코레이터는 동작을 수정하거나 데코레이트된 객체를 교체할 수도 있습니다.

데코레이터의 유형

데코레이터는 각각 다른 목적을 가진 다양한 대상에 적용될 수 있습니다.

• 클래스 데코레이터 : 클래스의 생성자를 받는 함수입니다.

function classDecorator(constructor: Function) {
  // Modify or extend the class constructor or prototype
}

• 메소드 데코레이터 : 대상 객체, 메소드 이름, 메소드 설명자를 전달받는 함수입니다.

function methodDecorator(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
  // Modify the method's descriptor
}

• Property Decorators : 대상 객체와 속성 이름을 전달받는 함수입니다.

function propertyDecorator(target: any, propertyKey: string) {
  // Modify the behavior of the property
}

• 매개변수 데코레이터 : 매개변수의 대상, 메소드 이름, 인덱스를 전달받는 함수입니다.

function parameterDecorator(target: any, propertyKey: string, parameterIndex: number) {
  // Modify or inspect the method's parameter
}

데코레이터에 인수 전달

데코레이터의 가장 강력한 기능 중 하나는 인수를 받아 동작을 사용자 정의할 수 있는 능력입니다. 예를 들어 인수에 따라 조건부로 메서드 호출을 기록하는 메서드 데코레이터를 만들어 보겠습니다.

function logConditionally(shouldLog: boolean) {
  return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
    const originalMethod = descriptor.value;

    descriptor.value = function (...args: any[]) {
      if (shouldLog) {
        console.log(`Calling ${propertyKey} with arguments: ${args}`);
      }
      return originalMethod.apply(this, args);
    };

    return descriptor;
  };
}

class Example {
  @logConditionally(true)
  greet(name: string) {
    return `Hello, ${name}`;
  }
}

const example = new Example();
example.greet('TypeScript Developer');

logConditionally 데코레이터에 true를 전달하여 메소드가 실행을 기록하도록 합니다. false를 전달하면 로깅을 건너뜁니다. 이러한 유연성은 데코레이터를 다재다능하고 재사용 가능하게 만드는 핵심입니다.

데코레이터의 실제 응용

데코레이터는 많은 라이브러리와 프레임워크에서 실용적으로 사용되었습니다. 다음은 데코레이터가 복잡한 기능을 간소화하는 방법을 보여주는 몇 가지 주목할만한 예입니다.

• 클래스 유효성 검사기의 유효성 검사: 데이터 기반 애플리케이션에서는 유효성 검사가 중요합니다. 클래스 유효성 검사기 패키지는 데코레이터를 사용하여 TypeScript 클래스의 필드 유효성 검사 프로세스를 단순화합니다.

import { IsEmail, IsNotEmpty } from 'class-validator';

class User {
  @IsNotEmpty()
  name: string;

  @IsEmail()
  email: string;
}

이 예에서 @IsEmail 및 @IsNotEmpty 데코레이터는 이메일 필드가 유효한 이메일 주소이고 이름 필드가 비어 있지 않은지 확인합니다. 이러한 데코레이터는 수동 유효성 검사 논리가 필요하지 않아 시간을 절약합니다.

• TypeORM을 사용한 객체 관계형 매핑: 데코레이터는 TypeScript 클래스를 데이터베이스 테이블에 매핑하기 위해 TypeORM과 같은 ORM 프레임워크에서 널리 사용됩니다. 이 매핑은 데코레이터를 사용하여 선언적으로 수행됩니다.

import { Entity, Column, PrimaryGeneratedColumn } from 'typeorm';

@Entity()
class User {
  @PrimaryGeneratedColumn()
  id: number;

  @Column()
  name: string;

  @Column()
  email: string;
}

여기서 @Entity, @Column 및 @PrimaryGeneratedColumn은 User 테이블의 구조를 정의합니다. 이러한 데코레이터는 SQL 테이블 생성의 복잡성을 추상화하여 코드를 더 읽기 쉽고 유지 관리하기 쉽게 만듭니다.

• Angular 종속성 주입: Angular에서 데코레이터는 서비스와 구성 요소를 관리하는 데 중추적인 역할을 합니다. @Injectable 데코레이터는 클래스를 다른 구성 요소나 서비스에 주입할 수 있는 서비스로 표시합니다.

@Injectable({
  providedIn: 'root',
})
class UserService {
  constructor(private http: HttpClient) {}
}

이 경우 @Injectable 데코레이터는 UserService가 전역적으로 제공되어야 함을 Angular의 종속성 주입 시스템에 신호로 보냅니다. 이를 통해 애플리케이션 전반에 걸쳐 서비스를 원활하게 통합할 수 있습니다.

자신만의 데코레이터 구현: 분석

데코레이터의 핵심은 기능일 뿐입니다. 데코레이터를 처음부터 만드는 과정을 자세히 살펴보겠습니다.

Class Decorator

A class decorator receives the constructor of the class and can be used to modify the class prototype or even replace the constructor.

function AddTimestamp(constructor: Function) {
  constructor.prototype.timestamp = new Date();
}

@AddTimestamp
class MyClass {
  id: number;
  constructor(id: number) {
    this.id = id;
  }
}

const instance = new MyClass(1);
console.log(instance.timestamp);  // Outputs the current timestamp

Method Decorator

A method decorator modifies the method descriptor, allowing you to alter the behavior of the method itself.

function logExecutionTime(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
  const originalMethod = descriptor.value;

  descriptor.value = function (...args: any[]) {
    const start = performance.now();
    const result = originalMethod.apply(this, args);
    const end = performance.now();
    console.log(`${propertyKey} executed in ${end - start}ms`);
    return result;
  };

  return descriptor;
}

class Service {
  @logExecutionTime
  execute() {
    // Simulate work
    for (let i = 0; i < 1e6; i++) {}
  }
}

const service = new Service();
service.execute();  // Logs the execution time

Property Decorator

A property decorator allows you to intercept property access and modification, which can be useful for tracking changes.

function trackChanges(target: any, propertyKey: string) {
  let value = target[propertyKey];

  const getter = () => value;
  const setter = (newValue: any) => {
    console.log(`${propertyKey} changed from ${value} to ${newValue}`);
    value = newValue;
  };

  Object.defineProperty(target, propertyKey, {
    get: getter,
    set: setter,
  });
}

class Product {
  @trackChanges
  price: number;

  constructor(price: number) {
    this.price = price;
  }
}

const product = new Product(100);
product.price = 200;  // Logs the change

Conclusion

Decorators in TypeScript allow you to abstract and reuse functionality in a clean, declarative manner. Whether you're working with validation, ORMs, or dependency injection, decorators help reduce boilerplate and keep your code modular and maintainable. Understanding how they work from first principles makes it easier to leverage their full potential and craft custom solutions tailored to your application.

By taking a deeper look at the structure and real-world applications of decorators, you've now seen how they can simplify complex coding tasks and streamline code across various domains.

위 내용은 TypeScript의 데코레이터 이해: 첫 번째 원칙 접근 방식의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!