Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Decoradores e asserções

Use @decoradores para anexar metadados ou envolver funções e métodos com comportamento extra (como logs ou validações), e assercao() para checar condições importantes em execução.

Metadados declarativos e envelopes

Um decorador simples como @rota(caminho="/usuarios") guarda dados constantes que podem ser consultados com decoradores(alvo). Se você declarar uma funcao de decorador, ela envolve automaticamente a função ou método decorado — recebendo a função original e devolvendo a nova versão.

funcao de decorador dobrarResultado(original: funcao): funcao {
    retorna funcao(alvo: qualquer, x: inteiro): inteiro {
        retorna original(alvo, x) * 2
    }
}

Asserções em runtime

assercao(condicao, "mensagem opcional") verifica uma garantia do seu código e lança uma exceção tratável caso falhe.

assercao(2 + 2 == 4, "a aritmética falhou")

Experimente: 23_decoradores

@minimo(valor = 0)
classe Medida {
    lado: numero
}

escreva(decoradores(Medida).classe[0].nome)
funcao alternativa(): qualquer {
    retorna 9
}

funcao de decorador trocar(original: qualquer): qualquer {
    retorna alternativa
}

@trocar
funcao obter(): qualquer {
    retorna 1
}

escreva(obter())

Ver exemplo completo e contrato de teste no GitHub

Experimente: 24_assercoes

assercao 2 + 2 == 4
escreva("validado")
tente {
    asserção(falso, "mensagem personalizada")
}
pegue (erro) {
    escreva(erro)
}

Ver exemplo completo e contrato de teste no GitHub

Experimente: 43_estaticos_mescla

funcao de decorador triplicar(original: funcao): funcao {
    retorna funcao(alvo: qualquer, x: inteiro): inteiro {
        retorna x * 3
    }
}

classe Etiquetavel {
    prefixo: texto = "Etiqueta:"

    rotulo(nome: texto): texto {
        retorna isto.prefixo + nome
    }
}

classe Registro mescla Etiquetavel {
    estatico criados: inteiro = 0
    nome: texto

    construtor(nome: texto) {
        isto.nome = nome
        Registro.criados = Registro.criados + 1
    }

    @triplicar
    escalar(x: inteiro): inteiro {
        retorna x
    }
}

const a: Registro = Registro("Ana")
const b: Registro = Registro("Bia")
escreva(Registro.criados)
escreva(a.rotulo(a.nome))
escreva(b.eInstanciaDe(Etiquetavel))
escreva(a.escalar(10))

Ver exemplo completo e contrato de teste no GitHub

Envelopes de decoradores funcionam em funções livres, métodos de instância e métodos estáticos (sem captura de ambiente). Asserções nunca são apagadas pelo -o.