허원철의 개발 블로그

github page로 이전 중 입니다.

허원철 — Wed, 7 Feb 2018 08:56:52 +0900

티스토리에서 다뤘던 내용을 지금 보다 알찬 내용을 담아내려 합니다.

https://heowc.github.io/

Java And Spring forward! 2017 세미나 - 후기

허원철 — Sun, 26 Nov 2017 21:01:40 +0900

이번 글을 Java And Spring forward!을 다녀온 후기를 남기는 글 입니다.

최근 Java 9와 Spring 5가 정식 릴리즈가 되면서 그에 대한 세미나가 생겨 참여하게 되었습니다. 앞서 말했듯이 Java 5와 Spring 5에 대한 내용을 주로 다루게 되는 세미나였는데요. Java Champion이신 양수열님과 Pivotal에서 정윤진님를 비롯해 네이버에서 정상혁님과 이명현님께서 스피커로 진행해주셨습니다.

세미나 전반적으로는 새로운 릴리즈되어 나온 기능들을 소개하기 위한 내용이다보니 스펙 위주로 진행되었습니다. 아쉽게도 참여를 하지 못한 분들은 3개월 안에(?) KSUG-유투브채널에 공개된다고 하니 Java 9와 Spring 5가 궁금하시다면 보시면 좋을 것 같습니다.

Java 9 new feature

주요기능

- Jigsaw: Java 9부터 모듈시스템 개념이 추가됩니다. (패키지 상위 개념?)

- Cloud 환경에서 Java언어로 만들어진 애플리케이션 타 언어에 비해 무거웠던 것을 보다 개선해 나가기 위한 과정입니다.

- 이로 인해 필요한 모듈만 가져옴으로써 보다 경량화된 모듈 시스템이 가능해집니다.

- Jlink: JVM 배포판을 만들 수있는 유틸성 도구입니다.

- 필요한 모듈만 가져와 사용할 수 있습니다.

- 버전 관리에 대한 가시성이 가능해집니다. ( --listmods )

- Multi Release Jar: 특정 버전에 맞춰 해당 버전에 맞게 원하는 클래스가 동작할 수 있습니다.

- 하위 버전에 대한 고려가 된 개념이라고 볼 수 있습니다. ( Module, Package )

- JShell: REPL을 지원 해주는 도구입니다.

- Concurrency에 대한 기능 개선 되었습니다.

- Deprecation에 대한 옵션 추가 되었습니다. ( forRemoval, since 등 )

- JVM

- 디폴트 GC가 G1로 변경되었습니다.

- String: Compact String 개념이 추가되면서 성능이 개선되었습니다. ( +XX:-CompactStrings )

- logging

- JVM상에서 로그를 핸들링할 수 있게 됩니다.

- GC logging 성능 상승

- 기타

- JDK/JRE 구조가 변경되었습니다. 이는 모듈시스템을 적용되면서 변경된 사항인데요. 아마 기존 라이브러리와 프레임워크 때문에 쉽사리 Java 9으로 버전을 올리는 것은 아직은 어려운 상황인 것 같습니다.

- 사라진 것들

- SHA-1에 대한 취약점이 발견되면서 기존 SHA-1는 거둬낸 상황이고, SHA-3으로 변경되었다고 합니다.

- 브라우저 이슈로 인해 액티브X가 없어지고 있는 것처럼, Applet 또한 거둬냈다고 합니다.

HTTP/2세대의 JAVA

- 2015년 5월 RRC 7240 스펙이 공표되었습니다.

- 전송 방식의 변경이 크게 대두되고 있습니다.

- 기존에는 text protocol, HTTP/2에는 Binary protocol입니다.

- 지속적인 연결을 하면서, 기존에 HTTP/1.1에서 keep-alive는 무시하게 됩니다.

- 헤더에 대한 표기가 약간 변경되었습니다. (기존에는 첫글자가 대문자, 이후에는 소문자)

- 용어 정리

- h2: 웹 브라우저와 서버 통신 ( with TLS )

- h2c: 서버 간 통신 ( without TLS )

- ALPN: TLS 확장. h2 필수

- HTTP/2가 필요한 이유

- 헤더가 압축됩니다.

- 여러 요청을 한번에 처리 가능합니다. => 정적 리소스를 합치지 않아도 된다.

- Server Push: 관련 자원을 같이 넘겨줄 수 있습니다. => 개발자도구 - Network에서 계단식 그래프를 안 볼 수 있다.

=> 결국에는 보다 빨라집니다.

- 그래서 Java에서는?

- Server Push: Tomcat9( Servlet 4.0 ), Jetty 10에서 지원합니다.

- Java 9에서 HTTP/2지원 하는 별도의 클래스 추가되었습니다. ( HttpClient )

- ALPN 지원 ( Java 7,8에서는 jetty-alpn-agent )

- H1.1에서 H2로 변경해보는 과정

- 1~2줄 변경하면 될 줄 알았지만, 현실은 아니였다고 하네요...

- 아직 H2를 제대로 지원하는 웹 서버나 통신 라이브러리가 없는 것 같습니다.

- OkHTTP가 그나마 H2통신을 지원하지만 H2C를 지원하지 않는다고 합니다.

- Proxy용도로 아직까지는 HAProxy가 H2를 지원합니다.

JPA 2.2와 JSON-B, JSON-P

- JPA 2.2

- @Repeatable

- 기존에 무의미하던 @NameQueries같은 것을 사용하지 않아도 @NameQuery를 여러번 사용할 수 있다.

- Date관련 API 지원하게 됩니다.

- 현재 상황으로는 아직 ZonedDateTime은 지원이 안된다고 하네요. ( 단, Hibernate 5.2에서는 지원합니다. )

- Stream API 지원합니다.

- 기존 Hibernate는 Stream를 만들어주는 반면에 하위 호환성을 위해(?) 콜랙션을 stream으로 변형하는 형태라고 하는데요. 아마 Hibernate가 JPA 2.2 스펙을 가져온다면.. 해당 메소드를 재정의해서 사용할 것이라는 예상이 있습니다.

- CDI

- Spring Bean처럼 만들어주는 것은 아니지만, injection이 가능해집니다.

- @PostConstruct, @PreDestory를 지원합니다.

- JSON-B, JSON-P

- Java 진영에서 JSON에 대한 표준 스펙이 정해졌습니다.

- 흔히 사용하는 jackson으로 예를 들 수 있습니다.

- jackson-databind는 JSON-B가 됩니다.

- jackson-core는 JSON-P가 됩니다.

- 시리얼라이즈와 디시리얼라이즈 과정이 전반적으로 비슷합니다.

- 나머지는 .. 스펙 확인바랍니다... ( http://json-b.net/ )

- Spring Boot는 2.x 버전 대에서는 JSON-B와 JSON-P를 다 구현한 Johnzon을 사용합니다. ( 이슈 참고 - https://github.com/spring-projects/spring-boot/pull/9648 )

Spring 5 new feature

- 엔터프라이즈급 애플리케이션에 적용하기에 너무 방대하고 어렵다..? ( 하위 호환성, PSA에 대한 결과..?)

- MSA를 해야합니다. ( YouTube - 혼돈의제왕, YouTube- Bootiful Microservice, 책 - Release it! )

- 가장 대두되는 것은 JDK9, HTTP/2, Reative입니다.

- Server Push는 지원합니다.

- JSON-B, JSON-P를 지원합니다.

- Java 8, 9 스펙을 지원합니다. ( 람다, 애노테이션 등 )

- XML Bean 설정이 개선됩니다. ( 버전을 명시 하지 않아도 알아서 맞춰줍니다. )

- spring-jcl가 logging 라이브러리를 auto decting 해줍니다.

- component scan에 대해서 @Indexed 개념(인덱스 설정)이 추가되면서 보단 빠른 로딩을 할 수 있습니다. ( spring-context-indexer )

- Funtional Bean을 지원합니다. ( 리플렉션과 CGLIB가 필요없어집니다. )

- 코틀린을 적용하면서 null safety한 환경이 가능케 합니다. ( @Nullable )

- HTTP/2 적용 시, Tomcat 9.0, Jetty 9.3, Undertow 1.4 이상을 사용해야 합니다.

- 파일 업로드 시, 용량 초과에 대한 에러 처리가 추가 되었습니다. ( MaxUploadSizeExceededException )

- exception을 던지면서 바로 상태 코드와 메시지를 보낼 수 있습니다.

- throw new ResponseStatusException

- exceptionHandler와 controllerAdvice는...?

- WebClient로 비동기 통신 지원합니다. ( AsyncRestTemplate는 사라졌습니다. )

- Spring Boot 2.0 GA는 2018년 초에 릴리즈될 예정입니다.

- Spring Cloud Gateway는 Netflix의 Zuul이 아닌 자체적으로 개발하여 적용될 예정입니다.

- http://spring-calendar.cfapps.io/에서 스프링관련 일정 확인이 가능합니다.

Reflow와 Repaint

허원철 — Mon, 6 Nov 2017 14:14:03 +0900

이번 글은 Reflow와 Repaint에 대한 내용입니다.

Reflow와 Repaint는 브라우저 렌더링 과정의 일부 입니다. 그렇기 때문에 설명하기에 앞서 브라우저 렌더링에 대한 개념을 우선적으로 알아야합니다.

브라우저 렌더링

렌더링은 화면에 컨텐츠를 그리는 과정으로 우리가 흔히 쓰는 크롬 브라우저에 UI를 그리는 것을 말합니다.

크롬에 경우, Webkit 엔진을 사용하여 렌더링하게 되는데요. 간단하게 과정을 설명하자면, 문서(html, css)를 파싱하여 렌더 트리를 생성하고 이를 배치 및 표현하게 됩니다.

(출처: http://taligarsiel.com/Projects/howbrowserswork1.htm)

렌더링 엔진은 해당 과정을 절차적으로 수행하지 않고 점진적으로 수행합니다. (단, Table Tag는 적용되지 않습니다.)

렌더 트리

렌더 트리는 스타일 정보와 HTML 표시 규칙을 가진 객체입니다. 어찌보면 DOM 객체와 동일하다고 생각될 수 있는데요. 하지만 이는 약간 다릅니다. 이유는 비시각적인 요소는 렌더트리로 생성되지 않기 때문입니다. (ex. style - display: none, <head> 등)

(출처: http://taligarsiel.com/Projects/howbrowserswork1.htm)

렌더 트리 배치(Reflow)

크기와 위치에 맞게 브라우저에 배치하는 과정을 Reflow라고 합니다. 위치를 결정하는 방법에는 3가지가 존재합니다.

- Nomal: 문서의 위치에 따라 배치, DOM 트리와 동일

- Float: Normal과 같이 배치된 후, 끝(왼 or 오른)으로 이동

- Absolute: DOM 트리와 다른 자리에 배치

렌더 트리 표현(Repaint)

시각적인 요소가 표현되는 과정을 Repaint라고 합니다. 표현이 되는 순서로는 아래와 같습니다.

1
배경색 > 배경이미지 > 테두리 > 자식 > 아웃라인
cs

최적화 방법

Reflow와 Repaint를 최소화하는 방법을 고려해야합니다.

1. 변경이 잦은 요소는 Absolute에 배치합니다.

2. 스타일 변경은 한번에 묶어서 처리합니다.

3. 테이블은 점진적 배치에서 제외되기 때문에 사용을 지양합니다.

4. 스타일을 최적화 합니다. (ex. css 최소화)

참고

https://github.com/nhnent/fe.javascript/wiki/Reflow%EC%99%80-Repaint

http://taligarsiel.com/Projects/howbrowserswork1.htm

https://github.com/Heo-Won-Chul/programming-study/blob/master/web/Reflow%EC%99%80_Repaint.md

https://github.com/Heo-Won-Chul/programming-study/blob/master/javascript/DOM_%EA%B0%9D%EC%B2%B4%EC%97%90_append_%ED%95%98%EB%8A%94_%EB%8B%A4%EC%96%91%ED%95%9C_%EB%B0%A9%EB%B2%95.md

Node.js - 로컬 모듈 접근에 대한 다양한 개선 방법

허원철 — Fri, 20 Oct 2017 15:39:23 +0900

Node.js를 접한지 얼마 되지 않았지만, 로컬 모듈을 접근할 시에 상대경로로 접근해야 하는 것에 대해서 불편함을 느꼈습니다. 그래서 다른 개발자분들은 어떤 식으로 해결하고 있을까? 라는 의문이 들었고 관련되서 멋진 gist을 접하게 되었습니다.

이 포스팅은 bran님께 허락을 구하고 작성한 글입니다.

문제점

예를 들어, 다음과 같이 depth가 깊은 모듈을 접근해야 합니다.

1
2
const Article = require('../../../models/article');   // (O)
const Article = require('models/article');            // (X)
cs

절대 경로로 접근할 순 없을까?

해당 링크를 참고하면 2017년을 기준으로 약 4년 동안에 많은 개발자들의 경험과 노하우를 엿볼 수 있습니다. bran님은 글을 작성하신 이후에도 또 다른 다양한 방법들을 추가해주셨습니다. 요약하자면,

1. IoC 컨테이너 구성

IoC 컨테이너를 구성할 수 있는 electrolyte 모듈을 사용하는 것 입니다.

2. node_modules 하위에 링크파일 만들기

- Linux

1
ln -nsf node_modules app
cs

- Windows

1
mklink /D app node_modules
cs

※ CVS나 SVN을 사용하는 경우만 사용이 가능합니다. (Git에서는 사용 불가능)

추가적으로 package.json에서 scripts - postinstall 옵션을 이용하여 만들 수 있습니다. ( scripts )

3. global 객체

app.js에 다음과 같이 선언할 수 있습니다.

1
global.__base = __dirname + '/';
cs

그리고, __base를 활용하여 require를 다음과 같이 작성할 수 있습니다.

1
const Aritcle = require(__base + 'app/models/article');
cs

4. 외장모듈 설치

대표적인(?) app-module-path 설치

1
npm install app-module-path --save
cs

app.js 최상위에 다음과 같이 선언합니다.

1
require('app-module-path').addPath(__dirname + '/app');
cs

- 이외에도 다양한 외장 모듈이 존재합니다. (본글 참고)

5. 환경변수 추가

NODE_PATH 환경 변수를 application의 절대 경로로 설정하고 모듈을 기준으로 할 디렉토리로 만듭니다.

1) node app명령어를 실행 이전에

- Linux

1
export NODE_PATH=.
cs

- Windows

1
set NODE_PATH=.
cs

※ 다음과 같은 변수 설정은 해당 쉘이 열려있는 환경에서만 유지가 되므로, 전역으로 사용하려면 profile을 수정해야 합니다.

2) node가 실행하는 동안

- Linux

1
NODE_PATH=. node app
cs

- Windows

1
cmd.exe \C "set NODE=.&& node app"
cs

6. 시작 스크립트

application을 실행할 수 있는 스크립트를 만드는 것 입니다.

1) Node.js에서 하는 방법(참고)

2) OS별 스크립트 작성

- Linux : 프로젝트 최상위에 shell script를 작성합니다.

1
2
#!/bin/sh
NODE_PATH=. node app.js
cs

- Windows : 프로젝트 최상위에 batch script를 작성합니다.

1
2
@echo off
cmd.exe \C "set NODE_PATH=.&& node app.js"
cs

7. Hack

해당 방법은 [ 5 - node가 실행하는 동안 ]과 동일하지만, 노드의 버전 변경에 의해 동작하지 않을 수 있다는 것을 유의해야 합니다.

1
2
3
4
process.env.NODE_PATH = __dirname;
require.('module').Module._initPaths();
 
// ...
Colored by Color Scripter
cs

8. Wrapper

1) require()를 래핑해서 사용하는 방법입니다.

1
2
3
global.rootRequire = function(name) {
    return require(__dirname + '/' + name);
}
Colored by Color Scripter
cs

2) 또 다른 방법은 require() 래퍼 없이 기본적으로 같은 기능을 하는 초기 함수 를 항상 사용하는 것 입니다. 다른 방법과 달리 실제로 문서화된 기능입니다.

1
require.main.require('app/models/ariticle');
cs

출처

https://gist.github.com/branneman/8048520

Node.js - 시작하기

허원철 — Wed, 11 Oct 2017 13:24:45 +0900

Node.js란 무엇인가?

확장성 있는 네트워크 애플리케이션(특히 서버 사이드) 개발에 사용되는 소프트웨어 플랫폼입니다. 작성 언어로 자바스크립트를 활용하며 Non-blocking I/O와 단일 스레드 이벤트 루프를 통한 높은 처리 성능을 가지고 있습니다.

Node.js 탄생 배경?

2009년 당시에는 파일 업로드시, 완료 될 때까지 기다려야 하는 번거로움을 없애기 위해 Ryan Dahl에 의해 고안되었습니다. (물론 지금은 아니라는 것...)

Node.js 특징

1) Non-blocking I/O

: 하나의 요청 처리가 끝날 때가지 기다리지 않고 다른 요청을 동시에 처리할 수 있는 비동기 입출력을 적용합니다.

2) 이벤트 기반

: 결과값 반환 시, 이벤트 호출을 통해 알립니다.

3) 모듈

: 자바에서 클래스와 인터페이스를 분리하는 것 처럼 자바스크립트에서는 파일을 분리하는데 이를 모듈이라고 합니다.

또한, 여러 모듈을 합쳐서 패키지라고 합니다.

Node.js 설치하기

https://nodejs.org

※ 두 종류의 버전 존재

- LTS : 서버 환경에서 안정적으로 동작하도록 지원하는 버전

- Current : 새로운 기능을 추가하거나 기존 버그를 우선적으로 적용하는 버전

Linux - fail2ban

허원철 — Thu, 21 Sep 2017 21:43:19 +0900

이번 글은 fail2ban에 대한 내용입니다.

Linux 서버를 누구나 접근이 가능한 네트워크망(IP대역을 제한할 수 없는 경우)에서 사용하게 되면, 무작위로 ssh 로그인을 시도하여 접근하는 것이 가능합니다. 이를 보완하기 위해서 첫째로는 ssh 로그인 시, 직접적으로 root로 접근하는 것을 막습니다. 두번째로 fail2ban을 이용하여 이를 보완할 수 있습니다.

fail2ban 란?

- 지정된 시간(findtime) 내에 지정된 횟수(maxretry) 이상으로 접근 실패시에 해당 IP를 지정된 시간(bantime)동안 차단하는 것을 말합니다.

fail2ban 설치하기(Centos 7 기준으로 합니다.)

1. epel 패키지 설치

- 공식 Centos 패키지 저장소에는 fail2ban이 없기 때문에 epel 패키지 설치합니다.

1
yum install -y epel-release
cs

2. fail2ban 설치

1
yum install -y fail2ban
cs

3. fail2ban 활성화

1
systemctl enable fail2ban.service
cs

4. fail2ban 재실행

1
systemctl restart fail2ban.service
cs

fail2ban 설정 변경

- 기본적인 경로는 /etc/fail2ban 하위 디렉토리에 위치합니다.

- 기본적인 설정은 jail.conf으로 있으나, 변경이 필요한 경우에는 jail.conf를 복사하여 jail.local 파일을 만들어 커스텀 하거나 jail.d/customisation.local에 값을 수정하여 사용하기를 권장합니다.

1
cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local
cs

설정을 전체적으로는 볼 수 없고, 기본적인 것만 보자면

1
vi /etc/fail2ban/jail.local
cs

1
2
3
4
5
6
7
8
[DEFAULT]
...
maxretry= (최대 로그인 시도 횟수)
findtime = (로그인 시도 유지 시간)
bantime = (차단 유지 시간)
...
[sshd]
enabled = (ssh 로그인 시, 활성화 유무)
cs

참고

- https://www.unixmen.com/install-fail2ban-centos-7/

책 '토비의 스프링 3.1' 후기

허원철 — Tue, 12 Sep 2017 20:23:55 +0900

토비의 스프링 3.1 세트: 국내도서; 저자 : 이일민; 출판 : 에이콘출판사 2012.09.21

상세보기

Spring 관련 국내 서적 중에서는 단연 1등이라고 볼 수 있는 책입니다.

'토비의 스프링 3.1'은 총 2권으로 나뉘어 있습니다.

1권에서는 스프링의 장점이라고 할 수 있는 IoC/DI, 서비스 추상화, AOP와 디자인 패턴, 프로그래밍 기법에 대해서 자세히 다루고 있습니다.

2권에서는 빈 설정 기법부터 웹 컨트롤러 기법까지의 최신 기술(3.1 버전)과 그 외 기술을 추가적인 내용을 다루고 있습니다.

책을 읽고 나서의 한 줄 평을 적어보자면..

"어려운 책. 인내심을 시험하는 책"

'토비의 스프링 3.1'은 스프링 프레임워크 관련 책이지만, 그 이상을 보여주는 책입니다. 그렇기 때문에 초심자, 자바를 잘 모르고 스프링을 접하게 되는 입문 개발자에게는 어렵게 느끼질 수 있을 거라 생각됩니다. (책 두께의 압박감도 장난이 아니기 때문에...)

경험을 비추어 볼 때...

자바도 잘 모르고 개발자로 입문하게 되었을 때, '토비의 스프링'을 읽으려고 시도했었지만 100장을 넘기지 못 하고 접었던 기억이 스쳐 지나갑니다. (디자인 패턴이 뭐죠..? 리팩토링이 뭐죠..?) 당시에는 너무나 어려웠습니다. 그렇게 두서 없이 접하고 읽을 책이 아니란 걸 깨닫고 마틴 파울러의 '리팩토링', '디자인 패턴' 등등을 읽으며 개발 경험이 쌓인 후에야 비로소 읽혀졌습니다.

또한, 그 동안 (두서 없이) 개발을 해오면서 스프링 개념의 굴곡 차이가 심했던 필자에게는 프레임워크의 개념부터 시작해 스프링에서 사용되는 기술들까지.. 전부 다 이해하고 기억에 남지는 않지만, 언제나 그렇듯이 알고 있던 지식 퍼즐들이 하나하나 짜맞춰질 수 있었습니다.

+) 토비의 스프링 4.0, 4.3 등이 없어서 아쉽네요...ㅠ

+) 최근 공식적으로, 토비(이일민)님께서 '토비의 스프링 5.0'을 쓰고 계시다는 말을 듣고, 이를 통해 WebFlux에 대해 공부해봐야겠다는 생각이 들었습니다.

Oracle Code Seoul - 2017

허원철 — Wed, 30 Aug 2017 18:14:21 +0900

서울 여의도 콘래드 호텔에서 진행되었던 'Oracle Code Seoul' 컨퍼런스를 참여한 후기 글입니다.

이번 'Oracle Code Seoul'은 사전 등록 시간을 포함해 아침 7시 30분부터 18시까지 진행 되는데, 7시 40분쯤 도착했는데도 많은 개발자분들이 계셨습니다. 그럼에도 불구하고 선착순 100분 안에 들어서 데스크패드 득했습니다. ( ㅎㅎㅎ )

항상 컨퍼런스를 가게 되면 느끼는 것이 있습니다. 평일임에도 불구하고 컨퍼런스를 참여하는 열정이 있는 개발자 분들이 정말 많다는 것 입니다. (회사에서 강제로 보내서 가시는 분들도 있겠지만요...?)

이번 컨퍼런스를 다녀와서 몸소 느낀점

아직 컨퍼런스를 찾아다닌지 얼마 안되기도 했고, 국외 컨퍼런스를 다녀온 적도 없었기 때문에 호텔에서 컨퍼런스가 진행된다는 것이 생소하기도 하고 신기한 일이 아닐 수 없었습니다. (다과 공간과 호텔 식사 제공...)

외국 스피커분들이 강연하는 곳은 처음이라 긴장하고 갔었습니다. 그런데 동시 번역 기계를 주더랍니다. (다들 주저하지 말고 외국 컨퍼런스를 다녀옵시다!!!)

한 세션당 짧은 시간이여서 조금 아쉬웠습니다. 실제 오라클에서 근무하시는 개발자분께서 자바, Oracle Cloud에 대해 소개를 해주셨지만, 시간이 촉박했기 때문에 보다 많은 내용을 들을 수 없었습니다.

자바는 아직 죽지 않았다 !

무엇을 듣고 왔는가?

제가 들은 세션은 점심시간까지 진행되었던

Sebastian Dashner님의 'CQRS를 언제, 왜, 그리고 어떻게 사용할 것인가'

Kevin Walsh님의 'API, 마이크로서비스, 챗봇을 사용한 모던 애플리케이션 개발'

이일민님의 'Java 9과 Spring 5로 바라보는 Java의 변화와 도전'

David Buck님의 'Java 8의 멋진 기능과 Java 9의 신기능 알아보기'

입니다.

요약 내용(?)

- 미흡하지만, 초간략하게 세션 내용을 정리해보았습니다..

Sebastian Dashner님의 'CQRS를 언제, 왜, 그리고 어떻게 사용할 것인가'

중요 개념은 이벤트 소싱과 이벤트 드리븐 아키텍처이다.

CQRS는 쓰기(void)와 읽기(get)를 분리한다.

로직을 이벤트로 묶어서 사용한다. (EventStore)

CQRS의 장점은 확장성이 좋고, 비동기 통신에 탁월한 효과를 볼 수 있다.

CQRS의 단점은 분산 시스템이 아니면 오버헤드가 있다.

참고 : https://github.com/sdaschner/scalable-coffee-shop

Kevin Walsh님의 'API, 마이크로서비스, 챗봇을 사용한 모던 애플리케이션 개발'

MicroService는 API 결합과 재사용이 가능해졌다.

서비스별 구성이 아닌 API별 구성 형태로 변화되어야 한다.

모놀리식 아키텍처에서 작은 컴포넌트들(마이크로서비스)로 변화되어야 한다.

apiary : API 생명주기 관리

- API 검증, 테스트, 모니터링, 문서화(api-blueprint), 등등

oracle cloud : 마이크로서비스 플랫폼 제공

- git, build. deploy, ci(hudson), 다양한 프로그래밍 언어 지원, AI, 등등

이일민님의 'Java 9과 Spring 5로 바라보는 Java의 변화와 도전'

9월 21일에 자바 9와 스프링 5가 릴리즈된다.

자바는 죽지 않았다. 다른 언어 또한 동일한 얘기가 오고 간다.

자바는 여러 위기를 극복하고 변화해왔다.

- 과도한 기술로 인한 오버엔지니어링(EJB) → 자바의 기본으로 돌아가자(POJO 개념 등장)

- 경쟁 언어의 등장(C#) → 하위 버전 호환성 가능

- 간결한 코드와 생산성(루비) → 애노테이선의 등장(Java EE, Spring, Lombok) + Spring Boot

- 함수형 프로그래밍과 비동기, 논블로킹(스칼라, 노드) → Java SE 8, Servlet 3.0 +

새로운 위기(?)와 변화

- 위기 : 관례의 범람 → 함수형 프로그래밍 언어로 업그레이드된 자바의 기본으로 돌아가자

1. 애노테이션의 한계 및 부작용

2. 리플렉션과 바이트 코드 조작

- 변화

1. Spring 5

- 서블릿에 대한 의존성 제거

- 새로운 HTTP : ServerResponse, ServerRequest

- 독립형 애플리케이션

- Handler Function, Router Function

2. Java 9

- Spring 5에서의 Mono(단일 오브젝트), Flux(스트림 오브젝트)를 Java 9의 Flow API와 호환가능(RxJava 도)

David Buck님의 'Java 8의 멋진 기능과 Java 9의 신기능 알아보기'

Java 8의 기능

- 람다 표현식(functional interface)

- 디폴트 메소드(기존 자바의 호환성을 위해 디폴트 메소드를 정의 가능한 새로운 인터페이스 제공)

- 메소드 레퍼런스( s -> s.toUpperCase() == String::toUpperCase )

- Date Time APIs - JSR 310(Joda Time API를 자바 플랫폼으로 가져온 것)

Java 9의 기능

- 보다 빠른 JDK

1. JEP 250 : Store Interned Strings in CDS Archives

- 다른 JVM 프로세스간에 String객체 및 기본 char배열 객체 를 공유하여 메모리 소비를 줄 입니다.

2. JEP 254 : Compact Strings

- String클래스 의 내부 표현을 UTF-16 char배열에서 byte배열과 인코딩 플래그 필드로 변경

3. Javadoc Search

...

- 새로운 기능과 함수형

- Project Jigsaw : 자바 모듈화

- Java Custom Runtime

- Enhanced Deprecation

- Java Shell

- Multi-Release Jar

- Unicode 8.0

- UTF-8 Property Files

- OCSP Stapling for TLS

- SHA 3

- HTML5 docs

- HTTP/2 Client

- Default G1 GC

...

CI - 젠킨스 원격지 배포하기(SSH)

허원철 — Mon, 28 Aug 2017 21:34:33 +0900

이번 글은 빌드된 jar 파일을 원격지에 배포해보는 과정을 적은 글입니다.

'CI - 젠킨스 빌드하기'에서 작성된 배포(?) 스크립트는 젠킨스 PATH에서 실행한 것이기 때문에 올바른 방법이 아닙니다. 그래서 원격지에 배포하는 방법을 간단하게 보면 3가지 정도인 것 같습니다. (이런 저런 과정이 추가된다면 많이 달리질 수 있습니다.)

1) SSH

