rotatelogs를 이용시, tomcat pid가 저장되어야하는 경로에 tomcat pid가 아닌 rotatelogs 데몬의 pid가 저장됨 shutdown.sh이나 catalina.sh stop 을 통해 종료할 때에 프로세스가 종료되지 않는 문제

해결 방안

catalina.sh 파일내용 중 tomcat.pid 저장하는 부분을 수정

• 원본

  if [ ! -z "$CATALINA_PID" ]; then
    echo $! > "$CATALINA_PID"
  fi

• 변경 후

  if [ ! -z "$CATALINA_PID" ]; then
    #echo $! > "$CATALINA_PID"
    `/bin/ps -ef | grep Tomcat_instance_Name | grep java | grep -v grep | awk '{print $2}' > $CATALINA_PID`
  fi

  종료시에 -force 옵션추가 하면, 정상적으로 종료가 되지 않았을 때 해당 pid를 가지고 kill -9 명령어를 입력해서 종료함

출처 rotatelogs 사용시 Tomcat PID 문제

개발을 하다보면 여러가지 환경(=개발, 배포, 테스트 등)에 맞춰 properties 파일의 값을 변경해줘야할 일이 있습니다.

• DB 접속 정보
• log 파일의 위치

이런 내용들을 각 환경에 맞는 properties로 구성해놓는 뒤, 각 환경에서 가져다 쓰는 properties 파일이 다르면 편리하겠죠?

ex)

• 개발 서버(window) : DB - 개발DB, 파일 경로 등의 위치 - D:/dev/...(윈도우 폴더구조에 맞게)~
• 실서버(linux) : DB - 운영DB, 파일 경로 등의 위치 - /home/...(리눅스 디렉토리 구조에 맞게)~

구성하는 방법

1. 각 필요한 환경에 맞춰 properties파일을 구성한다 변경 전 : application.properties 변경 후 : application-dev.properties, application-test.properties, application-prod.properties 등 이 때, dev, test, prod은 정해진 이름이 아니고 원하는 이름으로 정하면 된다.
   application.properties 파일이 존재해도 되고, 존재하지 않아도 된다. 다만 default 값이 application.properties 파일이기 때문에, 존재하지 않는다면 default 파일도 설정해야한다.

2. 프로젝트 실행 시, 어떤 환경인지 설정한다. 아래의 방법 중 하나를 선택해서 진행하면 된다.

   • intelliJ와 같은 IDE 툴이라면, 실행 구성 편집에 들어가서 active profile 값에 prod 와 같이 옵션 설정
   • SpringApplication.setAdditionalProfiles(...)을 애플리케이션이 실행되기전에 호출해 설정
   • properties 파일에서 spring-profiles-active=prod 와 같이 설정
   • OS 환경변수에 SPRING-PROFILES-ACTIVE 설정
   • jar 파일을 실행할때, -Dspring.profiles.active=prod 옵션을 주어서 실행

     설정을 application.properteis파일로 하고싶다면, default 값으로 설정하면 된다.

3. 확인하는 방법 프로젝트를 실행할 때, 로그에서 No active profile set, falling back to 1 default profile: "default" 와 같은 문구나 The following 1 profile is active: "dev" 와 같은 문구가 초반에 뜨게 된다. 첫번째 문장은 active된 profile이 없어서 default profile(=application.properties) 두번째 문장은 dev profile 로 설정되었다는 로그다.

스프링 버전 2.4 이하에서는 각 properties 파일마다 spring.profile.active=[현재 프로필] 과같이 명시를 해주어야 했는데, 이 이후에는 그렇지 않다고 한다.

• 테이블 스캔 : 테이블 데이터로 직접 접근
• 인덱스 스캔 : 인덱스를 통해 테이블 데이터에 접근

테이블 스캔

테이블 풀 스캔 ( Table Full Scan )

• 테이블에 포함된 레코드를 처음부터 끝까지 읽어들임
• where 조건문에 기준으로 활용할 인덱스가 없는 경우
• 대량의 데이터의 접근시 테이블 풀 스캔을 쓰면, 인덱스를 통한 랜덤 엑세스가 발생하지 않는 장점

인덱스 스캔

인덱스 풀 스캔 ( Index Full Scan )

• 인덱스만 풀 스캔해 원하는 데이터를 가져오는 것
• 인덱스는 테이블의 일부 데이터를 사용
• 검색 되는 데이터 극히 일부면 좋음

인덱스 범위 스캔 ( Index Range Scan )

• 인덱스를 범위 기준으로 스캔한 뒤 스캔 결과를 토대로 테이블에 접근( BETWEEN ~ AND, LIKE, < 등을 사용시 )
• 좁은 범위로는 좋지만 넓은 범위로는 비효율적

인덱스 고유 스캔 ( Index Unique Scan )

• 수직적 탐색만으로 찾는 방식, 기본키나 고유 인덱스로 테이블에 접근( = 사용시 )
• 인덱스를 사용하는 방식 중 가장 효율적

인덱스 루스 스캔 ( Index Loose Scan )

• 인덱스에서 필요한 부분만 선택하여 스캔하는 방식, where 조건문을 기준으로 불필요한 인덱스 키는 무시 ( GROUP BY, MAX(), MIN() 함수 포함 시 )

인덱스 병합 스캔 ( Index Merge Scan )

• 테이블 내에 생성되 인덱스를 통합하여 스캔하는 방식
• WHERE문의 조건 열이 서로 다른 인덱스에 존재할 때 사용됨.
• 인덱스 병합 스캔은 물리적으로 존재하는 개별 인덱스를 각각 접근

index fast full scan

• index full scan 보다 빠름, 인덱스 구조를 따라서 스캔하지 않고 세그먼트 전체를 스캔
• 결과 집합 순서 보장이 안됨

참조

1. [DB] 테이블 데이터 스캔 방식 및 디스크 접근 정리
2. 인덱스 풀 스캔(INDEX FULLSCAN)
3. 인덱스 스캔 방식 및 인덱스 쿼리튜닝

REST에서 resource란 기본 데이터 표현으로 일관된 REST resource 명명 전략을 갖는 것은 장기적으로 최고의 설계 결정 중 하나일 것입니다.

리소스는 특정 시점에 해당하는 엔티티가 아니라 엔티티 집합에 대한 개념적 매핑입니다. — Roy Fielding’s dissertation

1. Singleton & Collection

리소스는 싱글톤 또는 컬렉션인데, 이때 싱글톤은 customer이고, customers는 리소스입니다. /customers/{customerId}와같은 방법을 사용해 컬렉션 리소스를 식별할 수 있습니다.

2. Collection & Sub-collection

리소스에는 하위 컬렉션 리소스도 포함될 수 있습니다. customers/{customerId}/accounts와 같은 방식으로 컬렉션 리소스 내부에 싱글톤 리소스를 식별 할 수 있습니다.

3. URI

REST API는 URI를 사용해 리소스를 처리하기 때문에 리소스의 이름을 직관적이고 사용하기 쉽게 만들어야 사용하기 쉽습니다.

naming tip

1. 명사 사용

: 명사에는 동사에 없는 속성이 있는데, 리소스에도 속성이 있어 이를 표현하기에 명사가 좀 더 적합

http://api.example.com/device-management/managed-devices 
http://api.example.com/device-management/managed-devices/{device-id} 
http://api.example.com/user-management/users
http://api.example.com/user-management/users/{id}

2. 일관성

• 슬래시(/)를 사용해 계층관계를 표현

  http://api.example.com/device-management
  http://api.example.com/device-management/managed-devices
  http://api.example.com/device-management/managed-devices/{id}
  http://api.example.com/device-management/managed-devices/{id}/scripts
  http://api.example.com/device-management/managed-devices/{id}/scripts/{id}

• URI에 마지막에 슬래시(/)사용 X -> 혼동을 줄 수 있음

  👎http://api.example.com/device-management/managed-devices/
  👍http://api.example.com/device-management/managed-devices

• 하이픈(-) 사용해 가독성 향상

  👎http://api.example.com/device-management/managed-devices
  👍http://api.example.com/devicemanagement/manageddevices

• 밑줄(_) 사용 X, 밑줄 대신 하이픈(-)사용

  👎http://api.example.com/inventory-management/managedEntities/{id}/installScriptLocation
  👍http://api.example.com/inventory-management/managed-entities/{id}/install-script-location

• URI에 소문자 사용

  👍http://api.example.org/my-folder/my-doc
  👎HTTP://API.EXAMPLE.ORG/my-folder/my-doc
  👎http://api.example.org/My-Folder/my-doc

3. 파일 확장자 사용 X

파일 확장자는 Content-Type에 의존해 처리

👎http://api.example.com/device-management/managed-devices.xml
👍http://api.example.com/device-management/managed-devices

4. URI에 CRUD 사용 X

어떤 CRUD 기능을 하는지는 HTTP 요청 방법을 사용해 표현

