Express.JS Usage_node.js에 대한 자세한 설명

노드(다운로드)를 설치한 후 컴퓨터에 디렉터리를 만들고 첫 번째 애플리케이션을 시작하세요.

$ mkdir hello-world

이 디렉토리에서는 다른 노드 패키지와 다르지 않은 애플리케이션 "패키지"를 정의합니다. 파일 디렉터리의 json 파일은 종속성을 명확하게 정의합니다. 알려지지 않은 놀라움을 방지하기 위해 "3.x" 이외의 버전을 설치하는 대신 npm 명령을 사용하여 원하는 최신 버전의 Express를 얻을 수 있습니다.

{
 
"name": "hello-world",
 
"description": "hello world test app",
 
"version": "0.0.1",
 
"private": true,
 
"dependencies": {
  "express": "3.x"
}
}

이제 패키지가 생겼습니다. 이 디렉터리에 있는 package.json 파일을 npm(1)을 사용하여 이 종속성을 설치할 수 있습니다. 이 경우에는 다음을 입력하세요.

$ npm install

npm이 완료되면 /node_modules 디렉터리에 Express 3.x 종속성이 생깁니다. 다음 코드 조각은 Express 트리와 자체 종속성을 보여주므로 npm ls를 사용하여 이를 확인할 수 있습니다.

$ npm ls
hello-world@0.0.1 /private/tmp
└─┬ express@3.0.0beta7
 ├── commander@0.6.1
 ├─┬ connect@2.3.9
 │ ├── bytes@0.1.0
 │ ├── cookie@0.0.4
 │ ├── crc@0.2.0
 │ ├── formidable@1.0.11
 │ └── qs@0.4.2
 ├── cookie@0.0.3
 ├── debug@0.7.0
 ├── fresh@0.1.0
 ├── methods@0.0.1
 ├── mkdirp@0.3.3
 ├── range-parser@0.0.4
 ├─┬ response-send@0.0.1
 │ └── crc@0.2.0
 └─┬ send@0.0.3
  └── mime@1.2.6

이제 애플리케이션 자체를 만들려면 app.js 또는 server.js라는 파일을 만들고 express를 가져온 다음 express()를 사용하여 새 애플리케이션을 만듭니다.

var express = require('express');
var app = express();

새 애플리케이션 인스턴스는 app.VERB()를 통해 경로 정의를 시작할 수 있습니다. 이 경우 "Hello World" 문자열을 사용하여 "GET/" 요청에 응답합니다. req와 res는 제공되는 노드 개체와 정확히 동일하므로 res.pipe(), req.on('data', callback) 및 Express와 관련 없는 기타 작업을 호출할 수 있습니다.

Express는 컨텐츠 길이를 추가하는 것 외에도 res.send()와 같은 더 높은 수준의 인터페이스를 제공하기 위해 이러한 객체를 향상시킵니다.

app.get('/hello.txt', function(req, res){
 res.send('Hello World');
});

이제 연결을 위해 app.listen() 메서드를 호출하여 노드의 net.Server #listen()과 동일한 매개변수를 수락하고 바인딩하고 수신합니다.

var server = app.listen(3000, function() {
  console.log('Listening on port %d', server.address().port);
});

express(1)를 사용하여 애플리케이션 생성

Express 팀은 express-generator(1)라는 편리한 프로젝트 생성기를 유지 관리합니다. npm을 사용하여 전역적으로 express-generator를 설치하면 컴퓨터 어디에서나 액세스할 수 있습니다.

$ npm install -g express-generator

이 도구는 애플리케이션 프레임워크를 얻는 쉬운 방법을 제공하지만 범위가 제한되어 있습니다. 예를 들어 몇 가지 템플릿 엔진만 지원하는 반면 Express 자체는 실제로 노드용 웹사이트 프레임워크 템플릿 구축을 지원합니다. 도움말을 통해 볼 수 있습니다:

Usage: express [options]
Options:
 -h, --help     output usage information
 -V, --version    output the version number
 -e, --ejs      add ejs engine support (defaults to jade)
 -H, --hogan     add hogan.js engine support
 -c, --css  add stylesheet support (less|stylus|compass) (defaults to plain css)
 -f, --force     force on non-empty directory

모든 상황을 지원하는 애플리케이션을 생성하려면 간단히 실행하면 됩니다::

$ express --css stylus myapp
create : myapp
create : myapp/package.json
create : myapp/app.js
create : myapp/public
create : myapp/public/javascripts
create : myapp/public/images
create : myapp/public/stylesheets
create : myapp/public/stylesheets/style.styl
create : myapp/routes
create : myapp/routes/index.js
create : myapp/views
create : myapp/views/index.jade
create : myapp/views/layout.jade

install dependencies:
$ cd myapp && npm install

run the app:
$ DEBUG=myapp node app

다른 노드 애플리케이션과 마찬가지로 다음 종속성을 설치해야 합니다.

그럼 시작해 보겠습니다.

$ npm start

간단한 앱을 시작하고 실행하는 데 필요한 전부입니다. Express는 특정 디렉토리 구조에 묶여 있지 않으며 단지 지침을 제공하기 위한 것임을 기억하십시오. 애플리케이션 구조 선택은 github 저장소의 예제에서 볼 수 있습니다.

오류 처리

오류 처리 미들웨어는 일반 미들웨어와 동일하게 정의되지만 함수 시그니처(err, req, res, next)는 다음과 같습니다.