2) FTP

3) Tomcat Manager

※ AWS를 위한 별도의 플러그인도 있습니다.

spring boot를 jar 파일로 배포하기 위해 ssh를 이용해보도록 하겠습니다.

1 . Publish Over SSH 설치

- 젠킨스에서 원격지에 ssh로 접근하기 위한 플러그인을 설치 해줍니다.

[Jenkins 관리] - [플러그인 관리] - [설치 가능] 탭에서 'Pulish Over SSH'

2 . SSH 등록

- 원격지에 접근하기 위한 정보를 기입해줍니다.

① 환경 변수 설정

[Jenkins 관리] - [환경설정] - Publish Over SSH

② SSH Server 등록

- 원격지에 대한 정보를 기입해줍니다.

① Name : 별칭으로 사용할 이름

② Hostname : IP나 도메인

③ Username : SSH 접근할 id

④ Remote Directory : 접근할 디렉토리 위치

⑤ Passphrase : 비밀번호

3 . item 수정

- [빌드 후 조치] - [Send build artifacts over SSH] 추가해줍니다.

- 2-②에서 기입한 SSH Server를 가져와, Transfers를 추가 작성 해줍니다.

① Source files : 가져올 파일이나 디렉토리 지정

② Remove prefix : 제외한 디렉토리 위치

③ Remote directory : 배포할 디렉토리 위치(2-②와 중첩)

④ Exec command : 실행할 명령어

4. Build Now

- 해당 item을 빌드하게 되면, 기존과 달리 Console에서 SSH를 접근하고 'Exec command'에 적힌 명령어를 실행하는 것을 볼 수 있습니다.

※ 간단하게 작성 해논 빌드 스크립트는 Github에서 확인할 수 있습니다.

CI - 젠킨스 업그레이드

허원철 — Thu, 24 Aug 2017 14:42:38 +0900

젠킨스를 활용하면서 플러그인이 아닌 젠킨스 버전 업그레이드를 해야할 때가 있습니다.

앞서 블로깅 했던 내용으로 진행 하셨다면(Centos 라면), 다음과 같은 경로에 jenkins.war를 확인할 수 있습니다.

1
/usr/lib/jenkins/jenkins.war
cs

그게 아니라면,

1
find / -name 'jenkins.war'
cs

등 명령어를 통해 위치를 확인하시기 바랍니다.

※ 아래 내용은 이전 블로깅 내용을 기준으로 작성합니다.

새로운 jenkins.war 다운로드

- http://mirrors.jenkins-ci.org 에서 jenkins를 다운 받으실 수 있습니다. 가장 최신 버전을 받고자 하신다면, http://mirrors.jenkins-ci.org/war/latest/jenkins.war

1
wget http://mirrors.jenkins-ci.org/war/latest/jenkins.war
cs

기존 jenkins 멈춤

- service 로 jenkins를 시작하고 멈출 수 있습니다.

1
stop service jenkins stop
cs

수동으로 jenkins.war 변경

- 기존 jenkins 와 바꿔줍니다. (기존 war를 백업 해두시고 작업하시는 걸 추천드립니다.)

1
mv {새로 설치한 jenkins 경로} /usr/lib/jenkins/jenkins.war
cs

jenkins 시작

1
start service jenkins start
cs

CI - 젠킨스 빌드하기

허원철 — Wed, 28 Jun 2017 16:03:54 +0900

이번 글은 Github Repository에 올려놓은 프로젝트를 이용하여 젠킨스를 이용해보는 예제 글입니다.

새로운 Item 생성하기

- item 이름을 정해주고, Freestyle project 선택합니다.

소스 코드 관리

- Git을 선택하고, 해당 Repository URL을 기입합니다.

- Credentials → Add : 로그인 계정을 기입합니다.

- Branches to Build : master로는 다른 작업을 위해 다른 Branch를 이용하도록 하겠습니다.

Build

- 설치한 Gradle을 이용한다면 Invoke Gradle을 이용합니다.

- 이번 포스팅은 Spring Boot + Gradle Wrapper를 이용합니다.

① [ Make gradlew executable ] 체크

② Wrapper location : jenkins에서 제공해주는 환경변수가 있는데, ${workspace}는 해당 item 경로입니다.

③ Tasks : Gradle Task 명령어를 기입합니다.

Add Build step

- Linux는 shell script를 이용하여 Spring Boot를 실행할 것입니다.

- [ Execute shell ] 선택

1) shell script

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
#!/bin/bash
# bash Call
# sudo bash {PATH}/deploy.sh 8080 spring-boot-jenkins
 
# Field
 
# Server Port
# Ex) 8080
SERVER_PORT=$1
# Service Name
# Ex) spring-boot-jenkins
PROJECT_NAME=$2
 
PROJECT_PATH=/var/lib/jenkins/workspace/$PROJECT_NAME/build/libs
JAR_FILE=$PROJECT_PATH/$PROJECT_NAME-0.0.1-SNAPSHOT.jar
TMP_PATH_NAME=/tmp/$PROJECT_NAME-pid
 
# Function
function stop(){
    sudo echo " "
    sudo echo "Stoping process on port: $SERVER_PORT"
    sudo fuser -n tcp -k $SERVER_PORT # tcp $serverPort에 해당하는 port를 Kill함.
 
    if [ -f $TMP_PATH_NAME ]; then
        sudo rm $TMP_PATH_NAME
    fi
 
    sudo echo " "
}
 
function start(){
    sudo echo " "
    sudo nohup java -jar -Dserver.port=$SERVER_PORT $JAR_FILE /tmp 2>> /dev/null >> /dev/null &
    sudo echo "java -jar -Dserver.port=$SERVER_PORT $JAR_FILE /tmp 2>> /dev/null >> /dev/null &"
 
    sudo echo $! > $TMP_PATH_NAME
    sudo echo " "
}
 
# Function Call
stop
 
start
Colored by Color Scripter
cs

※ sudo를 사용하게 된다면,

sudo: no tty present and no askpass program specified

라는 에러가 발생할 수 있습니다. 해결 방법으로는 root로 접속하여 jenkins에 sudo 권한을 줍니다.

① user를 root로 변경

1
sudo su -
cs

② /etc/sudoers 파일 수정

1
visudo
cs

③ jenkins 추가

1
2
3
4
5
...
 
jenkins     ALL=(ALL)     NOPASSWD=(ALL)
 
...
Colored by Color Scripter
cs

2) Execute shell

- Command

1
bash ${WORKSPACE}/deploy.sh 8080 ${JOB_NAME}
cs

빌드 Now

- webhooks를 이용하여 commit/push시, 자동 빌드를 해보기 전에 수동으로 하는 방법을 해보도록 하겠습니다.

- Build Now를 누르게 되면 수동으로 빌드가 가능합니다.

콘솔 확인

- Clone, Test, Build, Deploy되는 과정을 볼 수 있습니다.

참고

- spring-boot-jenkins

CI - 젠킨스 시작하기

허원철 — Tue, 27 Jun 2017 13:57:16 +0900

단순히 서버에 FTP로 war나 jar 파일을 올리는 수동적인 배포만 해보다가 잠깐의 휴식기간(?) 동안 빌드, 테스트, 배포를 손쉽게 할 수 있는 젠킨스에 대한 글입니다.

CI란 무엇인가?

CI라는 용어를 먼저 살펴보자면, Continuous Integration의 줄임말로 지속적 통합이라고 불립니다.

대표적으로 젠킨스가 있는데 Agile 창시자 중 한 명인 마틴 파울러님이 주창한 지속적 통합을 구현하기 위한 자바 오픈소스 소프트웨어로 웹 어플리케이션 형태를 하고 있습니다. 원래는 허드슨이라는 명칭을 가지고 있었으나, 오라클과의 상표권 문제로 젠킨스로 이름이 바뀌게 되었습니다.

왜 써야하나요?

소스를 직접 배포하지 않고, 형상관리 시스템인 Git이나 SVN에서 파일을 읽어들여 빌드, 테스트, 배포를 할 수 있습니다.

젠킨스를 사용함으로써 얻을 수 있는 이점

1
2
3
4
5
6
7
간편한 인터페이스
빌드 툴(Ant, Maven, Gradle)로 인한 자동화 빌드 및 테스트
자동화 배포
분산빌드
레포팅 기능
 
...
Colored by Color Scripter
cs

젠킨스 설치하기 [Linux]

1) 사전 작업

① yum update

1
sudo yum update -y
cs

② jdk 설치

1
sudo yum install java-1.8.0-openjdk-devel.x86_64
cs

③ git 설치

1
sudo yum install -y git
cs

④ 빌드 툴 설치

- 해당 관련 포스팅은 wrapper를 이용하므로 별도의 설치를 하지 않겠습니다.

2) 설치하기

① jenkins 리포지토리 다운로드

1
sudo wget -O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins-ci.org/redhat/jenkins.repo
cs

1
sudo rpm --import http://pkg.jenkins-ci.org/redhat/jenkins-ci.org.key
cs

② jenkins 설치

1
sudo yum install -y jenkins
cs

③ 실행

1
sudo service jenkins start
cs

젠킨스 맛보기

① 초기 비밀번호 확인

- 아래 명령어를 입력한 뒤, 나온 비밀번호를 입력합니다.

1
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
cs

② 로그인 후, 플러그인 설치

- [ Install suggested plugins ] 선택

- 필요한 플러그인 설치

- 회원가입(이후 로그인은 해당 아이디와 비밀번호로 합니다.)

③ 시작페이지

④ 재부팅 시, 서비스 자동 시작

1
sudo chkconfig jenkins on 
cs

- 확인

1
sudo chkconfig --list jenkins
cs

⑤ 포트 변경

1
sudo vi /etc/sysconfig/jenkins
cs

1
2
3
4
5
...
 
JENKINS_PORT="{원하는 PORT}"
 
...
cs

- 재시작

1
sudo service jenkins restart
cs

Spring Boot - CORS

허원철 — Sun, 25 Jun 2017 18:19:38 +0900

이번 글은 Spring Boot를 이용하여 CORS를 해보는 예제 글 입니다.

보안상의 이유로 브라우저는 스크립트 내에서 시작된 교착 출처 HTTP 요청을 제한하는데, 이를 SOP라 합니다.

※ SOP(Same-Origin Policy) : 동일 출처 정책, 한 출처(origin)에서 로드된 문서나 스크립트가 다른 출처 자원과 상호작용하지 못하도록 하는 제약입니다.

SOP는 두 Origin 간에 프로토콜, 포트, 호스트가 같아야 동일 Origin라고 할 수 있습니다.

예를 들어, http://www.heowc.com 이라는 URL이 있다면

1
2
3
4
http://www.heowc.com/user [성공]
https://www.heowc.com [실패] - 프로토콜 상이
http://www.heowc.com:8080/ [실패] - 포트 상이
http://blog.heowc.com [실패] - 호스트 상이
cs

브라우저 스크립트에서는 jsoup라는 것을 사용하거나 서버에서는 CORS를 이용하여 해결 가능합니다.

※ CORS(Cross-Origin Resource Sharing) : 웹 서버 도메인간 액세스 제어 기능을 제공하여 보안 도메인간 데이터 전송을 가능하게 해줍니다.

동작과정

1. pre-flight request : 실제 요청하려는 경로와 같은 URL에 대해 OPTIONS메소드로 요청을 날려보고 요청가능한지 확인

2. 실제 요청

서버에서는 다음과 같은 설정을 추가해줘야 합니다.

1
2
3
4
5
Access-Control-Allow-Orgin : 요청을 보내는 페이지의 출처 [ *, 도메인 ]
Access-Control-Allow-Methods : 요청을 허용하는 메소드. Default : GET, POST, HEAD
Access-Control-Max-Age : 클라이언트에서 preflight의 요청 결과를 저장할 시간 지정. 해당 시간 동안은 pre-flight를 다시 요청하지 않는다.
Access-Control-Allow-Headers : 요청을 허용하는 헤더
...
Colored by Color Scripter
cs

Spring Boot에서 활용 해보기

Spring에서 기존에는 Filter를 이용하여 CORS를 허용하였으나, Spring 4.2 이후 버전에서는 @CrossOrigin을 이용하여 쉽게 해결할 수 있습니다. @CrossOrigin은 해당 레벨에 HTTP 메소드를 허용하게 해줍니다.

1) @CrossOrigin 설정

1
2
3
4
5
@CrossOrigin
@GetMapping("{value}")
public String get(@PathVariable String value) {
    return value;
}
Colored by Color Scripter
cs

2) Global CORS 설정

1
2
3
4
5
6
7
8
@Override
public void addCorsMappings(CorsRegistry registry) {
    registry.addMapping("/message/**")
            .allowedOrigins("*")
            .allowedMethods("POST")
            .allowCredentials(false)
            .maxAge(3600);
}
Colored by Color Scripter
cs

※ @CrosOrigin과 Global CORS는 같이 사용이 가능합니다.

참고

- SpringBootCors

일일 커밋 - 100(+2)일 회고

허원철 — Tue, 20 Jun 2017 15:55:51 +0900

내가 과연 "100일 동안 하루도 안빼먹고 커밋을 할 수 있을까?" 싶었다.

그렇게 50일이 지나고, 60일, 70일, 100일 지난 102일이 되었다. 내가 102일이라고 말하는 이유는 사실 중간에 이틀을 빼먹었다. "일일 커밋 실패 아니냐!"라고 따질 수 있는데 물론 맞다.

하지만 내게도 사정이 있다. 남자라면 국방의 의무를 다하고 예비군을 가야하는데, 나는 동원 훈련을 다녀왔다. (올해가 마지막 동원 훈련이였다! 야호!!)

그래서 100일이 아닌 100(+2)일 커밋에 대한 회고를 적어보려 한다.

깃헙을 접하다.

약 2년간 회사를 다니면서(현재는 퇴사 상태) 깃헙을 사용하게 된지는 1년도 채 되지 않는다. 첫 회사의 상황은 많이 열악했다.

사수가 없고 신입만 있는 신설 연구소...

기술적인 면에서나 IT 트렌드 면에서나 많이 부족했고, 회사에서는 많은 기술을 요구하지도 않았다. (언제나 그렇지만 변명에 불과하다.)

어영부영 시간을 보내면서 1년이 지난 후에야 이 상황에 많은 절박함을 느꼈다.

그렇게 여러 커뮤니티를 찾게 되었고, 나는 많은 기술 습득과 함께 깃헙을 쓰게 된다.

나의 일등 공신!

100일 동안 기록들을 살펴보자면,

Repository 생성 갯수 : 8개

Commit 횟수 : 282개

 
JavaDesignPattern : 자바를 이용한 주요 디자인 패턴 코드 [진행 중]
 
Java8Sample : Java 8에서 등장한 Stream, Optional, LocalDate,... 예제 코드
 
JavaScriptES6 : ES6 등을 이용한 예제 코드
 
JavaBasePractice : Thread Pool, 자료구조, 알고리즘, 주요 유틸 API 등등 예제 코드
 
SpringPersonalProject : 여러 기술을 이용한 게시판 프로젝트 [진행 중]
 
TobySpring : 토비 3.1을 읽으며 해보는 코드 [진행 중]
 
docker-centos-java-base : DockerFile 코드
 
BaekjoonPractice : 백준 문제 코드
 
---------------------------------------------------------------------------------
 
SpringBootSample : Spring Boot를 베이스로한 여러 샘플 코드 [진행 중]
 
Colored by Color Scripter
cs

거의 300개에 달하는 커밋 횟수에 1등 공신은 아마 SpringBootSample이지 않을까 싶다.

SpringBootSample은 Spring Boot를 베이스로 한 약 20가지 이상의 샘플 프로젝트를 Multi Project로 만들어논 리포지토리이다. (아마 프로젝트를 쪼갯다면 리포지토리가 40개 넘었을 듯...)

대부분이 실업무에 바로 쓸 수 있게끔 작업을 많이 내논 상태이다. 어려운 조합도 아니고, 이것저것 많이 조합한게 아니기 때문에 다른 조합을 추가할 때 어떤 이슈가 발생 할지는 잘 모르겠다.

하지만, 스프링이 그렇게 멍청하고 답답한 프레임워크가 아니기 때문에 이슈는 없으리라 생각된다.

일일커밋을 하면서 좋았던 점이 있다면..?

1. 기초 알고리즘이나 디자인 패턴을 다시 훑어보는 기회가 되기도 했다.

2. 코드를 공유함으로써 피드백을 받을 수 있다. (+ 리팩토링)

3. 히스토리를 통해 내가 성장하는 모습을 볼 수 있어, 약간의 뿌듯함을 느낄 수 있다.

4. Fork나 Star가 추가될 때마다 기분이 좋아진다.

나를 평가하는 해본다면.. 또 앞으로의 계획

100% 만족하진 못 하지만 정말 의미 있는 102일이였다고 생각한다.

회사를 그만 두고 나서도 매일 카페에 가서 코딩을 했고, (나는 자칭 쓰리커피라고 말한다.) 102일 전보다 많은 성장을 했다고 확신한다.

미안한 일도 있다. 왜냐하면 개발자가 아닌 주변 지인분들은 거의 만나지 않고, 정말 개발에 미쳐 살았던 것 같다. 다음에 만나게 되면 맞아도 할 말 없을 듯..

거추장스러운 계획은 없다. 지금은 매일 1~2시간씩 토비의 스프링을 읽으면서 일정 단위로 커밋을 하기 때문에 일일 커밋은 지속 될 것 같다.

그 이후로도 다른 회사에 입사를 할 때 까지 하고 있지 않을까 싶다. (너무 오래 하면 안되는데..)

https://github.com/Heo-Won-Chul

JSON vs JSONP

허원철 — Fri, 16 Jun 2017 15:04:31 +0900

우연치 않게 모회사에 기회가 되서 면접을 보게 되었는데 면접 질문 중에 "ajax를 사용하면 문제가 있다. 그 문제는 무엇인가?"라는 질문을 받았었습니다.

면접관 A님 : Ajax를 사용하면 문제가 있는데, 어떤 문제가 있나요?

나 : 동일 서버가 아닌 타 서버에 http 통신할 때 크로스 도메인이 발생합니다.

면접관 A님 : 그럼 이를 해결하려면 어떻게 해야하나요?

나 : 서버에서...

면접관 A님 : 크로스 도메인이 일어나면 서버에 가기 전에 에러가 발생하는데 어떻게 서버에서 하죠??

나 : 잘 모르겠습니다.

면접관 A님 : json과 jsonp가 뭔지 아시나요?

나 : .... 잘 모르겠습니다.

핑계를 대자면, Front-End와 Back-End를 같이 올리는 형태(?)인 모놀리식 아키텍처 경험이 대다수이다보니 RestTemplate을 떠올리게 되었고, 서버를 생각했었습니다.

그리고 json이라고 하면 자바스크립트 객체 형태의 데이터 포맷이라는 것을 알고 있었지만, jsonp는 구글링을 하다가 간혹스쳐가는 블로그 예제에서 보던 키워드였지 궁금해 하지도 찾아보지 않았었습니다.

결과적으로, 이들은 서로 서로 얽힌 개념들이라는 것을 추후에 구글링을 통해 알게 되었고, 개발자로서 많이 부족함을 느꼈던 면접이였음을 다시 깨달았습니다.

JSON 이란?

JavaScript Object Notation(이하 JSON)은 속성-값 쌍으로 이루어진 데이터 오브젝트를 전달하기 위해 사용하는 개방형 표준 포맷입니다. (위키 참고)

요즘 HTTP통신을 하게 되면 흔히 쓰는 데이터 포맷(JSON, XML) 중 하나입니다.

JSONP 이란?

JSON with padding(이하 JSONP)은 클라이언트와 다른 도메인에 있는 서버의 데이터를 요청하는데 사용되는 데이터 포맷입니다. (위키 참고)

Ajax를 이용한 jsonp 요청 방법

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
function getAjax(dataType) {
    console.log(`=============== ${dataType} ================`);
 
    $.ajax({
        url : `http://www.codejs.co.kr/jsonp.json`,
        dataType : dataType,
        jsonpCallback : "myCallback",
        success : function (response) {
            console.log(response);
        },
        error : function (xhr) {
            console.log(xhr);
        }
    });
}
Colored by Color Scripter
cs

1. json으로 했을 때

1
getAjax('json');
cs

2. jsonp으로 했을 때

- jsonpCallback : "myCallback"으로 넣어면 myCallback( json문자열 ) 형태의 데이터를 받을 수 있습니다.

1
getAjax('jsonp');
cs

하지만, 결국엔 서버측에서 jsonp에 대한 callback을 맞춰줘야하는 것이 아닌가란 생각도 들고.. 그냥 Spring Framework에서 제공해주는 RestTemplate를 사용하는게 좋지 않을까라는 생각을 해봅니다... (경험 부족이네요..)

참고

- 깃헙소스

Lombok - 간략 정리

허원철 — Thu, 1 Jun 2017 12:26:31 +0900

이번 글은 lombok에 대한 간단한 예제 글입니다.

lombok이 뭔가요..? 왜 쓰나요..?

- 흔히 Java에서 VO, DTO, Domain, Persistence, ... 같은 객체를 만들다 보면 getter/setter, toString, hashCode, equals, constructor, ... 등등 이 늘어나게 되고 비즈니스 로직이 아님에도 불구하고 코드가 길어지는 현상이 발생합니다. 이 때 "이 코드를 어떻게 줄이지?" 라는 고민을 하게 되는데, lombok을 이용하여 쉽고 빠르게 해결할 수 있습니다.

어떤 것들이 있나요??

- lombok은 어노테이션기반으로 되어 있으며, class나 field에 추가해줄 수 있습니다.

1) @Getter/@Setter

- getter/setter를 만들어 줍니다.

2) @ToString

- {className}(field1=value, field2=value, ... ) 형태의 toString()을 만들어 줍니다.

3) @EqualsAndHashCode

- equals(동등성)과 hashCode(동일성)을 만들어 줍니다.

4) @NoArgsConstructor

- 매개변수가 없는 기본생성자를 만들어 줍니다.

5) @AllArgsConstructor

- 해당 클래스에 모든 필드가 매개변수에 들어간 생성자를 만들어 줍니다.

6) @Data

- @Getter, @Setter, @RequiredArgsConstructor, @ToString, @EqualsAndHashCode, @lombok.Value를 만들어 줍니다.

※ 간단하게 쓴다면 @Data만 쓰는 것 만으로도 충분합니다.

7) @Builder

- 해당 클래스를 빌더 패턴으로 만들 수 있게 해줍니다.

8) @Slf4j

- 로그 변수를 만들어 줍니다.

...

어떻게 사용할 수 있나요..?

- IDE마다 초기 셋팅방법이 다릅니다.

1) Eclipse (STS)

① http://projectlombok.org/download.html

② [Window OS] 경우, cmd 접속하여 다운받은 lombok.jar를 실행

1
java -jar {설치 경로}/lombok.jar
cs

③ Specify location... 버튼 클릭 후, 사용하는 eclipse 선택

2) Intellij

① File -> Setting

② Plugins -> Browse repositories 버튼 클릭

③ lombok 검색 후, 설치

④ restart

어떻게 활용 할 수 있을까?

- Person 클래스를 만들어 예시를 들어보도록 하겠습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
public class Person {
 
    private String firstName;
 
    private String lastName;
 
    private String address;
 
    private String city;
 
    private LocalDate dateOfBirth;
 
}
Colored by Color Scripter
cs

1) @Getter/@Setter

- class에 어노테이션을 써주면 private로 선언한 모든 field에 getter/setter가 만들어집니다.

- 불필요한 getter/setter가 있는 경우, 해당 필드에 getter/setter를 다시 써주고 AccessLevel 옵션을 변경 해줍니다.

1
2
3
4
5
6
7
8
9
@Getter
@Setter
public class Person {
 
    @Getter(AccessLevel.PRIVATE)
    private String firstName;
    
    // ...
}
cs

2) @EqualsAndHashCode

- Set으로 중복제거할 때, 유용하게 사용할 수 있습니다.

- of는 해당 field들 중 식별의 대상이 될 필드명을 나열해줍니다.

- exclude는 of와 반대로 식별의 대상에서 제외될 필드명을 나열해줍니다.

1
2
3
4
5
@EqualsAndHashCode(of = {"firstName", "lastName", "dateOfBirth"})
//@EqualsAndHashCode(exclude = {"address", "city"})
public class Person {
    // ...
}
Colored by Color Scripter
cs

- 테스트를 위해 임의의 데이터를 넣어둔 Person 객체를 준비합니다.

1
2
3
4
5
6
7
8
9
public static Person getDefaultPerson() {
    Person person = new Person();
    person.setFirstName("won chul");
    person.setLastName("heo");
    person.setAddress("South Korea");
    person.setCity("Seoul");
    person.setDateOfBirth(LocalDate.of(1992, 7, 8));
    return person;
}
Colored by Color Scripter
cs

① 테스트 1

- 단순히 객체가 동등하고 동일한 객체인지 판별해봅니다.

 
1
2
3
4
5
6
7
8
9
@Test
public void test_equalAndHashCode() throws Exception {
    Person person = new Person();
    person.setFirstName("won chul");
    person.setLastName("heo");
    person.setDateOfBirth(LocalDate.of(1992, 7, 8));
 
    Assert.assertEquals(person, Person.getDefaultPerson());
}
Colored by Color Scripter
cs

② 테스트 2

- 같은 객체를 Set에 넣으면 중복제거가 되어 size가 1이 되는지 확인해봅니다.

1
2
3
4
5
6
7
8
9
10
@Test
public void test_hashSet() throws Exception {
    Set<Person> personSet = new HashSet<>();
    personSet.add(Person.getDefaultPerson());
    personSet.add(Person.getDefaultPerson());
    personSet.add(Person.getDefaultPerson());
    personSet.add(Person.getDefaultPerson());
 
    Assert.assertEquals(personSet.size(), 1);
}
Colored by Color Scripter
cs

3) @NoArgsConstructor

4) @AllArgsConstructor

- @NoArgsContructor는 이미 위 테스트과정에서 사용을 하였습니다. 기본 생성자는 위에서 어디에도 만들지 않았고, @NoArgsContrucrtor를 이용하여 만들어냈습니다.

1
2
3
4
5
6
@NoArgsConstructor
@AllArgsConstructor
public class Person {
 
    // ...
}
cs

5) @Builder

- XXXXBuilder가 class에 만들어 지면서 XXXX.builder()로 손쉽게 빌더패턴을 구현할 수 있습니다.

1
2
3
4
5
6
7
public static Person of(String firstName, String lastName, LocalDate localDate) {
    return Person.builder()
            .firstName(firstName)
            .lastName(lastName)
            .dateOfBirth(localDate)
            .build();
}
Colored by Color Scripter
cs

6) @Slf4j

- 해당 클래스에 log라는 변수가 생깁니다.

- slf4j는 log인터페이스이기 때문에 slf4j와 log처리에 활용할 라이브러리를 추가해줘야 합니다.

1
2
3
4
5
6
7
dependencies {
    compile group: 'org.slf4j', name: 'slf4j-api', version: '1.7.25'
    compile group: 'ch.qos.logback', name: 'logback-classic', version: '1.2.3'
    compile group: 'org.projectlombok', name: 'lombok', version: '1.16.16'
 
    testCompile group: 'junit', name: 'junit', version: '4.12'
}
Colored by Color Scripter
cs

참고

- Lombok

- https://projectlombok.org/

Naver Hack Day 2017

허원철 — Fri, 26 May 2017 20:58:40 +0900

다른 포스팅과 달리 경험을 살리기 위해 말을 짧게 쓰는 점 이해해주시면 감사하겠습니다.

경력 2년이 있는 상태에서 네이버에서 주최하는 Hack Day를 참여하게 되었다.

(물론, 사이버대학생으로 재학 중에 있어서 문제 없다.)

주제가 36가지 정도 되었는데 그 중, '천만 사용자 게시판 만들기' 라는 주제로 참여하게 되었다.

('대용량 로그 분석 ~~~' 라는 주제도 선택했는데 저게 된 듯...)

사실 헤커톤이 처음이다보니, 뭘 할지도 몰랐고.. 어떻게 진행되야 효율적인지도 몰랐다.

하지만, 나의 목표는 단 하나!

