Usina BRAdvPL Guia
Entrar
← Todos os tópicos
INCLUDEEm revisão

FWMVCDef.ch

#Include "FWMVCDef.ch"

Reúne definições usadas por rotinas MVC do Framework, incluindo constantes de operação que devem ser confirmadas na LIB atual.

IncludesMVCFrameworkConstantesEm revisão
01 · VISÃO GERAL

Visão geral

FWMVCDef.ch é frequentemente utilizada em fontes MVC para disponibilizar constantes e definições do Framework. ModelDef(), ViewDef() e MenuDef() são funções convencionais da arquitetura da rotina, não comandos que a include transforma por si só. Da mesma forma, TopConn.ch atende acesso SQL e não constitui o mecanismo de persistência do MVC. O material complementar registra MODEL_OPERATION_INSERT, MODEL_OPERATION_UPDATE e MODEL_OPERATION_DELETE; seus valores e sua disponibilidade devem ser confirmados no arquivo do release utilizado.

02 · SINTAXE

Sintaxe

#Include "FWMVCDef.ch"

Parâmetros

FWMVCDef.ch
Arquivo .chOpcional

Include usada por recursos MVC; confirme quais símbolos do fonte realmente dependem dela.

Retorno

Não possui retorno em execução; fornece definições ao compilador.

03 · EXEMPLO PRÁTICO

Estrutura mínima de funções MVC

#Include "TOTVS.ch"
#Include "FWMVCDef.ch"

Static Function ModelDef()
    Local oModelo := MPFormModel():New("EXEMPLO")
Return oModelo

Static Function ViewDef()
    Local oVisao := FWFormView():New()
    oVisao:SetModel(ModelDef())
Return oVisao
Resultado esperado

A include disponibiliza definições; ModelDef() e ViewDef() continuam sendo funções implementadas pelo desenvolvedor.

BOAS PRÁTICAS
  • Separe convenções arquiteturais, como ModelDef(), de macros e constantes realmente declaradas na include.
  • Use a documentação MVC e o arquivo atual para confirmar constantes de operação.
  • Mantenha SQL, modelo, visão e menu como responsabilidades distintas.
ARMADILHAS COMUNS
  • Afirmar que a include é obrigatória para toda tela MVC é amplo demais sem considerar o código e a versão.
  • TopConn.ch não gerencia automaticamente validações ou persistência MVC.
  • Valores numéricos de constantes não devem ser reproduzidos como números literais no fonte.

Conteúdos relacionados

REFERÊNCIAS
  1. GOOGLE. Dicionário de Comandos, Constantes Comuns e Exemplos Práticos testados. Material gerado em 8 ago. 2026, fornecido pelo editor do AdvPL Guia; conteúdo tecnicamente revisado e adaptado antes da publicação.
  2. TOTVS. MVC.pdf. Material oficial anteriormente incorporado ao AdvPL Guia; consultar a documentação do release para assinaturas atuais.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR