はてなブックマーク

StrongLoop / IBMによって提供されるこの翻訳. 本書は、英語の資料と比較すると古くなっている可能性があります。最新の更新については、英語版の資料を参照してください。 実稼働環境におけるベスト・プラクティス: パフォーマンスと信頼性 概説 この記事では、実稼働環境にデプロイされた Express アプリケーションのパフォーマンスと信頼性に関するベスト・プラクティスについて説明します。 このトピックは、従来型の開発と運用の両方にわたる「DevOps」の世界に明確に分類されます。したがって、情報は次の 2 つの部分に分かれています。 コードで実行する処理 (開発部分) gzip 圧縮を使用する 同期関数を使用しない ロギングを正確に実行する 例外を適切に処理する 環境/セットアップで実行する処理 (運用部分) Set NODE_ENV to “production” Ensure

StrongLoop / IBMによって提供されるこの翻訳. 本書は、英語の資料と比較すると古くなっている可能性があります。最新の更新については、英語版の資料を参照してください。 ルーティング ルーティング とは、アプリケーション・エンドポイント (URI) と、クライアントリクエストに対するそれらのレスポンスの定義のことです。 ルーティングの概要については、基本的なルーティングを参照してください。 ルーティングはHTTPメソッドに対応するExpressのappオブジェクトのメソッドを使用して定義します。たとえば、GETリクエストを処理するapp.get()やPOSTリクエストを処理するapp.postがあります。 完全なリストについては、app.METHODを参照してください。 また、すべてのHTTPメソッドを制御するためにapp.all()を、ミドルウェアを指定するためにapp.use

ここで紹介するのは基本的に、作成できる最も単純な Express アプリケーションです。このアプリケーションは単一ファイル・アプリケーションであり、Express ジェネレーター を使用して得られるものでは ありません 。このジェネレーターは、さまざまな目的で多数の JavaScript ファイル、Jade テンプレート、サブディレクトリーを使用する完全なアプリケーション用のスキャフォールディングを作成します。 最初に、myapp という名前のディレクトリーを作成して、そのディレクトリーに移動し、npm init を実行します。次に、インストール・ガイドに従い、依存関係として express をインストールします。 myapp ディレクトリーで、app.js というファイルを作成して、以下のコードを追加します。 const express = require('express') cons