네이버 현개발자분이 주제당 한분씩 멘토가 되어 이끌어 주신다. 그래서 나는 '네이버가 어떤 기술을 사용하고 있고, 어떻게 구성하고 있는지 (아키텍처)에 대해 배워보자' 라는 마음으로 임하게 되었다.

나와 멘토님을 포함해서 총 4명..

다행하게도 다들 자바를 사용(휴... 다른거 썻더라면...)했지만, 얼마나 활용도가 높은지 몰랐기 때문에 안심은 할 수 없었다.

준비된 서버는 웹서버 4대, db서버 2대였다. 아마 웹서버 4대는 로드밸런서로 묶을 것이다. (클라우드 환경이기 때문에 로드밸런싱은 쉽게 가능 했다.)

내가 사전에 생각한 구성도는 이러하다.

해커톤이라는 짧은 제약사항이 있기때문에 db 클러스터링 포기..(사실 개념만 알지 할 줄도 모름)

DB 서버 1대 NoSql로 유저 세션 관리

웹 서버 4대, DB 서버 1대는 게시판 관리

이렇게 하고.. 나름의 지식으로 Tomcat이 아닌 Netty기반의 Undertow를 넣어 조금 더 많은 Connection을 수용하도록 하고, MVC 에 Model(Service/Repository)부분을 비동기 처리를 하면 어떨까..라는 고민만 가지고 임하게 되었다.

(조금 더 다르게 접근한다면.. 메시지 큐로 db에 넣고 해당 데이터를 NoSql에 넣어 동기화하는 식의 방법도 생각해볼 수 있을 것 같다.)

결론부터 말하자면..

해커톤에 자체에 만족스럽진 못 했다. 서로 간의 역량 차이, 알지 못할 변수들(DB Connection 문제, Build 문제)..

또한 공교롭게도 다들 처음이라 갈피를 잡지 못해 시간 버린 것 들이 안타까운 헤커톤이였던 것 같다. (학생 기준으로 나이도 제일 많았고, 그나마 경력도 있었으나 제대로 받춰 주지 못해 미안한 마음도 든다..ㅠㅠ)

그래도 대충 게시판을 구성하고 부하테스트(Jmeter), 서버 CPU/IO 체크정도를 해보았다. (우리의 목표는 천만 사용자이지 게시판이 아니다.)

하지만!! 나의 목표는 어느 정도 이뤘다고 본다. 멘토님께서 네이버에서 사용하는 방법들을 작게나마 설명해 주셨다.

1) 뭘 구성하든 두 개 이상의 서버를 엮어 사용한다.

2) DB Lock 때문에, 동일 테이블을 여러개 두어 경합을 줄인다.

3) NoSQL과 RDB를 이용하여 서로 동기화하며, 빠른 응답처리를 한다.

(Redis를 사용할 때, Annotation으로 캐시 기반으로 쓰는 것 보다는 RedisTemplate를 이용하여 여러 컬랙션을 다룬다.)

4) L4는 단순히 분산하는 역할만 하지만, L7은 health 체크까지 한다.

(사실 몇 개 더 들은 것 같은데.. 기억이 안남...)

그 외)

- 네이버 지하식당에서 밥을 먹었는데 임직원은 2천원이더라.. (맛있다.)

- 네이버 휴게시설을 한번 구경했는데 작은 동네라고 무방할 정도이다. (병원, 카페, 휴게실... CU편의점도 있더라..)

- 헤커톤을 하기 위해 네이버 커넥트원?(춘천)을 갔다. 다만, 촬영 금지라.. 안타깝다. (시설 굳, 식사 굳, 경치 베리 굳이였다..)

- 그리고 마지막으로 기념품 자랑해달라고 하셔서 올려 보겠습니다 ㅋㅋ

Spring Boot - Async 제대로 사용하기

허원철 — Thu, 18 May 2017 15:09:59 +0900

이번 글은 Spring Boot에서 Async를 제대로 사용해보기 위한 글입니다.

스프링캠프를 다녀온 이후에 Spring에서 제공해주는 Async를 다시 한번 되짚어보고자 SimpleAsyncTaskExecutor와 다른 스레드풀을 비교하여 포스팅해보기로 하였습니다.

SimpleAsyncTaskExecutor는 스레드풀이 아닙니다. 그렇기 때문에 스레드를 관리하고 재사용하는 것이 아니라 계속 만들어냅니다. 스레드는 자원이 많이 들기 때문에 SimpleAsyncTaskExecutor를 쓰지 말아야합니다.

SimpleAsyncTaskExecutor와 쓰레드풀을 만들어서 visualvm으로 가시화 해보겠습니다.

1. Bean 등록

① SimpleAsyncTaskExecutor

1
2
3
4
@Override
public Executor getAsyncExecutor() {
    return new SimpleAsyncTaskExecutor("heowc-async-");
}
Colored by Color Scripter
cs

② Custom Thread Pool

1
2
3
4
5
6
7
8
9
10
@Override
public Executor getAsyncExecutor() {
    ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
    executor.setCorePoolSize(2);
    executor.setMaxPoolSize(10);
    executor.setQueueCapacity(500);
    executor.setThreadNamePrefix("heowc-async-");
    executor.initialize();
    return executor;
}
Colored by Color Scripter
cs

2. HTTP Test

- async를 10번 호출해보고 visualvm 확인한 결과입니다.

① SimpleAsyncTaskExecutor

② Custom Thread Pool

3. 결과

- thread를 매번 생성하는 SimpleAsyncTaskExecutor에 비해 custom thread pool에서는 core 갯수 만큼인 thread가 2개만 생성된 것을 확인할 수 있습니다.

4. AsyncRestTemplate 사용하기

- RestTemplate를 비동기로 활용하기 위한 방법입니다.

- 기본적으로는 Async와 비슷하게 쓰레드를 계속 생성하는 SimpleAsyncTaskExecutor(BIO)라는 것을 사용합니다. AsyncRestTemplate를 제대로 사용하기 위해서는 NIO 라이브러리를 추가해줘야 합니다.

4-1. Gradle 설정

- NIO 라이브러리에는 Apache와 Netty에서 제공하는 것이 있습니다.

1
2
3
4
5
dependencies {
    compile('org.apache.httpcomponents:httpasyncclient:4.1.3')
    compile('io.netty:netty-all:4.1.11.Final')
// ...
}
Colored by Color Scripter
cs

4-2. Bean 설정

- Apache에서 제공해주는 것은 HttpCoponentsAsyncClientHttpRequestFactory를 사용하면 되고, Netty에서 제공해주는 것은 Netty4ClientHttpRequestFactory를 이용하면 됩니다.

1
2
3
4
5
@Bean
    public AsyncRestTemplate getAsyncRestTemplate() {
//        return new AsyncRestTemplate(new Netty4ClientHttpRequestFactory());
        return new AsyncRestTemplate(new HttpComponentsAsyncClientHttpRequestFactory());
    }
Colored by Color Scripter
cs

4-3. HTTP Test

Docker - 시작하기

허원철 — Thu, 11 May 2017 10:39:52 +0900

이번 글은 Docker를 시작하는 분들을 위한 간단 요약 글입니다.

Docker?

- Immutable Infrastructure ( OS와 서비스 운영 환경(웹서버, DB 등)을 분리하고, 한 번 설정한 환경은 변경하지 않음 )인 이미지를 만들어 두고 컨테이너라는 곳에 올려 손쉽게 사용할 수 있도록 하는 것입니다.

사전 개념

전가상화 : vmware 같은 게스트 os 자체를 가상화하는 방식

반가상화 : 리눅스의 LXC와 비슷한 docker 자체에서 libcontainer방식으로 가상화하는 방식

이미지 : 컨테이너 실행에 필요한 파일과 설정 값을 등을 포함하고 있는 파일입니다.

컨테이너 : image를 실행한 상태를 의미합니다.

그렇다면 변경된 설정값은..?!

- 컨테이너에 올려 변경된 설장값은 컨테이너에 저장됩니다.

왜 Docker를 사용해야만 하는가?

1) 관리가 편해집니다.

Why ?

- 컨테이너에 올릴 이미지파일만 따로 관리하면 되기 때문입니다.

2) 확장성이 좋습니다.

Why ?

- 이미지는 다른 컨테이너에 재사용이 가능합니다,

3) 테스트하기 편합니다.

Why ?

- Docker만 있으면 어디서든 똑같은 환경을 손쉽게 구성할 수 있습니다.

4) 가볍습니다.

Why ?

- 반가상화 방식으로 호스트 OS와 거의 동일한 환경를 제공해줍니다.

설치하기

[ Window OS ]

1) install Docker for Windows -> stable channel -> msi 다운로드합니다.

2) hyper-v 나 vmware 같은 가상머신을 사전에 설치되어 있어야합니다. 이와 같은 가상머신 설치가 불가능한 경우 DockerToolbox를 설치합니다.

( 서칭 중, hyper-v 를 이용하면 network 환경이나 여러가지 이슈가 있어 DockerToolbox를 이용하는 것이 좋을 것 같습니다. )

추가로, DockerToolbox를 설치하면 따로 msi를 설치할 필요가 없습니다.

3) Docker Terminal를 실행하면 boot2docker.iso를 설치합니다.

4) 설치 후, docker -v 나 docker --version 을 통해 설치 유무와 버전을 확인 할 수 있음.

Dockerfile 이용하기

docker run [image 명]:[tag 명]

ex) docker run ubuntu:16.04

해당 이미지가 없는 경우, docker repository pull(다운로드)해서 가져옵니다.

기본 명령어

docker search [이미지 명]

docker ps : 컨테이너 목록 확인

docker stop [컨테이너 명] : 컨테이너 멈춤

docker rm [컨테이너 명] : 컨테이너 삭제

docker images : 이미지 확인

docker pull [image 명] : 이미지 다운로드

docker rmi [image 명] : 이미지 삭제

docker logs [컨테이너 명] : 컨테이너 로그 확인

docker start [컨테이너 명] : 컨테이너 시작하기

docker exec [컨테이너 명] : 컨테이너의 명령어 실행하기 ※ ssh 권장하지 않음

Spring Boot - Excel Upload & Download

허원철 — Fri, 5 May 2017 12:20:47 +0900

이번 글은 Spring Boot를 이용하여 Excel을 Upload 와 Download을 다루는 예제 글입니다.

자바진영에서 엑셀을 Upload, Download하기 위해 POI를 가장 많이 사용합니다. 엑셀 버전마다 다를 수 있는데, xls의 경우는 poi, xlsx의 경우는 poi-ooxml를 추가하면 됩니다. (xls의 경우, Excel(5.0/95)이하는 불가능한 걸로 알고 있습니다.)

1. Gradle

1
2
3
4
5
6
7
8
9
dependencies {
    compile('org.apache.poi:poi-ooxml:3.16') // .xlsx
    compile('org.apache.poi:poi:3.16') // .xls
 
    compile('org.projectlombok:lombok:1.16.6')
 
    compile('org.springframework.boot:spring-boot-starter-web')
    testCompile('org.springframework.boot:spring-boot-starter-test')
}
Colored by Color Scripter
cs

2. Upload

- Java 8의 Function, Stream을 이용하여 Component를 추가해보겠습니다.

2-1. Component

1) MultipartFile과 Function을 이용하여 Component를 만들어줍니다.

1
2
3
4
5
6
7
8
@Component
public class ExcelReadComponent {
 
    public <T> List<T> readExcelToList(final MultipartFile multipartFile,
                                       final Function<Row, T> rowFunc) throws IOException, InvalidFormatException {
    // ...
    }
}
Colored by Color Scripter
cs

2) File을 Workbook으로 변환하기 전에 엑셀 파일인지 검증해줍니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
public <T> List<T> readExcelToList(final MultipartFile multipartFile,
                                   final Function<Row, T> rowFunc) throws IOException, InvalidFormatException {
 
    final Workbook workbook = readWorkbook(multipartFile);
        
    // ...
}
 
private Workbook readWorkbook(MultipartFile multipartFile) throws IOException, InvalidFormatException {
    verifyFileExtension(multipartFile);
    return multipartFileToWorkbook(multipartFile);
}
 
private void verifyFileExtension(MultipartFile multipartFile) throws InvalidFormatException {
    if( !isExcelExtension(multipartFile.getOriginalFilename()) ) {
        throw new InvalidFormatException("This file extension is not verify");
    }
}
 
private boolean isExcelExtension(String fileName) {
    return fileName.endsWith(ExcelConfig.XLS) || fileName.endsWith(ExcelConfig.XLSX);
}
 
private boolean isExcelXls(String fileName) {
    return fileName.endsWith(ExcelConfig.XLS);
}
 
private boolean isExcelXlsx(String fileName) {
    return fileName.endsWith(ExcelConfig.XLSX);
}
Colored by Color Scripter
cs

3) Workbook으로 변환 뒤, Stream을 이용하여 Row 갯수 만큼 Domain로 바꾸고 해당 Stream을 List로 변환해줍니다.

1
2
3
4
5
6
7
8
9
10
11
12
public <T> List<T> readExcelToList(final MultipartFile multipartFile,
                                   final Function<Row, T> rowFunc) throws IOException, InvalidFormatException {
 
    final Workbook workbook = readWorkbook(multipartFile);
    final Sheet sheet = workbook.getSheetAt(0);
    final int rowCount = sheet.getPhysicalNumberOfRows();
 
    return IntStream
            .range(0, rowCount)
            .mapToObj(rowIndex -> rowFunc.apply(sheet.getRow(rowIndex)))
            .collect(Collectors.toList());
}
Colored by Color Scripter
cs

2-2. Controller & Domain

1) 위에서 작성한 Component를 이용하여 JSON 형태로 반환해줍니다.

1
2
3
4
5
6
7
8
9
10
11
12
@RestController
@RequestMapping("upload")
public class UploadExcelController {
 
    @Autowired ExcelReadComponent excelReadComponent;
 
    @PostMapping("excel")
    public List<Product> readExcel(@RequestParam("file") MultipartFile multipartFile)
                                                throws IOException, InvalidFormatException {
        return excelReadComponent.readExcelToList(multipartFile, Product::new);
    }
}
Colored by Color Scripter
cs

2) Row를 이용하여 Domain 객체를 만들어줍니다. (간단한 예제이기 때문에 유효성 검사가 없으니 상세한 작업을 원한다면 추가해줘야 할 것 입니다.)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
@Data
@AllArgsConstructor
public class Product implements Serializable {
 
    private String uniqueId;
 
    private String name;
 
    private String comment;
 
    public Product(Row row) {
        this(row.getCell(0).getStringCellValue(),
            row.getCell(1).getStringCellValue(),
            row.getCell(2).getStringCellValue());
    }
}
Colored by Color Scripter
cs

3. Download

- spring 4.x 이전에는 AbstractExcelView를 사용하였으나, 이후에는 AbstractXlsView, AbstractXlsxView, AbstractXlsxStreamingView를 이용해야 합니다.

- 각각의 Component로 등록을 해준 뒤, ModelAndView에서 해당 name으로 반환할 때, 인식할 수 있도록 @EnableWebMvc를 추가해줍니다.

- 각각의 AbstractXXXView는 내부적으로 기본 셋팅(Workbook 등등...) 되어 있기 때문에, 공통적으로 buildExcelDocument()를 오버라이딩하면 됩니다.

- 그래서 공통적으로 사용할 ExcelCommonUtil을 만들었습니다.

1
2
3
4
5
6
7
@Override
protected void buildExcelDocument(Map<String, Object> model,
                                  Workbook workbook,
                                  HttpServletRequest request,
                                  HttpServletResponse response) throws Exception {
    new ExcelCommonUtil(workbook, model, response).createExcel();
}
Colored by Color Scripter
cs

- workbook은 해당 Excel형식에 맞는 인스턴스 객체가 됩니다. (XSSFWorkbook, SXSSFWorkbook, HSSFWorkbook 등)

- model은 Controller에서 ModelAndView에서 담은 Map을 뜻합니다.

- response는 클라이언트에게 반환해줄 객체입니다.

3-1. ExcelCommonUtil

1
2
3
4
5
6
7
8
9
10
public void createExcel() {
    // 1)
    setFileName(response, mapToFileName());
    // 2)
    Sheet sheet = workbook.createSheet();
    // 3)
    createHead(sheet, mapToHeadList());
    // 4)
    createBody(sheet, mapToBodyList());
}
Colored by Color Scripter
cs

1) Download될 Excel 파일에 대해 명명을 해줍니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
private void setFileName(HttpServletResponse response, String fileName) {
    response.setHeader("Content-Disposition",
                       "attachment; filename=\"" + setFileExtension(fileName) + "\"");
}
 
private String setFileExtension(String fileName) {
    if ( workbook instanceof XSSFWorkbook) {
        fileName += ".xlsx";
    }
    if ( workbook instanceof SXSSFWorkbook) {
        fileName += ".xlsx";
    }
    if ( workbook instanceof HSSFWorkbook) {
        fileName += ".xls";
    }
 
    return fileName;
}
Colored by Color Scripter
cs

2) 해당 Excel 파일에 하나의 시트를 만들어줍니다. (단순 예제이기 때문에 시트 하나만 만들어줬습니다.)

3) head에 해당하는 데이터를 넣어줍니다.

1
2
3
private void createHead(Sheet sheet, List<String> headList) {
    createRow(sheet, headList, 0);
}
Colored by Color Scripter
cs

4) body에 해당하는 데이터를 넣어줍니다.

1
2
3
4
5
6
private void createBody(Sheet sheet, List<List<String>> bodyList) {
    int rowSize = bodyList.size();
    for (int i = 0; i < rowSize; i++) {
        createRow(sheet, bodyList.get(i), i + 1);
    }
}
Colored by Color Scripter
cs

※ createHead, createBody에서 공통으로 쓰인 메소드

1
2
3
4
5
6
7
8
9
private void createRow(Sheet sheet, List<String> cellList, int rowNum) {
    int size = cellList.size();
    Row row = sheet.createRow(rowNum);
 
    for (int i = 0; i < size; i++) {
        row.createCell(i)
            .setCellValue(cellList.get(i));
    }
}
Colored by Color Scripter
cs

3-2. Controller

- ModelAndView를 이용하여 각각의 Component를 호출해줍니다.

1
2
3
4
5
6
7
8
9
10
11
@Controller
@RequestMapping("download")
public class DownloadExcelController {
 
    @GetMapping("excel-xls")
    public ModelAndView xlsView() {
        return new ModelAndView("excelXlsView", getDefaultMap());
    }
 
    // ...
}
Colored by Color Scripter
cs

참고

- 조금 더 자세한 코드 내용은 깃헙을 참고하시기 바랍니다.

- SpringBootExcel

Spring Boot - Data JPA & ModelMapper

허원철 — Sun, 30 Apr 2017 12:33:43 +0900

이번글은 Data JPA를 사용하면서 편하게 DTO를 만들 수 있도록 도와주는 라이브러리에 대한 글입니다.

JPA를 사용하다보면 난해한 부분이 있습니다. '나는 이 데이터를 보여주기 싫어' 라는 생각이 들 때가 많습니다. 예를 들면, 게시판에 대한 내용을 글 목록만 보여주는 페이지에 굳이 안보여질 내용까지 반환되어 나오는 상황이 생깁니다. 여러가지 방법이 있겠지만, Repository를 수정하지 않고 Service, Controller에서만 작업을 하고 싶다면 Dozer, ModelMapper를 사용하면 간단하게 DTO로 변환할 수 있습니다.

Dozer와 ModelMapper 중 ModelMapper를 사용해보도록 하겠습니다. (개인적으로 더 간편해 보였습니다...ㅎ)

Gradle 설정

- dependency의 일부입니다.

1
2
3
4
5
6
7
dependencies {
//...
 
    compile('org.modelmapper:modelmapper:0.7.8')
 
//...
}
Colored by Color Scripter
cs

Bean 등록

- ModelMapper를 Bean으로 등록해줍니다.

1
2
3
4
@Bean
public ModelMapper modelMapper() {
    return new ModelMapper();
}
Colored by Color Scripter
cs

Notice Domain Class

- 게시판 용도의 Domain Class 입니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
@Data
@Entity
@Table(name = "NOTICE")
@JsonIgnoreProperties({"hibernateLazyInitializer", "handler"})
public class Notice implements Serializable {
 
    @Id @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "NOTICE_IDX")
    private Long idx;
 
    @NotNull
    private String title;
 
    @NotNull
    private String content;
 
    private LocalDateTime createDateTime;
 
    private LocalDateTime modifyDateTime;
 
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "EMAIL")
    private Member member;
 
    public Notice() {}
 
    public Notice(String title, String content) {
        this.title = title;
        this.content = content;
    }
}
Colored by Color Scripter
cs

Notice DTO Class

- 게시판 용도의 DTO 클래스입니다. Domain에서 내용 부분만 빼고 DTO를 구성하였습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
@Data
public class NoticeDto {
 
    private Long idx;
 
    private String title;
 
    private LocalDateTime createDateTime;
 
    private LocalDateTime modifyDateTime;
 
    private Member member;
}
Colored by Color Scripter
cs

Service

- JPA를 따로 설명을 하지 않을 것 이기 때문에, Service부분에서 ModelMapper를 적용한 일부만 발췌합니다.

- Java 8과 lamda 표현식으로 이용하면 매우 깔끔한 코드로 변환할 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
@Service
@Transactional
public class NoticeServiceImpl implements NoticeService {
 
    @Autowired NoticeRepository noticeRepository;
 
    @Autowired ModelMapper modelMapper;
 
    @Override
    public Page<NoticeDto> findNoticePaging(Integer page, String type, String keyword) {
        return findNoticeByConditions(page, type, keyword)
                .map(notice -> modelMapper.map(notice, NoticeDto.class));
    }
 
    // ...
}
 
Colored by Color Scripter
cs

참고

- 해당 예제는 개인프로젝트에서 진행한 소스 일부입니다. 자세한 사항은 깃헙 소스를 참고하시면 되겠습니다.

- SpringPersonalProject

- http://modelmapper.org/

Spring Camp 2017 - 후기

허원철 — Sun, 23 Apr 2017 17:15:12 +0900

이번 글은 Spring Camp를 다녀온 후기를 남기는 글 입니다.

작년에 GDG Seoul 2016 Fair에 이어 컨퍼런스를 참여하게 되었습니다. 개인적으로는 Spring Camp에 더 오고 싶은 마음이 컸고(저는 스프링을 애용하는 자바 개발자입니다.), KSUG이 10주년이 되는 해라고 해서 더욱 큰 규모로 진행된다고 하니 이번 컨퍼런스는 무척이나 기대되었습니다.

김경원님의 <Booting Spring Data REST>

이일민님의 <Async & Spring>

이일민님의 <Spring Web Flux>

김경원님의 <Booting Spring Data REST>

- Spring에서 제공하는 Data Rest에 대한 내용이였습니다. Data REST는 Spring + Data JPA 조합에서 보다 빠르게 REST API를 만들 수 있게 도와줍니다.

1 . Repository Interface 정의만으로 REST API를 제공 가능합니다 (Controller 없어도 됩니다.)

① @RepositoryRestResource로 Controller, Repository, Service이 통합됩니다.

② PagingAndSortRepository를 상속 받음으로써, 페이징처리와 정렬을 할 수 있습니다.

③ Insert 같은 경우에 전후처리가 필요한 시점이 있는데, @RepositoryEventHandler 추가하거나 AbstractReposoitoryEventHandler 상속받아 처리가 가능합니다.

④ Controller가 필요한 경우에, @RepositoryRestController를 이용하여 가능합니다.(상위 Path를 맞춰줘야 작동합니다.)

2 . Data JPA에서 Interface에서 메소드를 작성하면 Query를 작성할 수 있는데, 이것을 바로 API 지원합니다.

- 기본적으로는 {domain}s/search/{method name}으로 되나, @RestResource를 이용하여 세부적인 처리가 가능합니다.

3 . Projection을 이용하여 데이터의 다양한 표현방식을 제공합니다.

- {url}?projection={name}

4 . HATEOAS를 이용하여 메타데이터를 제공합니다.

- Client에게 url를 제공해줌으로써, url를 조합해야하는 수고를 덜어줍니다.

- ResourceProcessor를 이용하여 Global HATEOAS 설정 가능합니다.

5 . RepositoryRestConfigureAdapter로 전반적인 세부설정이 가능합니다.

이일민님의 <Async & Spring>

1 . Spring에서는 version 3.2~ 이후에 비동기 개발이 가능합니다.

① 자바 비동기(Future/Executor, Blocking Queue, ForkJoinTask, CompletableFuture, Flow)

② 서블릿 비동기(Async Processing Async Context, Non-Blocking IO, ...)

③ 스프링 비동기(@Async, AsyncRestTemplate)

1-1 . 동기와 비동기 차이가 무엇인가?

- 메소드 요청 작업과 리턴 시간이 일치하다면 동기입니다.(↔ 비동기)

1-2 . 동기&비동기와 항상 같이 대두되는 Blocking&Non-Blocking

- 동기&비동기를 논할 대상이 아닙니다.

- 내가 직접 제어를 할 수 없는 대상을 상대하는 방법이라고 합니다.

2 . @Async

- 정해진 리턴타입을 이용해야만 사용 가능 합니다. (String, List<T> 등등 사용 불가능)

① ~ Java 7 : Future, ListenableFuture<T>

② Java 8 ~ : CompletableFuture<T>

※ 기본적으로 SimpleAsyncTaskExecutor를 사용합니다.

- 쓰레드풀이 아닙니다.

- 매번 쓰레드를 만들고 사용 후 버려지게 되기 때문에, 자원 낭비가 심합니다.

- Executor, ExecutorService, TaskExecutor를 Bean으로 등록 하게 되면, 해당 쓰레드풀을 이용하여 관리됩니다.

+ 쓰레드풀을 설정할 때 corePool/maxPool/Queue를 초기화 하는데, Core Size 만큼 쓰레드를 관리하다가 Queue가 감당하기 힘들 만큼의 쓰레드 수가 늘어나게 되면, Max Size까지 늘리게 됩니다.

3 . 서블릿 + @MVC

① Callable

② WebAsyncTask : 시간과 쓰레드풀을 지정 가능합니다.

- DeferredResult : 임의의 쓰레드에서 리턴값 설정이 가능합니다.

- DeferredResult + @Async 조합하면 좋다 => ListenableFuture<T>로 대체 가능합니다.

But!! 두개의 비동기 방식으로 진행될 경우, DeferredResult를 중첩 사용해야합니다.

But!! 콜백 중첩이 발생합니다.

But!! CompletableFuture<T> 사용할 경우, 콜백 헬을 막을 수 있습니다. (그러니 Java 8를 사용하세요...ㅎ)

4 . AsyncRestTemplate

- Spring 4.0부터 사용 가능합니다.

- 비동기방식으로 진행되지만 많은 쓰레드를 만들게 되어 점유율이 높아집니다.

- Non-Blocking IO HttpClientFactory를 사용하면 쓰레드 점유율을 낮출 수 있습니다. (예 :Netty)

- ListenableFuture<T> 로만 반환하게 되므로 CompletableFuture<T> 커스터마이징해서 쓰는 것이 좋습니다.

5 . 결론

비동기 작업과 잦은 API 호출이라면...

- AsyncRestTemplate는 Non-Blocking IO를 조합해서 쓰자

- @Async와 적절한 TaskExecutor 를 사용하자

- ListenableFuture<T>, CompletableFuture<T> 를 사용하자

- 항상 기본 셋팅을 사용하지말고, 쓰레드풀을 만들어서 쓰자 ★

- But!! 모르면 쓰지말자... ★

① 코드가 복잡해진다.

② 디버깅이 힘들어진다.

③ 아무런 혜택도 못 누리게 된다.

이일민님의 <Spring Web Flux>

1 . 간단한 소개

- Spring 5.0에서 나오는 새로운 방법입니다. (아직 정식 릴리즈 안됨)

- Min JDK : Java 8

- 원래는 Java 9이 테마였으나, WebFlux로 변경되었습니다.

2 . 왜 써야하는가?

- Async & Non-Blocking Reactive 개발에 사용됩니다.

- 효율적으로 동작하는 고성능 웹 어플리케이션 개발이 가능합니다.

- 서비스 간 호출이 많은 Micro Service Architecture에 적합합니다.

3 . Web Flux 사용 방법

① 기존 MVC

- @Controller, @RestController

- @RequestMapping

② 새로운 함수형 모델링

- RouteFunction

- HandlerFunction

4 . 기존 서블릿 요청 탈피ing...

HttpServletRequest

HttpServletRsponse

↓

ServerRequest

ServerResponse

5 . 지원 서버&컨테이너

- Servlet 3.1 +

- Netty

- Undertow

6 . MVC 요청 방식

① 요청 매핑 - RequestMapping

② 요청 바인딩 - Url Path, Header, Cookie, Body

