learnyounode 第十一关:编写 HTTP JSON API 服务器(http_json_api_server)实战指南

发布时间:2026/11/23 0:18:12

learnyounode 第十一关:编写 HTTP JSON API 服务器(http_json_api_server)实战指南 教程CLI【免费下载链接】learnyounodeLearn You The Node.js For Much Win! An intro to Node.js via a set of self-guided workshops.项目地址https://gitcode.com/gh_mirrors/le/learnyounode点击查看免费下载本篇技术指南围绕 learnyounode 交互式教程中的HTTP JSON API 服务器练习exercises/http_json_api_server展开讲解如何基于 Node.js 内置http、url与Date模块构建一个提供/api/parsetime与/api/unixtime两个 JSON 接口的服务器。读完本文你将掌握new URL()解析请求路径与查询参数、按路由分发请求、用JSON.stringify()输出 JSON 并正确设置Content-Type的完整套路并了解官方自动化验证器exercise.js与测试用例test/http_json_api_server/如何校验你的实现。练习目标两个 JSON 端点 命令行端口参数本练习要求你创建http-json-api-server.js文件编写一个 HTTP服务器server并在收到以下两种 GET 请求时返回 JSON 数据路径/api/parsetime请求的 query string 中包含键为iso、值为 ISO 格式时间的参数响应 JSON 只包含hour、minute、second三个属性。路径/api/unixtime接收相同的 query string但响应中的unixtime属性值是 UNIX epoch 时间即自 1970 年 1 月 1 日 00:00:00 UTC 起的毫秒数。服务器必须监听命令行第一个参数指定的端口。典型请求与响应示例如下请求 /api/parsetime?iso2013-08-10T12:10:15.474Z 响应 { hour: 14, minute: 23, second: 15 } 请求 /api/unixtime?iso2013-08-10T12:10:15.474Z 响应 { unixtime: 1376136615474 }动手前建议先浏览 Node 官方url模块文档仓库内已归档于 docs-nodejs/url.html它是解析 URL 与 query string 的核心工具。关键知识点拆解1. 用request.url做路由分发HTTP 服务器的request对象带有url属性它保存着本次请求的路径与查询字符串。你可以通过它来“路由”route请求到两个端点例如用正则^/api/parsetime、^/api/unixtime对req.url做前缀匹配见 官方参考实现。这种方式无需引入任何路由框架完全依赖 Node 核心模块即可完成。2. 用new URL(request.url)解析查询参数URL 需要传两个参数才能正确解析相对路径因此官方提示中给出了固定基址写法$ node -pe new URL(/test?q1, http://example.com)返回的 URL 对象包含searchParams等实用属性可通过new URL(request.url, http://example.com).searchParams.get(iso)直接取出iso参数值参考 参考实现。注意new URL()是 Node 的 WHATWG URL 实现非旧式url.parse()它天然支持searchParams.get()比手动拆分 query string 更安全、更简洁。3.Date对象ISO 字符串 ↔ 时间值双向转换解析把iso字符串直接传给Date构造函数即可得到对应时间对象const time new Date(isoString)。输出new Date().toISOString()可生成 ISO 格式字符串Date#getTime()返回自 1970-01-01 00:00:00 UTC 起的毫秒数正是/api/unixtime需要的数值。4.JSON.stringify() 正确的Content-Type响应的 body 必须是 JSON字符串因此需要JSON.stringify(result)序列化。同时要做“Web 世界的好公民”正确设置Content-Typeres.writeHead(200, { Content-Type: application/json })完整可运行的参考实现仓库提供的标准解法位于 exercises/http_json_api_server/solution/solution.js核心代码如下use strict const http require(http) function parsetime (time) { return { hour: time.getHours(), minute: time.getMinutes(), second: time.getSeconds() } } function unixtime (time) { return { unixtime: time.getTime() } } const server http.createServer(function (req, res) { const parsedUrl new URL(req.url, http://example.com) const time new Date(parsedUrl.searchParams.get(iso)) let result if (/^\/api\/parsetime/.test(req.url)) { result parsetime(time) } else if (/^\/api\/unixtime/.test(req.url)) { result unixtime(time) } if (result) { res.writeHead(200, { Content-Type: application/json }) res.end(JSON.stringify(result)) } else { res.writeHead(404) res.end() } }) server.listen(Number(process.argv[2]))实现要点解析端口参数server.listen(Number(process.argv[2]))将第一个命令行参数转换为数字并监听。对比测试文件中的process.argv[2] | 0写法见 test/http_json_api_server/valid_01.js两者都用于把参数强制转换为数值但Number()语义更直白。非法路由处理当两个端点都不匹配时返回404此时result为undefined。测试用例 test/http_json_api_server/invalid_01.js 甚至是一个空文件用于验证完全不实现时的失败行为而 invalid_02.js 与 invalid_03.js 分别把unixtime数值加 1、把hour加 1用于校验“数值不准确会被判错”的边界场景。getTime()是方法而非属性官方提示中写作Date#getTime()而unixtime函数里必须调用time.getTime()带括号不能误写成time.getTime否则返回的是函数体字符串而不是毫秒数。自动化验证机制exercise.js 如何判定对错本练习的判定逻辑封装在 exercises/http_json_api_server/exercise.js 中理解它有助于你自查实现是否符合验收标准并行启动验证器基于workshopper-exercise的execute处理器用spawn()并行运行你的提交文件与官方参考解法并通过rndport()见 lib/rndport.js端口范围 102465535 随机为两者分配相邻的随机端口submissionPort与submissionPort 1。延迟查询addProcessor中通过setTimeout(query.bind(this, mode), 500)等待 500ms确保两个服务器启动完成后才开始请求。请求两个端点query()用hyperquest.get()依次请求http://localhost:{port}/api/parsetime?iso...与/api/unixtime?iso...请求所用的iso时间戳为new Date(Date.now() - 100000)即当前时刻前 100 秒见 exercise.js。JSON 规范化后比对收到的响应经normalizeJSON()即JSON.stringify(JSON.parse(data))重新序列化后写入 stdout最终由comparestdout处理器与参考解法的输出逐字节比较——这解释了为什么属性顺序、多余空格不会导致误判但数值错误如 invalid 用例中“1”会被精确捕捉。因此只要你的服务器能对上述两个端点返回与官方解法语义一致数值精确的 JSON即可通过验证Content-Type与状态码虽不影响 stdout 比对但仍是良好实现的重要部分。验收命令与排错建议编写完http-json-api-server.js后在 learnyounode 交互界面中运行$ learnyounode verify http-json-api-server.js仓库中对应命令模板为{appname} verify http-json-api-server.js其中{appname}即learnyounode。除此之外你还可以用learnyounode run http-json-api-server.js直接启动程序然后手动测试$ node http-json-api-server.js 8000 $ curl http://localhost:8000/api/parsetime?iso2013-08-10T12:10:15.474Z $ curl http://localhost:8000/api/unixtime?iso2013-08-10T12:10:15.474Z常见踩坑点自查清单忘记Number()转换端口参数导致listen收到字符串对iso参数未做new Date(...)解析就直接调用getHours()误用Date#getTime缺括号导致返回函数体使用旧式url.parse()而忘记其在新版本 Node 中已被标记为 legacy API两个端点之外的路径未返回404可自行加上res.writeHead(404)以提升健壮性。小结通过本练习你将完整走通“Node HTTP 服务器 WHATWG URL 解析 Date 时间换算 JSON 序列化 Content-Type 设置”这条典型链路。这与 learnyounode 前序的 http_client、http_file_server 等练习一脉相承前者教你发起请求后者教你响应文件流而本练习则首次引入“按路径路由 返回结构化 JSON 数据”的 API 服务形态为后续编写真实后端接口打下坚实基础。赞分享教程CLI【免费下载链接】learnyounodeLearn You The Node.js For Much Win! An intro to Node.js via a set of self-guided workshops.项目地址https://gitcode.com/gh_mirrors/le/learnyounode点击查看免费下载相关推荐learnyounode 实战编写 HTTP JSON API 服务器http_json_api_server 通关指南learnyounode 实战编写 HTTP JSON API 服务器http_json_api_server 通关指南 本文以 learnyounode教程CLIOpenLogi Hook 跨平台输入捕获架构CGEventTap、evdevuinput 与 WH_MOUSE_LL 的实现与冻结防护OpenLogi Hook 跨平台输入捕获架构CGEventTap、evdevuinput 与 WH_MOUSE_LL 的实现与冻结防护 导读 openlo教程CLImypy 错误码Error Code体系完全指南从 type: ignore[code] 到按模块细粒度控制mypy 错误码Error Code体系完全指南从 type: ignore code 到按模块细粒度控制 mypyOptional static ty教程CLI上一篇RAFT-stereo与ONNXCPU/GPU推理实现与性能对比完整指南下一篇EMO-2B完整使用指南从基础对话到高级情感支持技巧创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/20 1:59:57

