Maison > Article > interface Web > Parlons de la façon de créer un serveur HTTP simple à l'aide de Node.js
Comment créer un serveur HTTP avec NodeJS ? L'article suivant vous présentera comment utiliser Node pour créer un simple serveur HTTP. J'espère qu'il vous sera utile !
node.js
node.js
基于Chrome
的v8
引擎运行js
代码,因此我们可以摆脱浏览器环境,直接在控制台中运行js
代码,比如下面这个hello world
代码
console.log('hello world');
控制台中直接使用node
即可运行
node.js
的内置模块http
提供了基本的http
服务的能力,基于CommonJS
规范,我们可以使用require
导入http
模块进行使用http
模块中有一个createServer
函数能够让我们创建一个http
服务器
其接收一个回调函数作为参数,这个回调函数接收两个参数 -- request
和response
request
包括所有客户端请求的信息,比如url
、请求头header
、请求方式和请求体等response
主要用于返回信息给客户端,封装了一些操作响应体相关的操作,比如response.writeHead
方法就可以让我们自定义返回体的头部信息和状态码当我们将响应体处理好了之后,调用response.end()
方法就可以将响应体发送给客户端
使用createServer
函数只是帮我们创建了一个Server
对象,并没有让其开启监听,我们还需要调用server
对象的listen
方法才可以进行监听,真正作为一个服务器开始运行
listen
方法的第一个参数是监听的端口号,第二个参数则是绑定的主机ip
,第三个参数是一个回调函数,会被http
模块异步调用,当遇到错误的时候,就能够在这个回调函数的第一个参数中获取到抛出的异常 ,我们可以选择对异常进行处理,让我们的服务器更加健壮下面是使用http
模块创建一个简单服务器的例子
const { createServer } = require('http'); const HOST = 'localhost'; const PORT = '8080'; const server = createServer((req, resp) => { // the first param is status code it returns // and the second param is response header info resp.writeHead(200, { 'Content-Type': 'text/plain' }); console.log('server is working...'); // call end method to tell server that the request has been fulfilled resp.end('hello nodejs http server'); }); server.listen(PORT, HOST, (error) => { if (error) { console.log('Something wrong: ', error); return; } console.log(`server is listening on http://${HOST}:${PORT} ...`); });
可以直接尝试用node
运行它,创造一个属于你的服务器!服务器运行后,浏览器访问http://localhost:8080即可访问到这个服务器
也可以使用nodemon
运行它,这样当我们的代码发生变化的时候就不需要手动终止程序再重新运行了
npm i -g nodemon
建议全局安装它,这样就可以直接使用,不需要通过npx nodemon
去使用
使用也很简单,直接将node
命令改成nodemon
命令即可
nodemon http-server.js
前面我们在使用createServer
以及resp
对象的时候,看不到任何的语法提示,必须随时跟着node
官方文档去边用边查,有点不方便
但是没关系,我们可以使用ts
的.d.ts
文件帮助我们提供语法提示功能,注意,我们不是使用ts
进行开发,只是使用它的语法提示功能而已
npm init -y
@types/node
-- pnpm i @types/node -D
jsconfig.json
文件,将node_modules
排除在外,没必要对其进行检查{ "compilerOptions": { "checkJs": true }, "exclude": ["node_modules", "**/node_modules/*"] }
不知道你是否有发现上面的代码其实是有一处错误的呢?checkJs
能够帮助我们检查类型错误问题,可以根据需要选择是否开启
可以看到,开启检查后立马就给我们提示了参数类型不匹配的问题
这时候将鼠标悬浮在listen
basé sur le moteur v8
de Chrome Exécutez le code <code>js
, afin que nous puissions nous débarrasser de l'environnement du navigateur et exécuter le code js
directement dans la console, comme le hello world suivant code> code
const { createServer } = require("http"); const HOST = "localhost"; const PORT = 8080; const server = createServer((req, resp) => { resp.writeHead(200, { "Content-Type": "text/plain" }); console.log("server is working..."); // write some lorem sentences resp.write("Lorem ipsum dolor sit amet consectetur adipisicing elit.\n"); resp.write("Omnis eligendi aperiam delectus?\n"); resp.write("Aut, quam quo!\n"); resp.end(); }); server.listen(PORT, HOST, (error) => { if (error) { console.log("Something wrong: ", error); return; } console.log(`server is listening on http://${HOST}:${PORT} ...`); });🎜 Utilisez simplement
node
directement dans la console pour exécuter🎜🎜🎜node.js
intégré dans le module http
Fournit des fonctionnalités de base du service http
. Sur la base de la spécification CommonJS
, nous pouvons utiliser require
pour importer le. Module http
Il y a une fonction createServer
dans le module http
qui nous permet de créer un serveur http
.
Il reçoit une fonction de rappel en paramètre. Cette fonction de rappel reçoit deux paramètres - request
et response
🎜request
inclut Tout. informations demandées par le client, telles que url
, en-tête de demande en-tête
, méthode de demande et corps de la demande, etc.réponse
Principalement, elle est utilisée pour renvoyer des informations au client et encapsule certaines opérations liées au corps de la réponse. Par exemple, la méthode response.writeHead
nous permet de personnaliser les informations d'en-tête et le code d'état du corps de retour. response.end()
pour envoyer le corps de la réponse au client
L'utilisation de la fonction createServer
crée uniquement pour nous un objet Server
, mais ne lui permet pas d'écouter. Nous devons également appeler le du <code>server<.>. Seule la méthode Listen</.>
peut être utilisée pour la surveillance, et elle peut réellement commencer à s'exécuter en tant que serveur🎜listen
est le numéro du port d'écoute, et le deuxième paramètre est l'hôte lié ip
, le troisième paramètre est une fonction de rappel, qui sera appelée de manière asynchrone par le module http
en cas d'erreur. est rencontré, la fonction de rappel peut être appelée. L'exception levée est obtenue dans le premier paramètre. Nous pouvons choisir de gérer l'exception pour rendre notre serveur plus robuste. Module http
pour créer un exemple de serveur simple🎜const { createServer } = require("http"); const fs = require("fs"); const HOST = "localhost"; const PORT = 8080;const server = createServer((req, resp) => { // change the MIME type from text/plain to text/html resp.writeHead(200, { "Content-Type": "text/html" }); // read the html file content fs.readFile("index.html", (err, data) => { if (err) { console.error( "an error occurred while reading the html file content: ", err ); throw err; } console.log("operation success!"); resp.write(data); resp.end(); }); }); server.listen(PORT, HOST, (error) => { if (error) { console.log("Something wrong: ", error); return; } console.log(`server is listening on http://${HOST}:${PORT} ...`); });🎜Vous pouvez directement essayer de l'exécuter avec
node
et créer votre propre serveur ! Une fois le serveur exécuté, le navigateur accède à http://localhost:8080🎜Vous pouvez accéder à ce serveur🎜🎜🎜🎜Vous pouvez également utiliser nodemon
pour l'exécuter, de sorte que lorsque notre code changements Ensuite, il n'est pas nécessaire de terminer manuellement le programme et de le réexécuter🎜const { createServer } = require("http"); const HOST = "localhost"; const PORT = 8080; const server = createServer((req, resp) => { // change the MIME type to application/json resp.writeHead(200, { "Content-Type": "application/json" }); // create a json data by using an object const jsonDataObj = { code: 0, message: "success", data: { name: "plasticine", age: 20, hobby: "coding", }, }; resp.write(JSON.stringify(jsonDataObj)); resp.end(); }); server.listen(PORT, HOST, (error) => { if (error) { console.log("Something wrong: ", error); return; } console.log(`server is listening on http://${HOST}:${PORT} ...`); });🎜Il est recommandé de l'installer globalement afin qu'il puisse être utilisé directement sans utiliser
npx nodemon
C'est également très simple à utiliser, il suffit de changer la commande node
par la commande nodemon
🎜pnpm i pdfkit🎜🎜
plus tôt Lors de la création des objets Server
et resp
, vous ne voyez aucune invite de syntaxe. Vous devez suivre la documentation officielle de node
à tout moment pour vérifier lors de son utilisation, ce qui est le cas. un peu gênant.
Mais cela n'a pas d'importance, nous pouvons utiliser le fichier .d.ts
de ts
pour nous aider à fournir des invites de syntaxe. Notez que nous n'utilisons pas ts<.> pour le développement. Utilisez simplement sa fonction d'invite de syntaxe🎜<ol>
<li>Initialisez le projet-- <code>npm init -y
@types/node
- - pnpm i @types/node -D
jsconfig.json
dans le répertoire du projet et excluez node_modules
À l'extérieur, il n'est pas nécessaire de le vérifier/** * @description 创建 pdf 文件 */const createPdf = () => { return new Promise((resolve, reject) => { if (!fs.existsSync("example.pdf")) { // create a PDFDocument object const doc = new PDFDocument(); // create write stream by piping the pdf content. doc.pipe(fs.createWriteStream("example.pdf")); // add some contents to pdf document doc.fontSize(16).text("Hello PDF", 100, 100); // complete the operation of generating PDF file. doc.end(); } resolve("success"); }); };🎜Je me demande si vous avez trouvé qu'il y a réellement une erreur dans le code ci-dessus ?
checkJs
peut nous aider à vérifier les erreurs de type. Vous pouvez choisir de l'activer en fonction de vos besoins.
Comme vous pouvez le voir, après avoir activé la vérification, nous avons été immédiatement confrontés au problème de non-concordance des types de paramètres🎜🎜🎜🎜À ce moment, passez la souris sur la méthode écouter
, et vous pourrez voir la signature de la méthode🎜
可以看到,原来port
参数需要是number
类型,但是我们定义的时候是string
类型,所以没匹配上,将其修改为number
的8080
即可
而且可以直接查看到相关api
的文档,不需要打开node
官方的文档找半天去查看了
前面我们的简单http server
中只返回了一句话,那么是否能够返回多句话呢?
这就要用到resp
对象的write
方法了,end
只能够返回一次内容,而是用write
方法,我们可以多次写入内容到响应体中,最后只用调用一次end
,并且不传递任何参数,只让他完成发送响应体的功能
const { createServer } = require("http"); const HOST = "localhost"; const PORT = 8080; const server = createServer((req, resp) => { resp.writeHead(200, { "Content-Type": "text/plain" }); console.log("server is working..."); // write some lorem sentences resp.write("Lorem ipsum dolor sit amet consectetur adipisicing elit.\n"); resp.write("Omnis eligendi aperiam delectus?\n"); resp.write("Aut, quam quo!\n"); resp.end(); }); server.listen(PORT, HOST, (error) => { if (error) { console.log("Something wrong: ", error); return; } console.log(`server is listening on http://${HOST}:${PORT} ...`); });
这次我们写入了三句话,现在的效果就变成这样啦
我们不仅可以返回字符串给浏览器,还可以直接读取html
文件的内容并将其作为结果返回给浏览器
这就需要用到另一个Node.js
的内置模块 -- fs
,该模块提供了文件操作的功能
使用fs.readFile
可以异步进行读取文件的操作,但是它不会返回promise
对象,因此我们需要传入回调去处理读取到文件后的操作
还可以使用fs.readFileSync
进行同步阻塞读取文件,这里我们选择异步读取
const { createServer } = require("http"); const fs = require("fs"); const HOST = "localhost"; const PORT = 8080;const server = createServer((req, resp) => { // change the MIME type from text/plain to text/html resp.writeHead(200, { "Content-Type": "text/html" }); // read the html file content fs.readFile("index.html", (err, data) => { if (err) { console.error( "an error occurred while reading the html file content: ", err ); throw err; } console.log("operation success!"); resp.write(data); resp.end(); }); }); server.listen(PORT, HOST, (error) => { if (error) { console.log("Something wrong: ", error); return; } console.log(`server is listening on http://${HOST}:${PORT} ...`); });
现在的结果就像下面这样:
成功将html
返回注意:这里需要将响应头的**Content-Type**
改为**text/html**
,告知浏览器我们返回的是**html**
文件的内容,如果仍然以**text/plain**
返回的话,浏览器不会对返回的内容进行解析,即便它是符合**html**
语法的也不会解析,就像下面这样:
当我们需要编写一个后端服务器,只负责返回接口数据的时候,就需要返回json
格式的内容了,相信聪明的你也知道该怎么处理了:
MIME
类型设置为application/json
resp.write
的时候传入的是json
字符串,可以使用JSON.stringify
处理对象后返回const { createServer } = require("http"); const HOST = "localhost"; const PORT = 8080; const server = createServer((req, resp) => { // change the MIME type to application/json resp.writeHead(200, { "Content-Type": "application/json" }); // create a json data by using an object const jsonDataObj = { code: 0, message: "success", data: { name: "plasticine", age: 20, hobby: "coding", }, }; resp.write(JSON.stringify(jsonDataObj)); resp.end(); }); server.listen(PORT, HOST, (error) => { if (error) { console.log("Something wrong: ", error); return; } console.log(`server is listening on http://${HOST}:${PORT} ...`); });
结果如下:
和之前返回html
文件的思路类似,都是一个设置响应头MIME
类型,读取文件,返回文件内容的过程
但是这次我们搞点不一样的
我们的思路是在服务器运行的时候生成一个pdf
文件,并将它返回
还需要将MIME
的类型改为application/pdf
生成pdf
文件需要用到一个库 -- pdfkit
pnpm i pdfkit
首先我们编写一个创建pdf
文件的函数,因为创建pdf
文件还需要进行一些写入操作,不确定什么时候会完成,但是我们的请求必须等到pdf
文件创建完成后才能得到响应
所以我们需要将它变成异步进行的,返回一个promise
/** * @description 创建 pdf 文件 */const createPdf = () => { return new Promise((resolve, reject) => { if (!fs.existsSync("example.pdf")) { // create a PDFDocument object const doc = new PDFDocument(); // create write stream by piping the pdf content. doc.pipe(fs.createWriteStream("example.pdf")); // add some contents to pdf document doc.fontSize(16).text("Hello PDF", 100, 100); // complete the operation of generating PDF file. doc.end(); } resolve("success"); }); };
这里使用到了管道操作,将PDFDocument
对象的内容通过管道传到新创建的写入流中,当完成操作后我们就通过resovle
告知外界已经创建好pdf
文件了
然后在服务端代码中调用
const server = createServer(async (req, resp) => { // change the MIME type to application/pdf resp.writeHead(200, { "Content-Type": "application/pdf" }); // create pdf file await createPdf(); // read created pdf file fs.readFile("example.pdf", (err, data) => { if (err) { console.error( "an error occurred while reading the pdf file content: ", err ); throw err; } console.log("operation success!"); resp.end(data); }); }); server.listen(PORT, HOST, (error) => { if (error) { console.log("Something wrong: ", error); return; } console.log(`server is listening on http://${HOST}:${PORT} ...`); });
现在浏览器就可以读取到创建的pdf
文件了
思路依然是一样的,读取一个音频文件,然后通过管道将它送到resp
对象中再返回即可
const { createServer } = require("http"); const { stat, createReadStream } = require("fs"); const HOST = "localhost"; const PORT = 8080; const server = createServer((req, resp) => { // change the MIME type to audio/mpe resp.writeHead(200, { "Content-Type": "audio/mp3" }); const mp3FileName = "audio.mp3"; stat(mp3FileName, (err, stats) => { if (stats.isFile()) { const rs = createReadStream(mp3FileName); // pipe the read stream to resp rs.pipe(resp); } else { resp.end("mp3 file not exists"); } }); }); server.listen(PORT, HOST, (error) => { if (error) { console.log("Something wrong: ", error); return; } console.log(`server is listening on http://${HOST}:${PORT} ...`); });
效果如下
打开后就是一个播放音频的界面,这是chrome
提供的对音频文件的展示,并且打开控制台会发现有返回音频文件
注意:将音频文件流通过管道传到**resp**
后,不需要调用**resp.end()**
方法,因为这会关闭整个响应,导致音频文件无法获取
视频文件和音频文件的处理是一样的,只是MIME
的类型要改成video/mp4
,其他都一样
const { createServer } = require("http"); const { stat, createReadStream } = require("fs"); const HOST = "localhost"; const PORT = 8080; const server = createServer((req, resp) => { // change the MIME type to audio/mpe resp.writeHead(200, { "Content-Type": "audio/mp4" }); const mp4FileName = "video.mp4"; stat(mp4FileName, (err, stats) => { if (stats.isFile()) { const rs = createReadStream(mp4FileName); // pipe the read stream to resp rs.pipe(resp); } else { resp.end("mp4 file not exists"); } }); }); server.listen(PORT, HOST, (error) => { if (error) { console.log("Something wrong: ", error); return; } console.log(`server is listening on http://${HOST}:${PORT} ...`); });
我们学会了:
Node
创建一个http
服务器js
加上类型提示html
JSON
pdf
文件虽然内容简单,但还是希望你能跟着动手敲一敲,不要以为简单就看看就算了,看了不代表会了,真正动手实现过后才会找到自己的问题
更多node相关知识,请访问:nodejs 教程!
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!