③ 핸들러 실행 - 로직 수행 & 반환

④ 핸들러 결과 처리

6-1 . Web Flux 요청 방식

① 요청 매핑 - RouteFunction

② 요청바인딩, 핸들링 실행 및 결과 처리 - HandlerFunction

- @Bean이나 @Component로 따로 정의하여 route를 관리합니다.

- RouterFunctions.route(Path, ServerRequest)를 이용하여 조금 더 편리하게 관리 가능합니다.

+ and(), andRouth()로 체이닝 가능합니다.

+ nest()로 공통 path 설정이 가능합니다.

6-1-1 . 장점

① 요청작업을 명시시적인 코드로 작성이 가능합니다.

- 어노테이션에 의존하는 것이 아니라 명확합니다.

- 정확한 타입 체크가 가능합니다.

② 함수 조합을 통한 편리한 구성&추상화 유리합니다.

③ 테스트 작성이 편리합니다.

6-1-2 . 단점

① 함수형 스타일로 작성이 어려우면 어렵습니다.(러닝커브가 심합니다.)

7 . 스프링 Web Flux Annotation 방식

- @RestController, @RequestMapping를 동일하게 사용합니다.

- 반환타입을 Mono, Flux로 하고 실제 반환하고자하는 데이터를 제네릭타입에 넣어줍니다.

1
Mono<Entity>...
cs

- @RequestBody 또한 Mono<Entity>로 받는 것이 가능합니다.

1
2
3
Mono<String> hello(@RequestBody Mono<User> user) {
  return user.map(u -> "Hello" + user.getName());
}
Colored by Color Scripter
cs

8 . 개선할 수 있는 상황

① JPA : @Async + CompletableFuture 조합으로 개선이 가능합니다.

② Redis, Mongo : ReactiveCrudRepository를 구현하여 개선이 가능합니다.

③ WebClient : AsyncRestTemplate의 Reactive 방식

※ JDBC 방식은 JDK 10을 기다려보자....

9 . 왜 써야하는가?

① 성능 향상 및 개선된 코드를 볼 수 있습니다.

② 다양한 오퍼레이터 적용이 가능합니다.

③ 추상화된 코드 작성이 용이합니다.

④ 데이터 흐름의 속도를 제어할 수 있는 메커니즘을 제공합니다.

참고

- 아래 링크는 제가 들은 세션이외에도 추가 링크해놓았습니다.

- http://www.springcamp.io/2017/

Java Script - ECMAScript 6th(ES6)

허원철 — Thu, 20 Apr 2017 20:54:54 +0900

이번 글은 Java Script - ES6에 대한 글입니다.

1. 변수 선언의 다양성

- var은 전역으로 사용 가능합니다.

- let은 지역변수로 사용 가능합니다.

- const는 변경이 불가능합니다.

1
2
3
4
5
6
7
var globalField = 'global';
let areaField = 'area';
const finalField = 'final';
 
console.log(this.globalField);
console.log(this.areaField);
console.log(this.finalField);
cs

1
2
3
global
undefined
undefined
cs

2. let와 var 활용

- 블록 사이에서 변수는 새로운 변수로 인식되며, 블록 밖에 변수와는 무관하게 됩니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
function globalTest() {
   var name = 'null';
   if (true) {
      var name = 'wonchul';
      console.log(name);
   }
   console.log(name);
}
 
function areaTest() {
   let name = 'null';
   if (true) {
      let name = 'wonchul';
      console.log(name);
   }
   console.log(name);
}
 
globalTest();
areaTest();
cs

1
2
3
4
wonchul
wonchul
wonchul
null
cs

3 . for문의 변화

- 기존 forEach는 return 이나 break가 불가능하였으나, ES6부터는 가능합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
const arr = ['a', 'b', 'c'];
 
arr.forEach(value => {
   // can not use the break statement.
   console.log(value);
});
 
for(let i in arr) {
   console.log(arr[i]);
   if(i == 1) {
   break;
   }
}
 
for(let i of arr) {
   break;
   console.log(i);
}
Colored by Color Scripter
cs

1
2
3
4
5
6
a
b
c
 
a
b
cs

4 . Arrow function

- 조금 더 간결하게 function을 표현 할 수 있습니다.

1) 매개변수 불필요한 경우, () => { logic } / _ => { logic }

2) 매개변수 하나인 경우, x => { logic } / (x) => { logic } / => { logic }

3) 매개변수 둘이상 (x, y) => { logic }

- 한줄로 표현이 가능하면, {} 를 생략할 수 있습니다.

- 자바에서의 람다표현식과 매우 흡사합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
const pow = num => num * num;
const multiply = (x, y) => x * y;
 
console.log(pow(3));
console.log(multiply(2, 3));
 
const programmingLanguages = [
   "java",
   "javascript",
   "go"
];
 
const upperProgrammingLanguages = programmingLanguages.map(programming => programming.toLocaleUpperCase());
 
console.log(programmingLanguages);
console.log(upperProgrammingLanguages);
Colored by Color Scripter
cs

1
2
3
4
9
6
[ java, javascript, go ]
[ JAVA, JAVASCRIPT, GO ]
cs

5 . Template

- 문자열을 넣을 때, `` 로 표기할 수 있습니다.

- ${변수명}을 `` 사이에 넣을 수 있습니다.

1
2
3
4
let name = 'Heo Won Chul';
let birthYear = 1992;
const calcAge = year => new Date().getFullYear().valueOf() - birthYear;
console.log(`My name is ${name}. I am ${calcAge(birthYear)} years old.`);
cs

1
My name is Heo Won Chul. I am 25 years old.
cs

6 . 문자형 function

1
2
3
4
console.log(name.startsWith('Heo'));
console.log(name.includes(' '));
console.log(name.repeat(2));
console.log(`${name}, `.repeat(3));
cs

1
2
3
4
true
true
Heo Won ChulHeo Won Chul
Heo Won Chul, Heo Won Chul, Heo Won Chul,
cs

7 . Rest Parameter

- 가변인자가 가능합니다.

1
2
const addNumber = (... numbers) => numbers.reduce((sum, number) => sum + number, 0);
console.log(addNumber(1,2,3,4));
Colored by Color Scripter
cs

1
10
cs

8 . Spread Operator

- 두 배열을 합칠 수 있습니다.

1
2
3
const defaultColors = ['red', 'green'];
const userFavoriteColors =['yellow', 'orange'];
console.log([ ...defaultColors, ...userFavoriteColors ]);
cs

1
['red', 'green', 'yellow', 'orange']
cs

9 . Class & Default Value

- 자바와 같은 class 형태의 표현이 가능합니다.

- extends도 가능합니다.

- 매개변수에 default value를 넣을 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
class User {
   constructor(name = 'anonymous') {
      this._name = name;
   }
 
   open() {
      return 'Hello, ' + this._name;
   }
   
   static service() {
      console.log(`User name is ${name}.`)
   }
}
 
console.log(new User('wonchul').open());
console.log(new User().open());
User.service();
cs

1
2
3
Hello, wonchul
Hello, anonymous
User name is Heo Won Chul.
cs

10 . Promise

- 비동기처리를 할 수 있는 콜백 함수

1
2
const sleep = msec => new Promise((resolve, reject) => setTimeout(resolve, msec));
sleep(1000).then( () => console.log('wake!'));
Colored by Color Scripter
cs

1
2
3
1초 뒤,
 
wake!
cs

참고

- http://blog.jeonghwan.net/2016/04/28/es6.html

- https://gist.github.com/marocchino/841e2ff62f59f420f9d9

- JavaScriptES6

Spring Boot - MyBatis

허원철 — Thu, 13 Apr 2017 19:57:54 +0900

이번 글은 Spring Boot에서 MyBatis를 사용한 글 입니다.

Spring Boot에서는 JPA와는 달리 번거롭게 Bean을 설정하는 작업이 필요하는 등 MyBatis를 제대로 지원해주지 않았는데, 1.5.2(?) 버전에서 프로퍼티가 추가 되었습니다. 그래서 제가 스프링에서 주로 써왔던 MyBatis를 다시 한번 써보고자 작성하게 되었습니다.

1. Gradle

1
2
3
dependencies {
    compile("org.mybatis.spring.boot:mybatis-spring-boot-starter")
}
Colored by Color Scripter
cs

2. 요구사항

- MyBatis-Spring-Boot-Starter는 Java 6 이상 및 MyBatis-Spring 및 Spring Boot 버전이 필요합니다.

MyBatis-Spring-Boot-Starter	MyBatis-Spring	Spring Boot
1.3.x (1.3.0)	1.3 or higher	1.5 or higher
1.2.x (1.2.1)	1.3 or higher	1.4 or higher
1.1.x (1.1.1)	1.3 or higher	1.3 or higher
1.0.x (1.0.2)	1.2 or higher	1.3 or higher

3. Domain

- Lombok를 이용하여 간단하게 Domain을 만들어 줍니다.

1
2
3
4
5
6
7
8
@Data
@NoArgsConstructor
@AllArgsConstructor
public class User implements Serializable {
    private Long idx;
    private String name;
    private String local ;
}
Colored by Color Scripter
cs

4. SQL

- 해당 예제는 memory를 이용한 h2를 사용했기 때문에 table을 사전에 만들어주는 작업을 했습니다.

- resources 밑에 schema.sql를 만들어 User Table을 만들어줍니다.

1
2
3
4
5
CREATE TABLE USER (
  IDX   NUMBER        PRIMARY KEY   NOT NULL,
  NAME  VARCHAR(20)                 NOT NULL,
  LOCAL VARCHAR(20)                 NOT NULL
);
Colored by Color Scripter
cs

5-1. Mapper Annotation

- interface 선언에 @Mapper를 달아주고 해당 @Insert, @Select, @Delete, @Update를 만들어 줍니다.

- argument에 Query에 넣을 값을 지정 할 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
@Insert("INSERT INTO USER VALUES (#{idx}, #{name}, #{local})")
void insert(@Param("idx") Long idx, @Param("name") String name, @Param("local") String local);
 
@Select("SELECT * FROM USER WHERE IDX = #{idx}")
List<User> findByIdx(@Param("idx") Long idx);
 
@Delete("DELETE FROM USER WHERE IDX = #{idx}")
void deleteByIdx(@Param("idx") Long idx);
 
@Update("UPDATE USER SET NAME = #{name} WHERE IDX = #{idx}")
void setFixedNameByIdx(@Param("name") String name, @Param("idx") Long idx);
cs

5-2. XML

① properties에서 path를 잡아줍니다.

1
mybatis.config-location=classpath:mybatis-config.xml
cs

② 설정 xml 에서 domain에 해당하는 패키지 path와 mapper로 사용되는 xml를 지정해줍니다.

1
2
3
4
5
6
7
8
9
10
11
12
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <typeAliases>
        <package name="com.tistory.heowc.domain"/>
    </typeAliases>
    <mappers>
        <mapper resource="mapper/UserMapper.xml"/>
    </mappers>
</configuration>
Colored by Color Scripter
cs

③ <insert>, <select>, <delete>, <update> 안에 쿼리를 작성해줍니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="UserMapper">
 
    <insert id="insert">
      INSERT INTO USER VALUES (#{idx}, #{name}, #{local})
    </insert>
 
    <select id="findByIdx" resultType="User">
      SELECT * FROM USER WHERE IDX = #{idx}
    </select>
 
    <delete id="deleteByIdx">
      DELETE FROM USER WHERE IDX = #{idx}
    </delete>
 
    <update id="setFixedNameByIdx">
      UPDATE USER SET NAME = #{name} WHERE IDX = #{idx}
    </update>
</mapper>
Colored by Color Scripter
cs

참고

- 테스트 코드는 Github에 있으니 참고하시기 바랍니다.

- http://www.mybatis.org/spring-boot-starter/mybatis-spring-boot-autoconfigure/

- SpringBootMybatis

Google - Guava

허원철 — Thu, 6 Apr 2017 13:40:38 +0900

구글에서는 안드로이드 버전 네이밍을 유명 과자이름로 붙이는 방식으로 하고 있습니다.(오늘날까지는 오레오까지 확인되었습니다.) 이 와 비슷하게 자바 프레임워크인 Guice도 있고, 유틸성(?) 라이브러리 Guava라는 것이 있는데, 이번에는 그 중 Guava를 소개하고자 하는 글 입니다.

Guava 맛보기

- 유틸성 라이브러리이다보니, Spring Framework에서 제공해주는 것과 흡사한 것도 있고, 중복되는 것도 있습니다.

1) StopWatch

- Spring Framwork에서도 Stopwatch 존재합니다

1
2
3
4
5
6
7
8
9
10
@Before
public void before_start() {
    stopwatch = Stopwatch.createStarted();
}
// ...
@After
public void after_stop() {
    stopwatch.stop();
    System.out.println("Test Time : " + stopwatch);
}
Colored by Color Scripter
cs

2) Strings

① isNullOrEmpty

- Spring Framework에서 StringUtils.isEmpty() 존재합니다.

- 메소드 네이밍이 조금 더 명확한 표현인 듯 합니다.

1
2
3
4
5
@Test
public void test_isNullOrEmpty() throws Exception {
    Assert.assertTrue(Strings.isNullOrEmpty(""));
    Assert.assertTrue(Strings.isNullOrEmpty(null));
}
Colored by Color Scripter
cs

② repeat

- 반복하고자 하는 문자열을 n번 반복 가능합니다.

1
2
3
4
5
6
@Test
public void test_repeat() throws Exception {
    Assert.assertEquals("String is same content",
            Strings.repeat("wonchul ", 2),
            "wonchul wonchul ");
}
Colored by Color Scripter
cs

3) Joiner

- 서로 다른 문자열을 구분자를 넣어 하나의 문자열로 합칠 수 있습니다.

1
2
3
4
5
6
7
@Test
public void test_joiner() throws Exception {
    Joiner joiner = Joiner.on(",").skipNulls();
    String joinNumber = joiner.join("1", null, "3", "4");
 
    Assert.assertEquals("1,3,4", joinNumber);
}
Colored by Color Scripter
cs

① mapJoiner

- map의 key : value를 문자열로 원하는 표현을 할 수 있습니다.

1
2
3
4
5
6
7
8
9
10
@Test
public void test_joinerMapJoiner() throws Exception {
    Joiner.MapJoiner mapJoiner = Joiner.on("&").withKeyValueSeparator("=");
 
    Map<String, String> map = Maps.newHashMap();
    map.put("key", "param");
    map.put("key2", "param2");
 
    Assert.assertEquals(mapJoiner.join(map), "key2=param2&key=param");
}
Colored by Color Scripter
cs

4) Splitter

- 하나의 문자열을 구분자를 통해 나눌 수 있습니다.

1
2
3
4
5
@Test
public void test_splitter() throws Exception {
    Splitter splitter = Splitter.on(";");
    splitter.split("heo;won;chul").forEach(System.out::println);
}
Colored by Color Scripter
cs

① mapSplitter

- mapJoiner의 반대되는 기능이라고 볼 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
12
@Test
public void test_splitterMapSplitter() throws Exception {
    Splitter.MapSplitter mapSplitter = Splitter.on("&").withKeyValueSeparator("=");
 
    Map<String, String> map = Maps.newHashMap();
    map.put("key", "param");
    map.put("key2", "param2");
 
    Map<String, String> map2 = mapSplitter.split("key2=param2&key=param");
 
    Assert.assertEquals(map.get("key"), map2.get("key"));
}
Colored by Color Scripter
cs

5) ImmutableCollection

- 값을 추가하고 제거 할 수 없는 Collection Class를 만들 수 있습니다.

1
ImmutableCollection<Integer> IMMUTABLE_NUMBERS = ImmutableSet.of(1, 2, 3, 4, 5);
cs

※ add/remove 시, UnsupportedOperationException 발생합니다.

6) Collection

- 조금 더 간추려진 코드를 만들 수 있습니다.

① newArrayList

- 인스턴스 생성을 조금 더 간결하게 해줍니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
@Test
public void test_newArrayList() {
    Lists.newArrayList(1, 2, 3, 4, 5, 6, 7, 8, 9).forEach(System.out::println);
 
    // JDK 6 이하
    List<Integer> list1 = new ArrayList<Integer>();
 
    // JDK 7 이상
    List<Integer> list2 = new ArrayList<>();
 
    // Guava
    List<Integer> list3 = Lists.newArrayList();
}
Colored by Color Scripter
cs

② partition

- 사이즈 지정하여 Collection을 나눌 때 유용하게 사용될 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
12
@Test
public void test_partitionToLists() {
    Integer groupSize = 3;
 
    List<Integer> numberList = Lists.newArrayList(1, 2, 3, 4, 5, 6, 7, 8, 9);
 
    Lists.partition(numberList, groupSize)
         .forEach(list -> {
              list.forEach(System.out::print);
              System.out.println();
         });
}
Colored by Color Scripter
cs

③ cartesianProduct

- SQL CROSS JOIN과 같은 기능을 합니다.

1
2
3
4
5
6
7
8
@Test
public void test_cartesianProduct() {
    List<Integer> numberList1 = Lists.newArrayList(1, 2);
    List<Integer> numberList2 = Lists.newArrayList(3, 4);
 
    Lists.cartesianProduct(numberList1, numberList2)
         .forEach(System.out::println);
}
Colored by Color Scripter
cs

④ reverse

1
2
3
4
5
@Test
public void test_reverse() {
    List<Integer> numberList = Lists.newArrayList(1, 2, 3, 4, 5, 6, 7, 8, 9);
    Lists.reverse(numberList).forEach(System.out::println);
}
Colored by Color Scripter
cs

⑤ transform

1
2
3
4
5
@Test
public void test_transform() {
    List<Integer> numberList = Lists.newArrayList(1, 2, 3, 4, 5, 6, 7, 8, 9);
    Lists.transform(numberList, value -> value * 2).forEach(System.out::println);
}
Colored by Color Scripter
cs

7) Math

- XXXXMath Class가 존재하여, 각 형식에 맞게 변환 가능합니다.

- RoundingMode로 올림/반올림/내림 등의 처리 가능합니다.

1
2
3
4
5
6
7
8
9
10
@Test
public void test_checkedMultiply() throws Exception {
    try {
        IntMath.checkedMultiply(1 * 10000 * 10000, 100);
    } catch (ArithmeticException e) {
        e.printStackTrace();
    }
 
    Assert.assertTrue(true);
}
Colored by Color Scripter
cs

참고

- https://blog.outsider.ne.kr/710

- http://www.baeldung.com/java-list-split

- JavaBasePractice/GoogleLibraryGuava

Thread Pool 이해하기

허원철 — Sat, 1 Apr 2017 16:12:49 +0900

이번 글은 Thread Pool에 대한 기본적인 내용입니다.

Process : 운영체제에서 하나의 어플리케이션

Thread : Process에서 하나의 작업

Process에서 오직 하나의 Thread만 가지게 된다면..?

Server 경우, 다수의 Client가 동시에 접근하지 못 합니다.

Client 경우, UI 변경와 네트워크 통신이 자유롭지 못 합니다.

Multi Thread

여러 Thread를 동시에 만들어 실행(병렬처리) 합니다. Java에 경우, Thread Class, Runnable Interface를 이용하여 Main Thread와는 별개로 Work Thread를 만들 수 있습니다.

※ 동시성(Concurrency) 와 병렬성(Parallelism)

동시성은 싱글 코어에서 멀티 스레드를 동작시키기 위한 방식으로 멀티 태스킹을 위해 여러 개의 스레드가 번갈아가면서 실행되는 성질을 말한다. 동시성을 이용한 싱글 코어의 멀티 태스킹은 각 스레드들이 병렬적으로 실행되는 것처럼 보이지만 사실은 번갈아가면서 조금씩 실행되고 있는 것이다.

병렬성은 멀티 코어에서 멀티 스레드를 동작시키는 방식으로, 한 개 이상의 스레드를 포함하는 각 코어들이 동시에 실행되는 성질을 말한다. 병렬성은 데이터 병렬성(Data parallelism)과 작업 병렬성(Task parallelism)으로 구분된다.

- 데이터 병렬성

데이터 병렬성은 전체 데이터를 쪼개 서브 데이터들로 만든 뒤, 서브 데이터들을 병렬 처리하여 작업을 빠르게 수행하는 것을 말한다. 자바 8에서 지원하는 병렬 스트림이 데이터 병렬성을 구현한 것이다. 서브 데이터는 멀티 코어의 수만큼 쪼개어 각각의 데이터들을 분리된 스레드에서 병렬 처리한다.

- 작업 병렬성

작업 병렬성은 서로 다른 작업을 병렬 처리하는 것을 말한다. 대표적인 예는 웹 서버로, 각각의 브라우저에서 요청한 내용을 개별 스레드에서 병렬로 처리한다.

<출처 : '이것이 자바다' 신용권 저>

그렇다고 해서 Thread를 계속 늘려가는 건 좋은 것 일까? 당연히 아닙니다. 서버나 클러언트에는 하드웨어에 제한적인 사항이 있기 때문에 관리할 필요가 있습니다.

Thread Pool은 무엇인가..?

작업 처리에 사용되는 스레드를 제한된 개수만큼 정해 놓고 작업 큐(Queue)에 들어오는 작업들을 하나씩 스레드가 맡아 처리하는 것입니다. Java에 경우, 기본적으로 Executors Class, ExecutorService Interface를 이용하여 Thread Pool를 만들 수 있습니다.

1) Single Thread Pool

- ExecutorService executorService = Executors.newSingleThreadExecutor();

- 단일 Worker Thread를 사용합니다.

- 실패 시, 새로운 Thread를 생성하지 않습니다.

2) Fixed Thread Pool

- ExecutorService executorService = Executors.newFixedThreadPool(int nThreads);

- 고정된 Worker Thread를 사용하며, 모든 Thread를 사용 중 이라면 Queue에 쌓여 대기 합니다.

- 실패 시, 새로운 Thread를 생성하여 대체됩니다.

3) Cached Thread Pool

- ExecutorService executorService = Executors.newCachedThreadPool();

- 필요에 따라서 새로운 Thread를 생성하며, 이전에 생성된 Thread가 존재하면 재사용 합니다.

- 기본적으로 60초 정도 Thread가 유지됩니다.

- 비동기 작업에 사용하는데 합리적일 수 있습니다.

4) Scheduler Thread Pool

- ScheduledExecutorService scheduledExecutorService = Executors.newScheduledThreadPool(int corePoolSize);

- 지정된 delay 후에 실행하거나 주기적으로 실행하도록 명령을 예약 할 수 있는 Thread Pool 입니다.

5) Work Stealing Thread Pool

- ExecutorService executorService = Executors.newWorkStealingPool(int parallelism);

- 자바 8에서 새로 생긴 Thread Pool 입니다.

- 지정된 parallelism을 지원할만큼 충분한 Thread를 유지하고 여러 Queue을 사용하여 경합을 줄이는 Thread Pool을 만듭니다.

- Thread를 동적으로 늘리고 줄일 수 있습니다.

- 작업이 실행되는 순서를 보장하지 않습니다.

참고

- ThreadPool

클린 코드 (3)

허원철 — Sun, 26 Mar 2017 23:24:07 +0900

이번 글은 클린코드에 대한 세번째 글입니다.

주석

클린 코드를하는데 주석은 걸림돌이 될 수 있습니다. 왜냐하면 코드는 진화하는데 주석은 오랫동안 방치되는 경우가 대부분입니다.

1) 주석보단 코드로 의도를 표현합니다. (메소드명으로 행위를 명확하게 전달 합니다.)

2) 좋은 주석

- 법적인 주석 (라이센스 등)

- 정보를 제공하는 주석

- 의도를 명료하게 밝히는 주석

- 결과를 경고하는 주석

- todo 주석

- javadocs

3) 나쁜 주석

- 중복 주석

- 오해할 여지가 있는 주석

- 의무적인, 이력을 남긴 주석

- 함수나 변수로 표현할 수 없으면 주석을 달지 않습니다.

- 너무 많은 정보

- 모호한 관계

형식 맞추기

1) 적절한 행을 유지합니다.

- 위에서 아래로 서술적으로 쓰도록 합니다. (책에서는 내려가기 규칙이라 합니다.)

- 비슷한 개념의 파일은 가까이 둡니다. (메뉴별 패키지화, 모듈별 패키지화)

2) 가로 형식 맞춰춥니다.

- 가로 정렬(선언부가 길다면..)

객체와 자료구조

1) 객체는 직접적인 반환보다는 추상적인 반환이 좋습니다.

2) 때로는 절차적인 코드가 좋을 때도 있습니다.(물론 예외적인 상황입니다.)

3) 디미터 법칙을 적용합니다

- 모듈은 자신을 조작하는 객체의 속사정을 몰라야 한다.

클린 코드 (2)

허원철 — Sun, 26 Mar 2017 18:21:03 +0900

이번 글은 '클린 코드 시작하기'에 이은 글입니다.

의미 있는 이름 짓기

1) 이름을 명명할 때 명확하게 의도가 드러나도록 합니다.

ex) 학생 이름

1
2
String studentName; ------------------- (O)
String nm; ---------------------------- (X)
cs

2) 흡사한 이름을 사용하거나 유사한 개념을 다르게 표기하는 행위는 피하도록 합니다.

1
Map<String, Student> studentList; ------------------------ (X)
cs

3) 의미가 있게 구분합니다.

4) 검색하기 쉬운 이름을 사용합니다.

1
2
3
4
5
if ( getDayOfWeek() == 1 ) --------------- (X)
 
private static final MONDAY = 1;
...
if ( getDayOfWeek() == MONDAY ) ---------- (O)
cs

5) 클래스명은 명사나 명사구, 메소드는 동사나 동사구로 시작하도록 합니다.

1
2
Class     : Cutomer, Account, ...
Method    : getXXX(), setXXX(), isXXX(), ...
cs

6) 개념 하나에 단어 하나를 사용합니다.

- fetch, retrieve, get... 등등 섞어 쓰지 않습니다.

함수 만들기

- 제어문 단위로 적절하게, 한 함수에서 한가지 일만 하게 만듭니다.

1) 최대한 작게 만듭니다.

1
2
3
private boolean isEmpty(String value) {
    return value == null || "".equals(value);
}
Colored by Color Scripter
cs

2) 제어문 단위로 적절하게 함수를 만듭니다.

3) 함수 하나당 하나의 일만 수행합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
private void method() {
 
   for() {
      ...
   }
 
   for() {
      ...
   }
 
} ----------------------------- ( X )
 
private void method() {
 
     for1();
 
     for2();
 
} ----------------------------- ( O )
cs

4) 한 함수에서 추상화수준(깊이)을 하나로 합니다.

- 꼬리에 꼬리를 무는 메소드는 되도록이면 쓰지 않습니다.

5) switch 문을 드러내지 않도록 합니다.

- 디자인 패턴인 팩토리 패턴을 활용하는 것을 추천합니다.

6) 서술적인 함수명을 사용합니다.

- findStudentByStudentId(), findStudentByStudentNumber() 등등

7) 어규먼트는 최대한 적게 사용합니다.

- 플래그 어규먼트 사용하지 않는다.

- 어규먼트들을 클래스화 할 수 있는지 확인합니다.

1
2
3
private List<Area> findAreaByPointXAndPointY(double pointX, double pointY) --- (X)
 
private List<Area> findAreaByPoint(Point point) ------------------------------ (O)
cs

8) 함수 안에 부수 기능을 숨기지 않습니다.

1
2
3
4
private List<Student> findById(Long id) {
     deleteStudentById(id);
     return ...
} ------------------------------------- (X)
cs

9) 명령과 조회를 구분합니다.

1
2
3
if ( setPoint(127.000000, 37.000000) ) {
 
} ------------------------------------- (X)
cs

10) 복잡한 구조에서는 예외처리를 이용합니다.

11) 반복 코드를 사용하지 않습니다.

12) 큰 구조에서는 두개이상의 return 문을 넣지 않도록 합니다.

클린 코드 (1)

허원철 — Sun, 26 Mar 2017 17:56:41 +0900

클린 코드 Clean Code: 국내도서; 저자 : 로버트 C. 마틴(Robert C. Martin),박재호 / 이해영역; 출판 : 케이앤피북스 2010.03.11

상세보기

아는 분으로 부터 '클린코드' 라는 책을 접하게 되었습니다. 원래는 전부 읽고 전체적인 내용을 포스팅해보려고 했으나, 500페이지가 넘는 분량을 한 포스팅에 넣기에는 좋은 내용도 많았고 철학적인 얘기가 많은 터라 조금씩 나눠 포스팅해보려고 합니다.

그래서 클린 코드란 무엇인가?

짐작하시겠지만 깔끔한 코드를 말합니다. 아마 어느 게발자던지 클린코드를 싫어하는 분은 없으리라 생각됩니다.

