TypeScript Decorators: Mestring av Metadataprogrammeringsmønstre for Robuste Applikasjoner

            @MyDecorator
class MyClass {
  @AnotherDecorator
  myMethod() {
    // ...
  }
}
            

              
                Copy
              
            
          

            // tsconfig.json
{
  "compilerOptions": {
    "target": "ES2017",
    "module": "commonjs",
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true,
    "outDir": "./dist",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  }
}
            

              
                Copy
              
            
          

            npm install reflect-metadata --save
# eller
yarn add reflect-metadata
            

              
                Copy
              
            
          

            import "reflect-metadata";
// Din applikasjonskode følger
            

              
                Copy
              
            
          

            function Logger(prefix: string) {
  return function (target: Function) {
    console.log(`[${prefix}] Klassen ${target.name} er definert.`);
  };
}

@Logger("APP_INIT")
class ApplicationBootstrap {
  constructor() {
    console.log("Applikasjonen starter...");
  }
}

const app = new ApplicationBootstrap();
// Utdata:
// [APP_INIT] Klassen ApplicationBootstrap er definert.
// Applikasjonen starter...
            

              
                Copy
              
            
          

            function ClassDecorator(target: Function) { ... }
            

              
                Copy
              
            
          

            const InjectableServiceRegistry = new Map<string, Function>();

function Injectable(name?: string) {
  return function<T extends { new(...args: any[]): {} }>(constructor: T) {
    const serviceName = name || constructor.name;
    InjectableServiceRegistry.set(serviceName, constructor);
    console.log(`Registrert tjeneste: ${serviceName}`);

    // Eventuelt kan du returnere en ny klasse her for å utvide oppførselen
    return class extends constructor {
      createdAt = new Date();
      // Ytterligere egenskaper eller metoder for alle injiserte tjenester
    };
  };
}

@Injectable("UserService")
class UserDataService {
  getUsers() {
    return [{ id: 1, name: "Alice" }, { id: 2, name: "Bob" }];
  }
}

@Injectable()
class ProductDataService {
  getProducts() {
    return [{ id: 101, name: "Laptop" }, { id: 102, name: "Mouse" }];
  }
}

console.log("--- Tjenester Registrert ---");
console.log(Array.from(InjectableServiceRegistry.keys()));

const userServiceConstructor = InjectableServiceRegistry.get("UserService");
if (userServiceConstructor) {
  const userServiceInstance = new userServiceConstructor();
  console.log("Brukere:", userServiceInstance.getUsers());
  // console.log("User Service Created At:", userServiceInstance.createdAt); // Hvis den returnerte klassen brukes
}
            

              
                Copy
              
            
          

            function MethodDecorator(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor) { ... }
            

              
                Copy
              
            
          

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

  descriptor.value = function(...args: any[]) {
    const start = process.hrtime.bigint();
    const result = originalMethod.apply(this, args);
    const end = process.hrtime.bigint();
    const duration = Number(end - start) / 1_000_000;
    console.log(`Metoden "${propertyKey}" ble utført på ${duration.toFixed(2)} ms`);
    return result;
  };

  return descriptor;
}

class DataProcessor {
  @MeasurePerformance
  processData(data: number[]): number[] {
    // Simulerer en kompleks, tidkrevende operasjon
    for (let i = 0; i < 1_000_000; i++) {
      Math.sin(i);
    }
    return data.map(n => n * 2);
  }

  @MeasurePerformance
  fetchRemoteData(id: string): Promise<string> {
    return new Promise(resolve => {
      setTimeout(() => {
        resolve(`Data for ID: ${id}`);
      }, 500);
    });
  }
}

const processor = new DataProcessor();
processor.processData([1, 2, 3]);
processor.fetchRemoteData("abc").then(result => console.log(result));
            

              
                Copy
              
            
          

            function AccessorDecorator(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor) { ... }
            

              
                Copy
              
            
          

            function CachedGetter(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
  const originalGetter = descriptor.get;
  const cacheKey = `_cached_${String(propertyKey)}`;

  if (originalGetter) {
    descriptor.get = function() {
      if (this[cacheKey] === undefined) {
        console.log(`[Cache Miss] Beregner verdi for ${String(propertyKey)}`);
        this[cacheKey] = originalGetter.apply(this);
      } else {
        console.log(`[Cache Hit] Bruker mellomlagret verdi for ${String(propertyKey)}`);
      }
      return this[cacheKey];
    };
  }
  return descriptor;
}

