使用 HTMX 和 Bun 进行全栈 Web 开发

2024-04-06 16:52

本文主要是介绍使用 HTMX 和 Bun 进行全栈 Web 开发,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

将 HTMX 放在前端,Bun 放在后端,然后将它们与 Elysia 和 MongoDB 连接起来,形成快速便捷的技术栈,使开发 Web 应用程序变得轻而易举。

Bun 和 HTMX 是目前软件领域最有趣的两个事情。 Bun 是一个速度极快的一体化服务器端 JavaScript 平台,而 HTMX 是一种 HTML 扩展,用于创建简单而强大的界面。在本文中,我们将使用这两个出色的工具来开发一个全栈应用程序,该应用程序使用 MongoDB 进行数据存储,并使用 Elysia 作为其 HTTP 服务器。

技术栈

本文的重点是技术栈的四个主要组成部分如何相互作用。这四个组成部分分别是 Bun、HTMX、Elysia 和 MongoDB。这种架构提供了一个快速部署的设置,易于配置并且灵活变化。

  • Bun 是一个 JavaScript 运行时、打包器、包管理器和测试运行器
  • Elysia 是一个高性能 HTTP 服务器,基于 Bun 构建
  • HTMX 提供了一种向 HTML 添加细粒度交互性的新颖方法
  • MongoDB 是旗舰级 NoSQL 面向文档的数据存储

请注意,本文有两个部分。后续我们将合并 Pug、HTMX 模板引擎,用它来开发一些奇特的前端交互。

安装和设置

您需要安装 Bun.js,这很容易做到。我们还将在我们的开发机器上将 MongoDB 作为服务与 Bun 一起运行。安装这些软件包后,bun -vmongod -version 命令都可以在命令行中运行。

接下来,让我们开始一个新项目:

bun create elysia iw-beh

这告诉 bun 使用 Elysia 模板创建一个新项目。 Bun 中的模板是使用 create 命令快速启动项目的便捷方法。Bun 可以像 Node.js 一样工作,无需任何配置。

现在,进入新目录 cd iw-beh,并按原样运行项目 bun run src/index.js

最后一个命令告诉 bun 运行 src/index.js 文件。src/index.js 文件是启动 Elysia 服务器的代码:

import { Elysia } from "elysia";const app = new Elysia().get("/", () => "Hello Elysia").listen(3000);console.log(`🦊 Elysia is running at ${app.server?.hostname}:${app.server?.port}`
);

在此文件中,我们导入 Elysia 并使用它实例化一个新服务器,该服务器侦听端口 3000 并在根目录下有一个 GET 端点。该端点返回一个文本字符串「Hello Elysia」,其工作原理与 Express 的相似。如果您访问 localhost:3000,您会收到一条简单的问候语。

现在我们已经运行了 Elysia,让我们添加 static 插件。 Elysia 有几个用于处理常见场景的插件。在本例中,我们希望从磁盘提供一些 HTML。 static 插件正是我们所需要的:

bun add @elysiajs/static

现在,运行 static 插件的 Elysia 服务器应该提供 iw-beh/public 目录中的所有内容。如果我们在其中放置一个简单的 HTML 文件并访问 localhost:3000/public,我们将看到它的内容。

HTMX 的魔力

接下来,让我们向 index.html 添加一个 HTMX 页面。这是 HTMX 主页上的一个简单示例:

<script src="https://unpkg.com/htmx.org@1.9.10"></script><button hx-post="/clicked"hx-trigger="click"hx-target="#parent-div"hx-swap="outerHTML">Click Me!
</button>

该页面显示一个按钮。单击时,该按钮将调用 /clicked 服务器,并且该按钮将替换为响应中的任何内容。那里还什么都没有,所以目前它什么也没做。

但请注意,所有这些仍然是 HTML。我们正在进行 API 调用并执行细粒度的 DOM 更改,而无需任何 JavaScript。这项工作是由我们刚刚导入的 htmx.org 库中的 JavaScript 完成的,但重点是我们不必担心它。

HTMX 提供了一种 HTML 语法,只需使用三个元素属性即可完成这些操作:

  • hx-post 在 AJAX 请求触发时提交帖子
  • hx-target 告诉 hx-post 哪些事件执行 AJAX 请求
  • hx-swap 表示 AJAX 事件发生时要做什么

Elysia 和 MongoDB