프로젝트를 하게되면 당연하게 팀을 꾸리는 등 2명 이상의 개발자가 투입되어 소스를 공유하며 코드 작업을 합니다. 여기서 같이 작업할 동료 개발자에게나 작업이 끝나고 유지보수를 하게 될 어느 개발자에게 쉽고 빠르게 코드분석을 할 수 있도록 해야합니다. (물론 자기 자신이 나중에 보게될 경우도 있으므로...)

그렇기 때문에 개발자에게 있어 리팩토링은 필수 사항이며, 그로 인한 클린 코드를 만들어 내는 것은 좋은 습관이고 좋은 개발자로 나아가는 길이라고 생각됩니다.

반대로 나쁜 코드(더티 코드)를 만든다면...

- 흔히 스파게티 소스라고 말합니다.

1) 생산성이 떨어집니다.

2) 재설계가 필요해집니다.

3) 급하게 하려다가 오히려 늦어질 수 있습니다.

그래서 클린 코드는 어떻게 하나요?

클린 코드 책을 읽으면 된다? 이번 포스팅을 읽으면 된다..? 아닙니다. 클린코드 저자는 '클린코드는 감각이다.', '나쁜 코드를 안다고 클린 코드를 아는 것도 아니며, 클린 코드를 안다고 나쁜 코드를 바꿔낼 수도 없는 것 이다.' 라고 말하고 있습니다.

클린 코드를 작성하기 위해서는 적어도 3가지 노력은 해야합니다.

1) 쉬운 코드를 만듭니다.

2) 시간이 지나도, 코드 변경이 있더라도 클린 코드를 유지해야 합니다.

3) 클린 코드를 작성할 수 있도록 계속 연습해야 합니다.

Other Posting

- 의미있는 이름 짓기, 함수 만들기

- 주석, 형식 맞추기, 객체와 자료구조

Spring Boot + JPA + Time package Issue

허원철 — Wed, 22 Mar 2017 10:04:11 +0900

이번 글은 Spring Boot + Data JPA를 사용하면서 Java 8에서 나온 Time package 추가 했을 때에 대한 이슈 글입니다.

스펙 정리

1
2
3
4
// spring boot 1.5.2.RELEASE
 
compile('org.springframework.boot:spring-boot-starter-web')
compile('org.springframework.boot:spring-boot-starter-data-jpa')
cs

1. LocalDataTime 에서 @Temporal 사용 이슈

1) 기존에는 날짜 타입에서는 @Temporal를 추가해서 사용했습니다.

org.hibernate.AnnotationException: @Temporal should only be set on a java.util.Date or java.util.Calendar property

2) @Temporal 제거시,

ClassCastException: java.util.Date cannot be cast to java.time.LocalDateTime

1-1. 왜 이런 이슈가 생긴 것일까?

Java 8은 JPA2.1 이후에 Release 되어, 이에 대한 지원을 하지 않습니다.

그래서 방법은

1) JPA AttributeConverter를 구현합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
@Converter(autoApply = true)
public class LocalDateTimeAttributeConverter implements AttributeConverter<LocalDateTime, Timestamp> {
 
    @Override
    public Timestamp convertToDatabaseColumn(LocalDateTime locDateTime) {
        return (locDateTime == null ? null : Timestamp.valueOf(locDateTime));
    }
 
    @Override
    public LocalDateTime convertToEntityAttribute(Timestamp sqlTimestamp) {
        return (sqlTimestamp == null ? null : sqlTimestamp.toLocalDateTime());
    }
}
Colored by Color Scripter
cs

2) Hibernate 5에서 소개된 서포트 라이브러리를 이용하여 해결 가능합니다.

1
compile('org.hibernate:hibernate-java8:5.0.11.Final')
cs

2. LocalDateTime 반환 포맷 이슈

- 간한다게 LocalDateTime를 반환해보겠습니다.

1
2
3
4
5
6
7
8
9
@RestController
@RequestMapping("date")
public class TimeController {
 
    @GetMapping
    public LocalDateTime getLocalDateTime() {
        return LocalDateTime.now();
    }
}
Colored by Color Scripter
cs

- 결과

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "hour": 9,
  "minute": 4,
  "nano": 377000000,
  "second": 55,
  "dayOfMonth": 22,
  "dayOfWeek": "WEDNESDAY",
  "dayOfYear": 81,
  "month": "MARCH",
  "monthValue": 3,
  "year": 2017,
  "chronology": {
  "id": "ISO",
  "calendarType": "iso8601"
  }
}
cs

- LocalDateTime을 Jackson Converter에서 날짜라는 인식을 못하고 객체 자체를 반환하는 듯 합니다.

2-1. 해결법(1)

1
compile('com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.9.0.pr1')
cs

- 결과를 다시 확인해 봅니다. 하지만...

- 조금 줄기도 하고 깔끔해지긴 했지만, 우리가 원하는 포맷이 아닙니다. (YYYY-MM-DDTHH:mm:dd:ss.sss)

2-2. 해결법(2)

- application.properties 에서 이와 같이 추가해줍니다.

1
2
3
...
spring.jackson.serialization.WRITE_DATES_AS_TIMESTAMPS=false
...
Colored by Color Scripter
cs

- 다시 결과 확인

1
"2017-03-22T09:06:15.198"
cs

참고

- SpringBootJpa

- http://www.thoughts-on-java.org/hibernate-5-date-and-time/

JPA - Persistence Context (영속성 컨텍스트)

허원철 — Thu, 16 Mar 2017 08:41:08 +0900

이번 글은 JPA을 개념적으로 이해해본 내용에 대한 글입니다.

JPA를 개념적인 측면에서 제대로 이해하고 사용한 것은 아니였습니다. 대략적으로 사용해보고, 여러 삽질을 겪어보고, 그 때 마다 레퍼런스문서를 찾아보고 구글링을 통해 해답을 얻었습니다(참 바보같은 짓이죠...ㅠ). 그러다보니 개념적인 부분을 많이 놓치고 있는 것 같아 한 번 정리를 하고자합니다.

※ KSUG에서 발표하신 자료를 우연히 보게되어 내용을 조금씩 정리하고 제가 알고 있는 개념을 추가해서 작성한 것 입니다. ( 참고 : 2015 - KSUG Conference 영상 )

JPA가 어떻게 생겨났는가...?

- EJB라는 것이 존재했는데 너무 어렵고 쓰기 힘들었다고 합니다. 그래서 어느 개발자가 하이버네이트를 만들었고..EclipseLink, OpenJpa 등등이 생기면서 이걸 하나의 공통적인 스펙(인터페이스)으로 만들자고 하여 생긴 것이 JPA 입니다.

그래서 JPA가 뭐하는 것인가..?

- JPA는 xBatis랑은 달리 OOP(Object-Oriented Programming : 객체지향 프로그래밍)의 강점을 살리고자 하는 ORM(Object Relational Mapping) 프레임워크 입니다.

※ 물론, xBatis로 OOP의 강점을 살리면서 할 수 있지만, mapper 성격이 강하기 때문에 그렇게 까지는 안합니다.

JPA를 하기에 앞서 알아야할 개념

1) Persistence Context (영속성 컨텍스트) ★★★

: Server Side와 Database Side 사이에 엔티티를 저장하는 논리적인 영역이라고 할 수 있습니다.

- 이런 영역이 있음으로서 이룰 수 있는 이점?

① 1차 캐시

- 이해하기 쉽게 설명을 하자면, 영속성 컨텍스트에 Map과 같은 객체가 존재하여 임시로 객체를 저장해줍니다.

② 동일성 보장

- Collection에서 객체를 빼오듯이 같은 객체를 반환하게 되면 새로운 객체가 나오는 것이 아니라 동일한 객체가 반환됩니다.

③ 변경 감지

- 영속성 상태의 객체는 객체의 데이터가 변경이 되면, 자동 update 됩니다.

- EntityManager에서 flush가 되고, commit이 됩니다.

※ flush가 언제되나??

⑴ 강제 Flush : EntityManager.flush()

⑵ 트랜잭션이 끝났을 때 :영속성 컨텍스트는 트랜잭션으로 범위로 만들어지기 때문입니다.

⑶ JPQL Query 실행 : JPQL은 실제 Database Side에서 데이터를 가져오기 때문에 동기화를 위해 JPQL Query가 실행 전에 flush 됩니다.

④ 트랜잭션으로 인한 쓰기 지연

- 영속성 컨텍스트는 트랜잭션 범위 안에서 동작합니다.

- J2EE 스펙의 기본전략입니다.

※ 각각의 Thread는 서로 다른 트잭잭션을 이용하기 때문에 서로 다른 영속성 컨텍스트를 가집니다.

⑤ 지연로딩

- N + 1 쿼리라고 하는데, 엔티티와 관계가 맺어진 엔티티의 데이터를 가져 올 수 있습니다.

※ 지연로딩의 경우, 오히려 성능 저하의 원인이 될 수 있으므로 충분한 설정을 거쳐야 합니다.

2) EntityManagerFactory

: EntityManager를 관리하기 위한 객체입니다.

3) EntityManager

: Database Side에 엔티티를 반영하기 위한 객체입니다.

① 비영속(new / transist)

- 일반적인 인스턴스이라고 볼 수 있습니다. ( new Entity() )

② 영속(managed)

- EntityManager에 persist를 통해 인트스턴스를 영속성 컨텍스트에 넣어진 상태입니다.

③ 준영속(detached)

- 영속성 컨텍스트로부터 나온 객체입니다.

- detach, clear, close 등으로 가능합니다.

- 거의 비영속 상태라고 볼 수 있습니다

- 지연로딩이 불가능합니다.

- 식별자(@Id)가 존재합니다.

- merge 로 다시 영속성 상태로 만들 수 있습니다.

④ 삭제(removed)

- Database Side에서 지워졌지만 영속성 컨텍스트에서는 존재하는 상태입니다.

예제로 배워보는 Persistence Context

- 예시를 위해 영속성으로 쓰일 데이터와 준영속성으로 쓰일 데이터를 준비합니다.

1
2
3
4
5
6
7
8
9
// 비영속성 데이터
private Customer getPersistenceContextCustomer() {
    return new Customer("heo won chul", "010-xxxx-xxxx", "developer");
}
 
// 준영속성 데이터
private Customer getNotPersistenceContextCustomer() {
    return new Customer(10L,"heo won chul", "010-xxxx-xxxx", "developer");
}
Colored by Color Scripter
cs

1) 간단한 insert를 해보도록 하겠습니다. Test Case이므로 Rollback이 되기 때문에, flush는 덤으로 해보도록 하겠습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
@Transactional
@Test
public void test_insertA() {
//        org.hibernate.PersistentObjectException: detached entity passed to persist
//        em.persist(getNotPersistenceContextCustomer());
    em.persist(getPersistenceContextCustomer());
    em.flush();
}
 
@Transactional
@Test
public void test_insertB() {
    em.merge(getNotPersistenceContextCustomer()); // 영속성 컨텍스트에 추가
    em.flush();
}
Colored by Color Scripter
cs

※ 준영속성 엔티티를 persist() 할 경우, PersistentObjectException이 발생합니다

2) 영속성 컨텍스트의 존재를 보기 위해 간단한 Test Case를 살펴보도록 하겠습니다.

① flush (O) / clear (O)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
@Transactional
@Test
public void test_insertClearAndFindAndUpdateClear() {
    em.merge(getNotPersistenceContextCustomer()); // Persistence Context 추가
    em.flush(); // Database 동기화
    em.clear(); // Persistence Context 초기화
 
    Customer customer = em.find(Customer.class, 10L);
    System.out.println(customer);
    customer.setBigo("Developer");
    em.merge(customer); // Persistence Context 추가
    em.flush(); // Database 동기화
    em.clear(); // Persistence Context 초기화
 
    Customer result = em.find(Customer.class, 10L);
    System.out.println(result);
}
Colored by Color Scripter
cs

② flush (O) / clear (X)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
@Transactional
@Test
public void test_insertAndFindAndUpdate() {
    em.merge(getNotPersistenceContextCustomer()); // Persistence Context 추가
    em.flush(); // Database 동기화
 
    Customer customer = em.find(Customer.class, 10L);
    System.out.println(customer);
    customer.setBigo("Developer");
    em.merge(customer); // Persistence Context 추가
    em.flush(); // Database 동기화
 
    Customer result = em.find(Customer.class, 10L);
    System.out.println(result);
}
Colored by Color Scripter
cs

① - Console

1
2
3
4
5
6
7
8
Hibernate: select customer0_.idx as idx1_0_0_, customer0_.bigo as bigo2_0_0_, customer0_.name as name3_0_0_, customer0_.tel as tel4_0_0_ from customer customer0_ where customer0_.idx=?
Hibernate: call next value for hibernate_sequence
Hibernate: insert into customer (bigo, name, tel, idx) values (?, ?, ?, ?)
Hibernate: select customer0_.idx as idx1_0_0_, customer0_.bigo as bigo2_0_0_, customer0_.name as name3_0_0_, customer0_.tel as tel4_0_0_ from customer customer0_ where customer0_.idx=?
Customer(idx=10, name=heo won chul, tel=010-xxxx-xxxx, bigo=developer)
Hibernate: update customer set bigo=?, name=?, tel=? where idx=?
Hibernate: select customer0_.idx as idx1_0_0_, customer0_.bigo as bigo2_0_0_, customer0_.name as name3_0_0_, customer0_.tel as tel4_0_0_ from customer customer0_ where customer0_.idx=?
Customer(idx=10, name=heo won chul, tel=010-xxxx-xxxx, bigo=Developer)
Colored by Color Scripter
cs

② - Console

1
2
3
4
5
6
7
8
Hibernate: select customer0_.idx as idx1_0_0_, customer0_.bigo as bigo2_0_0_, customer0_.name as name3_0_0_, customer0_.tel as tel4_0_0_ from customer customer0_ where customer0_.idx=?
Hibernate: call next value for hibernate_sequence
Hibernate: insert into customer (bigo, name, tel, idx) values (?, ?, ?, ?)
 
Customer(idx=10, name=heo won chul, tel=010-xxxx-xxxx, bigo=developer)
Hibernate: update customer set bigo=?, name=?, tel=? where idx=?
 
Customer(idx=10, name=heo won chul, tel=010-xxxx-xxxx, bigo=Developer)
Colored by Color Scripter
cs

이 처럼 중간에 영속성 컨텍스트에서 1차 캐시역할을 하기 때문에 find를 하더라도 값이 존재하면 실제 Database에서 값을 가져오는 것이 아니라, 영속성 컨텍스트에서 가져와 처리를 할 수 있습니다.

참고

- EntityManagerTests

Java - Garbage First(G1) Garbage Collection

허원철 — Sun, 12 Mar 2017 21:54:25 +0900

이번 글은 Garbage First(이하 G1) Garbage Collection에 대한 글 입니다.

간단한 소개

1) JDK 7 update 4 및 이후 Release에서 완전히 지원합니다.

2) 대용량 메모리가 있는 다중 프로세서를 대상으로한 서버 스타일 GC입니다.

3) GC Thread와 Application Thread와 동시에 수행합니다.

Heap Structure

- Heap 영역을 동일 크기로 분할합니다. (region이라고 칭합니다.)

- 1~32MB 정도로 나누고 있으며, 약 2000개 region이 생깁니다.

- region은 기존에 영역인 eden, survivor, old 중 하나 일 수 있습니다.

Heap Allocation

- G1은 Heap 영역들에서 비어있는 region을 파악하고 수집합니다. 그렇기 때문에 많은 양의 여유 공간이 생깁니다.

- 하나 이상의 region에서 단일 region으로 객체를 복사하고 프로세스 과정에서 압축하여 메모리를 비웁니다. 이는 병렬로 수행되기 때문에 처리량을 줄일 수 있고, STW을 줄일 수 있습니다.

- Humongous Region, Available/Unused Region이 새로 생겼습니다.

① Humongous Region : 객체가 큰 경우 사용됩니다. (일반 객체보다 30~50% 큰 경우에 해당됩니다.)

② Available/Unused Region : 아직 사용하지 않은 영역입니다.

- 추가로, Heap 6GB이상을 권장하고 있습니다.

※ G1이 필요한 경우

① Heap의 50% 이상이 실시간 데이터로 가득 찬 경우

② 객체 할당 비율이나 프로모션의 속도가 크게 다른 경우

③ GC 수집이 긴 경우

GC Process

1) Young GC

- Live Object는 하나 이상의 survivor region에 복사 또는 이동됩니다.

- Aging Threshold이 충족되면, old region으로 승격됩니다. (STW 발생)

2) Old GC

- 일부분 Young GC이 포함되어 있습니다.

① Initial Mark

- Young GC에서 Live Object의 초기 마킹을 피기백합니다.

② Concurrent Marking

- 빈 region(Live Object가 없는 것을 뜻하는 듯..?)이 발견되면, Remark 단계에서 즉시 제거 됩니다. 또한 liveness를 결정하는 accounting 정보에 계산됩니다.

③ Remark

- 빈 영역이 제거되고 교정됩니다. 현재 모든 region에 대해 region liveness이 계산됩니다.

④ Copying/Cleanup

- liveness가 가장 낮은 region이 선택되어 가장 빠르게 수집 됩니다. region은 Young Collection과 동시에 수집됩니다.

⑤ After Copying/Cleanup

- 선택된 영역이 수집되고 압축됩니다.

Old GC KeyPoint

1) Concurrent Marking

- liveness 정보는 Application이 실행되는 동안 계산됩니다.

- liveness 정보는 Ebacuation 단계 중에 가장 좋은 region을 식별합니다.

- CMS와 같은 단계는 없습니다.

2) Remark

- CMS에서 사용된 알고리즘보다 훨씬 빠른 SATB 알고리즘을 사용합니다.

- 완전히 빈 지역은 제거됩니다.

3) Copying/Cleanup

- Young GC와 Old GC가 동시에 진행됩니다.

- Old GC는 liveness에 의애 선택됩니다.

참고

- http://www.oracle.com/technetwork/tutorials/tutorials-1876574.html

- http://initproc.tistory.com/50

Java - JVM Architecture

허원철 — Wed, 8 Mar 2017 17:18:07 +0900

이번 글은 Java Virtual Mechine (이하 JVM)에 대해 다뤄보고자 합니다.

Java는 운영체제에 종속적이다, 독립적이다 라는 말을 합니다. 어떻게 독립적으로 돌아가는 것 일까?

운영체제에 어떻게 독립적일까?

- 단순하게 그림만 보고 설명을 보충하자면, Java라는 언어는 JVM이라는 하나의 소프트웨어 위에 돌아갑니다.

(C계열같은 언어는 OS에서 실행이 되기 때문에 Java보다 빠릅니다.)

Java 동작과정

1) IDE에서 Java Code 작성(.java)

2) Java Compiler가 Java Code 컴파일

3) Java Byte Code로 변환(.class)

4) 실행

그렇다면 JVM은 무엇인가?

- 바이트 코드를 실행할 수 있는 주체입니다.

JVM이 왜 중요한가?

- JVM은 메모리 관리 기법 중 하나인 Garbage Collection(이하 GC)이 일어납니다.

※ GC알고리즘은 다양합니다. 각각의 특성과 동작원리를 제대로 알지 못하고 사용하게 되면 서비스 중에 큰 위험이 닥칠 수 도 있습니다. 또한 그 영역 어떤 원리로 GC가 일어나는지 또한 중요합니다.

그렇다면 JVM 구조를 알아보자

1) Class Loader : 런타임시점에서 클래스를 로딩하게 해줍니다. 인스턴스가 생성이 되면 Class Loader를 통해 메모리에 적재됩니다.

2) JVM Memory( = Runtime Data Areas) : OS로 부터 별도로 할당 받은 Memory 영역입니다.

① Method Area

- 모든 Thread가 공유하는 Memory 영역입니다. ( Class, Interface, Method, Field, Static Field 등이 저장됩니다. )

② Heap

- 런타임시, 동적으로 할당하여 사용하는 영역입니다. ( 인스턴스가 생성되면 Heap에 저장됩니다. )

③ JVM Stack

⑴ Thread

- Thread의 수행 정보를 Frame을 통해 저장됩니다.

- Thread가 생성될 때 생성되므로, Thread별로 각각 생성됩니다.

- 각 Thread 별로 서로 접근은 불가능 합니다.

⑵ Method

- Method가 호출되며, Method와 Method 정보가 쌓입니다.

- Method 정보로는 매개변수, 지역변수, 임시변수, Method Address가 있습니다.

- Method 호출이 종료되면 메모리 공간에서 사라집니다.

④ PC Register

- CPU 내의 기억장치인 레지스터와 다르게 작동합니다. (Stack - Base)

- Native Stack를 수행 할 때, JVM을 거치지 않고 API를 통해 바로 수행합니다. (이때, PC Register는 Undefined 됩니다.)

- 각 Thread 별로 하나씩 존재하고, JVM Instruction의 주소를 가지게 됩니다.

※ OS나 CPU입장에서보면 JVM은 하나의 프로세스이기 때문에, 버퍼공간으로 사용하기 위해 PC Register라는 메모리 영역이 존재하는 것 입니다.

⑤ Native Stack

- Java 외의 언어로 작성된 네이티브 코드들을 위한 Stack입니다.

- JNI(Java Native Interface)를 통해 호출되는 C/C++ 등의 코드를 수행하기 위한 Stack입니다.

- JVM 내부에 영향을 주지 않기 위함입니다.

※ JNI란?

- JVM에 실행되고 있는 자바코드를 네이티브 응용 프로그램(특히 하드웨어와 운영 체제 플랫폼)들과 C, C++ 그리고 어샘블리 같은 다른 언어들로 구현된 라이브러리에 의해 호출되거나 호출할 수 있는 프로그래밍 프레임워크이다. (참고 : 자바_네이티브_인터페이스)

3) Execution Engine : Byte Code를 실행하는 Runtime Module입니다.

- Class Loader를 통해 JVM 내의 Runtime Data Areas에 배치된 Byte Code를 명령어 단위로 읽어서 실행합니다.

- 최초에는 Interperter 방식(한 줄씩 해석하고 실행)이여서 속도가 느린 단점이 있었습니다.

- JIT Compiler 방식으로 느린 것은 보완 했습니다.

※ JIT Compiler 이란?

- Byte Code를 어셈블러 같은 Native Code로 바꿔 실행합니다. 물론 무조건 바뀌는 것이 아니라 JIT 역시 변환하는 과정에 비용이 발생하기 때문에, Interpreter 방식을 사용하다가 일정 기준이 넘어가면 바뀐다고 합니다.

4) Garbage Collector

Heap Area 파헤쳐 보기

1) Eden

- 객체들이 최초로 생성되는 공간입니다.

2) Survivor

- Eden에서 참조되는 객체들이 저장되는 공간입니다.

3) Old

- Eden 과 Survivor에사 마저 지워지지 않고 살아남은 객체들이 저장되는 공간입니다.

4) Permanent

- 생성된 객체들의 정보를 가리키는 주소 값이 저장된 공간입니다.

① 클래스의 메소드(바이트 코드 포함)

② 클래스의 이름

③ 상수 풀 정보

④ 객체 배열 및 클래스와 연결된 유형 배열

⑤ JVM에 의해 생성된 내부 객체

⑥ 컴파일러의 최적화에 사용되는 정보

- Permanent 의 문제점

① Static Object의 남용

② Class와 Method의 증가

※ Permanent Area가 가득차서 OOM(Out Of Memory)가 발생할 수 있습니다.

- 기존 대응방안

① Permanent을 적절히 늘립니다.

② 정기적인 재구동

변화된 Heap Area From Java 8...

- Java 8 이전까지는 위와 같은 Heap 영역의 형태를 가지고 있었습니다. 하지만 Java 8 이후로는 Permanent 영역이 사라지면서 Heap 영역이 아닌 Native Stack 영역 안에 Metaspace 영역으로 바뀌었습니다. (Oracle의 JRockit 및 IBM의 JVM과 유사합니다.)

Permanent Area vs Metaspace Area

Java - Compare GC

허원철 — Tue, 7 Mar 2017 11:30:25 +0900

저번 포스팅에 이어 GC에 대해 비교해보려고 합니다.

CPU 같이 나왔으면 좋았겠지만 갑자기 안나오더군요ㅠㅠ

[ Environment ]

OS : Window 7

Heap Size : 4GB

Monitoring Tool : VisualVM 1.3

Testing Tool : Jmeter 3.0

약 8분 가량 30 thread를 테스트한 결과 입니다.

1
java -XX:+UseSerialGC ...
cs

1
java -XX:+UseParallelGC ...
cs

1
java -XX:+UseParallelOldGC ...
cs

1
java -XX:+UseConcMarkSweepGC ...
cs

1
java -XX:+UseG1GC ...
cs

참고

- https://getpocket.com/a/read/1157009770

Java - GC (Garbage Collection)

허원철 — Sun, 5 Mar 2017 20:48:46 +0900

이번 글은 JAVA에서 Garbage Collection(이하 GC)에 대한 글 입니다.

GC란?

- 메모리 관리 기법 중에 하나로, 프로그램이 동적으로 할당했던 메모리 영역 중에서 필요없게 된 영역을 해제하는 기능입니다. JVM에서는 Heap영역의 메모리를 자동으로 관리해줍니다.

GC의 중요성?

- 하드웨어와 언어가 발전하면서 효율적인 GC 알고리즘이 만들어지고 있으니.. 알아갈 필요성이 있다?

- 자동적으로 관리를 해주지만, 'stop-the-world' (GC를 실행하는 쓰레드를 제외한 모든 쓰레드가 일시적으로 멈추고, GC작업이 완료된 후에야 중단되었던 작업이 다시 시작하는 것)이 발생하여, 이를 최소화(튜닝) 하기 위해선 GC에 대해 명확히 알아야 합니다.

GC의 기본 개념

- GC를 알기에 앞서, HotSpot VM에 물리적 공간(영역)에 대해 알고 있어야 합니다.

Young Area

- 새로 생긴 객체의 대부분이 여기에 위치합니다.

- Eden Area, Survivor Area (2개)로 구성됩니다.

- Minor GC가 발생한다고 말합니다.

Old Area

- Young Area에서 살아남은 객체가 여기에 위치합니다.

- Major GC 또는 Full GC가 발생한다고 말합니다.

GC의 종류

Young Area

1) bump-the-pointer

- Eden 영역에 마지막 객체를 캐싱 해두고, 그 다음에 생성되는 객체가 있으면 Eden에 넣기에 적당한지 판단합니다.

2) TLABs

- 멀티 스레드 환경을 고려해 Eden영역에 lock-contention으로 인한 성능 이슈를 개선한 것 입니다.

Old Area

1) Serial GC

- mark - sweep - compaction 알고리즘을 사용합니다.

① mark : 객체를 식별합니다.

② sweep : 힙영역을 앞에서 부터 확인하여 살아 있는 것만 남깁니다.

③ compaction : 힙에 가장 앞부분부터 채워 객체 존재 부분과 객체 미존재 부분으로 나눕니다.

- CPU가 하나 일 때 사용하는 방식입니다.

- 성능이 떨어지기 때문에 운영서버에 적합하지 못합니다.

2) Parallel GC

- ThroughputGC 라고도 말합니다.

- SerialGC와 알고리즘이 같으나, 여러 쓰레드를 사용하여 더 효율적입니다.

3) Parallel Old GC

- JDK 5 update 6부터 제공합니다.

- mark - summary - compaction 알고리즘을 사용합니다. (약간 더 복잡한 단계)

① summary : GC를 수행한 영역에 대해서 별도로 살아 있는 객체를 식별

4) CMS GC ( Concurrent Mark Sweep )

- Low Latency GC 라고도 말합니다.

- N개의 쓰레드를 가지고 지속적인 GC을 하여 stop-the-world를 줄입니다.

- GC 과정

① Inital Mark : 클래스 로더에서 가장 가까운 객체 중 살아 있는 객체만 찾습니다

② Concurrent Mark : 방금 확인한 객체에서 참조하고 있는 객체들을 확인합니다. (다른 쓰레드와 동시에 진행)

③ Remark : Concurrent Mark에서 새로 추가되거나 참조가 끊긴 객체를 확인합니다.

④ Concurrent Sweep : GC가 발생합니다. (다른 쓰레드와 동시에 진행)

- 단점

① 다른 GC방식보다 메모리와 CPU를 더 많이 사용합니다.

② compaction단계가 기본적으로 제공하지 않습니다.

5) G1 GC

- Server Style GC 라고도 말합니다.

- JDK 7 update 4 부터 제공합니다. (JDK 6에서는 early access라고 불리며 시험 사용이 가능했습니다.)

- Memory가 4GB 이상에서 사용하는 것이 좋습니다.

- 바둑판의 각 영역의 객체를 할당하고 GC를 실행합니다. (Heap 영역에 따라 1MB ~ 32MB 사이로 대략 2000개정도로 분할 됩니다.)

