update README
This commit is contained in:
71
README.md
71
README.md
@@ -194,58 +194,6 @@ fileUrlPortIn.getInline(
|
|||||||
`inline` 과 `attachment` 는 응답 헤더의 content-disposition 속성 값을 의미합니다.
|
`inline` 과 `attachment` 는 응답 헤더의 content-disposition 속성 값을 의미합니다.
|
||||||
업로드된 파일은 사용자에게 전달할 때 `inline` 과 `attachment` 두 방식 중 요건에 맞게 사용하면 됩니다.
|
업로드된 파일은 사용자에게 전달할 때 `inline` 과 `attachment` 두 방식 중 요건에 맞게 사용하면 됩니다.
|
||||||
|
|
||||||
## 코드 작성 규칙 (coding conventions)
|
|
||||||
|
|
||||||
기본 패키지 구조는 [포트 앤 어댑터 패턴](https://coco-log.tistory.com/205)에 기반해 구성됩니다.
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
getArticles 라는 주제(subject) 패키지 하부를 구성하는 ports 와 adapters 패키지를 주의깊게 봐주세요.
|
|
||||||
|
|
||||||
```
|
|
||||||
# 주제(subject)
|
|
||||||
getArticles
|
|
||||||
|-- adapters
|
|
||||||
| |-- persistence
|
|
||||||
| | |-- GetArticlesDao.java # 포트아웃 구현체
|
|
||||||
| `-- web
|
|
||||||
| |-- GetArticlesController.java
|
|
||||||
| `-- model
|
|
||||||
| `-- GetArticlesReqVO.java
|
|
||||||
`-- ports
|
|
||||||
|-- GetArticlesPortIn.java # 포트인 인터페이스
|
|
||||||
|-- GetArticlesPortOut.java # 포트아웃 인터페이스
|
|
||||||
`-- application
|
|
||||||
|-- GetArticlesService.java # 포트인 구현체
|
|
||||||
`-- domain
|
|
||||||
|-- GetArticles.java
|
|
||||||
`-- GetArticlesCmd.java
|
|
||||||
```
|
|
||||||
|
|
||||||
* ports 는 비지니스 로직을 담는 application 레이어가 위치한 곳입니다. application 은 `포트인` 인터페이스를 통해 호출되며 `포트아웃` 인터페이스를 호출해 결과를 얻습니다.
|
|
||||||
* application 은 누가 `포트인`을 호출하는지 신경쓰지 않습니다. **자신이 호출하는 `포트아웃`의 구현체에 대해서도 모릅니다.** 이를 통해 application 은 다른 계층(web,
|
|
||||||
persistence)과 관계없는 독립적인 레이어가 됩니다.
|
|
||||||
* adapters/web 은 사용자 요청을 처리하는 controller 레이어가 위치한 곳입니다. `포트인` 인터페이스를 호출하는 클라이언트로 해당 규격을 맞춘 어뎁터(adapter) 이며, *
|
|
||||||
*application 에 종속적입니다.**
|
|
||||||
* adapters/persistence 는 영속화(persistence) 레이어가 위치한 곳입니다. mybatis, jpa 등 다양한 ORM 기술을 이용하여 `포트아웃` 인터페이스를 구현합니다. `포트아웃` 규격을
|
|
||||||
맞춘 어뎁터이며, **application 에 종속적입니다.**
|
|
||||||
|
|
||||||
### 자동화 스캐폴딩 (scaffolding) 도구 소개
|
|
||||||
|
|
||||||
위 패키지 구조와 인터페이스 및 구현체를 일일이 타이핑하며 생성할 필요는 없습니다. [BASC](https://code.etribe.co.kr/core-architect/basc) 스캐폴팅 도구가 자동생성
|
|
||||||
해줍니다.
|
|
||||||
|
|
||||||
### Best Practices
|
|
||||||
|
|
||||||
코드 작성 규칙에 맞게 구현된 가장 좋은 예는 관리자의 **예제 게시판**입니다. 새로운 버전에 맞춰 모든 코드들이 재작성되었고 아래 고민들에 대한 해법이 녹아있습니다.
|
|
||||||
|
|
||||||
1. 패키지 구조 및 클래스 명칭을 어떻게 잡아야 할까?
|
|
||||||
2. 브라우저 history 를 잘 유지하면서 back 버튼 이슈를 발생시키지 않는 구현방식은 무엇일까?
|
|
||||||
3. form submit 과 ajax 호출. 어떤 방식이 더 유용할까?
|
|
||||||
4. 사용자 입력값을 검증하고 문제점을 표현하는 가장 좋은 방법은?
|
|
||||||
5. 어떻게 restfull 한 서비스를 구현할 수 있을까? (GET/POST/PUT/PATCH/DELETE)
|
|
||||||
6. 새로운 파일 업로드 방식.
|
|
||||||
|
|
||||||
## PACKAGING
|
## PACKAGING
|
||||||
|
|
||||||
배포방식 설정을 위해 두가지 maven 프로파일을 제공한다.
|
배포방식 설정을 위해 두가지 maven 프로파일을 제공한다.
|
||||||
@@ -265,3 +213,22 @@ $ ll admin/target
|
|||||||
-rw-r--r-- 1 user 197121 94905770 4월 22 09:59 admin-0.0.1-SNAPSHOT.war
|
-rw-r--r-- 1 user 197121 94905770 4월 22 09:59 admin-0.0.1-SNAPSHOT.war
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## 개발 서버 환경
|
||||||
|
|
||||||
|
### database - postgresql 14.17
|
||||||
|
|
||||||
|
```
|
||||||
|
URL: jdbc:postgresql://15.165.180.203:5432/korea_research
|
||||||
|
USERNAME: ko_research
|
||||||
|
PASSWORD: koresearch1@#4
|
||||||
|
```
|
||||||
|
|
||||||
|
### 🚀 ADMIN DEPLOY
|
||||||
|
|
||||||
|
#### `deploy_dev_admin` 브렌치로 merge! pipeline 실행 후 아래 URL 에서 확인가능.
|
||||||
|
* http://ko-research-admin.etribe.co.kr
|
||||||
|
|
||||||
|
### 🚀 FRONT DEPLOY
|
||||||
|
|
||||||
|
#### `deploy_dev_front` 브렌치로 merge! pipeline 실행 후 아래 URL 에서 확인가능.
|
||||||
|
* http://ko-research-front.etribe.co.kr
|
||||||
Reference in New Issue
Block a user