现在让我们在 Elysia 中创建一个端点,它将向 MongoDB 写入一些内容。首先我们将为 Bun 添加 MongoDB 驱动程序:bun add mongodb

接下来,像这样修改 src/index.ts

import { Elysia } from 'elysia'
import { staticPlugin } from '@elysiajs/static'
const { MongoClient } = require('mongodb')const app = new Elysia().get('/', () => 'Hello Elysia').get('/db', async () => {const url ='mongodb://127.0.0.1:27017/quote?directConnection=true&serverSelectionTimeoutMS=2000&appName=mongosh+1.8.0'const client = new MongoClient(url, { useUnifiedTopology: true })try {await client.connect()const database = client.db('quote')const collection = database.collection('quotes')const stringData = 'Thought is the grandchild of ignorance.'const result = await collection.insertOne({ quote: stringData })console.log(`String inserted with ID: ${result.insertedId}`)} catch (error) {console.error(error)} finally {await client.close()}return 'OK'}).use(staticPlugin()).listen(3000)console.log(`🦊 Elysia is running at ${app.server?.hostname}:${app.server?.port}`,
)

在这段代码中,我们添加了一个 /db 端点,它与 MongoDB 通信。现在它只是将一条引用写入到 quote 数据库中的 quotes 集合内。您可以直接通过访问 localhost:3000/db 来测试这一点。然后您可以验证数据是否已存储在 MongoDB 中:

$ mongoshtest> use quote
switched to db quote
quote> db.quotes.find()
[{_id: ObjectId("65ba936fd59e9c265cc8c092"),quote: 'Thought is the grandchild of ignorance.',author: 'Swami Venkatesananda'}
]

创建 HTMX 表格

现在我们从前端连接到数据库,让我们创建一个表来输出现有的报价。作为快速测试,我们将向服务器添加一个端点:

.get("/quotes", async () => {const data = [{ name: 'Alice' }, { name: 'Bob' }]let html = '<ul>'for (const item of data) {html += `<li>${item.name}</li>`}html += '</ul>'return html
})

然后在我们的 index.html 中使用它:

<ul id="data-list"></ul>
<button hx-get="/quotes" hx-target="#data-list">Load Data</button>

现在,当您加载 /public/index.html 并单击按钮时,就会显示从服务器发送的列表。从端点发出 HTML 与常见的 JSON 模式不同。我们在这里遵守 RESTful 原则,HTMX 有用于处理 JSON 端点的插件,但这更习惯使用。

在我们的端点中,我们只是手动创建 HTML。在真实的应用程序中,我们可能会使用某种 JavaScript 框架来使事情更易于管理。

现在,我们可以从数据库中检索数据:

