Pular para o conteúdo

13 · Decoradores

Estruturas: derivação e validação

Geração automática de Eq, Clone e Debug com @derive, e validação de campos com @validate.

Nesta página

@derive gera implementações padrão de traits para um struct sem código manual. As traits disponíveis são Eq (comparação por ==), Clone (método .clone()) e Debug (impressão estruturada via print). Várias traits podem ser combinadas em uma única linha:

Eq em Color, Clone em Config, e as três traits juntas em Vec3.

07-derive-eq-clone.zolo
Playground
// Feature: `@derive(Trait, ...)` — generates common implementations
// Syntax: `@derive(Eq)`, `@derive(Clone)`, `@derive(Debug)`, or multiple.
// When to use: structs where you want to compare (`==`), copy (`.clone()`),
// or print (`tostring`) without writing boilerplate.

@derive(Eq)
struct Color {
  r: int,
  g: int,
  b: int,
}

let red = Color { r: 255, g: 0, b: 0 }
let also_red = Color { r: 255, g: 0, b: 0 }
let blue = Color { r: 0, g: 0, b: 255 }

print("red == also_red? {red == also_red}")
// expected: red == also_red? true
print("red == blue? {red == blue}")

// expected: red == blue? false

@derive(Clone)
struct Config {
  host: str,
  port: int,
}

let cfg = Config { host: "localhost", port: 8080 }
let backup = cfg.clone()
print("backup = {backup.host}:{backup.port}")

// expected: backup = localhost:8080

// Multi-derive — several capabilities in a single line.
@derive(Debug, Clone, Eq)
struct Vec3 {
  x: float,
  y: float,
  z: float,
}

let v = Vec3 { x: 1.0, y: 2.0, z: 3.0 }
let w = v.clone()
print(v)
// expected: Vec3 { x: 1.0, y: 2.0, z: 3.0 }
print("v == w? {v == w}")
// expected: v == w? true

@validate gera o método .validate() no struct. Ele percorre todos os campos e retorna true se nenhum for nil — suficiente para validação de payloads de formulários e corpos de API antes de processar a requisição:

Validação simples de struct e composição com @serialize.

11-validate.zolo
Playground
// Feature: `@validate` — generates `.validate()` that checks for non-nil fields
// Syntax: `@validate` on a struct. The method returns `true` if all
// fields are non-nil.
// When to use: simple payload validation (form, API body) before
// processing.

@validate
struct Registration {
  username: str,
  email: str,
  age: int,
}

let valid = Registration { username: "alice", email: "[email protected]", age: 25 }
print("valid? {valid.validate()}")

// expected: valid? true

// `@validate` also pairs well with @serialize/@deserialize.
@validate
@serialize
struct LoginRequest {
  user: str,
  password: str,
}

let req = LoginRequest { user: "bob", password: "secret" }
print("login valid? {req.validate()}")
// expected: login valid? true
print("login json = {req.to_json()}")
// expected: login json = {"user":"bob","password":"secret"}

Desafio

Crie um struct Address com campos street, city e zip, anote-o com @derive(Debug, Eq) e @validate. Instancie dois objetos iguais e confirme que == retorna true e .validate() retorna true.

Índice global

Encontre seu caminho pela Zolo

Experimente uma ideia

Comece por aqui

9 resultados

9 resultados

enespt-br