【GitHub项目实战】DINet 实现音频驱动的数字人口型同步

视频对口型生成技术已成为数字人内容合成中的关键环节。DINet 项目以逐步细化的生成架构和同步感知训练策略,在口型同步度与视觉真实感之间找到良好平衡,适用于低资源环境下的高质量人脸驱动场景。 围绕 DINet 的完整训练与推理流程,本文解析其环境搭建、数据预处理、模型训…

2026/11/20 4:09:32

【GitHub项目实战】GOTURN 实现深度学习目标跟踪

GOTURN,即“Generic Object Tracking Using Regression Networks”,是一种突破传统对象跟踪模式的深度学习算法。不同于需在线更新的跟踪方法,GOTURN通过在离线状态下预先学习对象的运动特征,实现了对视频目标的高效跟踪。其核心在于使用卷积神经网络(CNN)训练模型以预测…

2026/11/20 6:06:59

【GitHub项目实战】ChatGLM-6B 搭建双语对话应用

深度学习和自然语言处理的领域中,硬件环境和模型配置直接决定了项目的成功与否。特别是当涉及到大规模预训练模型的运行时,合理地管理和使用系统资源尤为关键。本项目的设置与配置旨在帮助开发者快速构建一个能够高效运行的ChatGLM模型环境,尤其是在利用GPU进行推理和训练的…