- 장점

① 어떤 GC보다 빠릅니다.

JAVA 8 & GC

1) JDK 8 update 20부터는 String 중복제거를 해줍니다. 중복된 문자열을 식별하고 동일한 내부 문자를 가리키도록 수정 할 수 있습니다.

1
-XX : + UseStringDeduplication
cs

2) Permanent Generation (PermGem) 제거 되고 Metaspace라는 새로운 메모리 공간이 생겼습니다.

- 기존 PermSize 및 MaxPermSize 값은 무시됩니다. (MetaspaceSize 및 MaxMetaspaceSize 추가가 됐습니다.)

- 기존의 Perm에 저장되어 문제가 있던 부분(static object가 Heap으로 옮겨져 GC 발생)을 Metaspace로 옮겨 Heap Size가 동적으로 조정되면서 개선되었다고 합니다.

참고

- http://d2.naver.com/helloworld/1329

- http://imp51.tistory.com/entry/G1-GC-Garbage-First-Garbage-Collector-Tuning

GDG WebTech - AMP, PWA

허원철 — Mon, 27 Feb 2017 10:05:21 +0900

GDG WebTech에서 AMP와 PWA 주제로 세미나가 있어 참여하게 되었습니다.

AMP만 보고 참여한 세미나를 참여했지만 PWA에도 흥미가 생겨 끝까지 듣게 되었습니다. 물론 블로그를 보시면 아시겠지만, 내용이 많이 부실합니다. (사전 준비가 안되어 있어....) 그래도 이런 기능이 있구나.. 정도로만 참고하시면 될 것 같습니다. 자세한 내용을 접하고 싶으시다면 아래 첨부한 링크를 보시거나 직접 서치를 해주시면 감사하겠습니다.

AMP

- AMP를 처음 접하게 된건 블로그를 운영하면서 였습니다. 블로그를 하게 되면 방문자를 늘릴 수 있는 방법 중 하나로 검색 엔진에 노출되게끔 하는 것 입니다. 이는 구글이나 네이버 웹마스터도구를 통해 가능합니다. 구글 - 웹마스터도구 메뉴들을 보면 '액셀러레이티드 모바일 페이지(AMP)' 가 있습니다.

그래서 AMP가 무엇인가?

- 간단한게 말씀을 드리자면, 모바일에서 조금 더 최적화된 웹페이지를 구성하는 방법입니다. (물론 데스크탑도 해당 되는 얘기이지만, 모바일에서 조금 더 좋은 효과를 볼 수 있습니다. - 체감상 3~40% 정도 빨라진다고 합니다.)

왜 AMP를 써야하는가?

조은님 曰 : "우리가 쓰는 웹은 빠르지 않습니다. 다만 네트워크가 빠른 것 입니다. 그렇기 때문에 웹을 만들 때, 느리다는 가정 하에 만들어야 합니다."

※ AMP를 사용할 경우, 구글 검색에서 상위 노출되도록 도와줍니다. (구글에 적극적인 지원이 있습니다...)

어떤 이유 때문에 빨라 질 수 있는가?

- 여러가지 이유가 있지만, 몇 가지만 간추려서 적어보겠습니다.

1) 비동기방식 자바스크립만 사용 가능합니다.

1
<script async src="{...}"></script>
cs

2) 작성자가 작성한 자바스크립트 사용 불가능합니다.(amp에서 제공한 스크립트만 가능합니다.)

※ iframe 삽입을 허용하기 때문에 iframe에서 작성한 자바스크립트를 사용할 수 있습니다.

3) CSS를 inline으로 넣는다. (Size : 50kb 제한)

4) 렌더링에 성능 이슈를 주는 CSS는 제한됩니다.

5) preconnect API를 사용하여 페이지를 접근하기 전에 페이지를 미리 로딩됩니다.

간단한 예제를 통해 접해보자

- 세미나에서 진행 했던 걸 예제로 진행하기 위해.. 페이스북에 올라가 있는 프로필 사진으로 명함(?) 웹 페이지를 만들어 보겠습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
<!DOCTYPE html>
<html amp lang="ko">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1">
 
    <link rel="canonical" href="AmpCard.html"/>
    <title>Heo Won Chul - Card</title>
    
    <script async src="https://cdn.ampproject.org/v0.js"></script>
    <style amp-boilerplate>body{-webkit-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-moz-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-ms-animation:-amp-start 8s steps(1,end) 0s 1 normal both;animation:-amp-start 8s steps(1,end) 0s 1 normal both}@-webkit-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-moz-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-ms-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-o-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}</style><noscript><style amp-boilerplate>body{-webkit-animation:none;-moz-animation:none;-ms-animation:none;animation:none}</style></noscript>
    <style amp-custom>
    .card {
        padding : 10px;
    }
    </style>
</head>
<body>    
    <div class='card'>
        <amp-img
            src="https://scontent-icn1-1.xx.fbcdn.net/v/t1.0-1/p240x240/1518040_761651517286777_6537604985669832242_n.jpg?oh=b0fb88831ed414f133487f8d9ed93b35&oe=59355EED"
            width="240"
            height="240"
            layout="responsive">
        </amp-img>
        <dl>
            <dt>Heo Won Chul</dt>
            <dt>heowc1992@gmail.com</dt>
            <dt></dt>
        </dl>
    </div>
</body>
</html>
Colored by Color Scripter
cs

1) <!DOCTYPE html> 이어야 합니다.

2) html 태그에 amp 속성을 넣어줍니다.

3) 메타 태그로 charset=UTF-8을 넣어줍니다.

4) 메타 태그로 viewport 추가를 해줍니다.

5) 검색에서 더 자세하고 정확한 정보를 제공하기 위해 canonical link를 추가합니다.

6) amp에서 제공하는 스크립트를 추가해줍니다.

7) amp에서 제공하는 스타일을 넣어줍니다.

여기까지만 하면 amp에서 권장하는 기본 페이지입니다. (https://www.ampproject.org/)

추가로 이미지를 올리기 위해 img 태그가 아닌 amp-img 태그를 사용합니다. layout="responsive"은 화면 비율에 맞게 알아서 맞춰 주는 속성 입니다. (잔코딩을 줄여줄 속성일 듯 합니다.)

AMP 확인하기

- 로컬에서는 AMP가 브라우저에 적용되있는지 불가능하고 서버를 띄운 후 판단이 가능합니다. 개발자 도구(F12)에서 Console Tab에서 'AMP validation successful' 문구가 뜨면, 제대로 amp가 적용된 것을 알 수 있습니다.

PWA

- 점진적인 개선을 통해 점점 더 앱처럼 되어간다.. 조금 더 네이티브화 되어 간다.. 이런 모토(?)를 가지고 생겨난 기술인 것 같습니다.

GDG WebTech에서 PWA의 주요 기능으로 뽑는 것

1) 푸시 노티피케이션

- 스마트폰 앱처럼 브라우저에서 푸쉬 알림이 가능합니다. 현재 페이스북에서 푸시 알림을 사용하고 있습니다.

2) 서비스 워커

- 자체적인 스코프가 존재하여, 지속적인 백그라운드 처리가 가능합니다. 이는 브라우저의 설치되는 일종의 시스템 요소와 유사하다고 볼 수 있습니다. (https://jakearchibald.github.io/isserviceworkerready/)

- 주요 함수로는 cache, waitUntile, fetch가 있습니다.

※ 서비스가 되는 페이지라면 반드시 https로 사용해야 합니다.

3) 웹 인스터러블

- 웹용 매니페스트를 등록 해주면 앱에서든 데스크탑에서든 다운이 가능합니다. (안드로이드 매니페스트와 용도는 같다고 생각하시면 쉽습니다.)

manifest.json 추가 등록 후, (옵션이 여러가지 있으나.. 진행이 너무 빨라서 다는 못 들었습니다..ㅠㅠ)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
    "name": "heowc-card",
    "short_name": "heowc-card",
    "icons": [
        {
            "src": "https://scontent-icn1-1.xx.fbcdn.net/v/t1.0-1/p240x240/1518040_761651517286777_6537604985669832242_n.jpg?oh=b0fb88831ed414f133487f8d9ed93b35&oe=59355EED",
            "sizes": "240x240",
            "type": "image/png"
        }
    ],
    "start_url": "./?utm_source=web_app_manifest",
    "display": "standalone",
    "orientation": "portrait",
    "background_color": "#FFFFFF",
    "theme_color": "#3F51B5"
}
Colored by Color Scripter
cs

html 에 추가 수정 해주시면 됩니다.

1
2
3
4
5
6
7
8
9
<!DOCTYPE html>
<html amp lang="ko">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1">
 
    <link rel="canonical" href="AmpCard.html"/>
    <link rel="manifest" href="manifest.json"/>
...
Colored by Color Scripter
cs

결과(개발자도구 - Application)

- application tab에서 보면 방금 manifest.json 에서 등록한 정보가 추가되는 것을 볼 수 있습니다. 데스트탑에서는 'add to homescreen'으로 앱을 설치 할 수 있습니다.

참고

- https://github.com/pwa-workshop/namp-card/wiki/%EC%BD%94%EB%93%9C%EB%9E%A9(Codelab)-%EA%B0%80%EC%9D%B4%EB%93%9C-%EB%AC%B8%EC%84%9C

- https://github.com/pwa-workshop/namp-card

- https://www.ampproject.org/ko/docs/get_started/create/basic_markup

ELK Stack 개념 정리

허원철 — Thu, 23 Feb 2017 18:00:40 +0900

이번 글은 ELK Stack에 대해 간단한 개념을 소개하고자 하는 글 입니다.

로그의 중요성

- 데이터의 처리를 디비를 통해 알 수 도 있지만, 조금 더 명확하고 세세한 상황을 보기 위해서는 로그 분석이 필수적입니다.

로그처리를 하다보면 대규모 서비스 경우에는 하루에 수십기가가 넘는 로그가 쌓이는 경우도 있습니다. (물론 직접 경험해보진 못했습니다.) 이런 서비스 같은 경우는 당연히 로드밸런싱을 하게 되고.. 서버도 각각 나뉘어 있으면 로그를 하나하나 다 열어봐야하는 상황이 닥치게 됩니다. 그래서 로그를 한 곳으로 집중시키고 분석하고 적당한 쿼리를 만들어 원하는 데이터를 도출 해낼 수 있는 로그 관리 솔루션이 있는데, 요즘 추세로는 ELK Stack을 사용합니다. (Splunk 라는 것도 있지만 유료라고 하니 넘어가도록 합니다.)

ELK 이란 ?

- 모든 유형의 구조화 및 비정형 데이터에서 실시간으로 실행 가능한 통찰력을 제공하는 End to End Stack을 만들었습니다. 데이터를 검색하고 분석하는데 용이합니다.

E ( Elastic Search )

: 분산형 RESTful 검색 및 분석 엔진 입니다. 데이터를 중심부에 저장하여 예상되는 항목을 검색하고 예상치 못한 항목을 밝혀낼 수 있습니다.

1) 정형, 비정형, 위치정보, 메트릭 등 원하는 방법으로 다양한 유형의 검색을 수행하고 결합할 수 있습니다.

2) 표준 RESTful API와 JSON을 사용합니다.

L ( Logstash )

: 오픈소스 서버측 데이터 처리 파이프라인으로, 다양한 소스에서 동시에 데이터를 수집하고 변환하여 자주 사용하는 Stash 보관소로 보냅니다.

K ( Kibana )

: 데이터를 시각적으로 탐색하고 실시간으로 분석 할 수 있습니다.

ELK Stack 이란?

- ELK 솔루션에서 Beats 추가되면서 ELK Stack 이라고 불립니다.

Beats

: 서버에 에이전트로 설치하여 다양한 유형의 데이터를 Elastic Search 또는 Logstash에 전송하는 오픈 소스 데이터 발송자입니다.

Elastic Search - 개념정리

1) Near Realtime

- 거의 실시간 검색 플랫폼이라는 특징을 가지고 있습니다.

2) Cluster

- 전체 데이터를 함계 보유하고 모든 노드에서 연합 인덱싱 및 검색 기능을 제공하는 하나 이상의 노드모음입니다.

- 기본적으로 'elasticsearch' 라는 고유한 이름으로 식별합니다.

3) Node

- 클러스터의 일부이며 데이터를 저장하고 클러스터의 인덱싱 및 검색 기능에 참여하는 단일 서버입니다.

- 노드에 할당되는 임의 UUID인 이름으로 식별합니다.

- 특정 클러스터를 클러스터 이름으로 결합하도록 노드를 구성 할 수 있습니다.

4) Index

- 다소 유사한 특성을 갖는 문서들의 집합입니다.

- 단일 클러스터에서 원하는만큼의 인덱스를 정의 할 수 있습니다.

5) Type

- Index 내에서 하나 이상의 Type을 정의 할 수 있습니다.

6) Document

- Index를 생성 할 수 있는 기본 정보 단위입니다.

- JSON으로 표현합니다.

7) Shards

- Index는 잠재적으로 단일 노드의 하드웨어 제한을 초과 할 수 있는 많은 양의 데이터를 저장 할 수 있습니다. 하지만 단일 노드의 디스크가 맞지 않거나 단일 노드의 검색 요청만 처리하기에는 너무 느릴 수 있기 때문에 shards를 이용하여 Index를 여러 조각으로 나눌 수 있습니다.

- 수평적으로 콘텐츠 볼륨을 split/scale 가능합니다.

- 여러 노드에서 잠재적으로 분산을 통해 작업을 분산 및 병렬 처리를 할 수 있으므로 성능/처리량이 향상됩니다.

8) Replication

- 장애가 발생할 경우 고가용성을 제공합니다. 그렇기 때문에 복제본 샤드는 복사된 원본/기본 샤드와 동일한 노드에 할당되지 않습니다.

- 모든 복제본에서 검색을 병렬로 실행할 수 있기 때문에 검색 볼륨/처리량을 수평 확장 할 수 있습니다.

- 기본적으로 각 인덱스는 4개의 기본 샤드와 1개의 복제본이 할당됩니다.

Logstash - 개념정리

1) input

- 입력을 사용하여 Logstash에 데이터를 가져옵니다.

- file, syslog(RFC3164 형식), beats(Filebeat)

2) filter

- Logstash 파이프 라인의 중간 처리 장치입니다.

① grok : 구문 분석 및 임의의 텍스트로 구성합니다.

② mutate : 이벤트 필드에서 일반적인 변환을 수행합니다.

③ drop : 이벤트를 삭제합니다.

④ clone : 이벤트의 복사본을 만듭니다.

⑤ geoip : ip 주소의 지리적 위치에 대한 정보를 추가합니다.

3) output

- Logstash 파이프 라인의 최종 단계입니다.

① elasticsearch : 이벤트 데이터를 elasticsearch에 보냅니다.

② file : 디스크 파일에 씁니다.

③ graphite : graphite에 전송합니다. (graphite : 메트릭을 저장하고 그래프로 작성하는데 사용되는 오픈 소스 도구)

④ statsd : 카운터 및 타이머와 같은 통계르 수신하고 UDP를 통해 전송되며, 하나 이상의 플러그 가능한 백엔드 서비스에 집계를 보내는 서비스입니다.

4) codec

- 입력 또는 출력의 일부로 작동 할 수 있는 스트림 필터입니다.

- 인기 코덱에는 json, msgpack, plain이 있습니다.

① json : JSON 형식의 데이터를 인코딩하거나 디코딩합니다.

② multiline : 자바 예외 및 스택 추척 메시지와 같은 여러 줄 텍스트 이벤트를 단일 이벤트로 병합합니다.

Beats - 개념정리

1) FileBeat

- 서버에서 로그파일을 제공합니다.

2) PacketBeat

- 응용 프로그램 서버간에 교환되는 트랜잭션에 대한 정보를 제공하는 네트워크 패킷 분석기 입니다.

3) MetricBeat

- 운영 체제 및 서비스에서 Metrics를 주기적으로 수집하는 서버 모니터링 에이전트입니다.

4) WinlogBeat

- Windows 이벤트 로그를 제공합니다.

ELK Stack의 확장 : X-Pack

- 기존 ELK Stack에서 x-pack을 이용하여 구축 및 유지를 편리하게 해줄 솔루션입니다. (하지만 유료입니다...ㅠ)

1) 특징

① Security : 데이터 보호

② Alerting : 데이터 변경 사항에 대한 알림을 제공합니다.

③ Monitoring : ELK Stack 상태를 지속적으로 체크합니다.

④ Reporting : 주기적으로 보고서를 생성하여 이메일로 전송합니다.

⑤ Graph : 데이터에서 의미 있는 관계를 살필 수 있습니다.

Apache - version 2.4 설치하기

허원철 — Thu, 23 Feb 2017 17:25:28 +0900

이번 글은 Apache 2.4 설치에 대한 내용과 Centos 6.x 와 바뀐 점을 조금씩 언급한 글 입니다.

OS : Centos 7.0

Server : Apache 2.4.25

설치전 준비 사항

- 설치를 돕기 위해 관련 컴파일러를 설치합니다.

1
yum install gcc make gcc-c++
cs

필요한 설치파일 다운로드

1
2
3
4
5
cd /usr/local/src
wget http://ftp.neowiz.com/apache/httpd/httpd-2.4.25.tar.bz2
wget http://ftp.neowiz.com/apache/apr/apr-1.5.2.tar.bz2
wget http://ftp.neowiz.com/apache/apr/apr-util-1.5.4.tar.bz2
wget https://ftp.pcre.org/pub/pcre/pcre-8.33.tar.bz2
cs

※ wget : command not found

- 최소 설치를 하신 분들은 wget이 없으니 따로 설치를 해야 합니다.

1
yum -install wget
cs

압축해제 및 디렉토리 변경

1
2
3
4
5
6
tar xvf apr-1.5.2.tar.bz2
tar xvf apr-util-1.5.4.tar.bz2
tar xvf httpd-2.4.25.tar.bz2
tar xvf pcre-8.33.tar.bz2
mv apr-1.5.2 ./httpd-2.4.25/srclib/apr
mv apr-util-1.5.4 ./httpd-2.4.25/srclib/apr-util
cs

pcre 설치

1
2
3
4
cd /usr/local/src/pcre-8.33
./configure
make
make install
cs

apache 설치

1
2
3
4
cd /usr/local/src/httpd-2.4.20
./configure --prefix=/usr/local/apache2
make
make install
cs

방화벽 해제

centos 7 이전에는 iptable 에서 설정 작업을 했지만,

1
vi /etc/init.d/iptables
cs

centos 7 이후에는 firewalld 에서 설정 작업을 할 수 있습니다.

(이걸 모르고 iptables에 접근했다가 당황했습니다. -input .... 이런 내용이 있어야하는데...)

- 설치 및 시작

1
2
3
yum install firewalld
systemctl start firewalld
systemctl enable firewalld
cs

- http 방화벽 해제

1
2
firewall-cmd --permanent --zone=public --add-service=http
firewall-cmd --permanent --zone=public --add-service=https
cs

- 임의 포트 방화벽 해제

1
firwall-cmd --zone=public --add-port=8080/tcp
cs

- 임의 포트 방화벽 삭제

1
firwall-cmd --zone=public --remove-port=8080/tcp
cs

- 재시작

1
firewall-cmd --reload
cs

실행

1
/usr/local/apache2/bin/httpd -k start
cs

※ service 등록을 따로 해주어야 합니다.

초간단 설치법

yum 업데이트

1
yum -y update
cs

httpd 설치

1
yum -y httpd
cs

※ Centos 7부터는 yum만으로도 2.4 version을 설치 할 수 있는 듯 합니다.

(Centos 6에서 yum을 통해 설치하고 한다면, 다음 링크를 참고하시기 바랍니다. https://www.lesstif.com/pages/viewpage.action?pageId=26084187)

실행

1
systemctl start httpd
cs

※ Centos 7부터는 service ... [start|stop|restart]이 아닌 systemctl로 서비스 시작/정지 할 수 있습니다.

참고

- http://zetawiki.com/wiki/%EB%A6%AC%EB%88%85%EC%8A%A4_%EC%95%84%ED%8C%8C%EC%B9%98_%EC%B5%9C%EC%8B%A0%EB%B2%84%EC%A0%84_%EC%84%A4%EC%B9%98_(%EC%BB%B4%ED%8C%8C%EC%9D%BC)#.EC.95.84.ED.8C.8C.EC.B9.98_.EC.8B.9C.EC.9E.91

Java - Optional API

허원철 — Sun, 19 Feb 2017 15:45:21 +0900

이번 편은 JAVA 8에서 새롭게 등장한 Optional에 대한 간단한 예제 글 입니다.

왜 Optional을 사용해야 하는가...?

- 흔히 개발을 하다보면 null 처리에 대해 정말 난감한 부분이 많습니다. 예를 들면,

1
2
3
4
5
String name = "wonchul";
 
if(name != null && !"".equals(name)) {
    // ...
}
Colored by Color Scripter
cs

위와 같이 조건처리가 꼭 들어가고, default value 가 필요하면 또 적당한 코드 작업이 필요합니다. 물론 유틸 클래스를 만들어서 처리 할 수 있습니다. (Spring에선 StringUtils 클래스를 제공하여 유용하게 쓸 수 있습니다.)

Optional에서는 이런 부분을 람다식 표현을 더해 조금 더 간결하고 가독성을 높일 수 있습니다. 예제는 람다식 표현과 assertj를 이용한 test code이니 참고하시고 보시면 되겠습니다.

Optional 생성

1
2
3
Optional<String> opName = Optional.empty();
Optional<String> opName = Optional.of("wonchul");
Optional<String> opName = Optional.ofNullable("wonchul");
cs

1) null이 들어갑니다.

2) "wonchul" 이라는 문자열을 넣습니다.

3) "wonchul" 이라는 문자열을 넣습니다.( ※ null을 넣어도 가능합니다.)

Optional get

- get() 를 이용해서 제네릭에 표기된 자료형의 값을 가져올 수 있습니다.

1
2
Optional<String> opName = Optional.of("wonchul");
opName.get(); // wonchul
cs

※ 값이 빈 경우 NoSuchElementException이 발생합니다.

Optional isPresent

- isPresent() 를 이용하여 값이 비었는지 알 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
@Test
public void test_isParent() {
//    Optional<String> name = Optional.of("wonchul");
    Optional<String> name = Optional.ofNullable(null);
        
    if(name.isPresent()) {
        assertThat(name).isPresent();
    } else {
        assertThat(name).isNotPresent(); // call
    }
}
Colored by Color Scripter
cs

Optional ifPresent

- ifPresent() 를 이용하여 값이 있을 경우, 원하는 처리를 할 수 있도록 도와줍니다.

1
2
3
4
5
6
@Test
public void test_ifParent() {
    Optional<String> name = Optional.of("wonchul");
    
    name.ifPresent(System.out::println); // wonchul 
}
Colored by Color Scripter
cs

Optional isElse, isElseGet, isElseThrow

- isElseXXX() 를 이용하여 Default 처리를 하거나, exception를 보내버릴 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
@Test
public void test_orElse() {
    Optional<String> name         = Optional.of("wonchul");
    Optional<String> nameNullable = Optional.ofNullable(null);
        
//    ... call defaultValue()
    System.out.println("orElse      => " + name.orElse(defaultValue()));
    System.out.println("orElseGet   => " + name.orElseGet(() -> defaultValue()));
 
//    ... call defaultValue()
    System.out.println("orElse      => " + nameNullable.orElse(defaultValue()));
//    ... call defaultValue()
    System.out.println("orElseGet   => " + nameNullable.orElseGet(() -> defaultValue()));
 
//    System.out.println("orElseThrow => " + name.orElseThrow(NullPointerException::new));
}
    
private String defaultValue() {
    System.out.println("call defaultValue()");
    return "default name : wonchul";
}
Colored by Color Scripter
cs

※ orElse, orElseGet 차이점은 defaultValue() 함수를 무조건 호출 유무에 차이입니다. defaultValue()를 호출하는데 많은 비용이 든다면, orElseGet을 이용하는 것이 더 효율적일 것 입니다.

Example

- 오라클 기사(?)에 있는 예제를 참고한 것 입니다. (참고 : http://www.oracle.com/technetwork/articles/java/java8-optional-2175753.html)

- 다음과 같은 구조에서 version을 가져올 때, 코드 작성을 예로 들어보겠습니다.

1) optional 사용하지 않은 경우

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
private final String getDefaultVersion() {
    return "UNKNOWN";
}
 
@SuppressWarnings("unused")
@Test
public void test_basic() {
    Computer computer = null;
    
    String version = getDefaultVersion();
    if(computer != null) {
        if(computer.getSoundCard() != null) {
            if (computer.getSoundCard().getUsb() != null) {
                version = computer.getSoundCard().getUsb().getVersion();
            }
        }
    }
 
    assertThat(
            version
    ).isEqualTo(getDefaultVersion());
}
Colored by Color Scripter
cs

- 중첩 if문을 사용하지 않아도 되지만, 결론적으로는 if문을 3번 사용하게 되면서 코드가 길어집니다.

2) optional 사용한 경우

1
2
3
4
5
6
7
8
9
10
11
12
@Test
public void test_expansion() {
    Optional<OpComputer> opComputer = Optional.empty();
    
    assertThat(
            opComputer
                .flatMap(OpComputer::getSoundCard)
                .flatMap(OpSoundCard::getUsb)
                .flatMap(OpUsb::getVersion)
                .orElseGet(() -> getDefaultVersion())
    ).isEqualTo(getDefaultVersion());
}
Colored by Color Scripter
cs

- flatMap과 orElseGet를 조합하여 깔끔한 코드를 만들어낼 수 있습니다.

※ JAVA 8부터는 유용한 메소드가 많습니다. ( filter, steam, flatmap, map.. 등등 ) 여러 조합으로 섞어쓰면 기존에 JAVA 8미만에서의 코드보다 가독성이 높은 코드를 만들 수 있습니다.

참고

- http://www.oracle.com/technetwork/articles/java/java8-optional-2175753.html

- Java8OptionalAPI

Spring Boot - Security + JWT

허원철 — Mon, 13 Feb 2017 13:52:05 +0900

이번 편은 spring boot 와 security 조합에서 jwt를 더해 예제를 만들어 보았습니다.

Gradle 설정

1
2
3
4
5
6
7
8
9
dependencies {
    compile('org.springframework.boot:spring-boot-starter-data-jpa')
    compile('org.springframework.boot:spring-boot-starter-security')
    compile('com.auth0:java-jwt:3.1.0')
    compile('org.springframework.boot:spring-boot-starter-web')
    runtime('com.h2database:h2')
    compile('org.projectlombok:lombok')
    testCompile('org.springframework.boot:spring-boot-starter-test')
}
Colored by Color Scripter
cs

spring security에 대략적인 플로우입니다.

기본적인 spring security 과정에서는 필터에서 spring session 정보를 불러와 해당 권한을 가지고 인증을 합니다. 하지만 jwt token방식에서는 session이 필요하지도 않고 사용하지도 않습니다. 오직 token을 이용하여 정보를 가져오고, 인증을 받고 권한을 줍니다.

이런 작업을 위해 별도의 필터를 만들어줍니다. 또한 비동기 통신이 트렌드이기 때문에.. loginProcessing에 대한 필터를 더 만들어서 성공시에 header에 Token을 추가하는 방식으로 진행하려 합니다.

1
2
3
LOGIN_END_POINT    = "/login"   // 로그인 뷰
TOKEN_END_POINT   = "/token"   // 로그인 인증
REFRESH_END_POINT = "/refresh" // 토큰 갱신
cs

Filter

- filter 생성시에는 RequestMatcher 인터페이스를 무조건 받게 되어 있습니다. 여기서 RequestMatcher는 해당 필터에 대한 Url, Method 설정 부분입니다.

- SecurityConfig에서 security에 전반적인 설정을 합니다.

- addFilterBefore()를 이용하여 필터를 추가해줍니다.

[ SecurityConfig.java ]

1
2
3
4
5
6
7
8
9
10
@Override
protected void configure(HttpSecurity http) throws Exception {
    http
        .addFilterBefore(ajaxAuthenticationFilter(), UsernamePasswordAuthenticationFilter.class)
        .addFilterBefore(jwtAuthenticationFilter(), UsernamePasswordAuthenticationFilter.class)
        .csrf().disable()
        .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS)
   
    ....        
}
Colored by Color Scripter
cs

1
2
3
4
5
6
7
8
9
10
11
12
private AntPathRequestMatcher antPathRequestMatcher() {
    return new AntPathRequestMatcher(TOKEN_END_POINT, HttpMethod.POST.name());
}
 