//Get all devices
HTTP GET http://api.example.com/device-management/managed-devices
//Create new Device
HTTP POST http://api.example.com/device-management/managed-devices

//Get device for given Id
HTTP GET http://api.example.com/device-management/managed-devices/{id}
//Update device for given Id
HTTP PUT http://api.example.com/device-management/managed-devices/{id}
//Delete device for given Id
HTTP DELETE http://api.example.com/device-management/managed-devices/{id}

5. 쿼리 구성요소를 사용해 URI 컬렉션 필터링

http://api.example.com/device-management/managed-devices
http://api.example.com/device-management/managed-devices?region=USA
http://api.example.com/device-management/managed-devices?region=USA&brand=XYZ
http://api.example.com/device-management/managed-devices?region=USA&brand=XYZ&sort=installation-date

문자열에서 특정 문자 조합을 찾기 위한 패턴

java에서 정규식 사용하기

java에서 정규식을 사용하기 위해서는 java.util.regex의 Pattern, Matcher 두 가지의 클래스를 이용한다.

Pattern

Perl에서 사용되는 구문과 유사한 구문으로 문자열 형식으로 지정된 정규식을 나타냄 Pattern을 통해 문자열로 지정된 정규식을 컴파일한 후, 결과 패턴을 이용해 Matcher를 생성한다.

Pattern 사용 방법

Matcher 생성 하는 방법

Pattern p = Pattern.compile("a*b");
Matcher m = p.matcher("aaaaab");
boolean b = m.matches();

Matcher 생성 하지 않고 하는 방법

boolean b = Pattern.matches("a*b", "aaaaab");

차이

위의 두 코드는 결과가 같다. 이때 이 둘의 차이점은 정규식의 재사용을 두고 얘기할 수 있다. Matcher를 생성하면 여러 텍스트에 대해서 하나의 생성된 Matcher를 계속 반복해서 사용할 수 있지만, 두번째와 같이 Matcher를 생성하지 않으면, 사용된 정규식은 한번만 사용된다.

주요 메서드

백슬래시, 이스케이프

