使用 sgcHTML 进行 Delphi Web 开发
无需离开 IDE 的 Delphi Web 开发:用现成的服务器端组件,以 Object Pascal 构建完整的 Delphi Web 应用程序,无需编写 JavaScript。
无需离开 IDE 的 Delphi Web 开发:用现成的服务器端组件,以 Object Pascal 构建完整的 Delphi Web 应用程序,无需编写 JavaScript。
sgcHTML 是一个 Delphi Web 框架和 HTML 组件库。您的 Delphi 可执行文件就是 Web 服务器,每个页面都由服务器上的组件构建,浏览器接收的是纯 HTML。您编写 Object Pascal,由 sgcHTML 生成 HTML、CSS 和 JavaScript。
在窗体上放置 TsgcHTTPServer、TsgcHTMLDesignServer、TsgcHTMLDesignSurface 以及 TsgcHTMLComponent_Panel 等组件,在对象检查器中设置其属性并运行。点击和提交会在界面动作的 OnExecute 事件中运行 Delphi 代码。
创建一个 TsgcHTMLComponent_Site,添加菜单和分区,然后读取其 HTML 属性。如需完全控制标记,可深入到节点层:TsgcHTMLCard、TsgcHTMLForm、TsgcHTMLTable 等。
图表、网格、表单、仪表板、聊天等,分为十个系列。Grid、DataTable、Chart、Select、TreeView、Scheduler、Timeline 和 Form 可通过 LoadFromDataSet 或 DataSource 直接绑定到 TDataSet。
点击、表单提交和实时更新通过 htmx 往返于您的 Delphi 事件处理程序,服务器就地替换 HTML 片段。您无需 JavaScript 构建链,就能获得单页应用程序的体验。
PushFragment 和 BroadcastFragment 会向已连接的浏览器发送实时 HTML,因此仪表板、监视器和聊天窗口会在数据变化的瞬间更新。
每个组件都输出响应式 Bootstrap 5 标记,并通过 TsgcHTMLThemeController 支持浅色和深色主题。选择阿拉伯语或希伯来语,整个布局就会变为从右到左。
Delphi Web 应用程序通常需要以下三项中的一项或多项:供用户在浏览器中使用的页面、供其他程序调用的 API,以及实时更新。每一项都有各自的 eSeGeCe 组件包。
服务器由组件构建每个页面,浏览器接收 HTML。点击和表单提交时,htmx 就地替换片段,页面在进程内直接读取数据库,因此中间没有 REST 层。最适合使用者通过浏览器工作的应用程序。
sgcHTML →TsgcHTTPRESTServer 是一个 REST API 服务器,具备 CORS 处理,并可按需附加请求统计、多租户和本地用户存储。其 OpenAPI 引擎可直接根据规范提供 API,也可根据带特性标注的 Delphi 类生成规范。sgcHTTP 还增加了带 FastCGI / SCGI 网关的 HTTP 服务器,以及 HTTP/2 和 gRPC 客户端组件。
适用于 Delphi、C++ Builder、Lazarus 和 .NET 的 WebSocket 与实时通信,完全符合 RFC 6455。独立的 sgcHTML 通过服务器发送事件推送实时更新。使用 sgcWebSockets Professional、Enterprise 或 All-Access 时,sgcHTML 从 TsgcWebSocketHTTPServer 提供页面,并同样通过 WebSocket 推送更新。
这些选项可以组合使用。使用 sgcWebSockets Professional、Enterprise 或 All-Access 时,您还可以从 DataSnap 服务器提供 sgcHTML 页面,并在与 REST 端点相同的端口上进行实时 WebSocket 推送。请参阅 WebBroker 和 DataSnap 上的 sgcHTML。
启动 HTTP 服务器,在每次请求时用站点组件构建页面,并发送其 HTML。整个程序就是这样。
uses
SysUtils, Classes,
IdContext, IdCustomHTTPServer, // sgcIdContext, sgcIdCustomHTTPServer on the custom Indy build
// sgc
sgcHTTP_Server, sgcHTML_Component_Site;
procedure TForm1.FormCreate(Sender: TObject);
begin
FServer := TsgcHTTPServer.Create(nil);
FServer.Port := 8080;
FServer.OnCommandGet := HandleGet;
FServer.Active := True;
end;
procedure TForm1.HandleGet(AContext: TIdContext;
ARequestInfo: TIdHTTPRequestInfo; AResponseInfo: TIdHTTPResponseInfo);
var
oSite: TsgcHTMLComponent_Site;
begin
oSite := TsgcHTMLComponent_Site.Create(nil);
try
oSite.Title := 'My Delphi Web App';
oSite.Layout := slSidebarLeft;
oSite.AddMenu('Dashboard', '/');
oSite.AddMenu('Customers', '/?page=customers');
oSite.AddSection('Welcome', '<p>Served from Delphi.</p>');
AResponseInfo.ResponseNo := 200;
AResponseInfo.ContentType := 'text/html; charset=utf-8';
AResponseInfo.ContentText := oSite.HTML; // reading HTML runs the render
finally
oSite.Free;
end;
end;
Layout 还支持 slSidebarRight、slTopNav、slTopNavSidebarLeft、slIconRail 或 slOffcanvas。该模式来自随产品提供的演示 Demos\60.HTML\01.RunTime\07.Site,sgcHTML 快速入门会连同基于窗体的设计器一起逐步讲解。
sgcHTML 是使用标准 HTTP 的服务器端库,因此相同的页面可以以多种形式部署。
在您的应用程序内,通过内置的 TsgcHTTPServer 提供页面。sgcHTML ERP 演示是一个 7.7 MB 的 Delphi 可执行文件,旁边没有任何 DLL,基于 SQLite 提供完整的 Web ERP。
sgcHTML 页面可以通过独立的 TIdHTTPWebBrokerBridge、ISAPI 模块、Apache 模块、CGI 可执行文件或 HTTP.sys 桥接服务器提供。在普通的 WebBroker、CGI 或 ISAPI 下没有 WebSocket 推送。WebBroker 托管 →
由于 sgcHTML 使用标准 HTTP,新旧服务器可以在同一个反向代理之后并行运行,让您一次迁移一个页面。
您的服务器可运行于 Windows、macOS 或 Linux,并附带一个已在 Linux 上运行过的 ERP 演示。手机和平板电脑通过网络接收纯 HTML,因此 Android 和 iOS 是客户端,而不是构建目标。
| 目标 | 详情 |
|---|---|
| Delphi 7 至 13 | Delphi 7、2007、2009、2010、XE 至 XE8、10 Seattle 至 10.4 Sydney、11 Alexandria、12 Athens 和 13 Florence。 |
| C++ Builder | 对应版本的 C++ Builder。 |
| Lazarus | 通过 .lpk 包提供支持。 |
| 服务器 | Windows、macOS 和 Linux。 |
| .NET | .NET 8、.NET 9、.NET 10 和 .NET Standard 2.0,支持 ASP.NET Core Razor Tag Helpers,以 sgcHTML .NET 名称销售。 |
| 浏览器 | 内嵌 Bootstrap 5 和 htmx 资源。运行时无需 CDN。 |
sgcHTML 包含完整源代码和 1 年更新,按开发者授权,起价 €299,并作为独立组件包提供,内含 sgcWebSockets Core 运行时。请参阅 sgcHTML 价格以及 eSeGeCe 的其他 Delphi 组件。
可以。使用 sgcHTML,您的 Delphi 可执行文件就是 Web 服务器:每个页面都由服务器上的组件以 Object Pascal 构建,浏览器接收以 Bootstrap 5 渲染样式的纯 HTML。点击和表单提交通过 htmx 运行您的 Delphi 事件处理程序,实时更新则推送到浏览器。您可以继续使用 RAD Studio、数据模块和 TDataSet 逻辑。
安装 sgcHTML,然后在 VCL 窗体上设计页面,或用代码构建。在窗体上,放置 TsgcHTTPServer、TsgcHTMLDesignServer、TsgcHTMLDesignSurface 以及 TsgcHTMLComponent_Panel 等组件,在对象检查器中设置其属性并激活服务器。在代码中,创建一个 TsgcHTMLComponent_Site,添加菜单和分区,并提供其 HTML 属性,如上面的示例所示。快速入门以及试用版中的六个 QuickStart 演示对两种方式都有讲解。
不需要。sgcHTML 输出 Bootstrap 5 标记和 htmx 属性,而 htmx 正是让按钮回传并替换页面局部而无需刷新的关键。您用 Pascal 描述交互,属性由系统自动生成。Bootstrap 5 和 htmx 已内嵌,因此运行时无需 CDN。如果需要,您仍可通过 CustomHead 和 BodyEndHTML 添加自己的脚本。
这取决于您要构建什么。如果需要完全用 Object Pascal 编写 Web UI,带有现成组件、TDataSet 数据绑定、实时推送且无需 JavaScript 构建步骤,sgcHTML 正是为此而生。如果您的前端是只需要 API 的独立客户端,则 sgcREST 这样的 REST 服务器更合适。最简单的检验方法是下载试用版,为您自己的应用程序构建一个界面。
可以。sgcHTML 服务器可运行于 Windows、macOS 或 Linux,并附带一个已在 Linux 上运行过的 ERP 演示。浏览器只接收 HTML,因此手机和平板电脑可在浏览器中使用同一个应用程序。
有。sgcHTML 在十个系列中提供 110 个组件,包括图表、网格、表单、仪表板和聊天等。Grid、DataTable、Chart、Select、TreeView、Scheduler、Timeline 和 Form 可通过 LoadFromDataSet 或 DataSource 直接绑定到 TDataSet。功能矩阵列出了每个组件。
Delphi 7 至 13,从 Delphi 7 和 2007 到 11 Alexandria、12 Athens 和 13 Florence,C++ Builder 提供对应版本。同样支持 Lazarus。