public AjaxAuthenticationFilter ajaxAuthenticationFilter() throws Exception {
    AjaxAuthenticationFilter filter = new AjaxAuthenticationFilter(antPathRequestMatcher(), objectMapper);
    filter.setAuthenticationManager(authenticationManager());
    filter.setAuthenticationSuccessHandler(securityHandler);
    filter.setAuthenticationFailureHandler(securityHandler);
    return filter;
}
 
Colored by Color Scripter
cs

1
2
3
4
5
6
7
8
9
10
private SkipPathRequestMatcher skipPathRequestMatcher() {
    return new SkipPathRequestMatcher(Arrays.asList(LOGIN_END_POINT, TOKEN_END_POINT));
}
 
public JwtAuthenticationFilter jwtAuthenticationFilter() throws Exception {
    JwtAuthenticationFilter filter = new JwtAuthenticationFilter(skipPathRequestMatcher());
    filter.setAuthenticationManager(authenticationManager());
    filter.setAuthenticationFailureHandler(securityHandler);
    return filter;
}
Colored by Color Scripter
cs

AjaxAuthenticationFilter (비동기 로그인 필터)

- 로그인에 대한 필터링는 URL이 LOGIN_END_POINT 이면서 Method가 POST인 request만 가능하게 합니다.(설정 코드 참고..)

- 해당 해당 필터에서 ContentType 이 application/json 인지 여부를 판단합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
//..... 생략
@Override
public Authentication attemptAuthentication(HttpServletRequest request, 
                                            HttpServletResponse response) throws AuthenticationException,
                                                                                IOException,
                                                                                ServletException {
    if(request.getContentType().matches(MediaType.APPLICATION_JSON_VALUE)) {
        Member member = objectMapper.readValue(request.getReader(), Member.class);
        return getAuthenticationManager().authenticate(new AjaxAuthenticationToken(member.getId()));
    } else {
        throw new AccessDeniedException("Don't use content type for " + request.getContentType());
    }
}
//..... 생략
Colored by Color Scripter
cs

JwtAuthenticationFilter (토큰이 필요한 필터)

- Token에 대한 인증이 필요없는 LOGIN_END_POINT와 TOKEN_END_POINT 를 제외할 Custom RequestMatcher를 만들어줍니다.

- OrRequestMatcher를 이용하면 여러개의 RequestMatcher를 필터링 할 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
public class SkipPathRequestMatcher implements RequestMatcher {
 
    private OrRequestMatcher skipRequestMatcher;
    
    public SkipPathRequestMatcher(List<String> skipPathList) {
        if(!skipPathList.isEmpty()) {
            List<RequestMatcher> requestMatcherList = skipPathList.stream()
                                                                    .map(skipPath -> new AntPathRequestMatcher(skipPath))
                                                                    .collect(Collectors.toList());
            skipRequestMatcher = new OrRequestMatcher(requestMatcherList);
        }
    }
    
    @Override
    public boolean matches(HttpServletRequest request) {
        if(skipRequestMatcher.matches(request)) {
            return false;
        } else {
            return true;
        }
    }
}
Colored by Color Scripter
cs

- filter에서는 header에 token 정보가 담아있는지 판별합니다.

1
2
3
4
5
6
7
8
9
10
11
12
@Override
public Authentication attemptAuthentication(HttpServletRequest request,
                                            HttpServletResponse response) throws AuthenticationException,
                                                                                IOException, ServletException {
    String token = request.getHeader(JwtInfo.HEADER_NAME);
    
    if(!StringUtils.isEmpty(token)) {
        return getAuthenticationManager().authenticate(new JwtAuthenticationToken(token));
    } else {
        throw new AccessDeniedException("Not empty Token");
    }
}
Colored by Color Scripter
cs

Provider

- 인증 및 권한 제어를 제공하는 클래스입니다.

- 코드가 거의 흡사하여, JwtAuthenticationProvider만 발췌합니다.

1
2
3
4
5
6
@Override
public Authentication authenticate(Authentication authentication) throws AuthenticationException {
    String token = (String) authentication.getCredentials();
    UserDetailsImpl user = userDetailsService.loadUserByUsername(token);
    return new JwtAuthenticationToken(user.getMember(), user.getAuthorities());
}
Colored by Color Scripter
cs

AjaxAuthenticationProvider

- filter로 부터 받은 cerdentials(로그인 정보)를 userDetailsService에 넘겨줍니다.

- user 정보에 대한 별도의 인증 처리를 추가할 수 있습니다.

JwtAuthenticationProvider

- filter로 부터 받은 cerdentials(token)를 userDetailsService에 넘겨줍니다.

- token 정보에 대한 별도의 인증 처리를 추가할 수 있습니다.

UserDetailsService

- UserDetailsService가 실질직인 인증 처리라고 생각하여, DB 조회 및 token에 대한 유효형 판단을 이 부분에서 처리하였습니다.

AjaxDetailsService

- MemberRepository에서 해당 ID 정보를 가져옵니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
@Component
public class AjaxUserDetailsService implements UserDetailsService {
 
    @Autowired MemberRepository repository;
    
    @Override
    public UserDetailsImpl loadUserByUsername(String username) {
        
        Member user = repository.findOne(username);
        
        if(user == null) {
            throw new UsernameNotFoundException(username + "라는 사용자가 없습니다.");
        }
        
        return new UserDetailsImpl(user, AuthorityUtils.createAuthorityList(user.getRole()));
    }
}
Colored by Color Scripter
cs

JwtDetailsService

- token에 대한 유효형 판단을 합니다.(auth0에서 제공하는 JWT.verify()는 내부적으로 decode(), 알고리즘 검사, 날짜 유효성, claims 검사를 합니다.)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
@Component
public class JwtUserDetailsService implements UserDetailsService {
 
    @Autowired ObjectMapper objectMapper;
    
    @Autowired JwtUtil jwtUtil;
    @Autowired JwtFactory jwtFactory;
    
    @Override
    public UserDetailsImpl loadUserByUsername(String token) {
        System.out.println(token);
        if(!jwtFactory.verifyToken(token)) {
            throw new BadCredentialsException("Not used Token");
        }
        
        JWT jwt = jwtUtil.tokenToJwt(token);
        Member member = getStringToMember(jwt.getClaim("member").asString());
        
        if(member == null) {
            throw new BadCredentialsException("Not used Token");
        }
        
        return new UserDetailsImpl(member, AuthorityUtils.createAuthorityList(member.getRole()));
    }
    
    private Member getStringToMember(String memberStr) {
        try {
            return objectMapper.readValue(memberStr, Member.class);
        } catch (IOException e) {
            return null;
        }
    }
}
Colored by Color Scripter
cs

Handler

- 인증처리가 완료되고, header에 jwt Token을 할당 해주는 처리(successHandler), 로그인 실패 및 토큰 오류(?) 처리(failureHandler)를 합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
@Component
public class BaseSecurityHandler implements AuthenticationSuccessHandler, AuthenticationFailureHandler {
 
    @Autowired JwtFactory JwtFactory;
    
    @Autowired ObjectMapper objectMapper;
    
    @Override
    public void onAuthenticationSuccess(HttpServletRequest request,
                                        HttpServletResponse response,
                                        Authentication authentication) throws IOException, ServletException {
        Member member = (Member)authentication.getPrincipal();
        String jsonToMember = objectMapper.writeValueAsString(member);
        response.setContentType(MediaType.APPLICATION_JSON_UTF8_VALUE);
        response.setHeader(JwtInfo.HEADER_NAME, JwtFactory.createToken(jsonToMember));
    }
    
    @Override
    public void onAuthenticationFailure(HttpServletRequest request,
                                        HttpServletResponse response,
                                        AuthenticationException exception) throws IOException, ServletException {
        throw exception;
    }
}
Colored by Color Scripter
cs

해당 User에 대한 권한 처리

- jwtAuthenticationFilter에 보면 successfulAuthentication(...), unsuccessfulAuthentication(...) 찾아 해볼 수 있습니다. 이 부분은 Filter에 대해 인증 여부에 따라 각각에 메소드를 타게 됩니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// 생략 ....
@Override
protected void successfulAuthentication(HttpServletRequest request,
                                        HttpServletResponse response, 
                                        FilterChain chain,
                                        Authentication authResult) throws IOException, ServletException {
    SecurityContext context = SecurityContextHolder.createEmptyContext();
    context.setAuthentication(authResult);
    SecurityContextHolder.setContext(context);
    chain.doFilter(request, response);
}
 
@Override
protected void unsuccessfulAuthentication(HttpServletRequest request,
                                            HttpServletResponse response,
                                            AuthenticationException failed) throws IOException, ServletException {
    SecurityContextHolder.clearContext();
    getFailureHandler().onAuthenticationFailure(request, response, failed);
}
// 생략 ....
Colored by Color Scripter
cs

- 인증에 성공한 경우 해당 사용자에게 권한을 할당해줍니다. 그러면 Spring Security에서 가능했던 각 Controller에 @PreAuthorize @PostAuthorize를 사용할 수 있습니다.

- SecurityConfig.java에 @EnableGlobalMethodSecurity(prePostEnabled = true) 를 추가해야 합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
@RestController
public class RoleController {
 
    @PostAuthorize("hasAuthority('USER')")
    @GetMapping("/user")
    public String user(Authentication authentication) {
        System.out.println("RoleController : " + authentication.getAuthorities().toString());
        System.out.println("RoleController : " + authentication.getPrincipal());
        return "I'm Jwt Token User!";
    }
    
    @PreAuthorize("hasAuthority('ADMIN')")
    @GetMapping("/admin")
    public String admin(Authentication authentication) {
        System.out.println("RoleController : " + authentication.getAuthorities().toString());
        System.out.println("RoleController : " + authentication.getPrincipal());
        return "I'm Jwt Token Admin!";
    }
}
Colored by Color Scripter
cs

※ @xxxxAuthorize() 사용할 때, Authority를 "ROLE_"를 포함하여 권한을 주었는지 확인합니다. 포함하지 않았다면, hasRole() 를 사용하지 못하므로 hasAuthority를 사용합니다. (이것 말고도 좀 더 많은 설정이 있으니 확인해보시면 좋습니다. 레퍼런스-참고)

토큰 재갱신

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
@RestController
@RequestMapping("/refresh")
public class RefreshController {
    
    @Autowired JwtFactory jwtFactory;
    @Autowired ObjectMapper objectMapper;
    
    @GetMapping
    public ResponseEntity<String> refreshToken(Authentication authentication) {
        System.out.println("refreshToken");
        Member member = (Member)authentication.getPrincipal();
        
        try {
            String token = jwtFactory.refreshToken(objectMapper.writeValueAsString(member));
            
            MultiValueMap<String, String> headers = new LinkedMultiValueMap<>();
            headers.add(JwtInfo.HEADER_NAME, token);
            
            return new ResponseEntity<String>("success refresh token", headers, HttpStatus.OK);
        } catch (JsonProcessingException e) {
            return new ResponseEntity<String>("fail refresh token", HttpStatus.FORBIDDEN);
        }
    }
}
 
Colored by Color Scripter
cs

- RefreshController 또한 Security 필터를 거쳐야만 하기 때문에 별도의 인증 작업이 필요없어(개인적인 판단입니다..) Authentication를 이용하여 갱신된 token을 header에 넣어줍니다.

참고

- 한페이지에 모든 내용을 풀어나가기가 어려우므로, 깃헙소스를 찾고하시기 바랍니다.

- 상당히 많은 부분을 https://github.com/svlada/springboot-security-jwt 이 소스를 참고하였고, 부분적으로 코드를 수정해보았습니다. 제 소스가 안맞으시거나 틀린 부분이 있다면, 해당 깃헙 소스를 참고하시면 되겠습니다. (물론, 저에게도 피드백 주시면 감사하겠습니다.)

- https://github.com/svlada/springboot-security-jwt

- http://heowc.tistory.com/45

- https://github.com/auth0/java-jwt

- 깃헙소스

auth0 JWT 활용하기

허원철 — Sun, 12 Feb 2017 15:58:49 +0900

이번 글은 auth0에서 제공하는 jwt를 활용하는 글입니다.

※ jwt에 대해 모르시거나 이해가 부족하시다면, 간략한 글이지만 이전 포스팅을 읽어보시면 미약하게(?) 도움이 되시리라 생각합니다...(http://heowc.tistory.com/20)

JWT 생성

- 기본적으로는 create(), sign() 메소드만 있으면 됩니다. 그 안에 부가적인 정보를 추가하기 위해 claims를 추가 할 수도 있고 많이 쓰이는 내용은 별개로 추가할 수 있도록 되어 있습니다. (withExpiresAt, withIssuerAt, ... 등등)

1
2
3
4
5
6
7
8
9
10
11
EXPIRES_DATE  = Date.from(EXPIRES_LOCAL.toInstant(ZoneOffset.ofHours(9)));
    
try {
    JWT_TOKEN = JWT.create()
                    .withIssuer("wonchul")
                    .withExpiresAt(EXPIRES_DATE) // 만료일
                    .sign(Algorithm.HMAC256(JWT_SECRECT_KEY));
} catch (JWTCreationException createEx) {
    System.out.println("Create Error");
    createEx.printStackTrace();
}
Colored by Color Scripter
cs

- 생성을 실패한다면, JWTCreationException이 발생합니다.

- sign에서는 다양한 알고리즘을 제공합니다.

JWS	Algorithm	Description
HS256	HMAC256	HMAC with SHA-256
HS384	HMAC384	HMAC with SHA-384
HS512	HMAC512	HMAC with SHA-512
RS256	RSA256	RSASSA-PKCS1-v1_5 with SHA-256
RS384	RSA384	RSASSA-PKCS1-v1_5 with SHA-384
RS512	RSA512	RSASSA-PKCS1-v1_5 with SHA-512
ES256	ECDSA256	ECDSA with curve P-256 and SHA-256
ES384	ECDSA384	ECDSA with curve P-384 and SHA-384
ES512	ECDSA512	ECDSA with curve P-521 and SHA-512

<출처 : https://github.com/auth0/java-jwt >

JWT 변환

- jwt를 변환하는 메소드를 제공합니다.

1
2
3
4
5
6
try {
    JWT.decode(JWT_TOKEN);
} catch (JWTDecodeException decodeEx) {
    System.out.println("Decode Error");
    decodeEx.printStackTrace();
}
Colored by Color Scripter
cs

- 변환이 실패하면, JWTDecodeException이 발생합니다.

- decode()를 하면 JWT객체롤 반환됩니다. JWT객체에서는 생성될 때의 데이터 정보를 획득할 수 있습니다.

JWT 검증

- jwt를 검증할 수 있는 메소드입니다. (내부적으로 decode도 같이 합니다.)

- 날짜, 알고리즘, Claims 검증을 합니다.

1
2
3
4
5
6
7
8
9
10
11
try {
    JWTVerifier verifier = JWT.require(Algorithm.HMAC256(JWT_SECRECT_KEY))
                                .withIssuer("wonchul")
                                .acceptExpiresAt(DAY * 4) // 만료일 -4일
                                .build();
            
    DecodedJWT jwt = verifier.verify(JWT_TOKEN);
} catch (JWTVerificationException verificationEx) {
    System.out.println("Verify Error");
    verificationEx.printStackTrace();
}
Colored by Color Scripter
cs

- 검증이 실패하면(decode가 실패하거나.. 토큰이 만료되었거나.. 등등), JWTVerificationException이 발생합니다.

- decode()와 같이 DecodedJWT 에는 JWT객체가 있으므로, 생성될 때의 데이터 정보를 획득할 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
System.out.println("=================== test_verifyJwtToken ===================");
System.out.println("jwt token         : " + jwt.getToken());
System.out.println("jwt algorithm     : " + jwt.getAlgorithm());
System.out.println("jwt claims        : " + jwt.getClaims());
System.out.println("jwt issuer        : " + jwt.getIssuer());
System.out.println("jwt issuer date   : " + jwt.getIssuedAt());
System.out.println("jwt expires date  : " + jwt.getExpiresAt());
System.out.println("jwt signature     : " + jwt.getSignature());
System.out.println("jwt type          : " + jwt.getType());
System.out.println("jwt key id        : " + jwt.getKeyId());
System.out.println("jwt id            : " + jwt.getId());
System.out.println("jwt subject       : " + jwt.getSubject());
System.out.println("jwt content type  : " + jwt.getContentType());
System.out.println("jwt audience list : " + jwt.getAudience());
cs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
=================== test_verifyJwtToken ===================
jwt token         : eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJ3b25jaHVsIiwiZXhwIjoxNDg2ODI1MjAwfQ.j7xrHVu6t_MSe6xjPsMA9Gd9f2TONX4X6Dc1XjaFm9o
jwt algorithm     : HS256
jwt claims        : {iss=com.auth0.jwt.impl.JsonNodeClaim@145a821d, exp=com.auth0.jwt.impl.JsonNodeClaim@6caa4dc5}
jwt issuer        : wonchul
jwt issuer date   : null
jwt expires date  : Sun Feb 12 00:00:00 KST 2017
jwt signature     : j7xrHVu6t_MSe6xjPsMA9Gd9f2TONX4X6Dc1XjaFm9o
jwt type          : null
jwt key id        : null
jwt id            : null
jwt subject       : null
jwt content type  : null
jwt audience list : null
Colored by Color Scripter
cs

참고

- 이번 글은 spring boot + security + jwt 를 작성하기 전에 간단히 내용 정리 겸 작성한 포스팅입니다.(내용이 많이 부실합니다..) 코드는 깃헙 자료를 보시고 참고 하시면 되겠습니다. (SpringBootSecurityJwt - test)

- https://github.com/auth0/java-jwt

Java - time package(LocalTime, LocalDate, LocalDateTime,...)

허원철 — Tue, 7 Feb 2017 21:42:29 +0900

이번 글은 java 1.8에서 추가된 시간관련 패키지인 time 패키지에 대한 글 입니다.

기존 Date는 Deprecated 되어 권장하지 않습니다. 그 이후로 Calander를 이용하여 많이 작업을 합니다. 하지만 이 또한 자체 메소드로 지원이 적습니다. (Month가 0부터 시작하는.. 불편한 사항도 있었습니다.) 그래서 1.8부터는 time패키지에서 제공하는 LocalTime, LocalDate, LocalDateTime, ZoneDateTime을 이용하여 조금 더 편리하고 확장성 있게 코드를 작성 할 수 있습니다.

사용하면서 좋았던 점은 메소드명으로 쉽게 유추할 수 있는 메소드명들 이였습니다.

현재 시간

1
2
3
LocalTime localTime = LocalTime.now(); // ex) 20:00:00
LocalDate localDate = LocalDate.now(); //  ex) 2017-02-07
LocalDateTime localDateTime = LocalDateTime.now(); // 2017-02-07T20:00:00
cs

일정 값 주입

1
2
3
LocalTime.of(20,0,0) // 20:00:00
LocalDate.of(2017, 2, 7) // 2017-02-07
LocalDateTime( LocalDate.of(2017, 2, 7), LocalTime.of(20,0,0) ) // 2017-02-07T20:00:00
cs

년, 월, 주, 일, 시, 분, 초

1
2
3
4
5
6
7
8
9
10
LocalDateTime localDateTime = LocalDateTime.now()  // 2017-02-07T20:00:00
 
localDateTime.getYear(); // 2017
localDateTime.getDayOfYear() // 38 (년 기준으로 38일째)
localDateTime.getDayOfMonth() // 7 (달 기준으로 7일째)
localDateTime.getDayOfWeek() // TUSEDAY (주 기준으로 화 요일)
localDateTime.getMonth() // FEBRUARY 
localDateTime.getMonthValue() // 2
localDateTime.isLeapYear() // false (윤년 여부)
 
Colored by Color Scripter
cs

변경

- withXxxx( )를 이용하여 부분적으로 값을 변경 가능합니다.

1
2
LocalDateTime localDateTime = LocalDateTime.now(); //  2017-02-07T20:00:00
localDateTime.withYear(2016) // 2016-02-07T20:00:00
cs

더하기, 빼기

- xxxxYears( ), xxxxDays( ), xxxxHours( ), ... 등 으로 연산이 가능합니다.

1
2
3
4
5
LocalDateTime localDateTime = LocalDateTime.now(); //  2017-02-07T20:00:00
 
localDateTime.plusDays(1) //  2017-02-08T20:00:00
localDateTime.minusDays(1) //  2017-02-06T20:00:00
 
Colored by Color Scripter
cs

비교

- isAfter( ), isBefore( ), isEqual( )로 간단하게 비교 가능합니다.

- 앞을 기준으로 합니다.

1
2
3
4
5
LocalDateTime localDateTime = LocalDateTime.now(); //  2017-02-07T20:00:00
LocalDateTime compareDateTime = localDateTime.plusDays(1) //  2017-02-08T20:00:00
 
localDateTime.isBefore(compareDateTime) // true
 
Colored by Color Scripter
cs

Period vs Duration

- Period와 Duration으로 날짜간에 차이값을 구할 수 있습니다.

- Period는 기간(년,월,일)을 구할 때 사용 할 수 있습니다.

- Duration은 Period보다 세세하게 시간, 분, 초 단위까지 가능합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
LocalDate localDate = LocalDateTime.now(); //  2017-02-07
LocalDate compareDate = localDate.plusDays(1) //  2017-02-08
 
// 1.
Period period = localDateTime.until(compareDate)
period.getDays() // 1
 
// 2.
Period period = Period.between(locaDate, compareDate)
period.getDays() // 1
 
 
LocalDateTime localDateTime = LocalDateTime.now() //  2017-02-07T20:00:00
LocalDateTime compareDateTime = localDateTime.plusDays(1) //  2017-02-08T20:00:00
 
Duration duration = Duration.between(localDateTime, compareDateTime)
duration.toMinutes() // -1 * (24 * 60) -> 하루 차이를 분 단위로 표시
cs

Query

- 이 기능은 TemporalQuery<R>을 이용하여 커스텀한 기능을 가능하게 해줍니다. ( FuctionalInterface )

1
2
3
4
5
6
7
8
9
10
11
12
// ex) 2월이라면 참, 아니면 거짓
TemporalQuery<Boolean> query = t -> {
     if(t.get(ChronoField.MONTH_OF_YEAR) == Month.FEBRUARY.getValue()) {
         return true; 
     } else {
          return false;
     }
}
 
LocalDateTime localDateTime = LocalDateTime.now() //  2017-02-07T20:00:00
 
localDateTime.query(query) // true
Colored by Color Scripter
cs

DateTimeFormatter

- 기존에는 형식 클래스인 SimpleDateFormat로 패턴을 변경했지만, DateTimeFormatter로 패턴을 변경할 수 있습니다.

1
2
3
LocalDate localDate = LocalDate.of(2017, 2, 7) // 2017-02-07
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy년 MM월 dd일")
localDate.format(formatter) // 2017년 02월 07년
cs

참고

- 이외에도 TemporalAdjusters 를 이용하여 디테일한 날짜를 가져올 수 도 있습니다.

- 소스는 깃헙에 올려져 있으니 참고 하시면 되겠습니다. (Java8TimeAPI)

- http://blog.eomdev.com/java/2016/04/01/%EC%9E%90%EB%B0%948%EC%9D%98-java.time-%ED%8C%A8%ED%82%A4%EC%A7%80.html

- https://docs.oracle.com/javase/tutorial/datetime/iso/index.html

OpenSSL로 https 사용해 보기

허원철 — Mon, 6 Feb 2017 09:22:11 +0900

이번 편은 Apache에 OpenSSL를 이용하여 https 프로토콜을 사용해보도록 하겠습니다.

HTTP 통신을 하면 도메인의 정보와 그에 대한 데이터가 그대로 노출이 됩니다. 그래서 HTTP 통신의 취약점을 보완하기 위해 주고 받는 모든 메시지를 암호화하여 메시지를 교환합니다. 이런 프로토콜을 HTTPS 이라고 합니다.

HTTPS를 사용하기 위해서는 인증서가 필요한데, 이런 인증서는 사설 인증서, OpenSSL에서 제공하는 인증서가 있습니다. OpenSSL은 내부 어플리케이션이나 테스트 용도로 적당할 것 입니다. (물론 사설 인증서가 훨씬 강력한 보안이 되니 안전하겠죠?)

Apache SSL모듈 사용하기

1) apache에 mod_ssl.so가 있는지 확인합니다.

1
sudo ls /etc/httpd/modules/
cs

※ mod_ssl.so가 없다면 yum명령어로 설치할 수 있습니다.

1
yum -y install mod_ssl
cs

2) httpd.conf에 ssl모듈이 활성화시킵니다.

1
2
3
...
LoadModule ssl_module modules/mod_ssl.so
...
Colored by Color Scripter
cs

OpenSSL Key, CSR, CRT 만들기

- 기본옵션으로 진행하므로, 세부 설정은 따로 참고 바랍니다.

1) Private Key 생성

1
openssl genrsa -out {이름}.key 2048
cs

- RSA 키(2048bit) 암호화(2048bit 권장)

- 비밀번호를 등록한 후, 꼭 기억하시기 바랍니다!!

2) 인증서 서명 파일 생성

1
openssl req -new -key {이름}.key -out {이름}.csr
cs

- 인증서에 대한 정보를 입력합니다.

- common name에 사용하게 될 도메인을 등록합니다.

3) 자가 서명 인증서 생성

1
openssl x509 -req -days 365 -in {이름}.csr -signkey {이름}.key -out {이름}.crt
cs

4) 생성된 key, csr, crt 복사

1
2
3
cp {이름}.crt /etc/pki/tls/certs/
cp {이름}.key /etc/pki/tls/private/
cp {이름}.csr /etc/pki/tls/private/
cs

- /etc/pki/tls 경로에 두어야만 ssl 서비스를 제공이 가능합니다.

※ SELinux에 의해 해당 파일들이 삭제될 수 있습니다. 해당 설정을 내리거나 만약 사용 중에 삭제 되었다면 복원 명령어를 입력합니다.

1
restorecon -RvF /etc/pki
cs

Apache에 SSL 설정하기

1) httpd.conf을 수정합니다.

① 인증서관련 Path 설정

1
2
3
4
...
SSLCertificationFile /etc/pki/tls/certs/{이름}.crt
SSLCertificationKeyFile /etc/pki/tls/certs/{이름}.key
...
Colored by Color Scripter
cs

② NameVirtualHost 변경

1
2
3
...
NameVirtualHost *:443
...
cs

③ Listen 변경

1
2
3
...
Listen 443
...
cs

④ VirtualHost 수정

1
2
3
4
5
6
7
8
9
<VirtualHost *:443>
...
SSLEngine on
SSLCertificationFile /etc/pki/tls/certs/{이름}.crt
SSLCertificationKeyFile /etc/pki/tls/certs/{이름}.key
ServerAdmin {common name}
ServerName {common name}
...
</VirtualHost>
Colored by Color Scripter
cs

2) Apache 재시작

1
service httpd restart
cs

※ 등록해둔 비밀번호를 입력하면 Apache가 실행됩니다.

방화벽 설정

1
vi /etc/sysconfig/iptables
cs

1) 443포트 추가

1
2
3
...
-A INPUT -p tcp -m state --state NEW -m tcp --dport 443
...
Colored by Color Scripter
cs

2) iptable 재시작

1
service iptables restart
cs

Add

- SSL 검증을 위해 아래 사이트에서 테스트 해볼 수 있습니다.

