body-parser 미들웨어


이번에는 post로 요청했을때 요청 파라미터를 확인할 수 있도록 만들어둔 body-parser 미들웨어에 대해 알아보겠습니다.



get방식으로 요청할떄는 주소 문자열에 요청파라미터가 들어갑니다.


하지만 이와달리 post방식으로 요청할떄는 본문인 본문영역에 요청 parameter

들어있게 되므로 요청 parameter를 파싱하는 방법이 get방식과 다르게 됩니다.



body-parser 미들웨어는 클라이언트가 post 방식으로 요청할때 본문 영역에 들어있는

요청 파라미터들을 파싱하여 요청 객체의 body속성에 넣어줍니다.



다음과 같이 클라이언트 단에서 post 형식으로 전송할 수 있는 form을 생성해보겠습니다.


먼저 클라이언트 단의 login 페이지를 만들어보겠습니다.


public/login.html

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>로그인 테스트</title>
</head>

<body>
<h1>로그인</h1>
<br>
<form method="post">
<table>
<tr>
<td><label>아이디</label></td>
<td><input type="text" name="id"></td>
</tr>
<tr>
<td><label>비밀번호</label></td>
<td><input type="password" name="password"></td>
</tr>
</table>
<input type="submit" value="전송" name="">
</form>
</body>
</html>





body-parser 모듈을 새로 추가해야됩니다.


다음과 같이 명령 프롬프트에서 입력합니다.

> npm install body-parser --save


다음은 웹서버 입니다.



//Express 기본 모듈 불러오기.

var express = require('express');
var http = require('http');
var static = require('serve-static');
var bodyParser = require('body-parser');
var path = require('path');
//Express 객체 생성
var app = express();

//기본포트를 app 객체에 속성으로 설정
app.set('port', process.env.PORT || 3000);


//body-parser를 사용해 application/x-www-form-urlencoded 파싱
app.use(bodyParser.urlencoded({extended: false}));

//body-parser를 사용해 application/json 파싱
app.use(bodyParser.json());

app.use(static(path.join(__dirname, 'public')));




//미들웨어에서 파라미터 확인
app.use(function(req, res, next){
console.log('첫번째 미들웨어에서 요청을 처리함.');

var paramId = req.body.id || req.query.id;
var paramPassword = req.body.password || req.query.password;

res.writeHead('200',{'Content-type':'text/html;charset=utf8'});
res.write('<h1>express 서버에서 응답한 결과입니다.</h1>');
res.write('<div><p>param id: '+paramId+'</p></div>');
res.write('<div><p>param password: '+paramPassword+'</p></div>');
res.end();
});





//Express 서버 시작
http.createServer(app).listen(app.get('port'), function(){
console.log('Express 서버를 시작했습니다. : '+ app.get('port'));
});


클라이언트에서 요청할떄 get방식으로 요청할지, 아니면 POST방식으로요청할지 모르는 경우엔

어떻게 처리르해야할까요?

두가지 모두 고려하기위해서 다음처럼 두가지 요청 파라미터를 모두 검사합니다.


post 방식 vs get방식 모두 고려!
var paramId = req.body.id || req.query.id;


http://localhost:3000/login.html

아이디와 패스워드를 입력후 전송버튼을 누릅니다.



[결과화면] 


Express 요청 객체에 추가한 header와 parameter 분석



[표] Express에서 추가로 사용할 수 있는 요청 객체의 속성들.

 추가한정보          

 설명

 query    

 클라이언트에서 get방식으로 전송한 요청 파라미터를 확인합니다. ex) req.query.name

 body 

 클라이언트에서 POST방식으로 전송한 요청 파라미터를 확인합니다.

단 body-parser와 같은 외장 모듈을 사용해야합니다.

ex) req.body.name

 header(name) 

 헤더를 확인합니다.



요청하는 파라미터는 query string 이라고 합니다. 

클라이언트에서 서버로 요청할떄 문자열로 데이터를 전달하는것을 지칭합니다.


req객체의 query 객체 안에 넣어두어 사용합니다.