StrongLoop / IBMによって提供されるこの翻訳. 本書は、英語の資料と比較すると古くなっている可能性があります。最新の更新については、英語版の資料を参照してください。 エラー処理 エラー処理 は、Expressが同期的および非同期的に発生するエラーをキャッチして処理する方法です。Expressにはデフォルトのエラーハンドラが付属しているので、自分で作成する必要はありません。 エラーのキャッチ Expressがルート・ハンドラとミドルウェアの実行中に発生するすべてのエラーを確実にキャッチすることが重要です。 ルート・ハンドラとミドルウェア内の同期コードで発生するエラーは、余分な作業を必要としません。同期コードがエラーをスローすると、Expressはそれをキャッチして処理します。 例えば： app.get('/', (req, res) => { throw new Error('

StrongLoop / IBMによって提供されるこの翻訳. 本書は、英語の資料と比較すると古くなっている可能性があります。最新の更新については、英語版の資料を参照してください。 Express での静的ファイルの提供 イメージ、CSS ファイル、JavaScript ファイルなどの静的ファイルを提供するには、Express に標準実装されている express.static ミドルウェア関数を使用します。 静的アセットファイルを格納しているディレクトリーの名前を express.static ミドルウェア関数に渡して、ファイルの直接提供を開始します。例えば、public というディレクトリー内のイメージ、CSS ファイル、JavaScript ファイルを提供するには、次のコードを使用します。 app.use(express.static('public')); これで、public ディ

Express 4 のミドルウェアの完全なリストは、ここを参照してください。 ほとんどの場合、旧バージョン 3 のミドルウェアを単に Express 4 のミドルウェアに置き換えるだけですみます。詳細については、GitHub でモジュールの資料を参照してください。 app.use がパラメーターを受け入れます バージョン 4 では、変数パラメーターを使用して、ミドルウェア関数がロードされるパスを定義し、ルート・ハンドラーからパラメーターの値を読み取ることができます。 次に例を示します。 app.use('/book/:id', (req, res, next) => { console.log('ID:', req.params.id) next() }) ルーティング・システム アプリケーションがルーティング・ミドルウェアを暗黙的にロードするようになったため、router ミドルウェアに

StrongLoop / IBMによって提供されるこの翻訳. 本書は、英語の資料と比較すると古くなっている可能性があります。最新の更新については、英語版の資料を参照してください。 Express アプリケーションで使用するミドルウェアの作成 概説 ミドルウェア 関数は、リクエストオブジェクト (req)、レスポンスオブジェクト (res)、およびアプリケーションのリクエストレスポンスサイクルにおける次のミドルウェア関数に対するアクセス権限を持つ関数です。次のミドルウェア関数は一般的に、next という変数で表されます。 ミドルウェア関数は以下のタスクを実行できます。 任意のコードを実行する。 リクエストオブジェクトとレスポンスオブジェクトを変更する。 リクエストレスポンスサイクルを終了する。 スタック内の次のミドルウェアを呼び出す。 現在のミドルウェア関数がリクエストレスポンスサイクルを終

Express application generator Use the application generator tool, express-generator, to quickly create an application skeleton. You can run the application generator with the npx command (available in Node.js 8.2.0). $ npx express-generator For earlier Node versions, install the application generator as a global npm package and then launch it: $ npm install -g express-generator $ express Display t

StrongLoop / IBMによって提供されるこの翻訳. 本書は、英語の資料と比較すると古くなっている可能性があります。最新の更新については、英語版の資料を参照してください。 実稼働環境におけるベスト・プラクティス: セキュリティー 概説 「実稼働」という用語は、ソフトウェアのライフサイクルにおいて、アプリケーションや API をエンド・ユーザーまたはコンシューマーが広く使用できる段階を指します。対照的に、「開発」段階では、まだコードの作成とテストを積極的に行っていて、アプリケーションへの外部アクセスは不可能です。対応するシステム環境は、それぞれ実稼働 環境と開発 環境と呼ばれています。 開発環境と実稼働環境は通常、別々にセットアップされ、それぞれの要件は大きく異なっています。開発環境では許可されることが、実稼働環境では許可されないことがあります。例えば、開発環境ではデバッグのためにエ

StrongLoop / IBMによって提供されるこの翻訳. 本書は、英語の資料と比較すると古くなっている可能性があります。最新の更新については、英語版の資料を参照してください。

Production Best Practices: Security Overview The term “production” refers to the stage in the software lifecycle when an application or API is generally available to its end-users or consumers. In contrast, in the “development” stage, you’re still actively writing and testing code, and the application is not open to external access. The corresponding system environments are known as production and

StrongLoop / IBMによって提供されるこの翻訳. 本書は、英語の資料と比較すると古くなっている可能性があります。最新の更新については、英語版の資料を参照してください。 Express のアプリケーション生成プログラム アプリケーション生成プログラム・ツールの express を使用すると、アプリケーション・スケルトンを素早く作成できます。 次のコマンドを使用して、express をインストールします。 $ npm install express-generator -g -h オプションを指定してコマンド・オプションを表示します。 $ express -h Usage: express [options][dir] Options: -h, --help output usage information --version output the version number -

StrongLoop / IBMによって提供されるこの翻訳. 本書は、英語の資料と比較すると古くなっている可能性があります。最新の更新については、英語版の資料を参照してください。 Express アプリケーション用のプロセス・マネージャー Express アプリケーションを実動で実行する際、以下のタスクを実行するためにプロセス・マネージャー を使用すると便利です。 アプリケーションが異常終了した場合に自動的に再始動する。 ランタイム・パフォーマンスとリソース使用量に関するインサイトを得る。 パフォーマンスを向上させるために設定を動的に変更する。 クラスタリングを制御する。 プロセス・マネージャーは、アプリケーション・サーバーに似ていて、デプロイメントを容易に行えるようにして、高可用性を実現し、アプリケーションを実行時に管理できるようにする、アプリケーションの「コンテナー」です。 Expre

StrongLoop / IBMによって提供されるこの翻訳. 本書は、英語の資料と比較すると古くなっている可能性があります。最新の更新については、英語版の資料を参照してください。 FAQ どのようにしてアプリケーションを構成するのですか? この質問に対する決定的な答えはありません。ご使用のアプリケーションや関与するチームの規模によって答えは異なります。可能な限り柔軟であるために、Express には、構造に関する前提がありません。 ルートやその他のアプリケーション固有のロジックは、必要な数だけのファイルや、任意のディレクトリー構造に存在できます。参考のために、以下の例を参照してください。 ルートのリスト ルートのマップ MVC スタイルのコントローラー また、これらのパターンを簡素化する、サード・パーティー製の Express 拡張版があります。 Resourceful ルーティング どの

StrongLoop / IBMによって提供されるこの翻訳. 本書は、英語の資料と比較すると古くなっている可能性があります。最新の更新については、英語版の資料を参照してください。 Express 5 への移行 概説 Express 5.0 は、まだアルファ・リリースの段階ですが、ここでは本リリースにおける変更のプレビューを示し、Express 4 アプリケーションを Express 5 に移行する方法を説明します。 Express 5 は Express 4 とあまり変わりません。API の変更は、3.0 から 4.0 への変更ほど大きいものではありません。基本的な API は同じままですが、それでも互換性のない変更が行われています。つまり、Express 5 を使用するように既存の Express 4 を更新すると、機能しなくなる可能性があります。 最新のアルファをインストールして Ex

Routing Routing refers to how an application’s endpoints (URIs) respond to client requests. For an introduction to routing, see Basic routing. You define routing using methods of the Express app object that correspond to HTTP methods; for example, app.get() to handle GET requests and app.post to handle POST requests. For a full list, see app.METHOD. You can also use app.all() to handle all HTTP me

Using middleware Express is a routing and middleware web framework that has minimal functionality of its own: An Express application is essentially a series of middleware function calls. Middleware functions are functions that have access to the request object (req), the response object (res), and the next middleware function in the application’s request-response cycle. The next middleware functio

Database integration Adding the capability to connect databases to Express apps is just a matter of loading an appropriate Node.js driver for the database in your app. This document briefly explains how to add and use some of the most popular Node.js modules for database systems in your Express app: Cassandra Couchbase CouchDB LevelDB MySQL MongoDB Neo4j Oracle PostgreSQL Redis SQL Server SQLite E

4.x API express() Creates an Express application. The express() function is a top-level function exported by the express module. var express = require('express') var app = express() Methods express.json([options]) This is a built-in middleware function in Express. It parses incoming requests with JSON payloads and is based on body-parser. Returns middleware that only parses JSON and only looks at

StrongLoop / IBMによって提供されるこの翻訳. 本書は、英語の資料と比較すると古くなっている可能性があります。最新の更新については、英語版の資料を参照してください。 実稼働環境におけるベスト・プラクティス: セキュリティー 概説 「実稼働」という用語は、ソフトウェアのライフサイクルにおいて、アプリケーションや API をエンド・ユーザーまたはコンシューマーが広く使用できる段階を指します。対照的に、「開発」段階では、まだコードの作成とテストを積極的に行っていて、アプリケーションへの外部アクセスは不可能です。対応するシステム環境は、それぞれ実稼働 環境と開発 環境と呼ばれています。 開発環境と実稼働環境は通常、別々にセットアップされ、それぞれの要件は大きく異なっています。開発環境では許可されることが、実稼働環境では許可されないことがあります。例えば、開発環境ではデバッグのためにエ

StrongLoop / IBMによって提供されるこの翻訳. 本書は、英語の資料と比較すると古くなっている可能性があります。最新の更新については、英語版の資料を参照してください。 Express 用のテンプレート・エンジンの開発 独自のテンプレート・エンジンを作成するには、app.engine(ext, callback) メソッドを使用します。ext はファイル拡張子を表し、callback はテンプレート・エンジン関数です。この関数は、ファイルのロケーション、options オブジェクト、およびコールバック関数の項目をパラメーターとして受け入れます。 次のコードは、.ntl ファイルをレンダリングするための極めて単純なテンプレート・エンジンを実装する例です。 const fs = require('fs') // this engine requires the fs module a

StrongLoop / IBMによって提供されるこの翻訳. 本書は、英語の資料と比較すると古くなっている可能性があります。最新の更新については、英語版の資料を参照してください。 インストール 既に Node.js をインストールしてあることを想定して、ここではアプリケーションを作成するディレクトリーを作り、それを作業ディレクトリーにします。 $ mkdir myapp $ cd myapp npm init コマンドを使用して、アプリケーション用の package.json ファイルを作成します。 package.json の機能について詳しくは、Specifics of npm’s package.json handling を参照してください。 $ npm init 次のコマンドは、アプリケーションの名前やバージョンなど、いくつかのことを要求します。 ここでは、以下の例外を除いて、R

StrongLoop / IBMによって提供されるこの翻訳. 本書は、英語の資料と比較すると古くなっている可能性があります。最新の更新については、英語版の資料を参照してください。 ミドルウェアの使用 Express は、それ自体では最小限の機能を備えたルーティングとミドルウェアの Web フレームワークです。Express アプリケーションは基本的に一連のミドルウェア関数呼び出しです。 ミドルウェア 関数は、requestオブジェクト (req)、responseオブジェクト (res)、およびアプリケーションのリクエストレスポンスサイクルにおける次のミドルウェア関数に対するアクセス権限を持つ関数です。次のミドルウェア関数は一般的に、next という変数で表されます。 ミドルウェア関数は以下のタスクを実行できます。 任意のコードを実行する。 リクエストオブジェクトとレスポンスオブジェクトを

Express 5.0 beta documentation is now available. The beta API documentation is a work in progress. For information on what’s in the release, see the Express release history. Web Applications Express is a minimal and flexible Node.js web application framework that provides a robust set of features for web and mobile applications. APIs With a myriad of HTTP utility methods and middleware at your dis

StrongLoop / IBMによって提供されるこの翻訳. 本書は、英語の資料と比較すると古くなっている可能性があります。最新の更新については、英語版の資料を参照してください。 ルーティング ルーティング とは、アプリケーション・エンドポイント (URI) と、クライアントリクエストに対するそれらのレスポンスの定義のことです。 ルーティングの概要については、基本的なルーティングを参照してください。 ルーティングはHTTPメソッドに対応するExpressのappオブジェクトのメソッドを使用して定義します。たとえば、GETリクエストを処理するapp.get()やPOSTリクエストを処理するapp.postがあります。 完全なリストについては、app.METHODを参照してください。 また、すべてのHTTPメソッドを制御するためにapp.all()を、ミドルウェアを指定するためにapp.use

StrongLoop / IBMによって提供されるこの翻訳. 本書は、英語の資料と比較すると古くなっている可能性があります。最新の更新については、英語版の資料を参照してください。 Express での静的ファイルの提供 イメージ、CSS ファイル、JavaScript ファイルなどの静的ファイルを提供するには、Express に標準実装されている express.static ミドルウェア関数を使用します。 静的アセットファイルを格納しているディレクトリーの名前を express.static ミドルウェア関数に渡して、ファイルの直接提供を開始します。例えば、public というディレクトリー内のイメージ、CSS ファイル、JavaScript ファイルを提供するには、次のコードを使用します。 app.use(express.static('public')); これで、public ディ