NodeJS-Studiennotizen Http module_node.js

1, Eröffnungsanalyse

Zuallererst sollte jeder mit dem Konzept von „Http“ vertraut sein. Es handelt sich um ein allgemeines Anwendungsschichtprotokoll, aber sie bleiben gleich und die Ideen sind die gleichen

Als Host-Betriebsumgebung verwendet NodeJS auch eigene Standards für die Implementierung. In diesem Artikel lernen wir gemeinsam das „Http-Modul“ kennen. Aber als Voraussetzung,

Ich hoffe, Sie können zuerst die auf der offiziellen Website bereitgestellte API lesen und ein Vorverständnis haben, was viel praktischer ist. Das Folgende ist eine Übersicht über die API des HTTP-Teils:

Code kopieren Der Code lautet wie folgt:

HTTP
    http.STATUS_CODES
    http.createServer([requestListener])
    http.createClient([Port], [Host])
    Klasse: http.Server
    Beispiel: 'Anfrage'
    Beispiel: 'Verbindung'
    Beispiel: 'close'
    Ereignis: 'checkContinue'
    Beispiel: 'connect'
    Ereignis: 'Upgrade'
    Ereignis: 'clientError'
    server.listen(port, [hostname], [backlog], [callback])
    server.listen(path, [callback])
    server.listen(handle, [callback])
    server.close([callback])
    server.maxHeadersCount
    server.setTimeout(ms, Rückruf)
    server.timeout
    Klasse: http.ServerResponse
        Beispiel: 'close'
        Response.writeContinue()
        Response.writeHead(statusCode, [reasonPhrase], [headers])
        Response.setTimeout(msecs, callback)
        Response.statusCode
        Response.setHeader(Name, Wert)
        Response.headersSent
        Response.sendDate
        Response.getHeader(name)
        Response.removeHeader(name)
        Response.write(chunk, [encoding])
        Response.addTrailers(headers)
        Response.end([Daten], [Kodierung])
        http.request(Optionen, Rückruf)
        http.get(Optionen, Rückruf)
    Klasse: http.Agent
        neuer Agent([Optionen])
        agent.maxSockets
        agent.maxFreeSockets
        agent.sockets
        agent.freeSockets
        agent.requests
        agent.destroy()
        agent.getName(optionen)
        http.globalAgent
    Klasse: http.ClientRequest
        Ereignis „Antwort“
        Ereignis: 'socket'
        Beispiel: 'connect'
        Ereignis: 'Upgrade'
        Ereignis: 'Weiter'
        request.write(chunk, [encoding])
        request.end([Daten], [Kodierung])
        request.abort()
        request.setTimeout(timeout, [callback])
        request.setNoDelay([noDelay])
        request.setSocketKeepAlive([enable], [initialDelay])
    http.IncomingMessage
        Beispiel: 'close'
        message.httpVersion
        message.headers
        message.rawHeaders
        message.trailers
        message.rawTrailers
        message.setTimeout(msecs, callback)
        message.method
        message.url
        message.statusCode
        message.socket

让我们先从一个简单例子开始，创建一个叫server.js的文件，并写入以下代码：

复制代码 代码如下:

var http = require('http') ;
var server = http.createServer(function(req,res){
res.writeHeader(200,{
'Content-Type': 'text/plain;charset=utf-8' // charset=utf-8 hinzufügen
}) ;
res.end("Hallo, großer Bär!") ;
}) ;
server.listen(8888) ;
console.log("http-Server läuft auf Port 8888 ...") ;

(node ​​​​server.js) Das Folgende sind die Ergebnisse:

2. Detaillierte Analysebeispiele

Sehen Sie sich dieses kleine Beispiel im Detail an:

(Zeile 1): Führen Sie das mit NodeJS gelieferte „http“-Modul über „require“ ein und weisen Sie es der http-Variablen zu.

(2 Zeilen): Rufen Sie die vom http-Modul bereitgestellte Funktion auf: „createServer“. Diese Funktion gibt ein neues Webserverobjekt zurück.

