Skip to content
mobius1qwe edited this page Nov 16, 2026 · 1 revision

Home > O cliente > LiveBindings 🚧

LiveBindings: o JSON de uma API em controles VCL e FMX

Important

Em desenvolvimento (2.0). Ainda não está numa versão lançada e pode mudar.

Vale para a 2.0 · só Delphi, XE3 em diante · Nível: básico

Em uma frase: o TRALJSONBindSourceAdapter transforma a lista JSON que uma API devolve em registros do LiveBindings: liga-se num TAdapterBindSource e, pelo designer de LiveBindings, numa grade, em campos de edição, rótulos, em VCL ou FMX, sem escrever código de cópia.

Você vai precisar: o pacote RALClientLiveBindingsPackage (componente TRALJSONBindSourceAdapter, paleta RAL - Client). No Lazarus não há LiveBindings: lá o caminho é o dataset do DBWare.

No formulário

  1. Solte um TRALClient (BaseURL da API) e um TRALJSONBindSourceAdapter: aponte Client e Route (por exemplo clientes).
  2. Em FieldDefs, liste os campos, um por linha: nome, idade:integer, saldo:float, ativo:boolean (sem tipo é texto). Assim eles aparecem no designer antes de haver dados.
  3. Solte um TAdapterBindSource e ponha o adaptador em Adapter.
  4. No designer de LiveBindings, ligue a grade e os campos ao AdapterBindSource1.
  5. Em tempo de execução:
RALJSONBindSourceAdapter1.Execute;          // GET Route, carrega e mostra
Memo1.Lines.Text := RALJSONBindSourceAdapter1.ToJSON;   // o JSON com as edições

O que ele aceita

  • Uma lista de objetos ([{...},{...}]), um objeto (vira um registro) ou um objeto com a lista dentro: RootPath := 'data.items'.
  • LoadFromJSON(texto) carrega de qualquer lugar, sem Client.
  • Sem FieldDefs, os campos saem dos dados: todo membro que aparece em algum registro, com o tipo dos valores (inteiro, real, booleano; texto quando misturam). Um membro que falta num registro aparece vazio.
  • Editar, incluir e apagar (pela grade ou pelo TBindNavigator) mudam o JSON guardado; ToJSON devolve o resultado para mandar de volta à API.

Erros comuns

Sintoma Causa Solução
o designer não mostra campos FieldDefs vazio e nada carregado ainda preencha FieldDefs
RootPath ... is not in the answer o caminho não existe no JSON confira o caminho com pontos (data.items)
... answered 404 no Execute a rota ou a BaseURL erradas confira Route e o TRALClient

Veja também

  • O cliente
  • Exemplos: Delphi/VCL/LiveBindings (XE3+) e Delphi/FMX/LiveBindings (10.2+)

Começar

Servidor

MQTT 🚧

E-mail 🚧

Chatbot 🚧

Cliente

Motores

Avançado

Ajuda

🚧 = em desenvolvimento, pode mudar

Clone this wiki locally