class ReportGenerator {
  private data: number[];

  constructor(data: number[]) {
    this.data = data;
  }

  // Simulerer en kostbar beregning
  @CachedGetter
  get expensiveSummary(): number {
    console.log("Utfører kostbar oppsummeringsberegning...");
    return this.data.reduce((sum, current) => sum + current, 0) / this.data.length;
  }
}

const generator = new ReportGenerator([10, 20, 30, 40, 50]);

console.log("Første tilgang:", generator.expensiveSummary);
console.log("Andre tilgang:", generator.expensiveSummary);
console.log("Tredje tilgang:", generator.expensiveSummary);
            

              
                Copy
              
            
          

            function PropertyDecorator(target: Object, propertyKey: string | symbol) { ... }
            

              
                Copy
              
            
          

            interface ValidationRule {
  property: string | symbol;
  validate: (value: any) => boolean;
  message: string;
}

const validationRules: Map<Function, ValidationRule[]> = new Map();

function Required(target: Object, propertyKey: string | symbol) {
  const rules = validationRules.get(target.constructor) || [];
  rules.push({
    property: propertyKey,
    validate: (value: any) => value !== null && value !== undefined && value !== "",
    message: `${String(propertyKey)} er påkrevd.`
  });
  validationRules.set(target.constructor, rules);
}

function validate(instance: any): string[] {
  const classRules = validationRules.get(instance.constructor) || [];
  const errors: string[] = [];

  for (const rule of classRules) {
    if (!rule.validate(instance[rule.property])) {
      errors.push(rule.message);
    }
  }
  return errors;
}

class UserProfile {
  @Required
  firstName: string;

  @Required
  lastName: string;

  age?: number;

  constructor(firstName: string, lastName: string, age?: number) {
    this.firstName = firstName;
    this.lastName = lastName;
    this.age = age;
  }
}

const user1 = new UserProfile("John", "Doe", 30);
console.log("Valideringsfeil for bruker 1:", validate(user1)); // []

const user2 = new UserProfile("", "Smith");
console.log("Valideringsfeil for bruker 2:", validate(user2)); // ["firstName er påkrevd."]

const user3 = new UserProfile("Alice", "");
console.log("Valideringsfeil for bruker 3:", validate(user3)); // ["lastName er påkrevd."]
            

              
                Copy
              
            
          

            function ParameterDecorator(target: Object, propertyKey: string | symbol | undefined, parameterIndex: number) { ... }
            

              
                Copy
              
            
          

            interface ParameterMetadata {
  index: number;
  key: string | symbol;
  resolver: (request: any) => any;
}

const parameterResolvers: Map<Function, Map<string | symbol, ParameterMetadata[]>> = new Map();

function RequestParam(paramName: string) {
  return function (target: Object, propertyKey: string | symbol | undefined, parameterIndex: number) {
    const targetKey = propertyKey || "constructor";
    let methodResolvers = parameterResolvers.get(target.constructor);
    if (!methodResolvers) {
      methodResolvers = new Map();
      parameterResolvers.set(target.constructor, methodResolvers);
    }
    const paramMetadata = methodResolvers.get(targetKey) || [];
    paramMetadata.push({
      index: parameterIndex,
      key: targetKey,
      resolver: (request: any) => request[paramName]
    });
    methodResolvers.set(targetKey, paramMetadata);
  };
}

// En hypotetisk rammeverkfunksjon for å kalle en metode med oppløste parametere
function executeWithParams(instance: any, methodName: string, request: any) {
  const classResolvers = parameterResolvers.get(instance.constructor);
  if (!classResolvers) {
    return (instance[methodName] as Function).apply(instance, []);
  }
  const methodParamMetadata = classResolvers.get(methodName);
  if (!methodParamMetadata) {
    return (instance[methodName] as Function).apply(instance, []);
  }

  const args: any[] = Array(methodParamMetadata.length);
  for (const meta of methodParamMetadata) {
    args[meta.index] = meta.resolver(request);
  }
  return (instance[methodName] as Function).apply(instance, args);
}

