Referencia de Atributos ORM

En Osumi Framework, las asignaciones de bases de datos se definen mediante atributos PHP en las propiedades de la clase del modelo. Este documento detalla todos los atributos disponibles, sus parámetros y comportamientos esperados.

`#[OPK]`

Define un campo de clave principal. Cada modelo debe tener al menos uno.

Parámetro	Tipo	Predeterminado	Descripción
`type`	`string`	`OField::NUMBER`	Tipo de dato (ver Tipos a continuación).
`incr`	`bool`	`true`	Si el campo es autoincremental.
`comment`	`string`	`''`	Comentario para la columna de la base de datos.
`ref`	`string`	`''`	Referencia de clave externa (formato: `'tabla.campo'`).
`nullable`	`bool`	`true`	Si el campo puede almacenar valores `null`.
`default`	`mixed`	`null`	Valor predeterminado de la columna.

`#[OField]`

Define una columna de base de datos estándar.

Parámetro	Tipo	Predeterminado	Descripción
`type`	`string`	`null`	Tipo de dato (obligatorio).
`nullable`	`bool`	`true`	Si el campo puede almacenar valores `null`.
`default`	`mixed`	`null`	Valor predeterminado de la columna.
`max`	`int`	`50`	Tamaño/longitud máximos del campo.
`comment`	`string`	`''`	Comentario para la columna de la base de datos.
`visible`	`bool`	`true`	Si el campo se incluye al serializar el modelo.
`ref`	`string`	`''`	Referencia de clave externa (formato: `'tabla.campo'`).

Atributos temporales

Estos atributos gestionan el sellado de tiempo automático. Cada modelo debe tener exactamente un #[OCreatedAt] y un #[OUpdatedAt].

`#[OCreatedAt]`

Se configura automáticamente al crear un registro por primera vez (INSERTAR).

Parámetro: comment (cadena) - Comentario de la columna.

`#[OUpdatedAt]`

Se actualiza automáticamente al modificar el registro (ACTUALIZAR).

Parámetro: comment (cadena) - Comentario de la columna.

`#[ODeletedAt]`

Se utiliza para la función de eliminación temporal (seguimiento de cuándo se eliminó un registro).

Parámetro: comment (cadena) - Comentario de la columna.

Tipos de datos (Constantes `OField`)

Al definir type en #[OPK] o #[OField], utilice estas constantes de la clase Osumi\OsumiFramework\ORM\OField:

OField::NUMBER: Valores enteros.
OField::TEXT: Cadenas cortas (normalmente asignadas a VARCHAR).
OField::LONGTEXT: Bloques de texto grandes (normalmente asignados a LONGTEXT).
OField::FLOAT: Números de punto flotante.
OField::BOOL: Valores booleanos. - OField::DATE: Cadenas de fecha/hora.

Ejemplo de uso

use Osumi\OsumiFramework\ORM\OModel;
use Osumi\OsumiFramework\ORM\OPK;
use Osumi\OsumiFramework\ORM\OField;
use Osumi\OsumiFramework\ORM\OCreatedAt;
use Osumi\OsumiFramework\ORM\OUpdatedAt;

class Product extends OModel {
    #[OPK(comment: 'ID único del producto')]
    public ?int $id = null;

    #[OField(type: OField::TEXT, max: 150, nullable: false, comment: 'Nombre del producto')]
    public ?string $name = null;

    #[OField(type: OField::NUMBER, ref: 'category.id', comment: 'Enlace a la categoría')]
    public ?int $id_category = null;

    #[OCreatedAt(comment: 'Marca de tiempo de creación')]
    public ?string $created_at = null;

    #[OUpdatedAt(comment: 'Marca de tiempo de la última actualización')]
    public ?string $updated_at = null;
}

Lógica de validación

La clase base OModel utiliza estos atributos durante el proceso save():

Comprobación de longitud: Si una cadena de propiedad supera el valor max, se genera una excepción.
Nulabilidad: Si una propiedad es null pero nullable se establece en false, se genera una excepción.
Clave principal: garantiza que al menos un #[OPK] esté definido antes de continuar.

Referencia de Atributos ORM

#[OPK]

#[OField]

Atributos temporales

#[OCreatedAt]

#[OUpdatedAt]

#[ODeletedAt]

Tipos de datos (Constantes OField)