Objet HttpsServer

objet serveur https

L'objet serveur https est SslServer avec HttpHandler La combinaison d'objets encapsulés permet de construire rapidement un serveur, ce qui est logiquement équivalent à :

1
2
3
var svr = new net.SslServer(crt, key, addr, port, new http.Handler(function(req) {
    ...
}));

Méthode de création :

1
2
3
4
var http = require("http");
var svr = new http.HttpsServer(crt, key, 443, function(req) {
    ...
});

Héritage

Constructeur

HttpsServer

Constructeur HttpsServer, écoutant à toutes les adresses locales

1
2
3
new HttpsServer(Array certs,
    Integer port,
    Handler hdlr);

Paramètres d'appel :

• certs: tableau, liste de certificats de serveur
• port: Entier, précisez http Port d'écoute du serveur
• hdlr: Handler, http Processeur de message intégré, fonction de traitement, tableau de traitement en chaîne, objet de routage, voir les détails

Le format des certificats est :

1
2
3
4
5
6
7
8
9
10
11
[{
        name: "fibjs.org",
        crt: [X509Cert object],
        key: [PKey object]
    },
    {
        name: "*.fibjs.org",
        crt: [X509Cert object],
        key: [PKey object]
    }
]

---

Constructeur HttpsServer

1
2
3
4
new HttpsServer(Array certs,
    String addr,
    Integer port,
    Handler hdlr);

Paramètres d'appel :

• certs: tableau, liste de certificats de serveur
• addr: chaîne, spécifiez http Adresse d'écoute du serveur, "" signifie écouter sur toutes les adresses de cette machine
• port: Entier, précisez http Port d'écoute du serveur
• hdlr: Handler, http Processeur de message intégré, fonction de traitement, tableau de traitement en chaîne, objet de routage, voir les détails

Le format des certificats est :

1
2
3
4
5
6
7
8
9
10
11
[{
        name: "fibjs.org",
        crt: [X509Cert object],
        key: [PKey object]
    },
    {
        name: "*.fibjs.org",
        crt: [X509Cert object],
        key: [PKey object]
    }
]

---

Constructeur HttpsServer, écoutant à toutes les adresses locales

1
2
3
4
new HttpsServer(X509Cert crt,
    PKey key,
    Integer port,
    Handler hdlr);

Paramètres d'appel :

• crt: X509Cert, X509Cert Certificat pour le serveur d'authentification client
• key: PKey, PKey Clé privée, utilisée pour parler au client
• port: Entier, précisez http Port d'écoute du serveur
• hdlr: Handler, http Processeur de message intégré, fonction de traitement, tableau de traitement en chaîne, objet de routage, voir les détails

---

Constructeur HttpsServer

1
2
3
4
5
new HttpsServer(X509Cert crt,
    PKey key,
    String addr,
    Integer port,
    Handler hdlr);

Paramètres d'appel :

• crt: X509Cert, X509Cert Certificat pour le serveur d'authentification client
• key: PKey, PKey Clé privée, utilisée pour parler au client
• addr: chaîne, spécifiez http Adresse d'écoute du serveur, "" signifie écouter sur toutes les adresses de cette machine
• port: Entier, précisez http Port d'écoute du serveur
• hdlr: Handler, http Processeur de message intégré, fonction de traitement, tableau de traitement en chaîne, objet de routage, voir les détails

Attributs des membres

verification

Entier, définissez le mode de vérification du certificat, la valeur par défaut est VERIFY_NONE

1
Integer HttpsServer.verification;

---

ca

X509Cert, Vérification du certificat client ca

1
readonly X509Cert HttpsServer.ca;

---

maxHeadersCount

Entier, interrogez et définissez le nombre maximal d'en-têtes de requête, la valeur par défaut est 128

1
Integer HttpsServer.maxHeadersCount;

---

maxBodySize

Entier, interrogez et définissez la taille maximale du corps, en Mo, la valeur par défaut est 64

1
Integer HttpsServer.maxBodySize;

---

enableEncoding

Booléen, commutateur de fonction de décompression automatique, fermé par défaut

1
Boolean HttpsServer.enableEncoding;

---

serverName

Chaînez, interrogez et définissez le nom du serveur, la valeur par défaut est : fibjs/0.x.0

1
String HttpsServer.serverName;

---

socket

Socket, Le serveur écoute actuellement Socket Objet

1
readonly Socket HttpsServer.socket;

---

handler

Handler, objet d'interface de traitement des événements en cours du serveur

1
Handler HttpsServer.handler;

Fonction membre

enableCrossOrigin

Autoriser les requêtes interdomaines

1
HttpsServer.enableCrossOrigin(String allowHeaders = "Content-Type");

Paramètres d'appel :

• allowHeaders: chaîne, spécifiée pour accepter http Champ d'en-tête

---

start

Démarrer le serveur actuel

1
HttpsServer.start();

---

stop

Fermez le socket pour terminer le serveur en cours d'exécution

1
HttpsServer.stop() async;

---

toString

Renvoie la représentation sous forme de chaîne de l'objet, renvoie généralement "[Objet natif]", l'objet peut être ré-implémenté selon ses propres caractéristiques

1
String HttpsServer.toString();

Résultat de retour :

• String, Renvoie la représentation sous forme de chaîne de l'objet

---

toJSON

Renvoie la représentation au format JSON de l'objet, renvoie généralement une collection d'attributs lisibles définis par l'objet

1
Value HttpsServer.toJSON(String key = "");

Paramètres d'appel :

• key: chaîne, inutilisé

Résultat de retour :

• Value, Renvoie une valeur contenant JSON sérialisable