class UserController {
  getUser(@RequestParam("id") userId: string, @RequestParam("token") authToken?: string) {
    console.log(`Henter bruker med ID: ${userId}, Token: ${authToken || "N/A"}`);
    return { id: userId, name: "Jane Doe" };
  }

  deleteUser(@RequestParam("id") userId: string) {
    console.log(`Sletter bruker med ID: ${userId}`);
    return { status: "deleted", id: userId };
  }
}

const userController = new UserController();

// Simulerer en innkommende forespørsel
const mockRequest = {
  id: "user123",
  token: "abc-123",
  someOtherProp: "xyz"
};

console.log("\n--- Utfører getUser ---");
executeWithParams(userController, "getUser", mockRequest);

console.log("\n--- Utfører deleteUser ---");
executeWithParams(userController, "deleteUser", { id: "user456" });
            

              
                Copy
              
            
          

            @DecoratorA
@DecoratorB
class MyClass {
  // ...
}

            

              
                Copy
              
            
          

            function LogCall(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
  const originalMethod = descriptor.value;
  descriptor.value = function (...args: any[]) {
    console.log(`[LOG] Kaller ${String(propertyKey)} med argumenter:`, args);
    const result = originalMethod.apply(this, args);
    console.log(`[LOG] Metode ${String(propertyKey)} returnerte:`, result);
    return result;
  };
  return descriptor;
}

function Authorization(roles: string[]) {
  return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
    const originalMethod = descriptor.value;
    descriptor.value = function (...args: any[]) {
      const currentUserRoles = ["admin"]; // Simulerer henting av nåværende brukerroller
      const authorized = roles.some(role => currentUserRoles.includes(role));
      if (!authorized) {
        console.warn(`[AUTH] Tilgang nektet for ${String(propertyKey)}. Krevde roller: ${roles.join(", ")}`);
        throw new Error("Uautorisert tilgang");
      }
      console.log(`[AUTH] Tilgang gitt for ${String(propertyKey)}`);
      return originalMethod.apply(this, args);
    };
    return descriptor;
  };
}

class SecureService {
  @LogCall
  @Authorization(["admin"])
  deleteSensitiveData(id: string) {
    console.log(`Sletter sensitive data for ID: ${id}`);
    return `Data ID ${id} slettet.`;
  }

  @Authorization(["user"])
  @LogCall // Rekkefølgen endret her
  fetchPublicData(query: string) {
    console.log(`Henter offentlige data med søk: ${query}`);
    return `Offentlige data for søk: ${query}`; 
  }
}

const service = new SecureService();

try {
  console.log("\n--- Kaller deleteSensitiveData (Admin-bruker) ---");
  service.deleteSensitiveData("record123");
} catch (error: any) {
  console.error(error.message);
}

try {
  console.log("\n--- Kaller fetchPublicData (Ikke-admin-bruker) ---");
  // Simulerer en ikke-admin-bruker som prøver å få tilgang til fetchPublicData som krever 'user'-rollen
  const mockUserRoles = ["guest"]; // Dette vil mislykkes autorisasjon
  // For å gjøre dette dynamisk, trenger du et DI-system eller statisk kontekst for nåværende brukerroller.
  // For enkelhets skyld antar vi at Authorization-dekoratøren har tilgang til nåværende brukerkontekst.
  // La oss justere Authorization-dekoratøren til å alltid anta 'admin' for demoformål,
  // slik at det første kallet lykkes og det andre mislykkes for å vise forskjellige veier.
  
  // Kjør på nytt med brukerrolle for at fetchPublicData skal lykkes.
  // Tenk deg at currentUserRoles i Authorization blir: ['user']
  // For dette eksempelet, la oss holde det enkelt og vise rekkefølgeeffekten.
  service.fetchPublicData("søkeord"); // Dette vil utføre Auth -> Log
} catch (error: any) {
  console.error(error.message);
}