정규식을 만들다 보면 (,[,.등 처럼 특수문자를 그대로 인식해야하는 경우나 \d등 같은 정규식 문법을 사용해야하는데, java에 "\("으로 입력해 사용하면 오류가 난다.

• 이스케이프 이때는 특수문자 앞에는 \\이렇게 백슬래시를 2번 붙여서 사용한다. \\( ( -> \\(
• 백슬래시 이때는 \ 앞에 한번 더 붙여 사용한다. \d -> \\d

Matcher

주어진 패턴과 텍스트가 일치하는지 확인하는 엔진

Matcher 사용 방법

확인 작업과 주요 메서드를 조합해서 사용

만약 matches(), lookingAt(), find()를 하지 않고 바로 group()와 같은 메서드를 호출하면 오류 발생

String orgFileName = "가나다(1)";//테스트용 텍스트
Pattern pattern = Pattern.compile("\\([0-9]+\\)$");//정규식 컴파일
Matcher matcher = pattern.matcher(orgFileName);//Matcher 생성
while (matcher.find()) {//확인 작업
    String group = matcher.group();//찾아진 텍스트 
    System.out.println("Found: " group);
}

확인 작업

• matches() : 정규식을 전체 문자열에 대해서 완전히 일치하는지 여부

  ex) 정규식이 \[a-zA-Z\\s\]인 경우, "aaa 123 bbb" -> false "aaa bbb" -> true

• lookingAt() : 정규식에 일치하는 문자열로 시작하는지 여부

  ex) 정규식이 123인 경우, "abd 123" ->false "123 abc" -> true

• find() : 정규식에 해당하는 문자열이 있는지 여부

  ex) 정규식이 123인 경우, "abd 123" -> true "123 abc" -> true "가나다 text 123 가나다 12 abc" -> true "가나다 text 111 가나다 12 abc" -> false

주요 메서드

참고

1. java 공식 문서
2. Java RegEx: 파트 5 - match(), lookAt(), find()

@Test
void 정규식_테스트() {
    String text = "가나다(2)";

    Pattern pattern = Pattern.compile("\\([0-9]+\\)$");
    String res = pattern.matcher(text).group();
    log.info("res = {}", res);
}

가나다(2)에서 (2)와 같이 괄호 안에 숫자만 있는 부분을 정규식으로 잡아서 처리하고 싶었는데, 어째서인지 자꾸 No match found라는 메시지가 나오면 오류가 나왔으며, find()를 실행 했을 때에는 true값이 나오는 이상한 상황이였다.

자바 정규식은 Pattern과 Matcher를 이용하는데, Matcher에서 group()은 매칭된 부분을 반환해주고, find()는 대상 문자열과 패턴이 일치하는 지를 boolean값으로 반환해준다. 당연히 group()을 했을때, 반환되는 문자열이 없으면 ''와 같이 리턴이 될 줄 알았는데, 계속해서 오류로 처리가 되었다.

문제 원인

find()를 먼저 실행해서 찾게 하고, 그 이후에 end(), group()등과 같은 메서드를 실행해야 하는데, 하지 않아서 문제가 되었다.

해결방법

@Test
void 정규식_테스트() {
    String text = "가나다(2)";

    Pattern pattern = Pattern.compile("\\([0-9]+\\)$");
    Matcher matcher = pattern.matcher(text);
    if(matcher.find()){
        String res = matcher.group();
        log.info("res = {}", res);
    }
}

위와 같이 find()를 먼저 실행해서 찾고, 그 이후에 group(), end()와 같은 메서드를 실행한다.

참고

1. [Java] 정규표현식 사용법 및 예제 - Pattern, Matcher

${#request.requestURI}

navbar에 현재 위치 표시하기

<li class="nav-item" th:classappend="${#request.requestURI.equals('/test.do')}? 'active': ''">
</li>

언어(한글화)

language : {
  emptyTable: "데이터가 없습니다.",
  lengthMenu: "_MENU_",
  info: "현재 _START_ - _END_ / 총 _TOTAL_건",
  infoEmpty: "데이터 없음",
  infoFiltered: "( _MAX_건의 데이터에서 필터링됨 )",
  loadingRecords: "로딩중...",
  processing:     "잠시만 기다려 주세요...",
  paginate: {
      "next": "다음",
    "previous": "이전"
  },
  select: {
    rows: ""
  }
}

columns 와 columnDefs

columns: [
{ data: "id" , width: '10%'},
{ data: "phrase" , width: '75%'},
{
  defaultContent: "-", // 값이 없을때
  orderable: false, //정렬
  className: 'button',
  width: '10%', // 가로 값
  targets:   2, // 몇번째 컬럼
  render: function (data, type, row){// data: 데이터, row: 표현되는 줄에 다른 값 접근 가능
    const keywordId= row.id;
    return '<button onclick=\"alert("아이디는 '+keywordId+'");\">버튼</button>';// 이 부분이 실제로 표현됨
    }
  }
]

columnDefs = [
  { targets: 0, width: '6%',}, // 0번째를 6%로 설정
  { targets: 1, width: '7%',},
  { targets: 2, width: '11%',}
]

columns만 쓸 수도 있고, columnDefs와 같이 쓸 수도 있음

반응형

• 기능 설정

  //반응형 화면이 작을때 너무 많은 내용이면 몇개의 컬럼만 남기고 안보이게함 (+버튼을 누르면 보이게됨)
  responsive:false

• 반응형이 될 때 화면에 맞춰서 사라질 컬럼 순서 지정

  columnDefs:[
  {responsivePriority : -3 , targets: 1},
  {responsivePriority : -2 , targets: 2},
  {responsivePriority : 10009 , targets: 3},
  {responsivePriority : 10008, targets: 4},
  {responsivePriority : 10007 , targets: 5},
  {responsivePriority : 10006 , targets: 6},
  {responsivePriority : 10005 , targets: 7},
  {responsivePriority : 10004 , targets: 8},
  {responsivePriority : 10003 , targets: 9},
  ]

  columnDefs에 responsivePriority값을 지정 숫자가 큰 숫자일 수록! 먼저 사라짐, 음수는 사라지지 않게! 근데 정확하지 않은 내용인건지 음수인것도 화면이 너무 작으면 사라지거나 순서가 약간 다름

그 외 기능

//////// 기본기능
// 표시 건수(기본값 true)
lengthChange: false,
// 검색(기본값 true)
searching: false, //filter와 같은 듯?
// 정렬(기본값 true)
ordering: false, 
// 정보 표시(기본값 true)
info: false,
// 페이징(기본값 true)
paging: false,


// 그 외 설정
// 한 페이지에 보여줄 row 개수, 처음 화면
pageLength: 10,
//자동으로 width 변경(기본값 true)
autoWidth:false,
// 정렬 기준, 처음 화면
order: [[ 0, "asc" ]] // 다중시 [ [ 0, "asc" ], [ 1, "desc"] ]
// 기본 기능의 위치 변경 시
dom:<"#table_top.col-sm-12"<"col-sm-10"i><"col-sm-2"l>>tp //i(info)f(filter)l(length change)t(table)p(paging)

DOM 참고 https://datatables.net/reference/option/dom https://datatables.net/examples/basic_init/dom.html

데이터

ajax

ajax: { 
  url: 실제url,
  type:"GET", 
  dataSrc: ''
}

ajax: '../server_side/scripts/server_processing.php' //json형식으로 데이터가 있는 file

HTML

data

이벤트

자동으로 번호

drawCallback: function( settings ) {
  var api = this.api();
  var num = 1;
  api.rows().every( function () { // rows({page:'current'})
    $(this.node()).find('td').eq(0).html(num);
    num = num + 1;
  } );
}

• 위치: 파일 및 코드 템플릿 - 파일 - class(원하는 타입 선택) -포함

• 내용: 원하는 내용 작성

  • 사용한 템플릿

  /**
   * description    :
   * packageName    : ${PACKAGE_NAME}
   * fileName       : ${NAME}
   * author         : ${USER}
   * date           : ${DATE}
   * ===========================================================
   * DATE              AUTHOR             NOTE
   * -----------------------------------------------------------
   * ${DATE}        ${USER}       최초 생성
   */

  • 템플릿 변수

  변수이름	설명
  ${PACKAGE_NAME}	새 파일이 생성되는 패키지 이름
  ${USER}	현재 유저 시스템 로그인 이름
  ${DATE}	현재 시스템 날짜
  ${TIME}	현재 시스템 시간
  ${YEAR}	현재 년도
  ${MONTH}	현재 월
  ${MONTH_NAME_SHORT}	현재 월 이름 첫 세글자. 예: Jan, Feb 등등.
  ${MONTH_NAME_FULL}	현재 월의 이름 전체. 예: January, February 등등.
  ${DAY}	현재 일
  ${DAY_NAME_SHORT}	현재 요일의 첫 세 글자. 예: Mon, Tue 등.
  ${DAY_NAME_FULL}	현재 요일 이름 전체. 예: Monday, Tuesday 등.
  ${HOUR}	현재 시
  ${MINUTE}	현재 분
  ${PROJECT_NAME}	현재 프로젝트 이름

메서드 템플릿

1. JavaDoc plugins 설치

2. 도구 - JavaDoc - Templates

3. Method level - .+ 선택 및 편집 ( 더블 클릭 )

상단에 내용 추가

* description : 
* methodName : ${element.getName()}
* author : GongSuJeong
* date : 2022.06.

1. 서비스

• 서비스 - window update - 일반 일반 - 시작유형: 사용 안함 일반 - 서비스 상태: 중지 복구 - 모든 실패를 동작하지 않음으로 설정

2. 로컬 그룹 정책 편집기

window키 + R - gpedit.msc 로 로컬 그룹 정책 편집기 열기

windows 업데이트

로컬 컴퓨터 정책 - 컴퓨터 구성 - 관리 템플릿 - windows 구성 요소 - window 업데이트 에서

• windows 업데이트에서 제공된 업데이트 관리 - 자동 업데이트 검색 주기 사용 안함

• windows 업데이트에서 제공된 업데이트 관리 - 대상 기능 업데이트 버전 선택 사용 21H1

• 레거시 정책 - 자동 업데이트로 바로 설치 허용 사용 안함

• 레거시 정책 - 자동 업데이트를 통한 권장 업데이트 설정 사용 안함

• 최종 사용자 환경 관리 - 자동 업데이트 구성 사용 안함

• 최종 사용자 환경 관리 - 사용 시간 중 업데이트를 위한 자동 다시 시작 끄기 사용 안함

• 최종 사용자 환경 관리 - 사용 시간 중 업데이트를 위한 자동 다시 시작 끄기 사용 안함

인터넷 통신 관리

시스템 - 인터넷 통신 관리 - 인터넷 통신 설정 에서

• 모든 windows 업데이트 기능에 액세스 안 함 사용

3. 레지스트리

window키 + R - regedit.exe 로 레지스트리 편집기 열기

• HKEY_LOCAL_MACHINE - SOFTWARE - Policies - Microsoft - Windows - WindowsUpdate - AU NoAutoUpdate 값을 1, 16 진수로 설정
  만약 DWORD(32비트) 값이 없으면, 우클릭 - 새로 만들기 - DWORD(32비트) 선택 이름: TargetReleaseVersionInfo (F2를 눌러서 이름 편집) 값: 21H1 단위: 16진수(H)

참고

1. 윈도우10 자동 업데이트 끄기 및 완전 해제하는 방법
2. Windows 11 업데이트를 중지하는 방법

@PostMapping("form.do")
public String login(HttpServletRequest request){
    log.info("ip주소 = {}" ,request.getRemoteAddr());
}

ip주소를 받기 위해서는 위의 코드처럼 하면 되는데, 형식이 내가 알고 있던 것과 달라서 확인해보니 ipv6로 받고 있었다.

그래서 ipv4로 변경하고 싶어서 찾아보니 설정을 해주면 ipv4방식으로 받을 수 있다.

-Djava.net.preferIPv4Stack=true
-Djava.net.preferIPv4Addresses=true

이 코드를 도움말 - 사용자 지정 VM 옵션 편집,,,와 구성 편집 - spring Boot - 프로그램 Application - 빌드 및 실행 - VM옵션에 추가 해준다.

출처 이러쿵저러쿵:티스토리 IntelliJ IPv4 설정

컨트롤러의 중요한 역할 중 하나는 HTTP요청이 정상인지 검증하는 것이다.

• 클라이언트 검증 클라이언트 검증은 사용자에게 피드백이 빠르지만, 조작할 수 있어 보안에 취약
• 서버 검증 서버 검증은 보안에는 좋지만 피드백이 느림

따라서 클라이언트 검증과 서버 검증을 적절하게 섞어서 사용해야한다.

또 검증을 할 때에 검증 오류 발생했다면 오류가 발생한 폼에 사용자가 입력한 값을 유지시키고, 오류 메시지를 같이 띄워 사용자가 인식 할 수 있게 하는 것이 좋은 방법이라고 생각한다.

오류 종류

필드 오류

필드 오류란 말 그대로 필드 값이 요구되는 범위 밖으로 벗어난 오류를 말한다. 예를 들면 상품 개수를 1000개까지만 입력 받는데, 이때 1001개를 입력 했다면 이는 필드 오류에 해당한다.

객체 오류

객체 오류란 필드 오류와 다르게 하나의 필드 값으로만 발생하는 오류가 아니라 이를 넘어서는 오류를 말한다. 예륻 들면 주문을 받을때 최소 주문금액을 15,000원이라고 했을 때 5천원짜리 짜장면 한 그릇과 6천원짜리 짬뽕 한 그릇만 주문했다면 이는 객체 오류에 해당한다.

바인딩 오류

바인딩 오류란 HTTP 요청시 들어온 데이터 값이 제대로 바인딩 되지 않았을때 발생하는 오류로 예를 들자면 상품 개수가 1,2 와 같은 int 타입이아니라 한개, 두개와 같은 string 타입이 들어온다면 이는 바인딩 오류에 해당한다.

BindingResult

만약 위에서 말한 바인딩 오류가 발생한다면, 컨트롤러가 호출 되기도 전에 오류로 인해서 예외처리가 실행 될 것이다. 이렇게 되면 오류가 난 값을 따로 관리 할 수 없다. 이럴 때 사용하는 것이 BindingResult이다. BindingResult이란 검증 오류를 보관하는 객체로 오류를 낸 값까지 같이 보관을 하고 있다. 이 BindingResult를 사용한다면 바인딩 오류가 발생한다고 해도 컨트롤러가 호출된다.

다만 api방식에서는 컨트롤러가 호출 되지 않는다. api방식은 http 컨버터가 메시지를 변환하지 못하는 오류로 처리를 하기 때문이다.

BindingResult는 반드시 검증할 객체 뒤에 위치해야한다.

검증 오류 적용 방법

• @ModelAttribute의 객체가 바인딩 실패하면 spring이 자동으로 FieldError를 생성해서 BindingResult에 넣어준다.
• 개발자가 직접 넣어준다.
• @validated를 사용한다.

오류 코드와 메시지 처리

메시지 처리

설정

오류 메시지를 원하는 방식으로 정의 할 수있다. 이럴때 메시지를 정의하는 방법은 errors.properties파일을 만들어 원하는 오류 메시지를 적으면 된다.

그리고 이 파일을 적용시키기 위해서는 application.properties파일에 설정을 하나 해줘야한다.

spring.messages.basename=errors

이렇게 만들어진 파일이름을 적는 것이다. 만약 국제화를 위한 message.properties파일도 있다면 ,로 구분해서 여러개를 적으면 된다. 또 에러 메시지도 국제화를 하고 싶다면 errors_en.properties등의 파일을 만들어 국제화를 하면 된다.

우선순위

또 오류 메시지에는 우선순위가 있는데, 디테일한 것이 제일 우선순위가 높다. 만약 오류 메시지 파일에 내용이

required=필요한 값이 제대로 입력되지 않았습니다.
required.item.itemName=아이템 이름이 입력되지 않았습니다.

이런식으로 있다면, 아이템 이름이 입력되지 않은 상황에서는 2번째 줄인 아이템 이름이 입력되지 않았습니다.가 오류 메시지로 나오고, 나머지는 필요한 값이 제대로 입력되지 않았습니다.가 출력될 것이다.

이를 이용해 덜 디테일한 오류메시지를 기본으로 쓰고, 자세하게 오류 메시지를 알려줘야할 경우에는 해당 조건을 적어 그 부분은 자세히 따로 정의하면 된다.

오류 코드

이렇게 errors.properties를 작성할 때에 앞에 key값으로 적혀 있는 것들은 오류 코드라고하는데, 이러한 오류코드는 BindingResult에 같이 저장된다. 그래서 errors.properties를 작성 할 때에 이 규칙에 맞추어서 정의한다면 따로 기본 메시지라고 지정해 주지 않아도 spring이 읽는다. 만약 다르게 한다고 해서 사용 할 수 없는 것이 아니라 개발자가 직접 해당 오류에 이러한 메시지가 나와야한다고 지정해야한다.( 검증 오류 적용 방법에 따라 달라진다 )

Bean Validation

Bean validation방법은 위에서 말한 검증 오류 적용 방법중 @validated를 이용하는 방법이다. 그 외의 방법도 있지만 이 곳에서는 이 방법만 설명하려고 한다.

이 방식은 간단하다. @Validated 어노테이션을 검증할 객체 앞에 붙여주기만 하면된다. 또 이 검증 결과 또한 BindingResult에 담기기 때문에 검증할 객체 뒤에 당연히 있어야한다.그리고 각 필드의 검증 조건은 해당 객체에 정의한다.

• 컨트롤러

  @PostMapping("/test")
  pulbic String test(@Validated @ModelAttribute("item") Item item, BindingResult bindingResult){
    if(bindingResult.hasResult()){
        //검증 실패로직
    }
    // 검증 성공 로직
    ,,,
  }

• 검증 객체

  Public class Item{
  
    public Integer itemNum;
  
    @NotBlank
    public String itemName;
  
    @Range(min=100,max=9900)
    public Integer price;
  }

이렇게 각 필드에 어노테이션을 통해서 필드 검증 조건을 설정 할 수 있다.

한계와 극복

한계

예를 들어서 상품 등록시 검증 조건과 상품 수정시에 검증 조건이 다르면 어떻게 처리할 것인가? 이렇게 검증을 한다면, 간편하지만 같은 객체에 다른 검증 조건을 요구한다면 해결하기가 어렵다. 왜냐면 Item이라는 객체에 아예 검증 조건을 정의했기 때문이다.

극복

이를 극복하기위해 groups라는 기능을 사용하는 방법도 있지만, 코드가 복잡해지는 것 같아 추천하지 않는다. 대신 이런 경우에는 각 화면 별로 주고받는 데이터를 따로 구현해 검증을 한다. 예를 들어서 Item을 수정하거나 삭제한다고 할 때 SaveItemForm 과UpdateItemForm을 따로 만들어 클라이언트에게 입력 받은 데이터는 이러한 폼 객체를 사용해 검증하고, 폼 객체를 통해서 Item을 만드는 방식이다.

물론 컨트롤러에 이부분을 작성하는 것이 조금 번거롭겠지만 조금 더 직관적이라고 생각한다.

API(JSON) 검증

지금까지는 @ModelAttribute로 받는 폼 데이터에 대해 주로 검증했다. 만약 폼 데이터가 아닌 @RequestBody로 받는 HTTP body 메시지라면 어떻게 검증을 적용해야할까?

이 검증은 위에서 말한 것과 달리 HTTP body 메시지는 HTTP 컨버터가 실행되어 객체로 변환이되는데, 만약 여기서 오류가 난다면 위에서 바인딩 오류에 대해 처리한 것과 달리 HTTP 컨버터 예외처리로 들어가기 때문에 컨트롤러가 호출되기 이전에 끝난다. 때문에 BindingResult에 값이 담기지 않는다.

이러한 차이가 나는 이유는 폼 객체가 바인딩되는 과정과 HTTP body 메시지가 HTTP 컨버터를 통해 변환이 되는 과정이 다르기 때문이다.

차이

@ModelAttribute는 필드 단위로 정교하게 바인딩이 적용된다. 특정 필드가 바인딩 되지 않아도 나머지 필드는 정상 바인딩 되고, Validator를 사용한 검증도 적용할 수 있다. @RequestBody는 HttpMessageConverter 단계에서 JSON 데이터를 객체로 변경하지 못하면 이후 단계 자체가 진행되지 않고 예외가 발생한다. 컨트롤러도 호출되지 않고, Validator도 적용할 수 없다.

이 부분 이외에 컨트롤러가 호출된 이후부터는 똑같이 실행이 된다.

출처

1. 스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술

• 서버 사이드 HTML 렌더링 (SSR) : 타임리프는 백엔드 서버에서 HTML을 동적으로 렌더링 하는 용도로 사용
• 네츄럴 템플릿 : jsp등과 다르게 타임리프는 html형식을 최대한 유지하기 때문에 html파일을 직접 열어도 내용을 확인할 수 있고, 뷰 템플릿을 거치면 동적인 화면을 확인할 수 있다. 이렇게 순수 HTML을 유지하면서 뷰 템플릿을 유지하면서 뷰 템플릿을 사용할 수 있는 특징을 네츄럴 템플릿 이라고 함
• 스프링 통합 지원 : 타임리프는 스프링과 자연스럽게 통합되고, 스프링의 다양한 기능을 편리하게 사용 할 수 있게 지원해준다.

공식 사이트 : https://www.thymeleaf.org/ 공식 메뉴얼 - 기본 기능: https://www.thymeleaf.org/doc/tutorials/3.0/usingthymeleaf.html 공식 메뉴얼 - 스프링 통합 : https://www.thymeleaf.org/doc/tutorials/3.0/thymeleafspring.html

문법

사용 선언

<html xmlns:th="http://www.thymeleaf.org">을 html파일 상단에 선언하면 사용할 수 있다.

표현식

• 간단한 표현식
  • 변수 : ${,,,} 변수를 사용할 때 사용
  • 선택 변수 : *{,,,} th:Object와 함께 사용
  • 메시지 표현식 : #{,,,}
  • 링크 URL : @{,,,} URL 링크를 표현 할 때
  • 조각 표현식 : ~{,,,} replace, insert 등을 사용 할 때
• 리터럴
  • 텍스트 : 'one text', 'Another one!' ,,,,
  • 숫자 : 0, 34, 12.3, 14.0 ,,,,
  • 불린 : true, false ,,,
  • 널 : null
  • 리터럴 토큰 : one, sometext, main
• 문자 연산
  • 문자 합치기 : +
  • 리터럴 대체 : |My name is ${name}!|
    타임리프에서 문자 리터럴에서 주의해야할 점이 있는데, 바로 모든 문자열은 '(싱글) 으로 감싸져야한다는 것이다. 하지만 예외적으로 a-z, A-Z,0-9 으로만 이루어진 문자열은 감싸지 않아도 되지만, 띄어쓰기가 들어가거나 특수 문자 등이 들어가거나 변수와 문자열 합치기를 해야하는 경우에는 반드시 '(싱글)으로 감싸져 있어야한다. 혹은 위에서 말한 |으로 감싸져도 된다.
• 산술 연산
  • Binary operators : +, -, *, /, %
  • Minus sign (unary operator) : -
• 불린 연산
  • Binary operators : and, or
  • Boolean negation (unary operator) : !, not
• 비교와 동등
  • 비교 :>,<,>=,<=(gt,lt,ge,le)
  • 동등 연산 : ==, != (eq, ne)
    HTML Entity와 주의를 해야한다.
• 조건 연산
  • If-then: (if) ? (then)
  • If-then-else: (if) ? (then) : (else)
  • Default: (value) ?: (defaultvalue)
• 특별한 토큰
  • No-Operation : _

사용 방법

타임리프는 기본적으로 HTML 테그의 속성에 기능을 정의해서 동작한다.

<span th:text="${data}">원래 텍스트</span>

이런식으로 안에 th:를 먼저쓰고 뒤에 text나 object 등으로 어떤 값인지 구분을 하고, 그 값에 표현식을 넣는다.

아니면 html 태그 안에 값을 직접 넣고 싶다면,

<span>[[${data}]]</span>

이러한 방식으로 [[]]안에 표현식을 써서 사용할 수도 있다.

텍스트

data가 <b>text</b>라고 상황을 두고 두 개를 비교해보자.

• text : 이스케이프 기능이 자동으로 적용되는 text

[타임리프]

<span th:text="${data}">원래 텍스트</span>

[결과] -> 소스보기

<span>&lt;b&gt;text&lt;/b&gt;</span>

• utext : 이스케이프 기능이 적용되지 않는 text

[타임리프]

<span th:utext="${data}">원래 텍스트</span>

[결과] -> 소스보기

<span><b>text</b></span>

Escape html문서는 <, > 같은 특수 문자를 기반으로 정의 되기 때문에 html 텍스트를 보여줄 때 주의 해야하는데, 이때 <, >와 같이 html 파일에서 사용하는 특수문자를 문자로 표현하는 문자를 html entity라고 한다. 이 html 파일에서 사용하는 특수문자를 html entity로 변경하는 것을 escape라고 한다. 기본적인 예시로는 < -> < , > -> >가 있고 이 외에도 많은 html entity가 있다.

위에서 말한 [[]]안에 표현식을 써서 사용하는 방법은 text와 같고, [()]를 사용하면 utext와 같다.

변수

타임리프에서는 변수를 사용 할 때에는 ${,,,}의 변수 표현식을 사용하는데, 여기 안에는 springEL 이라는 스프링이 제공하는 표현식을 사용할 수 있다.

SpringEL 다양한 표현식 사용

1. Object user.username : user의 username을 프로퍼티 접근 user['username'] : 위와 같음 user.getUsername() user.getUsername() : user의 getUsername() 을 직접 호출
2. List users[0].username : List에서 첫 번째 회원을 찾고 username 프로퍼티 접근 -> list.get(0).getUsername() users[0]['username'] : 위와 같음 users[0].getUsername() : List에서 첫 번째 회원을 찾고 메서드 직접 호출
3. Map userMap['userA'].username : Map에서 userA를 찾고, username 프로퍼티 접근 map.get("userA").getUsername() userMap['userA']['username'] : 위와 같음 userMap['userA'].getUsername() : Map에서 userA를 찾고 메서드 직접 호출

• 지역 변수 : th:with 를 사용해 지역 변수를 선언해서 사용할 수 있, 해당 지역 변수는 선언한 태그 안에서만 사용할 수 있다.

[타임리프]

<div th:with="userFirst=${users[0]}">
    <p>1번째 유저 이름 : <span th:text="${userFirst.username}"></span></p>
</div>

객체

기본 객체

• ${#request}
• ${#response}
• ${#session}
• ${#servletContext}
• ${#locale}

유틸리티 객체

• #message : 메시지, 국제화 처리
• #uris : URI 이스케이프 지원
• #dates : java.util.Date 서식 지원
• #calendars : java.util.Calendar 서식 지원
• #temporals : 자바8 날짜 서식 지원
• #numbers : 숫자 서식 지원
• #strings : 문자 관련 편의 기능
• #objects : 객체 관련 기능 제공
• #bools : boolean 관련 기능 제공
• #arrays : 배열 관련 기능 제공
• #lists , #sets , #maps : 컬렉션 관련 기능 제공
• #ids : 아이디 처리 관련 기능 제공, 뒤에서 설명

URL 링크

타임리프에서 링크를 생성할 때 @{...}를 사용하면 된다.

• 단순한 URL @{/hello} -> /hello
• 쿼리 파라미터 : () 에 있는 부분은 쿼리 파라미터로 처리 @{/hello(param1=${param1}, param2=${param2})} -> /hello?param1=data1&param2=data2
• 경로 변수 : URL 경로상에 변수가 있으면 () 부분은 경로 변수로 처리 @{/hello/{param1}/{param2}(param1=${param1}, param2=${param2})} -> /hello/data1/data2
• 경로 변수 + 쿼리 파라미터 : 경로 변수와 쿼리 파라미터를 함께 사용할 수 있음 @{/hello/{param1}(param1=${param1}, param2=${param2})} -> /hello/data1?param2=data2

속성 값 설정

• 속성 값 설정 :th:*속성을 지정하면 기존 속성을 th:* 로 지정한 속성으로 대체한다. (없으면 만듬)

[타임리프]

<input type="text" name="mock" th:name="userA" />

[결과]

<input type="text" name="userA" />

• 속성 추가 : 원래 있던 속성 값을 대체 하는 것이 아니라 그 값에 추가
  • th:attrappend : 속성 값의 뒤에 값을 추가한다.(띄어쓰기 필요)
  • th:attrprepend : 속성 값의 앞에 값을 추가한다.(띄어쓰기 필요)
  • th:classappend : class 속성에 자연스럽게 추가한다.(띄어쓰기 필요 없음, 자동으로 띄어쓰기까지 해줌)

[타임리프]

<input type="text" class="text" th:attrappend="class=' large'" />

[결과]

<input type="text" class="text large" />

checked 사실 checked는 true, false 값을 구분하는 것이 아니라 속성 값이 존재하는지 하지 않는지를 구분하기때문에 처리가 까다로운데, 타임리프는 th:checked="false"라고 되어있으면 아예 checked 값을 넣지 않는다.

제어문

반복

• 반복 1

[타임리프]

<tr th:each="user : ${users}">
  <td th:text="${user.username}">유저이름</td>
</tr>

[결과]

<tr>
  <td>username1</td>
<tr>
</tr>
  <td>username2</td>
</tr>

반복시 오른쪽 컬렉션${users}의 값을 하나씩 꺼내서 왼쪽 변수user에 담아서 태그를 반복 반복 할 수 있는 객체 : Map, List ,배열, java.util.Iterable , java.util.Enumeration을 구현한 모든 객체를 반복에 사용할 수 있음

Map 도 사용할 수 있는데 이 경우 변수에 담기는 값은 Map.Entry 입니다.

• 반복 2 반복의 두번째 파라미터를 설정해 반복의 여러 값을 확인 할 수 있음 이 때 두번째 파라미터를 지정하지 않아도 첫번째 파라미터 이름 + Stat 으로 접근 가능 반복 상태 유지 기능
  • index : 0부터 시작하는 값
  • count : 1부터 시작하는 값
  • size : 전체 사이즈
  • even , odd : 홀수, 짝수 여부( boolean )
  • first , last :처음, 마지막 여부( boolean )
  • current : 현재 객체

[타임리프]

<tr th:each="user, userStat : ${users}">
  <td th:text="${userStat.index}">인덱스</td>
  <td th:text="${user.username}">유저이름</td>
</tr>

[결과]

<tr>
  <td>0</td>
  <td>username1</td>
</tr>
<tr>
  <td>1</td>
  <td>username1</td>
</tr>

조건

타임리프는 조건식을 비교했는데 맞지 않으면 아예 렌더링을 하지 않고 사라짐

• if, unless

[타임리프]

<span th:text="'결과1'" th:if="${21 lt 20}"></span>
<span th:text="'결과2'" th:unless="${21 gt 20}"></span>

[결과]

<span>결과2</span>

• switch th:case="*"는 만족하는 값이 없을때 사용하는 디폴트 값

[타임리프]

<td th:switch="'10'">
    <span th:case="10">10살</span>
      <span th:case="20">20살</span>
      <span th:case="*">기타</span>
</td>

[결과]

<td>
    <span>10살</span>
</td>

주석

• 표준 HTML 주석 : 타임리프가 렌더링 X , 주석 부분이 그대로 존재
• 타임리프 파서 주석 : 렌더링에서 주석 부분을 제거
  • 타임리프 프로토타입 주석 : HTML 파일 : 주석 / 타임리프를 렌더링 한 경우 : 보임

블록

<th:block> 은 HTML 태그가 아닌 타임리프의 유일한 자체 태그 원래 타임리프는 html태그 안에 속성으로 기능을 정의해서 사용하는데, 그렇게 하기 애매한 경우에 사용 이 태그는 렌더링시에는 사라진다.

[타임리프]

<th:block th:each="user : ${users}"> 
    <div>
        <div th:text="${user.index}"></div>
    </div>
    <div>
        <div th:text="${user.name}"></div>
        <div th:text="${user.age}"></div>
    </div>
</th:block>

[결과]

<div>
    <div>1</div>
</div>
<div>
    <div>유저1</div>
    <div>10</div>
</div>
<div>
    <div>2</div>
</div>
<div>
    <div>유저2</div>
    <div>20</div>
</div>

자바스크립트 인라인

타임리프는 자바스크립트에서 타임리프를 사용할 수 있는 자바스크립트 인라인 기능을 제공한다. 적용하기 위해서는 <script th:inline="javascript">를 적으면 된다.

• 텍스트 : 이스케이프까지 처리해서 "로 감싸져서 들어감
• 내추럴 템플릿 : 주석 부분은 렌더링시 사라짐
• 객체 : 객체를 자동으로 JSON으로 변환
• each : 반복문 문법이 동작함

[타임리프]

<script th:inline="javascript">
var username = [[${user.username}]];
var age = [[${user.age}]];
//자바스크립트 내추럴 템플릿
var username2 = /*[[${user.username}]]*/ "test username";
//객체
var user = [[${user}]];


[# th:each="user, stat : ${users}"]
var user[[${stat.count}]] = [[${user}]];
[/]
</script>

[결과]

<script>
var username = "userA";
var age = 10; //자바스크립트 내추럴 템플릿
var username2 = "userA"; //객체
var user = {"username":"userA","age":10};

var user1 = {"username":"userA","age":10};
var user2 = {"username":"userB","age":20};
var user3 = {"username":"userC","age":30};
</script>

템플릿 조각

템플릿 조각은 여러 페이지에서 공통적으로 사용하는 영역들을 해결하기 위해서 용한다. 예를 들어 footer와 header 등과 같은 부분은 여러 페이지에서 공통적으로 사용되면서 동시에 모든 페이지에서 똑같아야하는 부분등을 의미한다.

부분 포함

footer를 따로 파일로 분리하고, 각 페이지에서 분리했던 footer를 가져다 사용하는 방식이다.

[타임리프] /template/fragment/footer.html

<footer th:fragment="copy"> 푸터 자리 입니다.</footer>

<footer th:fragment="copyParam (param1, param2)">
    <p>파라미터 자리 입니다.</p>
    <p th:text="${param1}"></p>
      <p th:text="${param2}"></p>
</footer>

/template/fragment/main.html

<body>
    <h2>부분 포함 insert</h2>
    <div th:insert="~{template/fragment/footer :: copy}"></div>
    <h2>부분 포함 replace</h2>
    <div th:replace="~{template/fragment/footer :: copy}"></div>
    <h1>파라미터 사용</h1>
    <div th:replace="~{template/fragment/footer :: copyParam ('데이터1', '데이터 2')}"></div>
</body>

[결과]

<body>
    <h2>부분 포함 insert</h2>
    <div>
        <footer> 푸터 자리 입니다.</footer>
      </div>
    <h2>부분 포함 replace</h2>
    <footer> 푸터 자리 입니다.</footer>
    <h1>파라미터 사용</h1>
      <footer>
        <p>파라미터 자리 입니다.</p>
        <p>데이터1</p>
          <p>데이터2</p>
    </footer>
</body>

• th:insert : 이 속성이 적혀 있던 태그의 자식 태그로 들어옴
• th:replace : 이 속성이 적혀 있던 태그가 사라지고, 그 위치로 들어옴

또 파라미터를 사용 할 수 있고, 파라미터로는 태그도 들어 갈 수 있다. 이것을 이용해서 다양한 동적인 페이지를 만들 수 있다.

레이아웃

위에서는 공통된 부분을 부분별로 잘라내어 따로 저장하고 메인 페이지에서 이를 가져다 사용하는 방법이였다면, 이 방법은 오히려 반대로 한 html에 레이아웃을 짜놓고, 내용이 변경 되는 부분에만 내용을 넣어서 페이지를 구성하는 방식이다.

레이아웃을 짜놓을 파일에 <html th:fragment="layout(title, content)" xmlns:th="http://www.thymeleaf.org">를 추가해 해당 페이지를 layout이라고 정의하고, title과content를 받아서 레이아웃 안에 넣어 페이지를 보여준다.

[타임리프]

layout.html

<!DOCTYPE html>
<html th:fragment="layout (title, content)" xmlns:th="http://www.thymeleaf.org">
<head>
    <title th:replace="${title}">레이아웃 타이틀</title> 
</head>
<body>
<h1>레이아웃 H1</h1>
<div th:replace="${content}">
   <p>레이아웃 컨텐츠</p> 
</div>
<footer> 레이아웃 푸터</footer>
</body>
</html>

main.html

<!DOCTYPE html>
<html th:replace="~{template/layoutExtend/layoutFile ::layout(~{::title},~{::section})}"xmlns:th="http://www.thymeleaf.org">
<head>
    <title>메인 페이지 타이틀</title>
</head>
<body>
<section>
    <p>메인 페이지 컨텐츠</p>
    <div>메인 페이지 포함 내용</div>
</section>
</body>
</html>

[결과]

<!DOCTYPE html>
<html>
<head>
    <title>메인 페이지 타이틀</title>
</head>
<body>
<h1>레이아웃 H1</h1>
<section>
    <p>메인 페이지 컨텐츠</p>
    <div>메인 페이지 포함 내용</div>
</section>
<footer> 레이아웃 푸터</footer>
</body>
</html>

출처

1. 스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술

• jdk : 1.8
• IDE : intelliJ
• DB : Oracle 11g
• maven
• spring boot
• mybatis

의존성 추가 - pom.xml

pom.xml 파일에 아래 코드를 추가해주세요.

<dependency>
    <groupId>org.bgee.log4jdbc-log4j2</groupId>
    <artifactId>log4jdbc-log4j2-jdbc4.1</artifactId>
    <version>1.16</version>
</dependency>

logger 설정 파일 추가 - log4jdbc.log4j2.properties

propetties 파일을 새로 생성해 아래의 코드를 추가해주세요.

log4jdbc.spylogdelegator.name=net.sf.log4jdbc.log.slf4j.Slf4jSpyLogDelegator
log4jdbc.dump.sql.maxlinelength=0 # 최대 몇줄 출력에 관한 설정, 0으로 설정하면 제한 없이 설정

log level 설정 - application

1. spring.datasource.driver-class-name 변경
spring.datasource.driver-class-name=oracle.jdbc.OracleDriver
spring.datasource.driver-class-name=net.sf.log4jdbc.sql.jdbcapi.DriverSpy

2. spring.datasource.url 변경 ( 'jdbc:' 뒤에 'log4jdbc:' 추가 )
spring.datasource.url=jdbc:oracle:~~
spring.datasource.url=jdbc:log4jdbc:~~

위의 코드를 참고해서 spring.datasource.driver-class-name의 값과 spring.datasource.url값을 변경해주세요

출력하고 싶은 내용에 디버그 값을 설정해주세요 xml로 설정하는 방법도 있는데 xml파일을 최대한 사용하지 않기위해 application.properties에 작성했습니다. 만약 두 개 다 설정하셨다면 application.properties에 설정 한 내용이 우선 순위로 들어갑니다.

# 로그 관련 설정
logging.level.jdbc.sqlonly=OFF
logging.level.jdbc.sqltiming=INFO
logging.level.jdbc.resultsettable=INFO
logging.level.jdbc.audit=OFF
logging.level.jdbc.resultset=OFF
logging.level.jdbc.connection=OFF

참고 Springboot MyBatis 쿼리 로그 설정 MyBatis Logging 추가 스프링 부트(Spring boot) 마이바티스(Mybatis) 에서 쿼리 로그 출력 및 정렬하기.

클라이언트에서 서버로 요청 데이터를 전달할 때 가장 많이 사용하는 3가지 방식에 대해서 설명하고자한다.

1. GET - 쿼리 파라미터

/url?username=hello&age=20와 같이 HTTP 메시지 body없이 쿼리 파라미터에 데이터를 보내는 방식이다.

2. POST - HTML Form

html에 form 태그에 작성된 내용을 전송 받는 방법이다.

3. HTTP message body

HTTP API에서 주로 사용하는 방식이다.

1. GET - 쿼리 파라미터 & 2. POST - HTML Form

이 두가지 방식을 합친 이유는 클라이언트에서 보내는 방식이 다르게 보일지 몰라도 HTTP 메시지에는 같은 형식으로 저장되기 때문에 구분 없이 사용되기때문에 같이 설명하려고한다.

컨트롤러 작성

/url?username=hello&age=20을 처리해야한다는 상황을 가정하고 컨트롤러를 작성해보자.

1) HttpServletRequest

Servlet을 사용할 때 처럼 HttpServletRequest 통해서 값을 입력 받는 방식이다.

@RequestMapping("/request-param-v1")
public void requestParamV1(
    HttpServletRequest request,HttpServletResponse response
) throws IOException {
    String username = request.getParameter("username");
    int age = Integer.parseInt(request.getParameter("age"));
}

2) @RequestParam

@RequestParam라는 어노테이션을 이용하는 방식으로, ()안에 쿼리 파라미터의 키값을 넣어주면 뒤에있는 데이터 형식으로 변환해서 변수에 넣어준다. 1번의 방법보다 훨씬 코드가 깔끔해지는 것을 볼 수 있다.

값을 받을 변수명과 쿼리 파라미터의 키 값이 같다면 ()안에 쿼리 파라미터의 키값을 넣는 것을 생략할 수 있다. @RequestParam("username") String memberName -> @RequestParam String memberName 또 이때 변수의 형식이 단순 데이터(int, String, Integer 등 ) 이라면 @RequestParam까지 생략할 수 있다. @RequestParam("username") String memberName -> String memberName (이렇게 되면 spring 내부에서 required=false를 적용한다.) 하지만 어노테이션까지 생략하는 것은 명시적이지 않아 권하지 않는다.

@RequestParam 추가 속성

1. required : 파라미터 필수 여부 (기본 값 true)
2. defaultValue : 기본 값 세팅 (기본 값 없음)

@RequestMapping("/request-param-v2")
public void requestParamV2(
    @RequestParam("username") String memberName,
    @RequestParam("age") int memberAge) {
    log.info("username={}, age={}", memberName, memberAge);
}

3) @ModelAttribute

만약 값을 객체로 받고싶다면 @ModelAttribute를 사용해보자. 이 어노테이션을 사용한다면 객체도 자동으로 생성되고, 생성된 객체에 값도 자동으로 넣어준다.

이 어노테이션은 객체의 setter()를 통해서 값을 넣기 때문에 꼭 setter()가 정의되어있어야한다.

이 어노테이션도 생략할 수는 있지만 권장하지 않는다.

@ResponseBody
@RequestMapping("/model-attribute-v1")
public String modelAttributeV1(@ModelAttribute HelloData helloData) {
    log.info("username={}, age={}", helloData.getUsername(), helloData.getAge());
    return "ok";
}

2. HTTP message body

HTTP 메시지 body를 통해 데이터가 넘어오는 경우에는 위의 방식을 사용할 수 없다.

컨트롤러 작성

{"username":"hello", "age":20}
content-type: application/json

이러한 형식의 데이터를 받아서 처리한다고 가정하고 컨트롤러를 작성해보자

1) HttpServletResponse

HttpServletRequest를 사용해서 직접 HTTP 메시지 바디에서 데이터를 InputStream을 이용해 직접 읽을 수 있다.

• string

  @PostMapping("/request-body-json-v1")
  public void requestBodyJsonV1(
    HttpServletRequest request,
    HttpServletResponse response
  ) throws IOException {
    ServletInputStream inputStream = request.getInputStream();
    String messageBody = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);
    log.info("messageBody={}", messageBody);
    response.getWriter().write("ok");
  }

• json 등의 객체타입 문자로된 JSON 데이터를 변환하는 과정이 필요

  private ObjectMapper objectMapper = new ObjectMapper();
  

@PostMapping("/request-body-json-v1") public void requestBodyJsonV1( HttpServletRequest request, HttpServletResponse response ) throws IOException { ServletInputStream inputStream = request.getInputStream(); String messageBody = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8); log.info("messageBody={}", messageBody); HelloData data = objectMapper.readValue(messageBody, HelloData.class); log.info("username={}, age={}", data.getUsername(), data.getAge()); response.getWriter().write("ok"); }

### 2) InputStream
이 `InputStream`은 위의 `HttpServletResponse`에서 InputStream을 생성하던 것을 spring이 대신 해줘서 InputStream으로 바로 받을 수 있게 해주는 것이다. 나머지는 동일하다.

```java
@PostMapping("/request-body-string-v2")
public void requestBodyStringV2(
    InputStream inputStream, 
    Writer responseWriter
) throws IOException {
    String messageBody = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);
    log.info("messageBody={}", messageBody);
    responseWriter.write("ok");
}

3) HttpEntity

HttpEntity란 HTTP 메시지를 편하게 조회할 수 있게 해준다. HttpEntity를 상속받은 RequestEntity와 ResponseEntity도 같은 기능을 제공한다.

@PostMapping("/request-body-string-v3")
public HttpEntity<String> requestBodyStringV3(HttpEntity<String> httpEntity) {
    String messageBody = httpEntity.getBody();
    log.info("messageBody={}", messageBody);
    return new HttpEntity<>("ok");
}

4) @RequestBody

@RequestBody어노테이션은 HTTP 메시지 바디 정보를 편리하게 조회할 수 있게 해준다.

• string

  @ResponseBody
  @PostMapping("/request-body-string-v4")
  public String requestBodyStringV4(@RequestBody String messageBody) {
    log.info("messageBody={}", messageBody);
    return "ok";
  }

• json 등의 객체타입 만약 @RequestBody 데이터 타입이 객체라면 @ModelAttribute와 같이 객체가 생성되며 자동으로 값이 들어간다.
  @RequestParam나 @ModelAttribute`와 같이 생략은 불가능하다

  @ResponseBody
  @PostMapping("/request-body-json-v3")
  public String requestBodyJsonV3(@RequestBody HelloData data) {
    log.info("username={}, age={}", data.getUsername(), data.getAge());
    return "ok";
  }

  물론 HttpEntity에서도 동일하게 동작된다.

  @ResponseBody
  @PostMapping("/request-body-json-v4")
  public String requestBodyJsonV4(HttpEntity<HelloData> httpEntity) {
    HelloData data = httpEntity.getBody();
    log.info("username={}, age={}", data.getUsername(), data.getAge());
    return "ok";
  }

  HTTP 요청시에 content-type이 application/json인지 꼭! 확인해야 한다. 그래야 JSON을 처리할 수 있는 HTTP 메시지 컨버터가 실행된다.

출처

1. 스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술

spring에서 만들 수 있는 응답 데이터는 크게 3종류로 나누어져 있다. 각 응답 데이터를 어떻게 만들어서 응답하는지에 대해 정리해보고자 한다.

1. 정적 리소스

정적 리소스 : js, css, images 등과 같이 변화가 없는 리소스를 의미

2. 뷰 템플릿

동적인 html을 리턴할 때에는 뷰 템플릿을 이용한다.

3. HTTP 메시지

HTTP API를 작성 할 때에는 html이 아니라 데이터를 전달해야해서 HTTP 메시지에 JSON과 같은 데이터를 실어보낼수 있도록 한다.

1. 정적 리소스

기본경로

정적 리소스는 spring에서 코드를 따로 작성해서 응답을 하는 것이 아니라, 정적 리소스들을 미리 약속된 디렉토리에 넣어놓으면 알아서 spring이 정적 리소스를 제공한다. 이 때 미리 약속된 디렉토리는 클래스 패스의 시작 경로인 src/main/resources안에 있는 /static , /public , /resources , /META-INF/resources 이 있다.

ex src/main/resources/static/js에example.js가 있다면, /js/example.js를 요청하면 된다.

2. 뷰 템플릿

기본경로

뷰 템플릿을 거쳐서html을 생성하고, 뷰가 응답을 만들어서 전달한다. 이때 spring은 뷰 템플릿 기본 경로를 제공하는데 변경도 가능하다. 기본 경로는 src/main/resources/templates 이곳이다.

컨트롤러 작성

뷰 템플릿은 컨트롤러에서 리턴하는 방식이 3가지 정도가 있다. 각 방식의 특징에 대해서 알아보자

1) ModelAndView

이 방식은 컨트롤러 내에서 ModelAndView를 생성해서 반환하는 방법이다. 생성할 때에 경로를 넣고, 만약 같이 보내야할 데이터가 있다면 생성된 ModelAndView에 데이터를 추가해서 같이 전송한다.

@RequestMapping("/response-view-v1")
public ModelAndView responseViewV1() {
    ModelAndView mav = new ModelAndView("response/hello")
                            .addObject("data", "hello!");
    return mav;
}

2) String

이 방식은 보내야할 데이터가 있다면 model에 데이터를 넣고, 리턴은 경로만 리턴을 하는 방식이다. 앞에 ModelAndView와 기능은 같은데 ModelAndView를 직접 만들지 않아도 되서 코드가 훨씬 깔끔하다.

@RequestMapping("/response-view-v2")
public String responseViewV2(Model model) {
    model.addAttribute("data", "hello!!");
    return "response/hello";
}

3) Void