client 가 요청할 때 전달되는 헤더값들은 header()메소드로 확인할 수 있습니다.




//Express 기본 모듈 불러오기.

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

//Express 객체 생성
var app = express();

//기본포트를 app 객체에 속성으로 설정
app.set('port', process.env.PORT || 3000);



app.use(function(req, res, next){
console.log('첫번째 미들웨어 요청 처리');

var userAgent = req.header('User-Agent');
var paramName = req.query.name;

res.writeHead('200', {'Content-Type': 'text/html; charset=utf8'});
res.write('<h1>Express 서버에서 응답한 결과</h1>');
res.write('<div><p>user-agnet: ' + userAgent + '</p></div>');
res.write('<div><p>Param name: ' + paramName + '</p></div>');
res.end();

});


//Express 서버 시작
http.createServer(app).listen(app.get('port'), function(){
console.log('Express 서버를 시작했습니다. : '+ app.get('port'));
});



웹사이트에서 다음과 같은 url을 입력해봅니다.  query 에 name=jinss값을 넣어서 요청을 합니다.


http://localhost:3000/?name=jinss


[결과화면]



Client가 주소 문자열에 포함시켜 전달하는 요청 parameter를 web server에서 받아 확인할때는 복잡하지만, Express를 사용하면 매우 편하게 확인할 수 있습니다.






Express 의 요청 객체와 응답객체 알아보기



Express에서 추가로 사용할수있는 응답 객체 메소드.


 메소드이름   

 설명

 send([body])

  클라이언트에 응답 데이터를 보냅니다. 전달할 수 있는 데이터는 html 문자열, Buffer 객체, json 객체, json 배열입니다.

 status(code)

 http 상태코드를 반환합니다. 상태코드는 end()나 send()같은 전송 메소드를 추가로 호출해야전송할 수 있습니다.

 sendStatus(statusCode)

 http 상태 코드를 반환합니다. 상태코드는 상태메세지와함꼐 전송됩니다.

 redirect([status,] path)

 웹페이지 경로를 강제로 이동시킵니다.

 render(view[,locals][,callback])

 뷰엔진을 사용해 문서를 반든 후 전송합니다.


다음 아래와 같이, response (응답) 객체를 사용해보았습니다.


response 객체의 send method 사용예제입니다.



//Express 기본 모듈 불러오기.

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

//Express 객체 생성
var app = express();

//기본포트를 app 객체에 속성으로 설정
app.set('port', process.env.PORT || 3000);

//첫번째 미들웨어
app.use(function(req, res, next){
console.log("첫번째 미들웨어에서 요청을 처리함.");
res.send({name:'소녀시대', age:20});
next();
});


//Express 서버 시작
http.createServer(app).listen(app.get('port'), function(){
console.log('Express 서버를 시작했습니다. : '+ app.get('port'));
});




response 객체의 redirect 사용예제입니다.


//Express 기본 모듈 불러오기.

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

//Express 객체 생성
var app = express();

//기본포트를 app 객체에 속성으로 설정
app.set('port', process.env.PORT || 3000);



app.use(function(req, res, next){
console.log("첫번째 미들웨어에서 요청을 처리함.");
res.redirect('http://google.co.kr');
});


//Express 서버 시작
http.createServer(app).listen(app.get('port'), function(){
console.log('Express 서버를 시작했습니다. : '+ app.get('port'));
});


노드 서버를 실행후, 127.0.0.1:3000 으로접속하면 google로 redirect되는것을 확인하실 수 있습니다.






node.js middleware 사용


Middleware란 Client의 요청이 들어왔을 때 매번 수행되어야할 행위들을  말합니다.


미들웨어를 전부통과하고나서 적절한 response를 client에게 주도록 설계합니다.



//Express 기본 모듈 불러오기.

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

//Express 객체 생성
var app = express();

//기본포트를 app 객체에 속성으로 설정
app.set('port', process.env.PORT || 3000);