/* Forventet utdata for deleteSensitiveData:
[AUTH] Tilgang gitt for deleteSensitiveData
[LOG] Kaller deleteSensitiveData med argumenter: [ 'record123' ]
Sletter sensitive data for ID: record123
[LOG] Metode deleteSensitiveData returnerte: Data ID record123 slettet.
*/

/* Forventet utdata for fetchPublicData (hvis bruker har 'user'-rollen):
[LOG] Kaller fetchPublicData med argumenter: [ 'søkeord' ]
[AUTH] Tilgang gitt for fetchPublicData
Henter offentlige data med søk: søkeord
[LOG] Metode fetchPublicData returnerte: Offentlige data for søk: søkeord
*/
            

              
                Copy
              
            
          

            function log(message: string) {
  return function (target: any, propertyKey: string | symbol | undefined, descriptorOrIndex?: PropertyDescriptor | number) {
    if (typeof descriptorOrIndex === 'number') {
      console.log(`Param-dekoratør: ${message} på parameter #${descriptorOrIndex} av ${String(propertyKey || "constructor")}`);
    } else if (typeof propertyKey === 'string' || typeof propertyKey === 'symbol') {
      if (descriptorOrIndex && 'value' in descriptorOrIndex && typeof descriptorOrIndex.value === 'function') {
        console.log(`Metode/Aksessor-dekoratør: ${message} på ${String(propertyKey)}`);
      } else {
        console.log(`Egenskapsdekoratør: ${message} på ${String(propertyKey)}`);
      }
    } else {
      console.log(`Klassedekoratør: ${message} på ${target.name}`);
    }
    return descriptorOrIndex; // Returner descriptor for metode/aksessor, undefined for andre
  };
}

@log("Klassenivå D")
@log("Klassenivå C")
class MyDecoratedClass {
  @log("Statisk Egenskap A")
  static staticProp: string = "";

  @log("Instanse-egenskap B")
  instanceProp: number = 0;

  @log("Metode D")
  @log("Metode C")
  myMethod(
    @log("Parameter Z") paramZ: string,
    @log("Parameter Y") paramY: number
  ) {
    console.log("Metoden myMethod utført.");
  }

  @log("Getter/Setter F")
  get myAccessor() {
    return "";
  }

  set myAccessor(value: string) {
    //...
  }

  constructor() {
    console.log("Konstruktør utført.");
  }
}

new MyDecoratedClass();
// Kall metoden for å utløse metodedekoratøren
new MyDecoratedClass().myMethod("hello", 123);

/* Forutsagt utdatarekkefølge (omtrentlig, avhengig av spesifikk TypeScript-versjon og kompilering):
Param-dekoratør: Parameter Y på parameter #1 av myMethod
Param-dekoratør: Parameter Z på parameter #0 av myMethod
Egenskapsdekoratør: Statisk Egenskap A på staticProp
Egenskapsdekoratør: Instanse-egenskap B på instanceProp
Metode/Aksessor-dekoratør: Getter/Setter F på myAccessor
Metode/Aksessor-dekoratør: Metode C på myMethod
Metode/Aksessor-dekoratør: Metode D på myMethod
Klassedekoratør: Klassenivå C på MyDecoratedClass
Klassedekoratør: Klassenivå D på MyDecoratedClass
Konstruktør utført.
Metoden myMethod utført.
*/
            

              
                Copy
              
            
          

            import "reflect-metadata"; // Essensielt for emitDecoratorMetadata

const INJECTABLE_METADATA_KEY = Symbol("injectable");
const INJECT_METADATA_KEY = Symbol("inject");

function Injectable() {
  return function (target: Function) {
    Reflect.defineMetadata(INJECTABLE_METADATA_KEY, true, target);
  };
}

function Inject(token: any) {
  return function (target: Object, propertyKey: string | symbol, parameterIndex: number) {
    const existingInjections: any[] = Reflect.getOwnMetadata(INJECT_METADATA_KEY, target, propertyKey) || [];
    existingInjections[parameterIndex] = token;
    Reflect.defineMetadata(INJECT_METADATA_KEY, existingInjections, target, propertyKey);
  };
}

class Container {
  private static instances = new Map<any, any>();