2026/11/23 0:16:46

衡阳去哪里考电工证全国通用,别等上岗才慌

衡阳去哪里考电工证全国通用,别等上岗才慌 现在找工作越来越难,但你要是连特种作业操作证都还没拿到,那基本就别想进工地、工厂或者电力相关单位了。衡阳去哪里考电工证?很多人一上手就懵了,不知道流程、不知道哪里靠谱、甚至不知道这证是不是全国通用。…

2026/11/23 0:16:46

类似电工证的还有哪些含金量高的证书?别交完培训费考不过

类似电工证的还有哪些含金量高的证书?别交完培训费考不过 怕考不过白交培训费?你不是一个人。特种作业证考试,尤其是像电工证这类“硬通货”,很多人都在担心费钱费力却拿不到证。今天就从 类似电工证的还有哪些 这个角度出发,带你了解 含金量…

2026/11/23 0:16:46

_大学电工证最新政策解读

大学电工证千万别踩坑,跨省转证怎么操作全在这儿 之前考的证在外省能不能转过来?这是很多在外地打工、在洛阳涧西区中小施工企业上班的朋友们最头疼的问题。尤其是拿着大学电工证的小伙伴,很多人都不知道这张证到底能不能在别的省使用,流程又复杂不复杂。…

2026/11/23 0:16:46

陕西特种电工证怎么考最靠谱?全国通用证书报考避坑指南

陕西特种电工证怎么考最靠谱?全国通用证书报考避坑指南 不知道去哪报名怕被中介坑?陕西特种电工证考试报名流程复杂、真假难辨,很多考生一不小心就踩坑,花冤枉钱还拿不到全国通用的证书。今天就从陕西水利系统电工的实际需求出发,详细讲清楚陕西特种电工…

2026/11/23 0:11:45

耒阳市电工证假的怎么查?2026河南最新政策别踩坑

耒阳市电工证假的怎么查?2026河南最新政策别踩坑 实操考试心里没底怕挂科?2026河南最新政策已经明确,电工证办理流程和考试要求有重大变化,很多人因为信息不对称,误信虚假证书,耽误了工作和职业发展。今天就从漯河房建工程从业者的角度,告诉你…

2026/11/22 0:09:40

高压电工证还能年审吗良心建议来了,学历不高也能考!

高压电工证还能年审吗良心建议来了,学历不高也能考! 你是不是也担心,自己学历不高,根本报不上高压电工证?其实不然,现在政策已经非常明确, 高压电工证还能年审 ,而且只要符合条件, 学历不是门槛 , 良心建议…

2026/11/22 0:09:40

吴江的电工证免费培训怎么报名?官方报名入口全解析

吴江的电工证免费培训怎么报名?官方报名入口全解析 你急需特种作业证才能上岗找工作,但不知道从哪里下手?别急,现在就给你讲明白【吴江的电工证免费培训】到底怎么操作,以及怎么通过 官方报名入口…

2026/11/22 0:09:40

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱 不知道去哪报名怕被中介坑?这几乎是每个需要办理或复审电工证的人的真实经历。尤其在肃州区,信息不透明、流程复杂、中介收费高又不靠谱,让很多电工从业者感到头疼。作为一个在应急管理和特种作…

2026/11/23 0:01:38

南宁哪里可以学电工证值不值得考?怕被中介坑?看这篇就够了

南宁哪里可以学电工证值不值得考?怕被中介坑?看这篇就够了 不知道去哪报名怕被中介坑?南宁哪里可以学电工证值不值得考?这是很多想考电工证的朋友最关心的问题。现实中,不少人在选择培训机构时被各种五花八门的广告信息搞得晕头转向,甚至被坑了钱还没拿…

2026/11/23 0:01:38

建设局特种工证怎么查全国通用的复审流程

建设局特种工证怎么查全国通用的复审流程 证书过期了不知道怎么复审延期,这是很多特种作业从业者常遇到的问题。尤其是在洛阳涧西区从事水利工程工作的你,特种作业操作证不仅是上岗的“通行证”,更是保障安全作业的法律底线。如果操作证过期了,不仅影响工…

2026/11/23 0:01:38

电工证跨考政策值不值得考?学历不高也能考的真相

电工证跨考政策值不值得考?学历不高也能考的真相 你是不是也觉得学历不够,报电工证怕被拒?别急,国家安全生产考试网明文规定, 电工证跨考政策 对学历门槛没有硬性限制,只要你年满18岁,身体健康,能通过实操考试,就能报考。关键是, 值不值得考…

2026/11/22 9:39:14

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/22 5:39:03

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