Node.js - 17 데이터 모델 개선(+가상 속성, 액션)

데이터베이스로 데이터 저장 시 스키마로 데이터의 유효성을 검사할 수 없다.

데이터의 일관성을 보장하고 유효성을 검사하기 위한 방법을 알아보자.

 

+) 스키마 타입

JavaScript의 데이터 타입과 비슷하다. 

차이점은 Mongoose 라이브러리와 특정 연관관계가 있다는 것이다.

 

String	JavaScript의 String 타입으로 제공된 데이터를 저장하겠다는 의미.
Date	언제 데이터가 저장되거나 수정됐는지 알 수 있다. JavaScript의 Date 객체를 받을 수 있다.
Array	리스트 아이템을 속성에 저장할 수 있다. 대괄호로 묶은 배열 리터럴을 사용한다.
Mixed	키-값 쌍을 모델에 저장한다. mongoose.Schema.Types.Mixed를 정의해야 한다.
ObjectId	객체를 참조한다. 모델 상호간 조합이 일날 때 특히 중요하다. mongoose.Schema.Types.ObjectId를 정의해야 한다.

 

 

 

Subscriber.js에서 스키마에 Validator 추가

 

데이터의 유효성을 보장하기 위해 Mongoose에 Validator를 추가한다.

Validator는 모델 속성에 적용되며 유효성 검증에 실패하면 DB저장 등을 하지 못하게 한다.

 

 

이메일 주소를 데이터베이스에 저장 시 대소문자 문제를 없애기 위해 lowercase 속성을 true로 설정한다.

우편번호 속성은 필수 항목은 아니지만, 자리수의 최솟값, 최댓값이 존재한다. 10000아래의 값이 입력되면 사용자 정의 에러 메시지를 출력하고, 99999 이상이 입력되면 Mongoose로 부터 에러메시지가 출력되며 데이터는 저장되지 않을 것이다.

(+ 이메일 속성에서 사용된 unique 옵션은 validator는 아니며 mongoose 스키마의 헬퍼에 가깝다. 헬퍼는 경우에 따라 유효성 평가자와 같이 동작하는 메소드 같은 것이다.)

 

 

Subscriber.js에서 스키마에 인스턴스 메소드 추가

 

스키마 파일에 다른 인스턴스나 정적 메소드를 추가할 수 있다. 

instance 메소드는 subscriberSchema.methods 에 의해 정의되고,

정적(static) 메소드는 subscriberShema.statics 에 의해 정의된다.

 

 

23행~25행의 getInfo는 구독자 정보를 한 줄로 얻기 위해 호출한다.

27행~31행의 findLocalSubscribers는 동일 우편번호의 구독자들을 배열의 형태로 돌려준다.

 

 

더 많은 메소드를 정의할 수 있으나, Mongoose 자체적으로 여러가지 쿼리를 제공한다.

쿼리	설명
find	쿼리 매개변수에 맞는 레코드의 배열을 돌려준다. 이름이 "Jon"이라는 구독자를 검색하려면 Subscriber.find({name: "Jon"})으로 검색하면 된다.
findOne	단일 레코드를 돌려준다. Subscriber.findOne({name: "Jon"})을 검색하면 결과들을 하나의 도큐먼트에 담아서 돌려준다.
findById	ObjectId를 키로 쿼리한다. 데이터베이스에 존재하는 데이터를 수정하는데 용이.
remove	모든 도큐먼트를 삭제하기 위한 구문.

 

이들 각 쿼리는 프라미스를 돌려준다. 따라서 then과 catch를 사용해 결과 데이터나 에러 처리를 해야한다.

 

 

 

REPL에서의 테스팅 모델

 

터미널 창에서 node를 입력하고 REPL 모드로 들어가 코드를 입력한다.

(굳이 왜 이렇게 하는지 모르겠어서 걍 안했음)

 

 

 

모델 조합의 생성

 

Mongoose 패키지는 객체지향적 방법으로 데이터베이스 쿼리를 작성하고, 결과를 빠르고 쉽게 가져오도록 하는 메소드를 제공함으로써 개발에 많은 시간을 절약할 수 있게 해준다.

 

그러나 관계형DB가 아니기 때문에 테이블이 존재하지 않고, 조인도 불가능하다.

 

하지만 관계형DB에서의 일대일, 일대다, 다대다 관계를 구현할 수는 있어보인다.

연결된 모델 이름을 속성으로 추가한다. (마치 외래키 필드처럼)

 

ex) 구독자(subscribers)-강좌(courses)

 

 - Course 스키마에 subscribers 속성 추가

 subscribers: [{

    type: mongoose.Schema.Types.ObjectId,

    ref: "Subscriber" }]

>> 한 강좌에 여러명의 구독자가 있을 수 있음.

 

 - Subscriber 스키마에 courses 속성 추가

 courses: [{

    type: mongoose.Schema.Types.ObjectId,

    ref: "Course" }]

>> 여러개의 강좌를 등록할 수 있음.

     대괄호는 다중참조 배열을 의미한다. 구독자가 하나의 강좌만 신청 가능하다면 대괄호를 없애야한다.

 

 

