【Node.js24.x】Object::createServer()メソッドの使い方
createServerメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
createServerメソッドは、Node.js環境において、クライアントからのHTTPまたはHTTPSリクエストを受け付けるサーバーインスタンスを生成・初期化するために使用されるメソッドです。このメソッドは、主にhttpモジュールやhttpsモジュールを通じて提供され、WebアプリケーションやAPIサービスを構築する際の根幹となる要素です。
引数として、クライアントからリクエストが到着した際に実行されるコールバック関数であるrequestListenerをオプションで指定できます。このrequestListener関数は、一般的に、受信したリクエストの詳細を保持するIncomingMessageオブジェクトと、クライアントへ送信するレスポンスを制御するためのServerResponseオブジェクトの二つの引数を受け取ります。これにより、開発者はリクエストの内容に応じて動的なレスポンスを生成するロジックを記述できます。
また、HTTPSサーバーを作成する場合には、秘密鍵や証明書などのTLS/SSL設定を含むoptionsオブジェクトを最初の引数として渡すことで、セキュアな通信環境を構築することが可能です。
createServerメソッドの実行結果として返されるのは、HTTPまたはHTTPSサーバーとして機能するServerオブジェクトのインスタンスです。このServerインスタンスに対して、さらにlistenメソッドを呼び出すことで、特定のポートでクライアントからの接続を待ち受け、実際のWebサーバーとして動作を開始させることができます。Node.jsを用いてWebサービスを開発する上で、クライアントとの通信を確立し、アプリケーションの核となる処理を実行するための出発点として、このcreateServerメソッドは極めて重要な役割を担っています。
構文(syntax)
1const http = require('http'); 2 3const server = http.createServer((request, response) => { 4 response.statusCode = 200; 5 response.setHeader('Content-Type', 'text/plain'); 6 response.end('Hello from Node.js!'); 7});
引数(parameters)
options, requestListener
- options: object: サーバーの構成オプションを指定するオブジェクト。省略可能です。
- requestListener: function: リクエストを受け取るたびに呼び出されるコールバック関数。クライアントからのリクエストを処理し、レスポンスを返します。
戻り値(return)
戻り値なし
戻り値はありません