//첫번째미들웨어 등록
app.use(function(req, res, next){
console.log('첫 번째 미들웨어에서 요청을 처리함.');
req.user ='jinss';
next();
});
//두번째 미들웨어 등록
app.use('/', function(req, res, next){
console.log('두 번째 미들웨어에서 요청을 처리함.');
res.writeHead('200', {'Content-Type': 'text/html; charset=utf8'});
res.end('<h1>Express 서버에서' +req.user+'가 응답한 결과</h1>');
});


//Express 서버 시작
http.createServer(app).listen(app.get('port'), function(){
console.log('Express 서버를 시작했습니다. : '+ app.get('port'));
});


[서버실행 화면]



[웹브라우저 접속시 웹브라우저 화면]


[서버 콘솔 응답]



middleware 는 위에서 아래로 등록한 순서대로 실행을 타게 됩니다.


첫번째 middleware 에서는 req객체에 user속성을 추가하고 그값으로 문자열을 하나 넣습니다.

두번째 middleware에서 req객체에 설정된 user속성을 확인하여 사용자 정보를 사용할 수 있습니다.



참고>>

middleware 안에서는 기본적으로 요청 객체인 req와 응답객체인 res 객체를 Parameter로 전달받아 사용할수있습니다.



그리고 이 middleware함수를 호출한 app객체도 참조할수있습니다.

req.app 코드를 사용하면 app 객체 참조가능합니다.



middleware함수를 보면 요청 객체와 응답 객체가 파라미터로 전달되며, 그다음 middleware로

넘길 수 있는 next 함수 객체도 전달됩니다. 따라서 next 함수 객체를

실행하면 다음middleware로 넘길 수 있습니다.



middleware를 사용하기 위해서 먼저 use() 메소드를 호출해야하며, middleware 2개를 등록했습니다.



익스프레스 (Express) 웹 서버 만들기


http모듈만 사용해서 웹서버를 만들기엔 직접만들어야할것들이 많습니다.

그렇기때문에 보통 노드로 웹서버를 구현할때는 Express를 이용하는 편입니다.



그리고 Express에서 제공하는  middlewarerouter를 사용하면 훨씬 편리하게 구성할수있게됩니다.



-새로운 Express(익스프레스) Server 만들기.


명령프롬프트에 다음과 같이 입력합니다.

> npm init

> npm install express --save                           //express 모듈을 설치하기 위한 명령어입니다

app.js 파일의 코드는 아래와 같습니다.


//Express 기본 모듈 불러오기.

var express = require('express');
var http = require('http');
// 참고로 expree와 http는 내장모듈입니다.
// 그리고 express 모듈은 웹서버를 위해 만들어진것으로 http 모듈 위에서 동작합니다.
// 따라서 express 모듈을 사용할때는 항상 http 모듈도 함꼐 불러들여야 합니다.



//Express 객체 생성
var app = express();

//기본포트를 app 객체에 속성으로 설정
app.set('port', process.env.PORT || 3000);

//Express 서버 시작
http.createServer(app).listen(app.get('port'), function(){
console.log('Express 서버를 시작했습니다. : '+ app.get('port'));
});


[결과화면]


app 객체는 express() 메소드를 호출로만들어지는 익스프레스 서버 객체입니다.



express() 메소드를 호출하여 만든 app 객체의 주요 method

 메소드 이름 

  설명

 set(name,vlaue)

 서버 설정을 위한 속성을 지정합니다. set() 메소드로 지정한 속성은 get()메소드로 꺼내어 확인할 수 있습니다.

 get(name)

 서버 설정을 위해 지정한 속성을 꺼내옵니다.

 use([path,] function[,function...])

 미들웨어 함수를 사용합니다.

 get([path,] function)

 특정패스로 요청된 정보를 처리합니다.




서버 설정을 위해 미리 정해진 app 객체의 주요 속성

 속성이름   

 설명

 env   

 server mode를 설정합니다.

 views

 view 들이 들어있는 폴더 또는 폴더 배열을 설정합니다.

 view engine

 default로 사용할 view engine을 설정합니다.


+ Recent posts