이 방식은 앞의 String을 리턴하는 방식과 비슷한데, return을 void로 처리한 방식이다. 이것은 RequestMapping되는 경로와 뷰 템플릿의 경로가 같으면 사용할 수 있는데, 이 방식은 명시적이지 않아서 추천하지 않는다.

@RequestMapping("/response/hello")
public void responseViewV3(Model model) {
    model.addAttribute("data", "hello!!");
}

3. HTTP 메시지

이번에는 HTTP API를 제공하는 경우 html이나 뷰 템플릿이 아닌 데이터를 응답으로 보내야하기 때문에 HTTP 메시지에 데이터를 넣어야한다.

물론 정적 리소스, 뷰 템플릿을 사용해도 HTTP 메시지에 최종 데이터가 담겨서 가지만, 정적 리소스는 동적인 데이터를 전송할 수 없고, 뷰 템플릿은 뷰 템플릿을 거쳐서 가야한다. 이렇게 정적 리소스나 뷰 템플릿을 거치지 않고 직접 HTTP 응답 메시지를 전달하는 경우를 알아 보려고 한다.

컨트롤러 작성

1) HttpServletResponse

Servlet을 사용할 때 처럼 HttpServletResponse를 통해서 직접 전달하는 방식이다.

@GetMapping("/response-body-string-v1")
public void responseBodyV1(HttpServletResponse response) throws IOException
{
        response.getWriter().write("ok");
}

