Kurzreferenz

Modella Models Spickzettel

Ein Schnellreferenz-Leitfaden für Modella: Minimalistisches JavaScript-Modell-Framework, Attributdefinitionen, Validierungen und Plugins.

· Veröffentlicht

[!NOTE] Archiviertes Projekt: Modella ist ein historisches Modell-Framework für Node.js und Browser-Apps. Für moderne Projekte werden Zod oder Prisma empfohlen.

Modella ist eine extrem schlanke Datenmodellierungs-Bibliothek, die über Plugins erweitert werden kann.

Modelldefinition

const Modella = require('modella');
const validators = require('modella-validators');

const User = Modella('User')
  .attr('id')
  .attr('name')
  .attr('email', { required: true })
  .use(validators);

// Benutzerdefinierte Validierungsregel
User.validate((user) => {
  if (!user.name()) {
    user.error('name', 'Name is required');
  }
});

Modellinstanzen & Eigenschaften

// Instanziierung
const user = new User({ name: 'Alice', email: '[email protected]' });

// Getter und Setter
user.name();               // -> "Alice"
user.name('Bob');          // Sets name to "Bob"
user.set({ name: 'Charlie' });

// Status-Prädikate
user.has('name');          // -> true
user.isNew();              // -> true (not yet saved)
user.isValid();            // Runs sync validators -> true/false

Lebenszyklus-Events

// Persistenz-Ereignisse
user.on('save', () => console.log('Saved'));
user.on('create', () => console.log('Created'));
user.on('remove', () => console.log('Removed'));

// Asynchrone Hooks
user.on('saving', (instance, done) => {
  done();
});

// Attribut-Änderungsereignisse
user.on('change', () => console.log('Attributes modified'));
user.on('change email', () => console.log('Email changed'));

Plugin-Architektur

Ein Modella-Plugin ist eine Higher-Order-Funktion, die das Modell dekoriert:

const TimestampsPlugin = () => {
  return (Model) => {
    Model
      .attr('createdAt')
      .attr('updatedAt');

    Model.on('saving', (record, done) => {
      const now = new Date();
      if (record.isNew()) record.createdAt(now);
      record.updatedAt(now);
      done();
    });

    return Model;
  };
};

User.use(TimestampsPlugin());

Referenzen

Verwandte Themen