이제 실제로 개별 모델을 연결시키려면 JavaScript 할당 연산자를 사용한다.

 

ex) subscriber1, course1이 있고, 구독자는 다수의 강좌와 연결이 가능하다고 가정.

subscriber1.courses.push(course1)을 실행시켜야 한다. (ObjectId로도 푸시 가능)

 

 

강좌 데이터를 구독자로부터 검색하려면 강좌의 ObjectId와 Course 모델에 대한 쿼리를 사용하거나 연결된 강좌 콘텐츠에 따른 구독자 쿼리를 위한 populate 메소드를 사용할 수 있다.

 

 

연결 모델로부터의 데이터 포뮬레이팅

 

Population은 모델과 연결되어 있는 모든 도큐먼트를 갖고 쿼리 결과에 추가하게 해주는 메소드다.

진짜 뭔소린지 모르겠다.

 

예시로 좀 이해를 해봤는데,

Subscriber.populate(subscriber, "courses") 이렇게 정의하면, 

subscriber 객체와 연결된 모든 강좌를 하나의 Course 도큐먼트로 바꿔주게 된다.

 

예제 코드를 작성해봤다.

const mongoose = require("mongoose"),
Subscriber = require("./models/subscriber"),
Course = require("./models/course");

var testCourse, testSubscriber;

mongoose.connect(
  "mongodb://localhost:27017/recipe_db",
  {useNewUrlParser: true}
);

mongoose.Promise = global.Promise;

Subscriber.remove({})
.then((items) => console.log("Remove " + items.n + " records!"))
.then(() => {
  return Course.remove({});
})
.then((items) => console.log("Remove " + items.n + " records!"))
.then(() => {
  return Subscriber.create({
    name: "Hannah",
    email: "hannah@jo.com",
    zipCode: "12345"
  });
})
.then(subscriber => {
  console.log("Create Subscriber " + subscriber.getInfo());
})
.then(() => {
  return Subscriber.findOne({
    name: "Hannah"
  });
})
.then(subscriber => {
  testSubscriber = subscriber;
  console.log("Found one subscriber: " + subscriber.getInfo());
})
.then(() => {
  return Course.create({
    title: "Tomato Land",
    description: "Locally farmed tomatos only",
    zipCode: 12345,
    items: ["cherry", "heirloom"]
  });
})
.then(course => {
  testCourse = course;
  console.log("Created course: " + course.title);
})
.then(() => {
  testSubscriber.courses.push(testCourse);
  testSubscriber.save();
})
.then(() => {
  return Subscriber.populate(testSubscriber, "courses");
})
.then(subscriber => console.log(subscriber))
.then(() => {
  return Subscriber.find({courses: mongoose.Types.ObjectId(testCourse._id)});
})
.then(subscriber => console.log(subscriber));

 

코드 순서는

1. 구독자 관련 데이터베이스를 깨끗이 정리

2. 프라미스 체인을 구성한다

   구독자 생성 / testSubscriber라는 외부 변수 저장 / testCourse 외부변수 저장

3. 두 모델 인스턴스 연결

4. 연결 populating

5. 결과 로깅

 

 

결과는

 

이렇게 나온다. 더 잘 이해하기 위해 몇번 다시 읽어봐야겠다. 개념이 잘 이해가 안간다.

 

 

 

 

(+ 2021.11.08 16:18 추가)

가상 속성

: 계산된 속성 (computed attribute)

정규 스키마 속성과 유사하지만 데이터베이스에 저장되진 않는다.

DB에 저장되진 않지만 사용자 모델에서 user.zipCode와 같이 다른 속성과 마찬가지로 동작한다.

 

그래서 사용자의 풀네임을 얻기 위한 가상 속성을 추가했다.

 

models/user.js

 

58행은 로그를 찍어보기 위해 추가한 문장이다.

가상속성을 이렇게 지정하고, 컨트롤러나 다른 js 파일에서 user.fullName 이런식으로 접근해서 사용할 수 있고, 그러면 저 함수는 return문에 의해 last와 first name을 합쳐서 전달해준다.

 

이론적으로는 이런데,,, 막상 실행시켜보면 제대로 나오지 않는다. 출력해보면 {} 이런식으로 빈 대괄호가 나오거나

undefined 라고 나온다.. 근데 일단 당장 내 프로젝트에서 사용할 것 같진 않아서 그냥 넘어간다.

 

 

액션

 

지금까지는 모듈의 export 객체에 추가해 새로운 컨트롤러 액션을 생성했다.

그러나 더 많은 액션을 만들수록 export를 그만큼 반복하게 되며, 이것은 그다지 효율적이지 못하다.

 

그래서 새롭게 사용하는 방법이 module.exports 안에 액션을 콤마로 구분해서 모두 포함시키는 것이다.

 

원래같으면 이렇게 exports.(함수이름) 이런식으로 액션을 exports를 반복적으로 사용해서 정의했는데, 그렇게 하지 않고

 

 

이렇게 하겠단 소리이다.

미들웨어 함수와 액션 간의 좀 더 나은 연동을 사용하기 위해 이렇게 수정해서 사용한다.