[TIL] Week 8 도서 API

📖 도서 테이블 생성

ERD

처음에 DB를 이렇게 설정했지만 일부 컬럼명이 SQL 예약어랑 겹치고 있어 변경해주었다. 

예약어 : DB에서 SQL 용어로 사용 중인 단어 

• format → form
• description → detail
• index → contents

 

📕 도서 전체 조회 API

const allBooks = (req, res) => {
    let sql = 'SELECT * FROM books';
    
    conn.query(sql, (err, results) => {
        if (err) {
            console.log(err);
            return res.status(StatusCodes.BAD_REQUEST).end();
        }

        return res.status(StatusCodes.OK).json(results);
    })
};

화면 설계 상 도서의 모든 정보가 필요하진 않지만 굳이 잘라서 보내주기 보다는

프론트 상에서 필요한 정보만 가져다 쓰도록 작업

대신, API 명세서에 모든 내용이 포함되어있다는 내용을 추가

 

📗 상세 도서 조회 API

const bookDetail = (req, res) => {
    const {id} = req.params;

    let sql = 'SELECT * FROM books WHERE id=?';
    
    conn.query(sql, id,
        (err, results) => {
            if (err) {
                console.log(err);
                return res.status(StatusCodes.BAD_REQUEST).end();
            }

            if(results[0])
                return res.status(StatusCodes.OK).json(results[0]);
            else
                return res.status(StatusCodes.NOT_FOUND).end();
    })
};

results에 값이 1개만 들어오는데도 배열로 담아주고 있기 때문에 results[0]를 반환

 

📷 Picsum

Lorem Picsum

 

이미지를 가져다 사용할 수 있는 사이트

 

https://picsum.photos/id/{이미지id}/{width}/{height}

원하는 이미지의 아이디값을 넣어주고 원하는 크기를 함께 넣어서 호출해 사용할 수 있다. 

 

📘 카테고리별 도서 목록 조회 API

router.get('/', allBooks); // 전체 도서 조회
router.get('/:id', bookDetail); // 개별 도서 조회
router.get('/', booksByCategory); // 카테고리별 도서 목록 조회

같은 HTTP method, 같은 URI라면 먼저 작성된 라우터가 우선순위를 가지게 된다. 

따라서 아무리 bookByCategory가 쿼리를 포함해서 요청한다하더라도 allBooks가 먼저 실행되게 된다. 

 

따라서 둘을 분리하지말고 합친 다음 쿼리 유무에 따라 다른 결과를 반환하도록 해야한다.

 

const allBooks = (req, res) => {
    let {category_id} = req.query;

    if(category_id) {
        let sql = 'SELECT * FROM books WHERE category_id=?';
        conn.query(sql, category_id,
            (err, results) => {
                if (err) {
                    console.log(err);
                    return res.status(StatusCodes.BAD_REQUEST).end();
                }
    
                if(results.length)
                    return res.status(StatusCodes.OK).json(results);
                else
                    return res.status(StatusCodes.NOT_FOUND).end();
            }
        )
    } else {
        let sql = 'SELECT * FROM books';
    
        conn.query(sql, (err, results) => {
            if (err) {
                console.log(err);
                return res.status(StatusCodes.BAD_REQUEST).end();
            }
    
            return res.status(StatusCodes.OK).json(results);
        })
    }
};

 

쿼리에 카테고리 id가 들어왔다면 카테고리별 도서 목록을 조회해 반환하고, 

 

쿼리에 카테고리 id가 없다면 전체 도서를 반환하도록 수정하였다. 

 

🔖 카테고리 전체 목록 조회 API

위 API를 받는 사람은 카테고리 id만을 가지고는 무슨 카테고리인지 알 수 없다. 

그래서 id값 대신 카테고리명을 돌려줘야할 것 같다.

 

먼저 카테고리명부터 전체 조회 해보자

 

const allCategory = (req, res) => {
    let sql = "SELECT * FROM category";
    conn.query(sql, (err, results) => {
        if (err) {
            console.log(err);
            return res.status(StatusCodes.BAD_REQUEST).end();
        }

        return res.status(StatusCodes.OK).json(results);
    })
};