HTMX Engine Server

TsgcHTMX_Engine_Server — gère les requêtes de mise à jour partielle htmx via HTTP et diffuse en direct des fragments out-of-band à tous les navigateurs connectés via WebSocket.

En un coup d'œil

TsgcHTMX_Engine_Server

Relie les mises à jour partielles pilotées par HTTP de htmx au server-push WebSocket. Les requêtes htmx entrantes sont envoyées à OnHTMXRequest ; votre gestionnaire retourne uniquement le fragment à insérer. Appelez BroadcastFragment à tout moment pour pousser des mises à jour out-of-band en direct vers tous les navigateurs connectés.

Classe du composant

TsgcHTMX_Engine_Server

Rôle

Échanges htmx et server push en direct

Famille

Infrastructure & Moteur

Langages

Delphi, C++ Builder, .NET

Démarrage rapide

Gérer les requêtes htmx et pousser des fragments en direct

Reliez le moteur à votre serveur WebSocket, gérez les requêtes de mise à jour partielle dans OnHTMXRequest et appelez BroadcastFragment pour pousser des mises à jour vers tous les navigateurs connectés.

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>");

Référence

Propriétés et méthodes clés

Les membres les plus fréquemment utilisés.

Server

Le TsgcWSHTTPServer auquel ce moteur s'attache ; gère à la fois les requêtes HTTP de mise à jour partielle et le push WebSocket.

OnHTMXRequest

Événement déclenché pour chaque requête HTTP initiée par htmx ; votre gestionnaire retourne uniquement le fragment HTML à insérer.

BroadcastFragment

Envoie un payload htmx out-of-band à tous les clients WebSocket actuellement connectés simultanément.

HandleRequest

Appelé par le serveur hôte pour chaque requête ; identifie les en-têtes htmx et achemine vers OnHTMXRequest ou laisse passer.

hx-swap-oob

Attribut d'échange out-of-band de htmx : l'id du fragment doit correspondre à l'id de l'élément cible sur la page.

Sécurité des threads

BroadcastFragment est thread-safe ; appelez-le depuis des minuteries en arrière-plan, des threads de push ou des gestionnaires d'événements sans verrouillage.

Ressources

Continuer à explorer

	Aide en ligneRéférence API complète et guide d'utilisation pour ce composant.	Ouvrir
	Tous les composants sgcHTMLParcourez la matrice complète de 60+ composants.	Ouvrir
	Télécharger l'essai gratuitL'essai de 30 jours inclut les projets de démonstration 60.HTML.	Ouvrir
	TarifsLicences Single, Team et Site avec code source complet.	Ouvrir