멀티 모듈 구조를 사용했습니다.
- 프로젝트 디렉토리로 이동
cd {project-directory}- 프로젝트 빌드하기
./gradlew :app-api- 프로젝트 실행하기
java -jar -Dspring.profiles.active=local app-api/build/libs/app-api-0.0.1-SNAPSHOT.jar- 프로젝트 실행 전에 mysql이 실행되어 있어야한다.
- 로컬에서 테스트 시에는 docker를 사용해 mysql을 실행한다. 실행방법은 로컬에서 docker로 MYSQL 컨테이너 띄우기 참고.
- 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 컨테이너를 띄운다.
- 프로젝트 디렉토리로 이동
cd {project-directory}- 도커 컨테이너 실행
docker-compose up -d- mysql database를 위한 volume을 프로젝트 디렉토리 내에 생성한다.
- ai_review 데이터베이스가 만들어지고 username
reviewpasswordreview로 접속 가능하다. - 띄워진 컨테이너에 접속해서 user가 제대로 생성되었는지 확인해 볼 수 있다.
- 접속 확인하기
docker exec -it mysql-container bash
mysql -u review -p review- 로컬에서 부하 테스트를 위해 docker를 사용해 nGrinder controller 및 agent 1개를 띄운다.
- 프로젝트 디렉토리로 이동
cd {project-directory}- nGrinder controller 및 1개 agent 컨테이너 실행
docker-compose up -d- http://localhost:8880 으로 nGrinder controller UI에 접속할 수 있다.
- 기본 계정은 username
adminpassword `admin' 이다. - 만약 agent 컨테이너가
connection refused에러가 나며 controller에 연결되지 못한 채 종료된다면, amd 문제 일 수 있다(mac m1 등 amd 칩 사용 경우). 이 경우에는 nGrinder의 agent를 직접 실행한다.
./ngrinder-agent/run_agent.sh