2) ResponseEntity

ResponseEntity엔티티는 HTTP 메시지의 헤더, 바디 정보를 가지고HttpEntity를 상속 받은 객체이다. ResponseEntity는 여기에 더해서 HTTP 응답 코드를 설정할 수 있다.

HttpStatus는 HTTP 응답 코드가 정의 되어있다. 전부 상수로 되어있는데 200이라고 적는 것보다 HttpStatus.OK라고 적는 것이 보기에 좀 더 직관적이라 사용한다.

• string

@GetMapping("/response-body-string-v2") public ResponseEntity responseBodyV2() { return new ResponseEntity<>("ok", HttpStatus.OK); }

- json 등의 객체타입
```java
@GetMapping("/response-body-json-v1")
public ResponseEntity<HelloData> responseBodyJsonV1() {
    HelloData helloData = new HelloData();
    helloData.setUsername("userA");
    helloData.setAge(20);
    return new ResponseEntity<>(helloData, HttpStatus.OK);
}

3) @ResponseBody

@ResponseBody어노테이션을 사용하면 리턴 값이 그대로 들어간다. 따로 생성을 하거나 하지 않기 때문에 코드가 가장 간결하다.

HTTP 응답 코드도 설정할 수 있는데, @ResponseStatus(HttpStatus.OK)를 사용해서 할 수 있다. 다만 위의 ResponseEntity방식처럼 동적으로 지정할 수는 없어서 동적으로 지정하고 싶다면 ResponseEntity을 사용해서 리턴시켜야한다.

• string

  @ResponseBody
  @GetMapping("/response-body-string-v3")
  public String responseBodyV3() {
    return "ok";
  }

• json 등의 객체타입

  @ResponseStatus(HttpStatus.OK)
  @ResponseBody
  @GetMapping("/response-body-json-v2")
  public HelloData responseBodyJsonV2() {
    HelloData helloData = new HelloData();
    helloData.setUsername("userA");
    helloData.setAge(20);
    return helloData;
  }

ResponseEntity엔티티나 @ResponseBody어노테이션을 사용해서 객체 타입의 데이터를 데이터로 보낸다면 HTTP 메시지 컨버터가 동작해서 JSON 형식으로 변환된다.

출처

1. 스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술

1. openSSL 다운로드
2. openSSL.exe 실행
3. 다음 명령어 순서대로 입력

   openssl genrsa -des3 -out private.pem 2048
   openssl req -new -key private.pem -out private.csr
   openssl genrsa -aes256 -out rootCA.pem 2048
   openssl req -x509 -new -nodes -key rootCA.pem -days 3650 -out rootCA.csr
   openssl x509 -req -in private.csr -CA rootCA.csr -CAkey rootCA.pem -CAcreateserial -out private.crt -days 3650
   openssl pkcs12 -export -in private.crt -inkey private.pem -out keystore -name tomcat

   ssl 적용 테스트 용이라 대충 만들었어요 :)

SSL 적용

application.properties

• keyStore 파일을 이용

  server.port=8443
  server.ssl.key-store=classpath:keystore.jks
  server.ssl.key-store-password=secret
  server.ssl.key-password=another-secret

• pem으로 인코딩된 인증서 및 개인 키 파일을 사용

  server.port=8443
  server.ssl.certificate=classpath:my-cert.crt
  server.ssl.certificate-private-key=classpath:my-cert.key
  server.ssl.trust-certificate=classpath:ca-cert.crt
  server.ssl.key-store-password=secret

  이렇게 설정을 하면 더이상 8080 포트에서 HTTP 연결을 지원하지 않음 8080 포트로 HTTP를, 8443 포트로 HTTPS를 연결하고 싶다면 추가적으로 설정이 필요

Class Application

/**
 * Redirect all traffic from port 8080 to 8443
 * @return
 */
@Bean
public ServletWebServerFactory servletContainer(){
    TomcatServletWebServerFactory tomcat = new TomcatServletWebServerFactory(){
        @Override
        protected void postProcessContext(Context context) {
            SecurityConstraint securityConstraint = new SecurityConstraint();
            securityConstraint.setUserConstraint("CONFIDENTIAL");
            SecurityCollection collection = new SecurityCollection();
            collection.addPattern("/*");
            securityConstraint.addCollection(collection);
            context.addConstraint(securityConstraint);
        }
    };
    tomcat.addAdditionalTomcatConnectors(redirectConnector());
    return tomcat;
}

private Connector redirectConnector() {
    Connector connector = new Connector("org.apache.coyote.http11.Http11NioProtocol");
    connector.setScheme("http");
    connector.setPort(8080);
    connector.setSecure(false);
    connector.setRedirectPort(8443);
    return connector;
}

8080의 요청을 8443으로 redirect함으로써 8080 HTTP로도 접근이 가능하고, 8443 HTTPS으로도 접근이 가능

참고 Spring Boot SSL (HTTPS) examples Spring Enabling HTTPS (공식매뉴얼) Spring Configure SSL (공식매뉴얼)

의존성 추가

• maven

  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <optional>true</optional>
  </dependency>

  application.properties

  spring.devtools.restart.enabled=true
  spring.thymeleaf.cache=false

devtools는

• 파일 수정후 저장하면 자동으로 classpath에 존재하는 파일의 변경을 감지하고 자동으로 서버를 restart해주는 기능
• thymeleaf는 기본적으로 캐싱 기능을 제공하지만, 이 기능이 활성화 되어있으면 thymeleaf파일을 수정해도 바로 적용되지 않기때문에 false로 수정

intelliJ 설정

• 설정 - 빌드, 실행, 배포 - 컴파일러 - 프로젝트 자동 빌드 체크

tomcat 설정

• 인텔리제이 화면에서 ctrl + shift + A - 구성편집 검색 - 액션 탭에서 구성편집 선택 update 액션시 (U) 와 프레임 비활성화 시(F) 둘 다 클래스 및 리소스 업데이트로 설정

RequestMappingHandlerAdapter

RequestMappingHandlerAdapter는@RequestMapping은 를 처리하는 핸들러 어댑터이다. @RequestMapping 기반의 컨트롤러는 다양한 파라미터를 사용할 수 있다. 예를 들면 ``HttpServletRequest,Model,@RequestParam,@ModelAttribute,@RequestBody,HttpEntity등이 있다. 이렇게 많은 파라미터를 처리하는 등 매우 유연한 모습을 보여줄 수 있는 이유는ArgumentResolver`를 호출해 컨트롤러(=핸들러)가 필요한 파마미터 값(객체)를 생성하기 때문이다.