　Der Parameter „requestListener“ ist eine Funktion, die automatisch zur Abhörwarteschlange des „request“-Ereignisses hinzugefügt wird.

Wenn eine Anfrage eingeht, stellt Event-Loop die Listener-Rückruffunktion in die Ausführungswarteschlange und der gesamte Code im Knoten wird nacheinander zur Ausführung aus der Ausführungswarteschlange entnommen.

Diese Ausführungen werden alle im Arbeitsthread ausgeführt (die Ereignisschleife selbst kann als in einem unabhängigen Thread betrachtet werden. Wir erwähnen diesen Thread im Allgemeinen nicht, sondern nennen den Knoten eine Single-Thread-Ausführungsumgebung),

Alle Rückrufe werden in einem Arbeitsthread ausgeführt.

Schauen wir uns noch einmal die Callback-Funktion „requestListener“ an, die zwei Parameter (Anfrage, Antwort) bereitstellt,

Wird jedes Mal ausgelöst, wenn eine Anfrage eingeht. Beachten Sie, dass jede Verbindung mehrere Anforderungen haben kann (in einer Keep-Alive-Verbindung).

„request“ ist eine Instanz von http.IncomingMessage. „response“ ist eine Instanz von http.ServerResponse.

Ein http-Anfrageobjekt ist ein lesbarer Stream und ein http-Antwortobjekt ist ein beschreibbarer Stream.

Ein „IncomingMessage“-Objekt wird von http.Server oder http.ClientRequest erstellt,

Und als erster Parameter an die Ereignisse „request“ bzw. „response“ übergeben.

Es kann auch verwendet werden, um auf Antwortstatus, Header und Daten zuzugreifen.

　Es implementiert die „Stream“-Schnittstelle und die folgenden zusätzlichen Ereignisse, Methoden und Eigenschaften. (Einzelheiten finden Sie in der API).

(3 Zeilen): „writeHeader“, verwenden Sie die Funktion „response.writeHead()“, um einen HTTP-Status 200 und den Inhaltstyp des HTTP-Headers zu senden.

Antworten Sie den Antwortheader auf die Anfrage. „statusCode“ ist ein dreistelliger HTTP-Statuscode, z. B. 404. Der letzte Parameter, „headers“, ist der Inhalt der Antwortheader.

Geben Sie mir ein Beispiel:

Code kopieren Der Code lautet wie folgt:

var body = 'Hallo Welt' ;
Response.writeHead(200, {
„Content-Length“: body.length,
'Content-Type': 'text/plain'
}) ;

Hinweis: Die Inhaltslänge wird in Bytes berechnet, nicht in Zeichen.

Der Grund für das vorherige Beispiel ist, dass die Zeichenfolge „Hello World!“ nur Einzelbyte-Zeichen enthält.

Wenn der Textkörper Multibyte-codierte Zeichen enthält, sollten Sie Buffer.byteLength() verwenden, um die Anzahl der Bytes der Zeichenfolge im Fall der Multibyte-Zeichencodierung zu ermitteln.

Es sollte weiter erläutert werden, dass Node nicht prüft, ob das Content-Lenth-Attribut mit der übertragenen Körperlänge übereinstimmt.

statusCode ist ein dreistelliger HTTP-Statuscode, zum Beispiel: „404“. Worüber ich hier sprechen möchte, ist „http.STATUS_CODES“, das die Sammlung und Kurzbeschreibung aller standardmäßigen „Http“-Antwortstatuscodes enthält.

Das Folgende ist die Quellcode-Referenz:

Code kopieren Der Code lautet wie folgt:

var STATUS_CODES = exports.STATUS_CODES = {
  100: 'Weiter',
  101: 'Protokolle wechseln',
  102: „Verarbeitung“,                 // RFC 2518, veraltet durch RFC 4918
  200: 'OK',
  201: 'Erstellt',
  202: 'Akzeptiert',
  203: „Nicht verbindliche Informationen“,
  204: „Kein Inhalt“,
  205: 'Inhalt zurücksetzen',
  206: „Teilinhalt“,
  207: „Multi-Status“,               // RFC 4918
  300: „Mehrfachauswahl“,
  301: „Dauerhaft verschoben“,
  302: „Vorübergehend verschoben“,
  303: „Andere anzeigen“,
  304: „Nicht geändert“,
  305: 'Proxy verwenden',
  307: 'Temporäre Weiterleitung',
  400: „Ungültige Anfrage“,
  401: „Unautorisiert“,
  402: „Zahlung erforderlich“,
  403: „Verboten“,
  404: „Nicht gefunden“,
  405: „Methode nicht zulässig“,
  406: „Nicht akzeptabel“,
  407: „Proxy-Authentifizierung erforderlich“,
  408: 'Timeout anfordern',
  409: 'Konflikt',
  410: 'Weg',
  411: „Länge erforderlich“,
  412: „Vorbedingung fehlgeschlagen“,
  413: „Anforderungsentität zu groß“,
  414: 'Anfrage-URI zu groß',
  415: „Nicht unterstützter Medientyp“,
  416: „Angeforderter Bereich nicht erfüllbar“,
  417: „Erwartung fehlgeschlagen“,
  418: „Ich bin eine Teekanne“,              // RFC 2324
  422: „Unverarbeitbare Entität“,       // RFC 4918
  423: 'Gesperrt',                     // RFC 4918
  424: „Failed Dependency“,          // RFC 4918
  425: 'Ungeordnete Sammlung',       // RFC 4918
  426: „Upgrade erforderlich“,           // RFC 2817
  500: „Interner Serverfehler“,
  501: „Nicht implementiert“,
  502: „Bad Gateway“,
  503: „Dienst nicht verfügbar“,
  504: „Gateway-Timeout“,
  505: „HTTP-Version nicht unterstützt“,
  506: „Variant Also Negotiates“,    // RFC 2295
  507: „Unzureichender Speicherplatz“,       // RFC 4918
  509: „Bandbreitenlimit überschritten“,
  510: „Nicht erweitert“                // RFC 2774
};

节选自，Nodejs源码 „http.js“ 143行开始.

其实从客户端应答结果也不难看出:

 

（6行）：“response.end“------当所有的响应报头和报文被发送完成时这个方法将信号发送给服务器。服务器会认为这个消息完成了.

　 每次响应完成之后必须调用该方法。如果指定了参数 „data“ und 就相当于先调用 „response.write(data,kodierung)“. Geben Sie „response.end()“ ein.

（8行）：“server.listen(8888)“ ------ 服务器用指定的句柄接受连接,绑定在特定的端口.

以上就是一个比较详细的分析过程, 希望有助于加深理解, 代码虽然不多, 但是重在理解一些细节机制,以便日后高效的开发NodeJS应用.

三，实例

除了可以使用"request"对象访问请求头数据外,还能把"request"对象当作一个只读数据流来访问请求体数据.

这是一个"POST"请求的例子:

复制代码 代码如下:

http.createServer(Funktion (Anfrage, Antwort) {
var body = [];
console.log(request.method) ;
console.log(request.headers) ;
Request.on('data', function (chunk) {
            body.push(chunk);
}) ;
Request.on('end', function () {
​​​​body = Buffer.concat(body);
console.log(body.toString()) ;
});
}).listen(8888) ;

Das Folgende ist ein vollständiger Inhalt der „HTTP“-Anforderungsdaten.

Code kopieren Der Code lautet wie folgt:

POST/HTTP/1.1
Benutzeragent: curl/7.26.0
Host: localhost
Akzeptieren: */*
Inhaltslänge: 11
Inhaltstyp: application/x-www-form-urlencoded
Hallo Welt

Viertens, Zusammenfassung

(1), verstehen Sie das Konzept von „HTTP“.
(2) Seien Sie mit der Verwendung von „Http“-bezogenen APIs vertraut.
(3) Achten Sie auf die Details, z. B. die Verarbeitungsdetails zwischen „POST, GET“.
(4), Verständnis von „requestListener“.
(5) betont ein Konzept: Ein http-Anforderungsobjekt ist ein lesbarer Stream und ein http-Antwortobjekt ist ein beschreibbarer Stream.