HTMX Engine Server

TsgcHTMX_Engine_Server — processa requisições htmx de troca parcial de página via HTTP e transmite fragmentos out-of-band ao vivo para todos os navegadores conectados via WebSocket.

Visão geral

TsgcHTMX_Engine_Server

Integra as atualizações parciais orientadas a HTTP do htmx com o envio server-push via WebSocket. As requisições htmx recebidas são despachadas para OnHTMXRequest; seu manipulador retorna apenas o fragmento a ser substituído. Chame BroadcastFragment a qualquer momento para enviar atualizações out-of-band ao vivo para todos os navegadores conectados.

Classe do componente

TsgcHTMX_Engine_Server

Função

Trocas htmx + envio ao vivo pelo servidor

Família

Infraestrutura & Motor

Linguagens

Delphi, C++ Builder, .NET

Início rápido

Processe requisições htmx e envie fragmentos ao vivo

Conecte o motor ao seu servidor WebSocket, processe as requisições de troca parcial em OnHTMXRequest e chame BroadcastFragment para enviar atualizações a todos os navegadores conectados.

uses
  sgcHTMX_Engine_Server;

var
  oHTMX: TsgcHTMX_Engine_Server;
begin
  oHTMX := TsgcHTMX_Engine_Server.Create(nil);
  oHTMX.Server         := WSSServer;
  oHTMX.OnHTMXRequest  := HandleHTMXRequest;

  // later, from any thread, push a KPI update:
  oHTMX.BroadcastFragment(
    '<div id="kpi-revenue" hx-swap-oob="true">' +
    CurrToStr(FRevenue) + '</div>');
end;

TsgcHTMX_Engine_Server *oHTMX = new TsgcHTMX_Engine_Server(NULL);
oHTMX->Server        = WSSServer;
oHTMX->OnHTMXRequest = HandleHTMXRequest;

// push a live update:
oHTMX->BroadcastFragment(
  "<div id=\"kpi-revenue\" hx-swap-oob=\"true\">" +
  CurrToStr(FRevenue) + "</div>");

var htmx = new TsgcHTMX_Engine_Server();
htmx.Server        = wssServer;
htmx.OnHTMXRequest += HandleHTMXRequest;

// push a live update:
htmx.BroadcastFragment(
    "<div id=\"kpi-revenue\" hx-swap-oob=\"true\">" +
    revenue.ToString("N0") + "</div>");

Referência

Propriedades e métodos principais

Os membros usados com mais frequência.

Server

O TsgcWSHTTPServer ao qual este motor se conecta; processa tanto as requisições HTTP de troca parcial quanto o envio via WebSocket.

OnHTMXRequest

Evento disparado para cada requisição HTTP acionada pelo htmx; seu manipulador retorna apenas o HTML do fragmento a ser substituído.

BroadcastFragment

Envia um payload htmx out-of-band para todos os clientes WebSocket conectados simultaneamente.

HandleRequest

Chamado pelo servidor hospedeiro para cada requisição; identifica os cabeçalhos htmx e encaminha para OnHTMXRequest ou repassa adiante.

hx-swap-oob

Atributo de troca out-of-band do htmx: o id do fragmento deve corresponder ao id do elemento alvo na página.

Segurança de thread

BroadcastFragment é thread-safe; chame-o a partir de timers em segundo plano, threads de envio ou manipuladores de eventos sem necessidade de bloqueio.

Recursos

Continue explorando

	Ajuda onlineReferência completa da API e guia de uso para este componente.	Abrir
	Todos os componentes sgcHTMLNavegue pela matriz completa de 60+ componentes.	Abrir
	Baixar versão de avaliação gratuitaA versão de avaliação de 30 dias inclui os projetos de demonstração 60.HTML.	Abrir
	PreçosLicenças Single, Team e Site com código-fonte completo.	Abrir