ArgumentResolver

ArgumentResolver란 정확히 HandlerMethodArgumentResolver이고, 줄여서 ArgumentResolver라고한다. 파라미터를 각 타입으로 변환시켜주는 리졸버이다. 스프링에는 약30개 이상의ArgumentResolver가 존재함

동작방식

1. RequestMapping핸들러 어댑터가 ArgumentResolver의 supportsParameter()를 호출해서 컨트롤러(=핸들러)가 원하는 파라미터를 지원하는지 확인
2. 지원하면, resolveArgument()를 호출해 파라미터를 변환
3. RequestMapping핸들러 어댑터가 변환된 파라미터를 넘겨주며 컨트롤러(=핸들러) 호출

ReturnValueHandler

ReturnValueHandler란 정확히HandlerMethodReturnValueHandler이다. 이것은 ArgumentResolver와 비슷한데, ArgumentResolver는 요청 값에 대한 변환을 처리했다면 ReturnValueHandler는 응답 값에 대한 처리를 한다. 응답 값을 String으로 리턴해도 뷰 이름으로 동작하게 해주고, @ResponseBody가 붙어있으면 그대로 반환하게 해주는 이유이다. 이것도 ArgumentResolver와 같이 spring에서 여러개의 ReturnValueHandler가 존재한다.