(https://www.ssllabs.com/)

- SSL 취약점 발견으로 SSL을 막도록 합니다(TLS만 제공합니다.)

1
SSLProtocol All -SSLv2 -SSLv3
cs

- RC4를 비활성화 하고, 알고리즘을 변화시킵니다.

1
2
SSLHonorCipherOrder On
SSLCipherSuite ALL:!ADH:!EXP:!LOW:!RC2:!3DES:!SEED:!RC4:+HIGH:+MEDIUM
cs

참고

http://egloos.zum.com/guswl47/v/6514311

https://www.lesstif.com/pages/viewpage.action?pageId=6979614

https://github.com/ssllabs/research/wiki/SSL-and-TLS-Deployment-Best-Practices

Apache - httpd.conf 설정 하기

허원철 — Wed, 1 Feb 2017 16:06:46 +0900

이번글은 Apache Server를 사용할 때, 세부 설정에 대한 글 입니다.

설정 파일 Path

1
vi /etc/httpd/conf/httpd.conf
cs

ServerTokens [OS : default/Prod/Major/Minor/Min/Full]

- Http로 응답할 Header 설정 값입니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
ServerTokens Prod
Server sends (e.g.): Server: Apache
 
ServerTokens Major
Server sends (e.g.): Server: Apache/2
 
ServerTokens Minor
Server sends (e.g.): Server: Apache/2.0
 
ServerTokens Min[imal]
Server sends (e.g.): Server: Apache/2.0.41
 
ServerTokens OS
Server sends (e.g.): Server: Apache/2.0.41 (Unix)
 
ServerTokens Full (or not specified)
Server sends (e.g.): Server: Apache/2.0.41 (Unix) PHP/4.2.2 MyMod/1.2
cs

※ 최소한의 정보를 제공하는 Prod로 설정하는 것이 좋습니다.

Timeout [300 : default]

- 클라이언트 요청에 의해 서버와 연결이 될 때, 서로간에 아무런 메시지가 발생하지 않을 때 연결을 끊는 시간입니다.

※ Rest API 경우에는 낮을 수록, 웹서비스에 경우 높을 수록 좋을 것 같습니다.

KeepAlive [On : default / Off]

- Apache의 한 프로세스가 사용자의 지속적인 요청작업을 계속 처리할 것인지 대한 여부입니다.

※ 현재는 모르겠으나, 어느 블로거분의 말씀에 의하면 Off를 하게되면 시간이 지나도 안 끊기고 계속 살아 있다고 합니다. 그래서 On 을 두고 KeepAliveTimeout을 이용해 적절히 조절하는 것이 좋을 것 같습니다.

KeepAliveTimeout [5 : default]

- KeepAlive가 On인 경우 유효한 값으로, 설정 시간(초)동안 요청이 없으면 타임아웃 시킵니다.

※ 낮을수록 동시접속 수를 늘릴 수 있습니다.

MaxKeepAliveRequests [100 : default]

- KeepAlive가 On인 경우 유효한 값으로, 하나의 프로세스가 방문자들의 요청을 처리할 횟수를 지정합니다.

※ 0으로 설정하면 무제한 요청이 허용됩니다. 서버 성능을 최대화하려면 설정값을 높은 값으로 유지하는 것이 좋습니다.

MPM 방식

prefork [default]

- Process : Thread = 1 : 1

- 안정적이다.

- 메모리를 독립적으로 사용

StartServers 8

MinSpareServers 5

MaxSpareServers 20

ServerLimit 256

MaxClients 256

MaxRequestsPerChild 4000

</IfModule>

worker

- Process : Thread = 1 : n

- 동시접속 수가 많은 곳에 적합

- 메모리를 공유하며 사용

StartServers 4

MaxClients 300

MinSpareThreads 25

MaxSpareThreads 75

ThreadPerChild 25

MaxRequestsPerChild 0

</IfModule>

ExtendedStatus [Off : default / On]

- Apache의 상태를 모니터링 할 때, 자세한 상태정보 기능을 제공할 것 인지에 대한 설정입니다.

※ server-status에 영향을 줍니다.

User [apache : default]

Group [apache : default]

- Apache 자식 프로세스들의 실행소유자와 소유그룹을 설정하는 값입니다.

※ 보안을 위해 nobody로 설정합니다.

ServerName [www.example.com : default]

- 클라이언트에게 보여줄 호스트이름을 지정합니다.

※ 도메인이 없다면 IP주소라도 꼭 적어야 한다.

ServerName을 지정하지 않으면 서버는 먼저 운영 체제에 시스템 호스트 이름을 요청하여 실패한 경우, 시스템에있는 IP 주소에 대해 역 조회를 수행하여 클라이언트가 볼 수있는 호스트 이름을 추론합니다.

ServerName에 지정된 포트가 없으면 서버는 들어오는 요청의 포트를 사용합니다. 최적의 신뢰성과 예측 가능성을 위해서는 ServerName 지시문을 사용하여 명시 적 호스트 이름과 포트를 지정해야합니다.

UseCanonicalName [Off : default / On]

On : 지정한 ServerName 를 사용합니다

Off : 호스트네임과 포트를 사용합니다.

<Directory> ~ </Directory>

- Options [None/All/Indexes/Includes/IncludesNOEXEC/FollowSymlinks/ExecCGI/MultiViews]

- AllowOverride [None/All/AuthConfig/FileInfo/Indexes/Options/Limit]

- Order [allow || deny]

- [allow || deny] from [도메인 네임/호스트 이름 주소/호스트 IP 주소/IP 주소의 앞부분 3byte/all]

HostnameLookups [Off : default / No]

- access_log에 기록되는 설정 값입니다.

On일 경우, IP주소에 대하여 DNS에 질의하여 해당 IP주소에 대한 도메인 정보를 가져옵니다.

Off일 경우, IP주소만 기록합니다.

※ DNS질의로 인한 트래픽이 발생하기 때문에 Off로 설정합니다.

EnableMMAP [On : default / Off]

- 메모리매핑을 지원한다면, Apache가 웹문서를 로딩하기 위해 내부문서를 읽을 때 파일을 메모리 매핑하여 처리합니다.

※ 아파치의 성능이 크게 향상될 수 있으나, 안정성을 해치기도 하고 여러 이슈가 있어 Off를 하는 것이 좋습니다.

EnableSendfile [On : default / Off]

- sendfile을 지원한다면, 정적 파일을 서비스하는 경우 전송할 파일을 직접 읽지 않고 가능합니다.

※ 안정성을 해치므로 Off로 하는 것이 좋습니다.

BrowserMatch {browser} {option}

- 특정 브라우저들에 대한 특정 수행을 지시하기 위한 설정입니다.

NameVirtualHost [*:80]

- 이름기반 가상 호스트를 사용하겠다는 설정입니다.

※ mod_ssl을 이용한 SSL 사용 시, 포트를 443으로 수정해야 합니다.

<VirtualHost *:80> ~ </VirtualHost>

- ServerAdmin : 해당 가상호스트의 관리자 이메일 주소

- DocumentRoot : 해당 가상호스트의 홈페이지디렉토리 위치

- ServerName : 해당 가상호스트의 도메인명

- ErrorLog : 해당 가상호스트의 웹에러로그 파일 위치

- CustomLog : 해당 가상호스트의 웹로그파일 위치

참고

http://httpd.apache.org/docs/2.4/mod/

http://httpd.apache.org/docs/2.2/mod/

http://webdir.tistory.com/178

Spring Boot - QueryDSL

허원철 — Wed, 25 Jan 2017 23:51:31 +0900

이번 글은 Spring Boot에서 QueryDSL를 사용한 예제에 대한 글입니다.

우리나라에서는 흔히 사용하는 ORM은 ibatis, mybatis라고 볼 수 있습니다. 외국에서는 옛날부터 JPA를 주로 사용합니다. 그런데 요즘 우리나라에서도 (Spring Boot에서 jpa 연동이 간단해서 그런가..?) 예전보다 사용율이 높아진 것 같습니다.

<출처 : http://www.slideshare.net/ZeroTurnaround/java-tools-and-technologies-landscape-for-2014-image-gallery >

JPA만으로는 제한적인 것들이 많아서 JPA Criteria나 QueryDSL를 사용하여 디테일한 표현을 가능하게 합니다. 몇 달 전에 아주아주 간단하게 JPA를 접해봤습니다(너무 미흡한 점이 많았습니다. 깊이 반성합니다..ㅠ). 그래서 이번에는 QueryDSL를 이용한 예제를 하나씩 살펴보려 합니다.

QueryDSL은 jpa를 쉽게 쓰기 위한 라이브러리로, 도메인 객체가 Q도메인 형태로 만들어지는데 이를 이용하여 보다 편하게 쿼리를 작성할 수 있게 도와줍니다. 물론, 객체간의 관계 설정은 확실하게 해주어야 합니다. 또한, Q도메인 클래스를 생성하기 위한 설정도 필요합니다. (레퍼런스 문서에서는 maven으로만 설명이 되어 있어, 다른 블로거님의 설정을 참고 했습니다.)

※ QueryDSL은 한글 레퍼런스 문서가 존재하므로, 쉽게 보실 수 있습니다. 다만 업데이트가 조금 느려서 영문과 다를 수 있습니다.

Spring Boot Version : 1.4.3.RELEASE

Hibernate Version : 5.0.11.Final

QueryDSL Version : 4.1.4

- BASE DATA

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
Grade firstGrade = new Grade("일학년");
Grade secondGrade = new Grade("이학년");
Grade thirdGrade = new Grade("삼학년");
 
Student wonchul = new Student("wonchul", 173.8);
Student naeun = new Student("naeun", 165.2);
Student tistory = new Student("tistory", 160.0);
 
firstGrade.getStudents().add(wonchul);
secondGrade.getStudents().add(naeun);
thirdGrade.getStudents().add(tistory);
 
gradeRepository.save(firstGrade);
gradeRepository.save(secondGrade);
gradeRepository.save(thirdGrade);
 
studentRepository.save(wonchul);
studentRepository.save(naeun);
studentRepository.save(tistory);
 
entityManager.flush();
cs

1. 기본

1
SELECT * FROM STUDENT WHERE STUDENT_NAME = 'wonchul'
cs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
1.
@Override
public Predicate equalName(String name) {
    Path<Student> path            = Expressions.path(Student.class, "student");
    Path<String>  studentName    = Expressions.path(String.class, path, "name");
    Expression<String> equalName= Expressions.constant(name);
    return Expressions.predicate(Ops.EQ, studentName, equalName);
}
 
studentRepository.findStudentByName("wonchul")
                            .forEach(System.out::println);
 
2.
@Override
public List<Student> findStudentByName(String name) {
    QStudent student = QStudent.student;
    return queryFactory
            .selectFrom(student)
            .where(student.name.eq(name))
            .fetch();
}
 
studentRepository.findAll(studentRepository.equalName("wonchul"))
                            .forEach(System.out::println);
 
3.
@Override
public List<Student> findStudentByNameExtension(String name) {
    PathBuilder<Student> studentPath = new PathBuilder<>(Student.class, "student");
    
    return queryFactory.selectFrom(studentPath)
            .where(studentPath.get("name").eq(name))
            .fetch();
}
 
studentRepository.findStudentByNameExtension("wonchul")
                            .forEach(System.out::println);
Colored by Color Scripter
cs

1) 가장 간단하게 사용할 수 있는 방법입니다.

2) Q클래스를 못 만드는 경우, Predicate를 만들어서 사용할 수 있는 방법입니다.

3) 2)과 동일하게 Q클래스를 못 만드는 경우, 쿼리를 작성 방법입니다.

2. 조건절

1
SELECT * FROM STUDENT WHERE STUDENT_GRADE = 1 AND STUDENT_HEIGHT >= 165
cs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
@Override
public List<Student> findStudentByNameAndHeight(String name, Double height) {
    QStudent student = QStudent.student;
    
    BooleanBuilder builder = new BooleanBuilder();
    builder.and(student.name.eq(name));
    builder.and(student.height.goe(height));
 
1.    
    return queryFactory
            .selectFrom(student)
            .where(builder)
            .fetch();
 
2.
    return queryFactory
            .selectFrom(student)
            .where(student.name.eq(name), student.height.goe(height))
            .fetch();
 
3.
    return queryFactory
            .selectFrom(student)
            .where(student.name.eq(name).and(student.height.goe(height)))
            
Colored by Color Scripter
cs

1) 동적으로 조건절을 추가하고 싶은 경우 사용하는 방법입니다.

2) 3) 동일한 방법이나 3)이 보기에 더 명확하지 않을까 싶습니다.

3. 정렬

1
SELECT * FROM STUDENT ORDER BY STUDENT_NAME
cs

1
2
3
4
5
6
7
8
@Override
public List<Student> findStudentOrderByName() {
    QStudent student = QStudent.student;
    return queryFactory
            .selectFrom(student)
            .orderBy(student.name.asc())
            .fetch();
}
Colored by Color Scripter
cs

- asc(), desc() 등을 추가할 수 있습니다.

4. 그룹

1
2
3
4
5
SELECT       GRADE.GRADE_NUM
FROM         GRADE
INNER JOIN   STUDENT
ON           GRADE.GRADE_NUM = STUDENT.GRADE_NUM
GROOUP BY    GRADE.GRADE_NUM
cs

1
2
3
4
5
6
7
8
9
10
11
@Override
public List<Integer> findStudentGroupingByGradeNum() {
    QStudent student = QStudent.student;
    QGrade grade = QGrade.grade;
    return queryFactory
            .select(grade.gradeNum)
            .from(grade)
            .join(grade.students, student)
            .groupBy(grade.gradeNum)
            .fetch();
}
Colored by Color Scripter
cs

- Group에 넣고 싶은 컬럼을 나열합니다.

- 별개로, 별개의 컬림을 보이고 싶다면 select(보이고 싶은 컬럼, ...) 사용 가능 합니다.

5. CASE

1
2
3
4
5
6
7
8
9
10
SELECT      CASE
            WHEN GRADE0_.GRADE_NUM>? THEN '고학년'
            ELSE '저학년'
            END,
            STUDENT.STUDENT_ID,
            STUDENT.STUDENT_NAME,
            STUDENT.STUDENT_HEIGHT
FROM        GRADE
INNER JOIN  STUDENT
ON          GRADE.GRADE_NUM=STUDENT.GRADE_NUM
cs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
@Override
public List<Tuple> findCaseStudentAll_Tuple() {
    QStudent student = QStudent.student;
    QGrade grade = QGrade.grade;
    Expression<String> cases = new CaseBuilder()
            .when(grade.gradeNum.gt(3)).then("고학년")
            .otherwise("저학년");
 
        return queryFactory
            .select(cases, student.id, student.name, student.height)
            .from(grade)
            .join(grade.students, student)
            .fetch();
}
Colored by Color Scripter
cs

- CaseBuilder로 case를 작성 할 수 있습니다.

- Tuple를 이용해서 도메인이 아닌 컬럼들을 뽑을 수 있습니다. 또한 Projections를 이용해서도 가능 합니다.

6. 조인

1
2
3
4
5
SELECT        GRADE.GRADE_NUM, GRADE.GRADE_NAME
FROM          GRADE
INNER JOIN    STUDENT
ON            GRADE.GRADE_NUM=STUDENT.GRADE_NUM
WHERE         STUDENT.STUDENT_NAME="wonchul"
cs

1
2
3
4
5
6
7
8
9
10
11
@Override
public List<Grade> findGradeJoinNameOfStudent(String name) {
    QGrade grade = QGrade.grade;
    QStudent student = QStudent.student;
 
    return queryFactory
            .selectFrom(grade)
            .join(grade.students, student)
            .where(student.name.eq(name))
            .fetch();
}
Colored by Color Scripter
cs

- join, leftJoin, rightJoin 등을 사용할 수 있습니다.

- from절에 엔티티를 나열하게되면 cross join이 됩니다.

7. 서브쿼리

1
2
3
4
5
6
7
SELECT  GRADE.GRADE_NUM, GRADE.GRADE_NAME
FROM     GRADE
WHERE     GRADE.GRADE_NUM=(SELECT        GRADE1_.GRADE_NUM
                         FROM         GRADE GRADE1_
                         INNER JOIN STUDENT
                         ON         GRADE1_.GRADE_NUM=STUDENT.GRADE_NUM
                         WHERE         STUDENT.STUDENT_NAME='wonchul')
cs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
@Override
public List<Grade> findGradeSubQueryNameOfStudent(String name) {
    QGrade grade = QGrade.grade;
    QStudent student = QStudent.student;
    return queryFactory
            .selectFrom(grade)
            .where(grade.gradeNum.eq(queryFactory
                                    .select(grade.gradeNum)
                                    .from(grade)
                                    .join(grade.students, student)
                                    .where(student.name.eq(name)))
            )
            .fetch();
}
Colored by Color Scripter
cs

8. DELETE

1
2
3
DELETE 
FROM  GRADE
WHERE GRADE_NUM = 3
cs

1
2
3
4
5
6
7
8
9
10
11
12
@Override
public Long deleteByNum(Integer num) {
    QGrade grade = QGrade.grade;
    return queryFactory
            .delete(grade)
            .where(grade.gradeNum.eq(num))
            .execute();
}
 
...
 
gradeRepository.deleteByNum(3)
cs

9. UPDATE

1
2
3
UPDATE GRADE
SET    GRADE_NAME = "<1>학년"
WHERE  GRADE_NUM  = 1
cs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
@Override
public Long setFixedNameByNum(Grade grade) {
    QGrade _grade = QGrade.grade;
    
    return queryFactory
            .update(_grade)
            .where(_grade.gradeNum.eq(grade.getGradeNum()))
            .set(_grade.gradeName, grade.getGradeName())
            .execute();
}
 
...
 
gradeRepository.setFixedNameByNum(new Grade(1, "<1>학년"));
cs

참고

Querydsl 레퍼런스

Gitbub 예제

Spring Boot - jar로 Deploy(배포)하기

허원철 — Thu, 19 Jan 2017 16:27:32 +0900

Spring Boot를 jar로 배포하면서 생긴 이슈들을 공유하기 위한 글입니다.

Apache와 Tomcat 조합에서는 Tomcat에서 정의한 위치에 war를 올려 사용했습니다. 하지만 Spring Boot에서는 기존 방식과 달리 jar파일로 배포가 가능하다는 것입니다. (기본적으로 Tomcat이 내장되어 있고, Jetty나 Undertow로 대체할 수 있습니다.)

Server : Centos v6.5

1 . properties(yaml) 구분하기

2 . service 구성

1 . properties(yaml) 구분하기

- Spring Boot로 프로젝트를 구성하게 되면, 리소스폴더에 application.properties 가 생성 되는데, 어지간한 설정은 다 할 수 있습니다. (톰캣, DB 등등..) 그리고 구분이 필요한 프로퍼티는 아래와 같이 추가할 수있습니다.

1
application-{custom}.properties
cs

만약 로컬(개발) 설정과 서버 설정이 다르고 로컬에서는 실서버를 바로 볼 수 없는 상황이라고 생각해봅니다. 그리고 Spring Boot에서 jar를 만들 때 서버를 바라보게 하고 빌드를 하게 되면 빌드 과정에서 Exception를 내뿜으면서 실패하고 맙니다. 그래서 환경에 따라 설정을 달리하기 위해 profile을 이용하여 대처할 수 있습니다.

1) 로컬환경과 서버환경이 다를 경우, 각각의 프로퍼티 추가

1
2
application-local.properties
application-server.properties
cs

2) application.properties에 초기 설정을 추가

1
spring.profiles.active=local
cs

3) 실행

1
java -Dspring.profiles.active=server -jar myApp.jar
cs

2 . service 구성

- Putty로 java -jar myApp.jar 로 실행하고 Putty를 내리게 되면 jar 역시 꺼지게 됩니다. 그래서 service에 등록하여 손쉽게 끄고 킬 수 있게 할 수 있습니다. Centos 7 이상에서는 Spring Guide를 보시면 systemd를 이용하여, 각각 설정과 service를 손쉽게 등록 할 수 있습니다.(공식 가이드)

하지만!! Centos 7 미만에서는 지원을 하지 않아, 직접 service에 등록하여 사용할 수 있습니다. (다른 더 좋은 방법이 있을 수도 있으니.. 이런 방법도 있다라는 것을 참고만 하셔도 될 것 같습니다.)

1) 서비스 등록

1
sudo vi /etc/init.d/myApp
cs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
#!/bin/sh
SERVICE_NAME=myApp
PATH_TO_JAR=/usr/local/myApp.jar
PID_PATH_NAME=/tmp/myApp-pid
JAVA_OPTS="-server -Dspring.profiles.active=server"
case $1 in
    start)
        echo "Starting $SERVICE_NAME ..."
        if [ ! -f $PID_PATH_NAME ]; then
            nohup java $JAVA_OPTS -jar $PATH_TO_JAR /tmp 2>> /dev/null >> /dev/null &
                        echo $! > $PID_PATH_NAME
            echo "$SERVICE_NAME started ..."
        else
            echo "$SERVICE_NAME is already running ..."
        fi
    ;;
    stop)
        if [ -f $PID_PATH_NAME ]; then
            PID=$(cat $PID_PATH_NAME);
            echo "$SERVICE_NAME stoping ..."
            kill $PID;
            echo "$SERVICE_NAME stopped ..."
            rm $PID_PATH_NAME
        else
            echo "$SERVICE_NAME is not running ..."
        fi
    ;;
    restart)
        if [ -f $PID_PATH_NAME ]; then
            PID=$(cat $PID_PATH_NAME);
            echo "$SERVICE_NAME stopping ...";
            kill $PID;
            echo "$SERVICE_NAME stopped ...";
            rm $PID_PATH_NAME
            echo "$SERVICE_NAME starting ..."
            nohup java $JAVA_OPTS -jar $PATH_TO_JAR /tmp 2>> /dev/null >> /dev/null &
                        echo $! > $PID_PATH_NAME
            echo "$SERVICE_NAME started ..."
        else
            echo "$SERVICE_NAME is not running ..."
        fi
    ;;
esac
Colored by Color Scripter
cs

2) 권한 설정

1
sudo chmod +x /etc/init.d/myApp
cs

3) 실행/중지/재시작

1
2
3
sudo service myApp start
sudo service myApp stop
sudo service myApp restart
cs

Spring Boot - Apache proxy를 이용한 로드밸런싱

허원철 — Tue, 17 Jan 2017 19:13:01 +0900

이번 글은 Apache 설치와 로드밸런싱을 하여 Spring Boot를 올려 보도록 하겠습니다.

Apache 를 선택한 이유

- 요즘은 apache가 지는 태양이라고 한다면 nginx라는게 뜨는 태양이라고 할 수 있습니다. 서버 동작 차이라고하는데.. 아직은 nginx를 알지도 못하고 Apache가 친숙하지 않기 때문에 Apache를 선택했습니다. (추후에 nginx도 공부하는 걸로...)

로드밸런싱을 하게된 이유

- WAS를 KT 클라우드에 올리게 되어 8 core X 8 G 사양을 선택하게 되었습니다. 과부하를 줄이기 위해 튜닝쪽 구글링을 하다가 로드밸런싱을 하는 것이 좋을 것 같다고 판단되어 Apache에서 모듈을 이용해 로드밸런싱을 해보려고 합니다.

- 톰캣 인스턴스당 2~3GB 정도의 Heap Szie만을 갖길 권장합니다. 왜냐하면 JAVA에서는 메모리가 자동적으로 내려가는 GC가 발생하는데, GC가 발생하는 동안 응답이 지연되는 현상이 일어납니다. Heap Size가 클수록 GC를 해야할 범위가 늘어나 Heap Size를 작게 하는 것이 좋다고 합니다. 또한 Heap Size를 높게 잡아도 실질적으로는 2~3G 정도 밖에 사용하지 못한다고 합니다.

Apache 설치

OS : Centos 6.5

Apache Version : v2.2.15

- v2.4.+ 버전이 나와있는 시점인데도 불구하고 v2.2 버전을 설치하는 이유는.. OpenSSL Update와 v2.4에서는 별도의 유틸이 필요하다보니 구성이 너무 어렵다고 판단하여(몇일 삽질... 했습니다.) yum으로 빠르게 설치할 수 있는 v2.2 를 선택했습니다.

1) httpd 설치 확인

- 최소 설치를 한 경우에는 httpd가 설치 안되어 있으므로, 일단 확인해 봅니다. (Available Packages 라고 나와있으면 미설치)

1
2
rpm -qa httpd
yum list httpd
cs

2) Apache 설치

1
yum install httpd
cs

3) 방화벽 해제

① iptables 편집

1
vi /etc/sysconfig/iptables
cs

② 80포트를 Open

[ iptables ]

1
-A INPUT -m state --state NEW -m tcp -p tcp --dport 80 -j ACCEPT
cs

③ iptables 재실행

1
service iptables restart
cs

4) Apache 실행

1
service httpd start
cs

<기본 테스트 페이지>

※ OpenSSL version is too old 에러가 나는 경우에는 Version Update 를 해달라는 메시지입니다.

- ftp://ftp.openssl.org/source/ 에서 새로운 버전 설치 (1.1.0 이후 버전은 다른 작업이 필요한 듯 합니다. 일단은 1.0.2+ 설치 합니다.)

1) 압축 풀기

1
2
cd /usr/local/src
tar -xzvf openssl-1.0.2j.tar.gz
cs

2) 실행

1
2
3
4
cd ./openssl-1.0.2j
./config
make
mak install
cs

3) 버전 및 기존 위치 확인

- 대부분 /usr/bin/openssl 에 위치

1
2
openssl version
which openssl
cs

4) openssl 백업

1
mv /usr/bin/openssl /root/
cs

5) 설치한 openssl 적용

1
ln -s /usr/local/ssl/bin/openssl /usr/bin/openssl
cs

※ C / C++ Compiler 필요할 경우

1
yum groupinstall 'Development Tools'
cs

mod_jk를 이용한 tomcat 연동

1) tomcat-connectors 설치

1
2
cd /usr/local/src
wget http://www.apache.org/dist/tomcat/tomcat-connectors/jk/tomcat-connectors-1.2.42-src.tar.gz
cs

2) native 디렉토리로 이동

1
cd  tomcat-connectors-1.2.42-src/native
cs

3) 실행

1
2
3
./configure --with-apxs={apxs path}
make
make install
cs

※ apxs path 확인

① 경로를 모르는 경우

1
find / -name apxs
cs

② 없는 경우

1
yum install httpd-devel
cs

4) httpd.conf 수정

1
2
cd /etc/httpd/conf
vi httpd.conf
cs

[ httpd.conf ]

- 맨 아래 추가

1
2
3
4
... 
LoadModule jk_module modules/mod_jk.so
include conf/mod_jk.conf
include conf/http_vhost.conf
cs

5) mod_jk.conf 추가

1
vi mod_jk.conf
cs

[ mod_jk.conf ]

1
2
3
4
5
<IfModule mod_jk.c>
 JkWorkersFile conf/workers.properties
 JkLogFile     logs/mod_jk.log
 JkLogLevel    info
</IfModule>
cs

6) workers.properties 추가

1
vi workers.properties
cs

[ workers.properties ]

1
2
3
4
5
6
worker.list=worker1
 
worker.worker1.port=18009
worker.worker1.host=127.0.0.1
worker.worker1.type=ajp13
worker.worker1.lbfactor=1
cs

6) http_vhost.conf 추가

1
vi http_vhost.conf
cs

[ http_vhost.conf ]

1
2
3
4
5
6
7
<VirtualHost *:80>
 SerberAdmin webmaster@localhost
 ServerName  localhost
 ServerAlias localhost
 
 JkMount /* worker1
</VirtualHost>
cs

mod_jk를 이용한 로드 밸런싱

1) worker.properties 수정

1
vi workers.properties
cs

[ worker.properties ]

1
2
3
4
5
6
7
8
9
10
11
12
13
14
worker.list=worker1,worker2,load_balance
 
worker.worker1.port=18009
worker.worker1.host=127.0.0.1
worker.worker1.type=ajp13
worker.worker1.lbfactor=1
 
worker.worker2.port=28009
worker.worker2.host=127.0.0.1
worker.worker2.type=ajp13
worker.worker2.lbfactor=1
 
worker.load_balance.type=lb
worker.load_balance.balanced_workers=worker1,worker2
cs

2) http_vhost.conf 수정

1
vi http_vhost.conf
cs

[ http_vhost.conf ]

1
2
3
4
5
6
7
<VirtualHost *:80>
 SerberAdmin webmaster@localhost
 ServerName  localhost
 ServerAlias localhost
 
 JkMount /* load_balance
</VirtualHost>
cs

mod_proxy를 이용한 톰캣 연동

1) httpd.conf 수정

1
2
cd /etc/httpd/conf
vi httpd.conf
cs

[ httpd.conf ]

1
2
3
4
5
6
...
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
LoadModule proxy_http_module modules/mod_proxy_http.so
...
include conf/mod_proxy.conf
Colored by Color Scripter
cs

5) mod_proxy.conf 추가

1
vi mod_proxy.conf
cs

[ mod_proxy.conf ]

1
2
3
4
5
6
7
8
9
ProxyPass / http://127.0.0.1:8080/
ProxyPassPassReverse / http://127.0.0.1:8080/
 
ProxyRequests On
 
<Proxy *>
  Order deny, allow
  Allow from all
</Proxy>
Colored by Color Scripter
cs

※ ProxyPass, ProxyPassReverse 에 / ...../ 꼭 넣어줘야 합니다. (삽질의 원인...)

mod_proxy를 이용한 로드 밸런싱

1) mod_proxy.conf 수정

1
vi mod_proxy.conf
cs

[ mod_proxy.conf ]

1
2
3
4
5
6
7
8
9
10
ProxyRequests On
ProxyPreserveHost On
 
<Proxy balancer://mycluster>
  BalancerMember http://127.0.0.1:8080
  BalancerMember http://127.0.0.1:8081
</Proxy>
 
ProxyPass / balancer://mycluster/
ProxyPassReverse / balancer://mycluster/
cs

※ ProxyPass, ProxyPassReverse 에 / ...../ 꼭 넣어줘야 합니다. (삽질의 원인...)

Spring Boot 실행

1
2
java -server -Dserver.port=8080 -jar test.jar
java -server -Dserver.port=8081 -jar test2.jar
cs