.get("/quotes", async () => {const url ='mongodb://127.0.0.1:27017/quote?directConnection=true&serverSelectionTimeoutMS=2000&appName=mongosh+1.8.0'const client = new MongoClient(url, { useUnifiedTopology: true })try {await client.connect()const database = client.db('quote')const collection = database.collection('quotes')const quotes = await collection.find().toArray()// Build the HTML table structurelet html = '<table border="1">'html += '<tr><th>Quote</th><th>Author</th></tr>'for (const quote of quotes) {html += `<tr><td>${quote.quote}</td><td>${quote.author}</td></tr>`}html += '</table>'return html} catch (error) {console.error(error)return 'Error fetching quotes'} finally {await client.close()}
})

在此端点中,我们检索数据库中所有现有的报价并将它们作为简单的 HTML 表返回。在实际应用程序中,我们会将数据库连接工作提取到一个中心位置。

如果您查看到目前为止应用程序的服务器和客户端,您会发现我们只做了最少的工作。HTMX 在这里简化的最重要的事情是提交表单。hx-post 属性取代了从表单中取出数据、将其编组为 JSON 并使用 fetch() 或类似内容提交的所有工作。

总结

随着事情变得越来越复杂,我们开始不得不依赖客户端中的 JavaScript,即使使用 HTMX。例如,内联行编辑。我们可能希望使用 JavaScript 执行的某些操作(例如将新行直接插入表中)可以通过 HTMX 交换来完成。HTMX 允许您使用简单的语法做很多事情,然后在必要时回退到 JavaScript。

最大的心理变化是从服务器生成 HTMX。您可以选择多种 HTML 或 JavaScript 模板引擎,使这一切变得更加容易。一旦我们习惯使用 HTMX,一切都会变得轻而易举。本质上我们已经从技术栈中消除了整个 JSON 转换层。

我们刚刚通过组合 Bun、Elysia、HTMX 和 MongoDB 进行了简单的演示模版,但您至少应该对这个技术栈有一个感觉,这些组件可以很好地协同工作。Bun、Elysia 和 MongoDB 安静地完成自己的工作,而如果您更习惯 JSON API,则 HTMX 需要多考虑一下。

这篇关于使用 HTMX 和 Bun 进行全栈 Web 开发的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/880360

相关文章

vue使用docxtemplater导出word

《vue使用docxtemplater导出word》docxtemplater是一种邮件合并工具,以编程方式使用并处理条件、循环,并且可以扩展以插入任何内容,下面我们来看看如何使用docxtempl... 目录docxtemplatervue使用docxtemplater导出word安装常用语法 封装导出方

Linux换行符的使用方法详解

《Linux换行符的使用方法详解》本文介绍了Linux中常用的换行符LF及其在文件中的表示,展示了如何使用sed命令替换换行符,并列举了与换行符处理相关的Linux命令,通过代码讲解的非常详细,需要的... 目录简介检测文件中的换行符使用 cat -A 查看换行符使用 od -c 检查字符换行符格式转换将

使用Jackson进行JSON生成与解析的新手指南

《使用Jackson进行JSON生成与解析的新手指南》这篇文章主要为大家详细介绍了如何使用Jackson进行JSON生成与解析处理,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1. 核心依赖2. 基础用法2.1 对象转 jsON(序列化)2.2 JSON 转对象(反序列化)3.

使用Python实现快速搭建本地HTTP服务器

《使用Python实现快速搭建本地HTTP服务器》:本文主要介绍如何使用Python快速搭建本地HTTP服务器,轻松实现一键HTTP文件共享,同时结合二维码技术,让访问更简单,感兴趣的小伙伴可以了... 目录1. 概述2. 快速搭建 HTTP 文件共享服务2.1 核心思路2.2 代码实现2.3 代码解读3.

Elasticsearch 在 Java 中的使用教程

《Elasticsearch在Java中的使用教程》Elasticsearch是一个分布式搜索和分析引擎,基于ApacheLucene构建,能够实现实时数据的存储、搜索、和分析,它广泛应用于全文... 目录1. Elasticsearch 简介2. 环境准备2.1 安装 Elasticsearch2.2 J

使用C#代码在PDF文档中添加、删除和替换图片

《使用C#代码在PDF文档中添加、删除和替换图片》在当今数字化文档处理场景中,动态操作PDF文档中的图像已成为企业级应用开发的核心需求之一,本文将介绍如何在.NET平台使用C#代码在PDF文档中添加、... 目录引言用C#添加图片到PDF文档用C#删除PDF文档中的图片用C#替换PDF文档中的图片引言在当

Java中List的contains()方法的使用小结

《Java中List的contains()方法的使用小结》List的contains()方法用于检查列表中是否包含指定的元素,借助equals()方法进行判断,下面就来介绍Java中List的c... 目录详细展开1. 方法签名2. 工作原理3. 使用示例4. 注意事项总结结论:List 的 contain

C#使用SQLite进行大数据量高效处理的代码示例

《C#使用SQLite进行大数据量高效处理的代码示例》在软件开发中,高效处理大数据量是一个常见且具有挑战性的任务,SQLite因其零配置、嵌入式、跨平台的特性,成为许多开发者的首选数据库,本文将深入探... 目录前言准备工作数据实体核心技术批量插入:从乌龟到猎豹的蜕变分页查询:加载百万数据异步处理:拒绝界面

Android中Dialog的使用详解

《Android中Dialog的使用详解》Dialog(对话框)是Android中常用的UI组件,用于临时显示重要信息或获取用户输入,本文给大家介绍Android中Dialog的使用,感兴趣的朋友一起... 目录android中Dialog的使用详解1. 基本Dialog类型1.1 AlertDialog(

Python使用自带的base64库进行base64编码和解码

《Python使用自带的base64库进行base64编码和解码》在Python中,处理数据的编码和解码是数据传输和存储中非常普遍的需求,其中,Base64是一种常用的编码方案,本文我将详细介绍如何使... 目录引言使用python的base64库进行编码和解码编码函数解码函数Base64编码的应用场景注意