동작방식

ArgumentResolver의 동작 방식과 비슷하다.

HTTP 메시지 컨버터

위치

요청의 경우 ArgumentResolver를, 응답의 경우 ReturnValueHandler를 사용해서 각각의 값을 변환한다. 이렇게 변환을 할 때에 사용하는 것이 HTTP 메시지 컨버터이기때문에 HTTP 메시지 컨버터는 ArgumentResolver와 ReturnValueHandler안에서 호출되어 사용된다.

출처

1. 스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술

git config -l

이름 변경

git config --global user.name 공수정

이메일 변경

git config --global user.email 0sujeong@naver.com

SSh 인증

아무나 커밋을 하는게 아니라 등록된 사람들만 커밋을 할 수 있게 하는 방식을 하기 위해서 인증서를 발급해 서버에 등록하고, 자신의 pc에도 가지고 있어서 이 인증서로 인증을해서 커밋을 할 수 있게 한다.

• 키 생성

  ssh-keygen -t ecdsa

  생성하면 비밀키와 공개키 2개의 파일이 생김 공개키(.pub확장자) 파일은 서버 관리자에게 주어서 등록을 해야하고, 하나는 가지고 있어야한다. 한번 해당 서버에서 클론을 하면 인증이 된 서버라는 등록정보가 또 파일로 저장이 된다

메모하자 메모 :)