  static resolve<T>(target: { new (...args: any[]): T }): T {
    if (Container.instances.has(target)) {
      return Container.instances.get(target);
    }

    const isInjectable = Reflect.getMetadata(INJECTABLE_METADATA_KEY, target);
    if (!isInjectable) {
      throw new Error(`Klassen ${target.name} er ikke merket som @Injectable.`);
    }

    // Hent konstruktørparametrenes typer (krever emitDecoratorMetadata)
    const paramTypes: any[] = Reflect.getMetadata("design:paramtypes", target) || [];
    const explicitInjections: any[] = Reflect.getMetadata(INJECT_METADATA_KEY, target) || [];

    const dependencies = paramTypes.map((paramType, index) => {
      // Bruk eksplisitt @Inject-token hvis gitt, ellers inferer typen
      const token = explicitInjections[index] || paramType;
      if (token === undefined) {
        throw new Error(`Kan ikke løse parameter ved indeks ${index} for ${target.name}. Det kan være en sirkulær avhengighet eller primitiv type uten eksplisitt @Inject.`);
      }
      return Container.resolve(token);
    });

    const instance = new target(...dependencies);
    Container.instances.set(target, instance);
    return instance;
  }
}

// Definer tjenester
@Injectable()
class DatabaseService {
  connect() {
    console.log("Kobler til database...");
    return "DB-tilkobling";
  }
}

@Injectable()
class AuthService {
  private db: DatabaseService;

  constructor(db: DatabaseService) {
    this.db = db;
  }

  login() {
    console.log(`AuthService: Autentiserer ved hjelp av ${this.db.connect()}`);
    return "Bruker logget inn";
  }
}

@Injectable()
class UserService {
  private authService: AuthService;
  private dbService: DatabaseService; // Eksempel på injeksjon via egenskap med en tilpasset dekoratør eller rammeverkfunksjon

  constructor(@Inject(AuthService) authService: AuthService,
              @Inject(DatabaseService) dbService: DatabaseService) {
    this.authService = authService;
    this.dbService = dbService;
  }

  getUserProfile() {
    this.authService.login();
    this.dbService.connect();
    console.log("UserService: Henter brukerprofil...");
    return { id: 1, name: "Global User" };
  }
}

// Løs hovedtjenesten
console.log("--- Løser UserService ---");
const userService = Container.resolve(UserService);
console.log(userService.getUserProfile());

console.log("\n--- Løser AuthService (bør være mellomlagret) ---");
const authService = Container.resolve(AuthService);
authService.login();
            

              
                Copy
              
            
          

            function LogMethod(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
  const originalMethod = descriptor.value;
  descriptor.value = function (...args: any[]) {
    console.log(`[LOG AOP] Går inn i metode: ${String(propertyKey)} med argumenter:`, args);
    try {
      const result = originalMethod.apply(this, args);
      console.log(`[LOG AOP] Forlater metode: ${String(propertyKey)} med resultat:`, result);
      return result;
    } catch (error: any) {
      console.error(`[LOG AOP] Feil i metode ${String(propertyKey)}:`, error.message);
      throw error;
    }
  };
  return descriptor;
}

class PaymentProcessor {
  @LogMethod
  processPayment(amount: number, currency: string) {
    if (amount <= 0) {
      throw new Error("Betalingsbeløpet må være positivt.");
    }
    console.log(`Behandler betaling på ${amount} ${currency}...`);
    return `Betaling på ${amount} ${currency} behandlet vellykket.`;
  }

  @LogMethod
  refundPayment(transactionId: string) {
    console.log(`Refunderer betaling for transaksjons-ID: ${transactionId}...`);
    return `Refusjon initiert for ${transactionId}.`;
  }
}

const processor = new PaymentProcessor();
processor.processPayment(100, "USD");
try {
  processor.processPayment(-50, "EUR");
} catch (error: any) {
  console.error("Fanget feil:", error.message);
}
            

              
                Copy
              
            
          

            interface FieldValidationRule {
  property: string | symbol;
  validator: (value: any) => boolean;
  message: string;
}

const fieldValidationRules = new Map<Function, FieldValidationRule[]>();

