Giters

review-with-ai / backend

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

✅API 명세

API 명세

사용 스택

시스템 아키텍처

프로젝트 구조

멀티 모듈 구조를 사용했습니다.

프로젝트 실행하기

app-api 프로젝트 실행하기

  1. 프로젝트 디렉토리로 이동
cd {project-directory}
  1. 프로젝트 빌드하기
./gradlew :app-api
  1. 프로젝트 실행하기
java -jar -Dspring.profiles.active=local  app-api/build/libs/app-api-0.0.1-SNAPSHOT.jar

API 설계 규칙

  • URL을 구성할 때 맨 앞에 버전을 명시한다 ex) /api/v1/...
  • 여러 단어로 구성된 경우 dash를 사용한다 ex) /api/v1/review-cards
  • URL의 Entity를 나타내는 구문은 복수형으로 한다 ex) /api/v1/articles
  • 조회 조건은 쿼리 파라미터를 사용한다 ex) /api/v1/user/1/review-cards?state=done
  • 리소스 만으로 특정 동작을 나타내기 어려울때 특정 행위를 나타내는 단어를 url에 추가하는 것을 허용한다.
    • ex) api/v1/user/review-cards/share
    • GET, POST, PUT, DELETE 로 처리하기 애매한 경우 Control-URL를 사용한다.
  • 모든 성공한 응답은 HTTP Status 200을 보낸다.
  • 모든 실패한 응답은 HTTP Status로 실패를 나타내고, http 메시지 body에 에러 코드와 에러 메시지를 담아서 상세한 내용을 전달한다. 
    {
  "errorCode" : "RESOURCE_NOT_FOUND",
  "errorMessage" : "유저 id = 1000 가 존재하지 않습니다."
}
    • 단, 인증이 실패하였을 때는 HTTP 401 Unauthorized 에러가 반환되고, 에러 메시지는 전달하지 않는다.
  • PUT 메소드는 전체 리소스를 업데이트할때 사용하고, PATCH 메소드는 리소스의 일부를 업데이트할때 사용한다.
  • PATCH 메소드로 특정 필드를 업데이트 할때, 수정할 필드만 http 메시지 바디에 담아서 요청하고, 값이 있는 필드만 수정한다.
  • 쿼리 파라미터나 http 메시지 바디로 전달되는 데이터의 유효성은 dto에서 체크하여 빠르게 실패할 수 있도록 한다.
    • 유효성 검증에 실패한 경우 400 BAD REQUEST를 전달한다.
  • DELETE 메소드는 멱등성을 가지도록 특정 자원을 지정해서 지우도록 한다(/api/v1/users/1가능. /api/v1/users/last 불가능.)
  • API 요청 결과가 여러개였을때 그 최대 limit을 지정해야한다.
    • limit을 쿼리 파라미터로 받고, 서버에서 limit으로 받을 수 있는 값의 범위를 지정한다.
    • limit이 null일 경우의 디폴트 값을 지정해둔다.
  • 인증이 필요한 API의 경우 /api/v1/account/auth를 통해 인증 후 응답받은 token을 header에 포함한 요청만 처리가 된다. 그렇지 않으면 HTTP 401 unauthorized 에러가 반환된다.

인증

  • /api/v1/account/login을 통해 로그인을 요청하면 username, password를 사용해 로그인한 후 jwt 토큰을 응답으로 반환한다.
  • 인증 사용자용 API를 호출할때는 요청 헤더에 X-AIREVIEW-AUTH 항곰을 추가하고, 값으로 로그인 후 전달받은 token에 Bearer 키워드를 붙여 입력한다.
    • JwtAuthenticationTokenFilter는 HTTP 요청 헤더에서 JWT 값을 추출하고 해당 값이 올바르다면 인증된 사용자 정보(JwtAuthenticationToken)을
curl --request GET 'http://localhost:8080/api/v1/users/me' \
--header 'Accept: application/json' \
--header 'X-PRGRMS-AUTH: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9
  • 인증 사용자용 API 호출시 X-AIREVIEW_AUTH 헤더가 누락되거나 값이 올바르지 않은 경우 401 UnAuthorized 에러를 반환한다.

코딩 컨벤션

  • POSIX를 준수하기 위해 모든 파일 끝에 newline을 추가하도록 한다.
    • intellij 설정 ``General > Editor > ensure every saved file ends with a line break``` 을 통해 실수를 방지한다.

🔍 개발 과정

기타

로컬에서 docker로 MYSQL 컨테이너 띄우기

  • 로컬에서 테스트를 위해 docker를 사용해 mysql 컨테이너를 띄운다.
  1. 프로젝트 디렉토리로 이동
cd {project-directory}
  1. 도커 컨테이너 실행
docker-compose up -d
  • mysql database를 위한 volume을 프로젝트 디렉토리 내에 생성한다.
  • ai_review 데이터베이스가 만들어지고 username review password review로 접속 가능하다.
  • 띄워진 컨테이너에 접속해서 user가 제대로 생성되었는지 확인해 볼 수 있다.
  1. 접속 확인하기
docker exec -it mysql-container bash
mysql -u review -p review

로컬에서 docker로 nGrinder 컨테이너 띄우기

  • 로컬에서 부하 테스트를 위해 docker를 사용해 nGrinder controller 및 agent 1개를 띄운다.
  1. 프로젝트 디렉토리로 이동
cd {project-directory}
  1. nGrinder controller 및 1개 agent 컨테이너 실행
docker-compose up -d
  • http://localhost:8880 으로 nGrinder controller UI에 접속할 수 있다.
  • 기본 계정은 username admin password `admin' 이다.
  • 만약 agent 컨테이너가 connection refused 에러가 나며 controller에 연결되지 못한 채 종료된다면, amd 문제 일 수 있다(mac m1 등 amd 칩 사용 경우). 이 경우에는 nGrinder의 agent를 직접 실행한다.
./ngrinder-agent/run_agent.sh

About

Languages

Language:Java 100.0%