주소록 - 프로젝트 생성 및 mongoose로 DB 연결

이번 포스팅에서는 주소록을 만들기 위해 새 프로젝트를 생성하고 mongoose로 DB를 연결합니다.
이번 강의를 진행하기 전에 이전 강의(mlab.com가입 및 온라인 Mongo DB 생성)에서 생성한 DB connection string을 환경변수로 MONGO_DB에 저장해 주세요.

• Mongoose는 mongoDB와 node.js를 연결해 주는 ORM library입니다.

프로젝트 생성

프로젝트 폴더를 만들고 npm init으로 package.json을 생성해 줍니다.

다음 명령어를 입력하여 atom 에디터를 실행해 줍니다.

$ atom .

폴더구조

index.js만 생성합니다.(.gitingore, README.md는 github을 위해 생성한 파일입니다. 여러분들은 만드시지 않으셔도 됩니다.)

Package 설치

아래 명령어를 사용하여 ejs, express, mongoose 세개의 package를 한번에 설치해 줍시다.

$ npm install --save ejs express mongoose

코드

var express = require("express");
var mongoose = require("mongoose");
var app = express();

// DB setting
mongoose.set('useNewUrlParser', true);    // 1
mongoose.set('useFindAndModify', false);  // 1
mongoose.set('useCreateIndex', true);     // 1
mongoose.connect(process.env.MONGO_DB); // 2
var db = mongoose.connection; // 3
// 4
db.once("open", function(){
  console.log("DB connected");
});
// 5
db.on("error", function(err){
  console.log("DB ERROR : ", err);
});

// Other settings
app.set("view engine", "ejs");
app.use(express.static(__dirname+"/public"));

// Port setting
var port = 3000;
app.listen(3000, function(){
  console.log("server on! http://localhost:"+port);
});

나머지는 Hello World!강의에서 설명된 내용이고, DB setting 부분만 살펴보겠습니다.

1. mongoose에서 내는 몇가지 경고를 안나게 하는 코드인데, 이 부분이 없어도 실행에는 아무런 문제가 없습니다. 경고가 자꾸 뜬다고 제보해주신 분들이 많아서 추가하였습니다. 자세한 설명은 https://mongoosejs.com/docs/deprecations.html 에서 읽어주세요.

2. node.js에서 기본으로 제공되는 process.env 오브젝트는 환경변수들을 가지고 있는 객체입니다. 저는 DB connection string을 MONGO_DB라는 이름의 환경변수에 저장하였기 때문에 node.js코드상에서 process.env.MONGO_DB로 해당 값을 불러올 수 있습니다.
mongoose.connect("CONNECTION_STRING")함수를 사용해서 DB를 연결할 수 있습니다.

3. mongoose의 db object를 가져와 db변수에 넣는 과정입니다. 이 db변수에는 DB와 관련된 이벤트 리스너 함수들이 있습니다. 

4. db가 성공적으로 연결된 경우 "DB connected"를 출력합니다.

5. db연결중 에러가 있는 경우 "DB ERROR : " 와 에러를 출력합니다.

DB연결은 앱이 실행되면 단 한번만 일어나는 이벤트 입니다. 그러므로 db.once("이벤트_이름",콜백_함수) 함수를 사용했고, error는 DB접속시 뿐만 아니라, 다양한 경우에 발생할 수 있으며, DB 연결 후에는 DB 에러가 발생한 후에도 다른 DB 에러들이 또다시 발생할 수도 있기 때문에 db.on("이벤트_이름",콜백_함수)함수를 사용합니다.

실행결과

이번부터는 nodemon을 사용해 서버를 실행하겠습니다. nodemon으로 서버를 실행하면 서버 코드를 수정시 자동으로 서버를 재시작해줍니다.
우선 아래 명령어로 nodemon을 설치해 주세요.

$ npm install --global nodemon

아래 명령어로 서버를 실행합니다.

$ nodemon

아직 route을 생성하지 않았으므로 http://localhost:3000 으로 접속해도 아무 내용이 뜨지 않지만 console에 DB가 정상적으로 접속이 된 것을 알 수 있습니다.

만일 에러가 있다면

$ printenv

를 입력해서 DB connection string이 환경변수에 제대로 설정되어 있는지, DB connection string이 정확한지를 확인해 주세요.

마치며..

이제 DB가 연결되었으니 활용을 해야겠죠?
다음강좌는 DB활용에 대한 기본적인 이론을 알아보고 실습을 하겠습니다.