app.use(function(err, req, res, next){
 console.error(err.stack);
 res.send(500, 'Something broke!');
});

필수 오류 처리 미들웨어는 일반적으로 마지막에 정의되지 않지만 다른 app.use() 이후 호출은 다음과 같습니다.

var bodyParser = require('body-parser');
var methodOverride = require('method-override');
app.use(bodyParser());
app.use(methodOverride());
app.use(app.router);
app.use(function(err, req, res, next){
 // logic
});

이러한 미들웨어의 응답은 완전히 임의적입니다. HTML 오류 페이지, 간단한 메시지, JSON 문자열 또는 원하는 기타 응답으로 응답할 수 있습니다.

체계적이고 높은 수준의 프레임워크를 구축하려면 일반 미들웨어를 정의하는 것처럼 이러한 오류 처리 미들웨어를 여러 개 정의할 수 있습니다. 예를 들어 XHR 요청에 대한 오류 처리기를 정의한다고 가정해 보겠습니다. 이 외에도 다음을 수행할 수 있습니다.

var bodyParser = require('body-parser');
var methodOverride = require('method-override'); 

app.use(bodyParser());
app.use(methodOverride());
app.use(app.router);
app.use(logErrors);
app.use(clientErrorHandler);
app.use(errorHandler);

보다 일반적인 logErrors에서는 stderr, loggly 또는 유사한 서비스에 요청 및 오류 메시지를 작성할 수 있습니다.

function logErrors(err, req, res, next) {
 console.error(err.stack);
 next(err);
}

clientErrorHandler의 정의는 다음과 같습니다. 이 오류는 다음 오류로 명시적으로 전달됩니다.

function clientErrorHandler(err, req, res, next) {
 if (req.xhr) {
  res.send(500, { error: 'Something blew up!' });
 } else {
  next(err);
 }
}

errorHandler의 다음 "만능" 구현은 다음과 같이 정의할 수 있습니다.

function errorHandler(err, req, res, next) {
 res.status(500);
 res.render('error', { error: err });
}

온라인 사용자 수

이 섹션에서는 Redis를 사용하여 온라인 사용자 수를 추적하는 (소형) 애플리케이션에 대해 자세히 설명합니다. 먼저 패키지를 만듭니다. json 파일에는 두 개의 첨부 파일이 포함되어 있습니다. 하나는 redis 클라이언트용이고 다른 하나는 Express 자체용입니다. 또한 Redis가 $redis-server를 통해 래핑되어 실행되고 있는지 확인하세요.

{
 "name": "app",
 "version": "0.0.1",
 "dependencies": {
  "express": "3.x",
  "redis": "*"
 }
}

다음으로 애플리케이션을 생성하고 Redis에 연결해야 합니다.

var express = require('express');
var redis = require('redis');
var db = redis.createClient();
var app = express();

다음 미들웨어는 온라인 사용자를 추적합니다. 여기서는 정렬된 세트를 사용하여 N 밀리초만 소요되는 redis를 통해 온라인 사용자를 쿼리할 수 있습니다. 우리는 타임스탬프를 회원에 대한 "온라인 표준"으로 사용합니다. 여기서는 일반적인 사용자 ID 대신 사용자 에이전트 문자열을 사용합니다.

app.use(function(req, res, next){
 var ua = req.headers['user-agent'];
 db.zadd('online', Date.now(), ua, next);
});

다음 미들웨어는 zrevrangebyscore를 사용하여 마지막 순간에 최대 온라인 사용자 수를 얻는 것입니다. 우리는 항상 가장 최근 온라인 사용자를 얻습니다. 그의 상한은 현재 타임스탬프에서 60000밀리초를 뺀 값입니다.

app.use(function(req, res, next){
 var min = 60 * 1000;
 var ago = Date.now() - min;
 db.zrevrangebyscore('online', '+inf', ago, function(err, users){
  if (err) return next(err);
  req.online = users;
  next();
 });
});

最后,我们通过一个url使用它,并绑定到一个端口!这就完了,在一个新浏览器访问这个应用程序,您会看到在线人数增加。

app.get('/', function(req, res){
 res.send(req.online.length + ' users online');
});

app.listen(3000);

Expree的反向代理

在反向代理背后使用Expree,如Varnish 或Nginx是微不足道的,然而它需要配置。通过启用“信任代理”设置app.enable(“trust proxy”),Express有一些反向代理的技巧，X-Forwarded - *头字段可能是可信的,否则他们可能很容易被欺骗。

启用该设置有一些微妙的影响。第一个是X-Forwarded-Proto可能被反向代理设定，告诉app那是https或者只是简单的http。这个值由req.protocol反射。

第二个变化是req.ip和req.ips值将填充X-Forwarded-For地址的列表。

调试Express

Express内部使用调试模块记录路径匹配和应用程序模式的信息。要看到这条信息,只要简单设置调试环境变量为express:*,当启动应用程序后，你将在控制台看以调试信息。

$ DEBUG=express:* node ./bin/www

运行这个hello world示例将打印以下内容：

express:application booting in development mode +0ms
express:router defined get /hello.txt +0ms
express:router defined get /hello.txt +1ms

另外, 表达可执行(生成器)生成的程序也使用调试模块,默认作用域是my-application调试命名空间。

你可以用以下命令启用这些调试语句

$ DEBUG=my-application node ./bin/www

关于调试的更多信息,请参见调试 指南