function addValidationRule(target: Object, propertyKey: string | symbol, validator: (value: any) => boolean, message: string) {
  const rules = fieldValidationRules.get(target.constructor) || [];
  rules.push({ property: propertyKey, validator, message });
  fieldValidationRules.set(target.constructor, rules);
}

function IsPositive(target: Object, propertyKey: string | symbol) {
  addValidationRule(target, propertyKey, (value: number) => value > 0, `${String(propertyKey)} må være et positivt tall.`);
}

function MaxLength(maxLength: number) {
  return function (target: Object, propertyKey: string | symbol) {
    addValidationRule(target, propertyKey, (value: string) => value.length <= maxLength, `${String(propertyKey)} kan maksimalt være ${maxLength} tegn langt.`);
  };
}

class Product {
  @MaxLength(50)
  name: string;

  @IsPositive
  price: number;

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

  static validate(instance: any): string[] {
    const errors: string[] = [];
    const rules = fieldValidationRules.get(instance.constructor) || [];
    for (const rule of rules) {
      if (!rule.validator(instance[rule.property])) {
        errors.push(rule.message);
      }
    }
    return errors;
  }
}

const product1 = new Product("Laptop", 1200);
console.log("Feil for produkt 1:", Product.validate(product1)); // []

const product2 = new Product("Et veldig langt produktnavn som overstiger femti tegns grensen for testformål", 50);
console.log("Feil for produkt 2:", Product.validate(product2)); // ["name kan maksimalt være 50 tegn langt."]

const product3 = new Product("Bok", -10);
console.log("Feil for produkt 3:", Product.validate(product3)); // ["price må være et positivt tall."]
            

              
                Copy
              
            
          

            // En dekoratør som sikrer at en metode logges og også krever admin-roller
function AdminAndLoggedMethod() {
  return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
    // Anvend Authorization først (indre)
    Authorization(["admin"])(target, propertyKey, descriptor);
    // Anvend deretter LogCall (ytre)
    LogCall(target, propertyKey, descriptor);

    return descriptor; // Returner den modifiserte beskrivelsen
  };
}

class AdminPanel {
  @AdminAndLoggedMethod()
  deleteUserAccount(userId: string) {
    console.log(`Sletter brukerkonto: ${userId}`);
    return `Bruker ${userId} slettet.`;
  }
}

const adminPanel = new AdminPanel();
adminPanel.deleteUserAccount("user007");
/* Forventet utdata (forutsatt admin-rolle):
[AUTH] Tilgang gitt for deleteUserAccount
[LOG] Kaller deleteUserAccount med argumenter: [ 'user007' ]
Sletter brukerkonto: user007
[LOG] Metode deleteUserAccount returnerte: Bruker user007 slettet.
*/
            

              
                Copy
              
            
          

            function ApplyMixins(constructors: Function[]) {
  return function (derivedConstructor: Function) {
    constructors.forEach(baseConstructor => {
      Object.getOwnPropertyNames(baseConstructor.prototype).forEach(name => {
        Object.defineProperty(
          derivedConstructor.prototype,
          name,
          Object.getOwnPropertyDescriptor(baseConstructor.prototype, name) || Object.create(null)
        );
      });
    });
  };
}

class Disposable {
  isDisposed: boolean = false;
  dispose() {
    this.isDisposed = true;
    console.log("Objekt avhendet.");
  }
}

class Loggable {
  log(message: string) {
    console.log(`[Loggable] ${message}`);
  }
}

@ApplyMixins([Disposable, Loggable])
class MyResource implements Disposable, Loggable {
  // Disse egenskapene/metodene blir injisert av dekoratøren
  isDisposed!: boolean;
  dispose!: () => void;
  log!: (message: string) => void;

  constructor(public name: string) {
    this.log(`Ressurs ${this.name} opprettet.`);
  }

  cleanUp() {
    this.dispose();
    this.log(`Ressurs ${this.name} ryddet opp.`);
  }
}

const resource = new MyResource("NetworkConnection");
console.log(`Er avhendet: ${resource.isDisposed}`);
resource.cleanUp();
console.log(`Er avhendet: ${resource.isDisposed}`);
            

              
                Copy