로컬에서 Llamafile 돌려보기

소개

llamafile은 하나의 파일로 로컬환경에서 텍스트 생성형 AI-Llama를 쉽게 돌릴 수 있는 툴이다.

• 공식 홈페이지 : https://github.com/Mozilla-Ocho/llamafile

현재 실행파일내에 embed헝태로 지원하는 모델은 3개이다

1. Mistral-7B-Instruct : 텍스트 생성 AI
2. LLaVA 1.5 : 이미지 인식 텍스트 생성형 AI
3. WizardCoder-Python-13B : 파이썬 코딩 특화 LLM

현재 *nix, mac, windows모두 지원한다. (하지만 윈도우즈에서는 실행파일 크기가 4G가 넘으면 실행이 불가한 문제로 모델파일을 따로 다운로드 하고 인수로 넘겨서 실행해야 한다)

테스트 환경

• CPU : Intel i5 6600
• Memory : 32G
• GPU : 사용하지 않음

제약사항

1. 메모리가 최소 런타임 파일 사이즈 만큼 필요. 예를 들어 Mistral-7B-Instruct의 경우 사이즈가 4G이므로 메모리를 4G이상 사용한다.
2. GPU를 사용하지 않을 경우 CPU 사용량이 엄청 높다(응답 생성시 100%사용, 아이들링시에도 35% 정도 사용). 그래서 GPU가 필수일 듯

테스트

• 초기화면에서 옵션을 설정할 수 있다.

• 한글도 잘 된다. 하지만 중간에 응답이 끊겼다

결론

시스템 리소스를 너무 많이 써서 실사용이 힘들다. GPU가 있는 고사양 장비를 가지고 있는 분들은 시도해볼만 하겠다. 그래서 나는 그냥 ChatGTP를 계속 쓰기로…

얼굴인식 오픈소스 간단 비교 OpenFace, CompreFace & 뉴스에서 정치인 얼굴 검색 데모

CompreFace

• 얼굴인식(Facial Detection), 얼굴식별(Facial Recognition), 동일인 판별(Facial Validation)
• 그 외 분석 속성 : 나이, 성별, 인종, 시선, landmark, 마스크 착용 여부
• 웹GUI, API 제공
• GPU없이 CPU만 쓰는데도 OpenFace에 비해 처리 속도가 빠르다.
• 악수하는 손을 인물로 인식하는 경우

해당 인물이 아닌 다른 인물로 인식하는 경우도 많은데 그럼에도 산출된 유사도가 90%가 넘는다. 반면 몇몇 인물은 아주 잘 인식하기도 하는 것으르 보면 이는 샘플 이미지의 문제인 것 같다. 이 블로그와 이 블로그에서 학습시킬 얼굴 이미지들을 전처리하는 것처럼 하면 인식율이 높아질 것 같기는 한데 노가다작업이라 할 엄두가 나지 않는다.

데모 : 뉴스에서 정치인 얼굴 검색

• 주소 : http://bossa.iptime.org:8005/
• 대표적인 정치인들의 사진으로 학습(3692명 7379장의 사진)
• 미디어 다음 > 정치뉴스의 사진에서 정치인을 찾아서 태깅
• 웹ui에서 정치인 이름으로 해당 정치인이 등장한 사진이 있는 기사 검색(AND 검색 지원)

OpenFace

• 파이썬 라이브러리(간단한 웹API도 제공)
• 얼굴인식(Facial Detection), 얼굴식별(Facial Recognition), 동일인 판별(Facial Validation)
• 그 외 분석 속성 : 나이, 성별, 감정, 인종
• CompreFace에 비해 인식 속도는 느리지만 인식율이 좋고 평가된 유사도가 더 정확한 듯
• 이 라이브러리를 ‘뉴스에서 정치인 얼굴 검색’에서 사용하려면 해줘야 할게 너무 많다 -.-

PLANTUML - 텍스트 기반 다이어그램 드로잉 툴

다이어그램을 그릴 수 있는 툴들은 많다. 가장 쉽게 구할 수 있는(?) 파워포인트부터 전통을 자랑하는 Visio, IBM Rational Software 같은 끝판왕급 툴들 그리고 각종 개발툴의 플러그인 형태의 소프트웨어까지.

그런데 갑자기 텍스트 기반 다이어그램 툴이라니.

하지만 개발자가 작성하는 것은 결국 텍스트 파일아닌가. 그렇다면 다이어그램을 텍스트로 작성한다는게 그렇게 이상하지는 않은데…

PlantUML

2009년에 Arnaud Roques라는 분이 Java로 개발해서 발표한 오픈소스 다이어그램 그리기 툴이다.

‘23년 말 현재 지원하는 다이어그램들은 다음과 같다.

🧩 UML 다이어그램

1. Sequence diagram
2. Use case diagram
3. Class diagram
4. Object diagram
5. Activity diagram
6. Component diagram
7. Deployment diagram
8. State diagram
9. Timing diagram

📈 UML이 아닌 다이어그램

이름은 PlantUML이지만 UML이외의 다이어그램을 더 많이 지원한다.

1. JSON data
2. YAML data
3. EBNF (Extended Backus-Naur Form)
4. Regex (Regular Expression)
5. Network diagram (nwdiag)
6. Salt (Wireframe graphical interface or UI Mockups)
7. Archimate diagram
8. SDL (Specification and Description Language)
9. Ditaa diagram
10. Gantt diagram
11. MindMap diagram
12. WBS (Work Breakdown Structure)
13. Mathematical Notations (AsciiMath, JLaTeXMath)
14. IE/ER (Information Engineering/Entity Relationship)

PlantUML의 장점은

1. 뭐니뭐니해도 매우 빠른 프로토타이핑이다. 마우스 없이 키보드만으로 엄청난 속도로 다이어그램을 그릴 수 있다.
2. 다이어그램 버전 간의 diff가 가능해진다. 즉 다이어그램 파일을 버전 관리 시스템에서 쉽게 관리할 수 있게된다.

물론 단점도 있는데

1. 못생겼다(하지만 진정 예쁜 것을 원한다면 포토샵으로 작업하자).
2. 작업도중에 레이아웃이 확 바뀌는 경우가 있다(이것은 PlnatUML이 기본적으로 최적의 레이아웃을 자동으로 맞춰주기 때문).

시퀀스 다이어그램의 최강자

PlantUML로 최고의 속도감을 느낄 수 있는 다이어그램은 시퀀스 다이어그램이다. PPT로 작업한 시퀀스 다이어그램에 스윔레인을 추가해본 적이 있는가. 이 작업이 얼마나 개발자를 좌절시키는지 해본 사람은 안다.

이 작업을 PlantUML로 어떻게 하는지 동영상으로 확인해보자.

재빠르게 문법을 둘러보자.

@startuml

James -> Alice: Hello!
Alice -> James : Hi?
James -> Roger : Hi Roger?
Roger -> James : Good James!
Roger -> James : How's Merry?
James -> Roger : Merry is fine.
Roger -> Alice : How are you Alice?
Alice -> Roger : I'm fine. Please call Merry
Roger -> Alice : No prob.
Roger -> Merry : Are you there?
Merry -> Roger : Honey? Can I help you?

@enduml

설명이 필요없을만큼 직관적이다. 하지만 다른 다이어그램들은 시퀀스 다이어그램만큼 편리하지는 않은데 렌더링 후에 항목을 추가하다보면 레이아웃이 확 바뀌는 문제가 있기 때문이다. 이것은 나름 PlantUML이 사용자를 대신하여 최선을 다해 레이아웃을 맞추는 과정에서 발생하는 문제라 사용자가 특정을 잘 알고 사용해야 한다. 하지만 이 기능이 단점이라고만 할 수 없는 것이 레이아웃을 작성자가 다시 맞추는 것도 보통 작업이 아니기 때문이다. PlantUML은 이 기능을 Smart Layout Algorithms라고 부르고 있다.

관련 툴

• Swagger to UML
• pikturr : swagger visualizer
• PlantUML Visualizer : 크롬 확장
• Doxygen : Javadoc 생성기
• VS code용 확장

그 외에도 많은 툴들이 PlantUML을 지원한다. 목록은 여기에서 확인 할 수 있다

VScode Java코드품질검사 확장 SornarLint vs CodeScene

코드 리뷰를 받을 수 없는 솔로 개발자 혹은 사실상(?) 솔로 개발자의 필수품-정적 코드 분석기, VS code-Java에도 역시나 있다.

VS Code 공식 확장 마켓에서 가장 많은 설치 건수를 자랑하는 2개의 확장 프로그램들을 재빨리 비교해보자.

SonarLint

• 그 유명한 SonarQube가 VS code 품으로
• SonarSource의 모든 rule들을 그대로 사용가능
• 특정 rule 제외(무시) 가능. 추가/수정은 불가능
• 마켓플레이스 보기, SonarLint 공식문서

실제 동작 방식을 살펴보자.

아래는 어떤 문제가 있는 소스다. 그래서 해당 구문에 SonarLint가 노란색 물결무늬 밑줄을 그어줬다. 그 위에 마우스를 올리면 SonarLint의 경고 내용을 확인할 수 있다.

혹은 problems 창에서 해당 경고를 마우스 오른쪽 버튼으로 클릭 후 “SonarLint Open description of rule ‘java:Sxxxx’“를 클릭하면

상세 내용을 볼 수 있다.

상세 내용을 보면 다음 내용을 확인 할 수 있는데

1. 어떤 유형의 이슈인지
2. 얼마나 심각한지
3. 이 이슈가 왜 문제인지
4. 어떻게 개선할 수 있는지
5. 기타 참고 사이트 목록

잘 짜여진 학습자료를 보는 느낌이다.

CodeScene

• codescene에서 제공하는 코드 건강(?) 분석 서비스의 무료 stand alone 버전
• rule 편집 가능(.codescene/code-health-rules.json 수정)
• 마켓플레이스 보기
• CHANGE COUPLING이라는 기능을 쓰려면 유료 클라우스 서비스를 사용해야 한다. 이 기능은 모듈 간의 논리적 의존성까지 검사해 준다고. 이 확장은 사실상 이 기능을 홍보하려고 만든 것 같다.

실제 동작 방식을 살펴보자.

이슈를 발견했을 때 해당 메소드 바로 위 편집기에 해당 제목이 뜬다.

혹은 problems에도 띄워 준다.

해당 제목을 클릭하면 상세 정보를 확인할 수 있다.

결론

• SonarQube는 코딩 규칙 검사기에 가깝다면 CodeScene은 설계 검사에 가까운 듯 하다. 상호 보완적이므로 둘 다 쓰지 않을 이유가 없다.
• 이 2개의 도구에서 지적하지 않더라도 뭔가 찜찜한 코드가 있을 때 추가로 생성형 AI에게 반드시 물어보자.

유용한 LINUX CLI명령어와 쉡스크립트들

ffmpeg

범용 미디어 변환 프로그램

• 오디오 파일을 avi동영상으로 변환하기

  ffmpeg -i inputFile.mp4 -q:v 6 outputFile.avi

• 특정 폴더의 mp3 파일들을 합친 후 사진을 삽입하여 유튜브 업로드용 동영상으로 변환하기

  find -name "*.mp3" -exec ffmpeg -loop 1 -framerate 2 -i 사진.jpg -i {} -tune stillimage -crf 18 -c:a copy -shortest {}.mkv \;

• 동영상 파일에서 특정 구간 복사하기

  #10초부터 20초 분량의 동영상 추출
  ffmpeg -ss 00:00:10 -i "원본.MP4" -t 00:00:20 -vcodec copy -acodec copy "10초부터_20초까지.MP4"

• rtsp 스트리밍 동영상을 캡쳐하여 mp4로 저장

  ffmpeg -i rtsp://서버주소 -vcodec copy -acodec copy -f mp4 -y 저장파일명.mp4    

uvccapture

웹캠 캡쳐 유틸

• YUYV포맷으로 캡쳐하여 파일명.jpg로 저장하기

  uvccapture -m -o파일명.jpg

lshw

하드웨어 정보 출력

• 하드웨어 정보를 html 포맷으로 생성하고 파이어폭스에서 열기

  lshw -html > ~/hardware_info.html && firefox ~/hardware_info.html

curl

각종 인터넷 프로토콜 클라이언트

• http응답 코드 출력

  curl -Is https://www.google.com/  | grep HTTP | cut -d ' ' -f2

xdotool

명령행 x11자동화 툴

• 마우스 위치 출력하기

  while true; do xdotool getmouselocation; sleep 0.2; clear; done

ctronome

메트로놈 유틸리티

• https://github.com/bivanbi/ctronome에서 소스를 받아서 컴파일해야 함
• 구동 스크립트 샘플

  #!/bin/sh
  killall ctronome
  bpm="100"
  baseDir="메트로놈_사운드_wav파일_디렉토리"
  if [ "$#" -eq  "0" ]
  then	
      bpm="100"
      echo "No arugments supplied"
      echo bpm : $bpm
  else
      bpm=$1
      echo bpm : $bpm
  fi
  padsp ctronome -b $bpm -t 2 -w1 $baseDir/a5.wav -w2 $baseDir/a4.wav

웹서버

• mini-httpd : 가벼운 설치형 웹서버. CGI, SSL지원. Apache웹서버 성능의 90% 성능을 보인다고

• darkhttpd : 직접 컴파일이 필요한 가벼운 웹서버

• python3 내장 웹서버 : python3에는 웹서버가 내장되어 있다. 터미널에서 아래 명령어를 입력하여 실행한다.

  python3 -m http.server

csv를 xlsx로 변환

• libreoffice

  soffice --headless --convert-to xlsx:"Calc MS Excel 2007 XML" file.csv

• csv2xlsx

      csv2xlsx --output 변환후.xlsx 변환전.csv

yewtube

• 터미널 유튜브 클라이언트
• 유튜브 계정없이 사용가능
• 유튜브 광고 없음
• 동영상 다운로드 가능

yt-dlp

유튜브 다운로더

• 동영상 다운로드

  yt-dlp https://www.youtube.com/watch?v=^CaN5ZCaiQI

• mp3로 다운로드

  yt-dlp https://www.youtube.com/watch?v=^CaN5ZCaiQI -x --audio-format mp3

쉘 스크립트

• 특정 폴더내의 특정 확장자 파일내의 탭문자를 스페이스 4개로 바꾸기

  #!/bin/bash
  find 해당디랙토리 -name '*.java' ! -type d -exec bash -c 'expand -i -t 4 "$0" > /tmp/e && mv /tmp/e "$0"' {} \;    

• 카운트 다운

  #!/bin/sh
  # ex) ./countdown.sh 60 : 1분 동안 카운트 다운
  clear
  date1=$((`date +%s` + $1));
  while [ "$date1" -ge `date +%s` ]; do
  ## Is this more than 24h away?
  days=$(($(($(( $date1 - $(date +%s))) * 1 ))/86400))
  echo "\033[H$days day(s) and $(date -u --date @$(($date1 - `date +%s`)) +%H:%M:%S)\r"; 
  sleep 0.1
  done

• 스탑와치

  date1=`date +%s`;
  while true; do
  days=$(( $(($(date +%s) - date1)) / 86400 ))
  echo -ne "$days day(s) and $(date -u --date @$((`date +%s` - $date1)) +%H:%M:%S)\r";
  sleep 0.1
  done

리눅스 터미널 입출력을 녹화하기

파이썬 기반의 CLI로 asciicinema가 있다.

설치

python3 -m pip install asciinema

​ 만약 python3가 설치되어 있지 않다면 먼저 설치해야 한다. (비단 코딩 목적뿐만이 아니라 여러 유용한 유틸리티를 사용하려면 리눅스에서 파이썬은 필수)

설치 후 해당 바이너리를 찾지 못하는 문제가 있을 수 있는데 이는 경로 문제 때문이다. pip으로 설치하는 바이너리들은 ~/.local/bin에 설치된다. 이 경로를 path에 추가해줘야 한다.

녹화

녹화는 간단하다. 명령을 입력할 때 rec 아규먼트만 추가하면 된다.

asciinema rec 해당파일명.cast

​ 이 다음부터 입출력되는 모든 텍스트는 녹화되며 <ctrl-d> 혹은 “exit”를 입력하면 녹화가 중지된다.

재생하기

재생도 간단하다. 명령을 입력할 때 play 아규먼트와 파일명만 추가하면 된다.

asciinema play 해당파일명.cast

​

부록 - 녹화 파일을 gif로 변환하기

agg - asciinema gif generator를 사용하면 쉽게 gif로 변환 가능하다

설치

agg 깃헙의 release에서 본인 아키텍쳐에 맞는 실행 바이너리를 다운로드한다. (리눅스용은 agg-x86_64-unknown-linux-gnu이다)

실행

해당 명령어의 아규먼트로 입력 파일명과 출력파일명만 넘겨주면 변환된다.

agg 해당파일명.cast 해당파일명.gif 

​

샘플

부록의 부록

• https://ezgif.com/crop : 애니메이션 gif의 시작과 끝의 불필요한 녹화내용을 제거할 때 유용하다

CPU와 메모리가 열일하고 있는지 확인하기

리눅스 CLI용 모니터링 툴을 비교해보자

테스트 환경

1.

CPU : Intel(R) Core(TM) i5-6600 4core

2.

memory : 32GB

top(Table Of Processes)

왠간한 리눅스 배포판에는 기본으로 있다

시스템 요약 정보 뿐만 아니라 현재 리눅스 커널이 관리하고 있는 프로세스와 쓰레드 목록도 같이 보여주는데 무었을 어떻게 보여줄지는 사용자가 설정 가능하다. 설정을 저장해서 다음에 명령어를 실행할 때도 사용할 수 있다.

하지만 나는 이 명령어를 잘 사용하지 않는다. 못생겼기 때문이다 -.-

htop

일단 top보다 훨씬 예쁘다.

•

cpu코어별로 bar차트를 제공하므로 부하를 쉽게 확인 가능

•

ncurses 기반이라 top보다 다양한 기능 제공(가로 혹은 세로로 스크롤하기 등)

•

프로세스 죽이기, 우선순위 변경하기 등을 바로 수행가능함

•

적당한 cpu 사용량

(유틸리티의 저자 이름이 Hisham라서 htop이라고…)

atop

모두 다 보여줄게. 하지만 가독성이 떨어짐

•

거의 모든 시스템 리소스(CPU, memory, disk, network)를 퍼포먼스 관점에서 모니터링

•

윈도우 가로 사이즈가 어느정도 이상 되어야 함

•

프로세스별로 디스크 IO 모니터링 가능

•

cpu코어를 최대한 많이 사용하는 듯. 각 코어별 사용량을 합쳐도 전체 사용량은 적은 편

vtop

nodejs 기반

1.

장점

•

심플

•

CPU와 메모리 사용량 추이를 쉽게 알 수 있음

2.

단점

•

다른 모니터링 툴보다 CPU와 메모리를 가장 많이 사용

•

nodejs기반이라 프로세스 식별이 힘듬

btop

가장 아름다운 ui

•

cpu코어를 최대한 많이 사용하는 듯. 각 코어별 사용량을 합치면 전체 사용량은 꽤 된다.

•

터미널 사이즈가 최소 가로 80, 세로 24가 되어야 띄울 수 있다(최소치 미달일 때 경고가 뜸)

•

프로세스별 상세보기 지원

glances

python기반

•

python기반이라 자체 프로세스 식별이 힘듬

•

파티션별 IO 모니터링

•

메모리를 상당히 많이 사용(46MB) 하지만 CPU코어는 한 개만 사용하도록 개발한듯

•

high load 발생 시 경고 출력

총평

어플리케이션 개발자라면 btop을, 시스템 관리자라면 glances를 추천

•

가장 가벼운 툴 : top

•

CPU 로드 추이 시각화 : vtop, btop

•

CPU 코어별 로드 모니터링 : atop, btop, htop(바 차트)

•

CPU 코어별 온도(그 외 각종 센서들) : btop, glances

•

디스크 IO : atop(프로세스별로도 가능), glances(파티션 별), btop(프로세스별)

•

네트워크 IO : btop(추이 보기), glances

•

프로세스별 상세 보기 : btop

자바의 정석 8장. 예외처리

8장. 예외처리

1.1 프로그램 오류 p.414

컴파일 에러 : 컴파일 시에 발생하는 에러 런타임 에러 : 실행 시에 발생하는 에러 논리적 에러 : 실행은 되지만 의도와 다르게 동작하는 것

• 처리 가능 여부에 따라

에러(error) : 프로그램 코드에 의해서 수습될 수 없는 심각한 오류 예외(exception) : 프로그램 코드에 의해 수습될 수 있는 다소 미약한 오류

1.2 예외 클래스의 계층구조 p.415

• Throwable

• Exception

Excetion클래스들 : 사용자의 실수와 같은 외적인 요인에 의해 발생하는 예외 RuntimeException클래스들 : 프로그래머의 실수로 발생하는 예외

catch 순서 p.421

package chap8;

public class ExceptionEx7 {
	public static void main(String args[]) {
		try {
			int i = 1/0;
		} catch (Exception e) {
		} catch (ArithmeticException e) {
			//"Unreachable catch block for ArithmeticException. It is already handled by the catch block for Exception"
		}
	}
}

Exception.printStackTrace() vs @Slf4j logger.error() p.422 https://stackoverflow.com/a/10477646/4766882

printStackTrace()는 단순히 오류를 어딘가에 출력하는데 그치지만 Slf4j를 쓰면 출력을 할지 말지 부터 어디에 출력할지를 소스 수정없이 조절가능. 출력은 시스템 런타임 성능을 저하시키는 주요 요인

예외의 종류 : 컴파일러가 체크할 수 있는가

1. checked : 컴파일러가 체크 가능. 컴파일 에러 발생(소스를 수정해야 컴파일 될 것이므로 코딩 시에 excetion에 대한 대처가 가능)
2. unchecked : 컴파일러가 체크 불가능. 컴파일 에러 발생하지 않음

언제 Exception을 사용할까? 가능한 안써야 한다. 특히 ‘제어로직에 예외를 사용하지 마라’

1. 소스 가독성 저하(goto문이랑 동일함)
2. 런타임의 속도저하

언제 Exception(throws)을 사용할까?

호출stack이 깊을 때 예외 상황을 우아하게 처리하기 위해. ‘예외를 마지막에 처리하는 쪽은 최초 call을 발생시킨 객체다’

1.9 자동 자원 반환 - try-with-resources

1. 소스가 많이 짧아져서 가독성이 좋아졌다.
2. 해당 리소스는 AutoCloseable인터페이스를 구현해야 한다.

• before

Scanner scanner = null;
try {
    scanner = new Scanner(new File("test.txt"));
    while (scanner.hasNext()) {
        System.out.println(scanner.nextLine());
    }
} catch (FileNotFoundException e) {
    e.printStackTrace();
} finally {
    if (scanner != null) {
        scanner.close();
    }
}

• after

try (Scanner scanner = new Scanner(new File("test.txt"))) {
    while (scanner.hasNext()) {
        System.out.println(scanner.nextLine());
    }
} catch (FileNotFoundException fnfe) {
    fnfe.printStackTrace();
}

1.10 사용자정의 예외 만들기

필요에 따라 예외처리의 여부를 선택할 수 있는 ‘unchecked’예외가 강제적인 ‘checked예외’보다 더 환영받고 있다 👉 하지만 예외처리를 강제하기 위해서는 checked예외가 필요

1.12 연결된 예외(chained exception)

여러가지 예외(원인과 결과)를 하나의 큰 분류의 예외로 묶어서 다루기 위해

• exception-handling-for-rest-with-spring : tutorials/spring-boot-rest at master · eugenp/tutorials

• Exception Handling in Spring MVC : https://github.com/paulc4/mvc-exceptions

자바의 정석 7장. 객체지향 프로그래밍 II

자바의 정석(남궁성) 독후감 형식의 글입니다

7장. 객체지향 프로그래밍 II

1.1상속의 정의와 장점

1. 재사용성을 높히고
2. 코드의 중복을 제거하여
3. 생산성과 유지보수성을 높힌다.

왜 상속에 해당하는 키워드가 inherit이 아니고 extends인가

상속을 거듭할수록 상속받는 클래스의 멤버 개수가 점점 늘어나기 때문

JPA의 최상위 모델객체 예제

@MappedSuperclass
@EntityListeners(AuditingEntityListener.class)
public class BaseEntity {
    @Id
    @GeneratedValue
    private Long id;
		@CreatedBy
    private String regUserId;
		@LastModifiedBy
    private String modUserId;
		@CreatedDate
    private Date regDate;
		@LastModifiedDate
    private Date modDate;
    @Version
    private Integer version;
}

@Entity
public class File extends BaseEntity {
    private String name;
    private String content;
}

1.2 클래스간의 관계 - 포함관계

언제 포함관계를 사용하는가?

https://stackoverflow.com/a/37624298/4766882

언제나 상속 대신 포함관계 사용이 가능하다.

언제 상속관계를 사용하는가

1. 자식이 부모에 대해 ‘is a’ 관계인 동시에 자식이 부모의 모든 기능을 다 가지고 있을 때
2. 다중상속을 할 수 없으므로(?) : “VCR클래스는 TVCR클래스에 포함” p.325

ex) 사각형과 정사각형 문제

1. 사각형 클래스에 가로길이_늘리기()가 정의되어 있다고 하자.
2. 정사각형 클래스는 사각형 클래스를 상속했다.
3. 정사각형 객체에서 사각형 클래스의 가로길이_늘리기()를 호출하는 순간 정사각형은 더 이상 정사각형이 아니게 된다.

2.3 오버로딩 vs 오버라이딩

• 오버로딩 : 과적(하면 할 수록 갯수가 늘어남)

  • https://www.google.com/search?q=overloaded+vehicles

  • 한때 유명했던 귀여운 동물사진 블로그

    

• 오버라이딩 : 덮어씌우기(아무리 많이 해도 갯수가 늘어나지 않는다)

  • overwrite와 유사함 https://stackoverflow.com/a/34036684/4766882

2.4 super

• 메소드 체이닝 샘플 p.331

3.3 import문

한 패키지에서 여러 클래스를 사용하는 경우 클래스의 이름을 일일이 지정해주는 것보다 패키지명.*과 같이 하는것이 편리하다 ☛ IDE의 import정리기능을 써서 사용할 클래스들을 명시적으로 import 것이 좋다. import만 보면 어떤 클래스들을 쓰는지(dependency)를 쉽게 파악할 수 있기 때문.

4.2 static - 클래스의, 공통적인 p.344

static의 사전적 의미 : 정적인, 변하지 않는

Nothing is static. Everything is evolving.(Chuck Palahniuk, Fight Club)

4.3 final - 마지막의, 변경될 수 없는

모든 private 메소드는 final이다 하지만 모든 final 메소드가 private인 것은 아니다. p.353

4.4 abstract - 추상의, 미완성의

추상 클래스를 상속extend하는 구상 클래스는 모두 abstract 메소드를 override해야 한다

VS

인터페이스를 구현implement하는 클래스는 모두 메소드를 override해야 한다

언제 abstract를 써야 하는가?

언제 interface를 써야 하는가?

composition over inheritance vs inheritance over composition

4.6 제어자(modifier)의 조합

메서드에 private와 final을 같이 사용할 필요는 없다. (중략) 이 둘 중 하나만 사용해도 의미가 충분하다 ☛ private 메소드에 final 제어자를 쓸 필요는 없다. 하지만 final 메소드에 접근 제어자를 지정하지 않는다면 접근 제어자는 default가 된다. 즉 private가 아니다.

5. 다형성

5.1 다형성이란?

5.2 참조변수의 형변환

5.3 instanceof 연산자

5.4 참조변수와 인스턴스의 연결

메서드의 경우 조상 클래스의 메소드를 자손의 클래스에서 오버라이딩한 경우에도 참조변수의 타입에 관계없이 항상 실제 인스턴스의 메서드(오버라이딩된 메서드)가 호출되지만, 멤버변수의 경우 참조변수의 타입에 따라 달라진다.

https://github.com/bluedskim/java_standard_study/blob/master/src/test/java/chap7/AnimalShopperTest.java

다운캐스팅은 지양해야 한다 https://stackoverflow.com/a/30659861/4766882

6. 추상 클래스

6.1 추상 클래스란?

1. 클래스 = 설계도
2. 추상 클래스 = 미완성 설계도
3. 인터페이스 = 기본 설계도

추상 클래스로 인스턴스 생성 불가

7. 인터페이스

7.1 인터페이스란?

• 인터페이스는 일종의 추상 ‘클래스’이다. ☛ 자식이 인스턴스를 만들 수 있으므로 추상클래스는 클래스다. 하지만 인터페이스는 자식이 인스턴스를 만들 수 없으므로 클래스가 아니다.
• 인터페이스는 명세서(specfication)다. “인터페이스의 이름에는 주로 Fightable과 같이 ‘~을 할 수 있는’의 의미인 able로 끝나는 것들이 많은데, 그 이유는 어떠한 기능 또는 행위를 하는데 필요한 메서드를 제공한다는 의미를 강조하기 위해서이다.”
• 인터페이스는 구현체에 대한 관점이다.

7.3 인터페이스의 상속

다중 상속이 가능하다

7.4 인터페이스의 구현

‘implements’ 구문이 상속을 의미하지 않는다. extends구문은 생략 가능

7.5 인터페이스를 이용한 다중상속

7.6 인터페이스를 이용한 다형성

https://github.com/bluedskim/java_standard_study/blob/master/src/test/java/chap7/PolymorphismTest.java

7.7 인터페이스의 장점

• 표준화가 가능하다
• 독립적인 프로그래밍이 가능하다
• 개발시간을 단축시킬 수 있다
• 서로 관계없는 클래스들에게 관계를 맺어 줄 수 있다

Liskov Substitution Principle 해결 p.395

• https://www.baeldung.com/cs/liskov-substitution-principle
• https://www.infragistics.com/community/blogs/b/dhananjay_kumar/posts/simplifying-the-liskov-substitution-principle-of-solid-in-c
• https://www.javabrahman.com/programming-principles/liskov-substitution-principal-java-example/

7.8 인터페이스의 이해

• 클래스를 사용하는 쪽(User)과 클래스를 제공하는 쪽(Provider)이 있다.
• 메소드를 사용(호출)하는 쪽(User)에서는 사용하려는 메서드(Provider)의 선언부만 알면 된다(Open-Close Principal)

7.9 디폴트 메서드와 static메서드

Java8부터 인터페이스에 구상 메소드 사용가능

8. 내부 클래스(inner class)

• 테스트 : https://github.com/bluedskim/java_standard_study/blob/b3f9ccc40a6e0a3683748bb51e228a076dfffff1/src/test/java/chap7/PublicFinalInnerMethodTest.java

8.5 익명 클래스(anonymous class)

임시 클래스. 주로 인수 생성용

자바의 정석 6장. 객체지향 프로그래밍 I

자바의 정석(남궁성) 독후감 형식의 글입니다

6장. 객체지향 프로그래밍1

1. 객체지향언어

1.2 객체지향언어

현실 세계를 프로그램의 세계에서 표현하기 위한 방법 p.230

1. 코드의 관리가 용이하다
2. 코드의 재사용성이 높다
3. 신뢰성이 높은 프로그래밍을 가능하게 한다.

p.231 일단 프로그램을 기능적으로 완성한 다음 어떻게 하면 보다 객체지향적으로 코드를 개선할 수 있을지를 고민하여 점차 개선해 나가는 것이 좋다 → 리팩터링

2. 클래스와 객체

2.1 클래스와 객체의 정의와 용도

• p.232 클래스에 대한 각종 메타포
  • 클래스:객체=설계도(청사진blue print):제품(들)
  • 클래스:객체=붕어빵틀:붕어빵(들)

p.232 인스턴스와 객체는 같은 의미지만 객체는 모든 인스턴스를 대표하는 포괄적인 의미를 갖는다.

2.4 인스턴스의 생성과 사용 p.234

2.6 클래스의 또 다른 정의 p.243

1. 변수 : 하나의 데이터를 저장할 수 있는 공간

2. 배열 : 같은 종류의 여러 데이터를 하나의 집합으로 저장할 수 있는 공간
3. 구조체 : 서로 관련된 여러 데이터를 종류에 관계없이 하나의 집합으로 저장할 수 있는 공간
4. 클래스 : 데이터와 함수의 결합(구조체 + 함수). 변수와 함수가 서로 유기적으로 연결되어 작업이 간단하고 명료해진다

• 대표적인 클래스 : String

3 변수와 메서드

• 메소드 vs 메서드
• 멤버변수 = static변수 + 인스턴스 변수 p.246

3.2 클래스 변수와 인스턴스 변수

클래스변수를 참조할 때는 ‘클래스이름.클래스변수’의 형태로 하는 것이 좋다. 인스턴스 참조 변수를 통해서도 클래스변수를 사용할 수 있지만 이렇게 하면 클래스 변수를 인스턴스 변수로 오해하기 쉽기 때문이다. p.249

3.3 메서드 p.249

메서드를 사용하는 이유

1. 높은 재사용성
2. 중복된 코드의 제거
3. 프로그램의 구조화

3.4 메서드의 선언과 구현

메서드의 선언부는 후에 변경사항이 발생하지 않도록 신중히 작성해야 한다. 메서드의 선언부를 변경하게 되면, 그 메서드가 호출되는 모든 곳도 같이 변경해야 하기 때문이다. →하지만 너무 겁먹지 말자. 우리에게는 강력한 리팩토링 기능을 제공하는 IDE가 있다

• 메소드 이름 짓기 : 동사(목적어), 동사+한정사(목적어)
• p.254 argument와 parameter의 차이 : argument는 넘겨주는 것이고 parameter는 받는 것이다.

“Parameter” vs “Argument”

3.6 return문 p.258

• 메소드의 실행을 강제로 종료하는 효과

• return문을 어떻게 쓰면 좋을까 : https://stackoverflow.com/questions/1419278/control-flow-via-return-vs-if-else

  • option1

  public ActionResult Edit(MyClass class)
  {
      if (!class.Editable)
         return null;
  
      class.Update();
      return View();
  }

  • option2

  public ActionResult Edit(MyClass class)
  {
      if (class.Editable)
      {
         class.Update();
         return View();
      }
      else
      {
         return null;
      }
  }

  • option3

  public ActionResult Edit(MyClass class)
  {
      ActionResult rv = null;
      if (class.Editable)
      {
          class.Update();
          rv = View();
      }
      return rv;
  }

• p.260 매개변수의 유효성 검사 : IllegalArgumentException을 쓰자

  float divide(int x, int y) {
  	// 작업을 하기 전에 나누는 수(y)가 0인지 확인한다
  	if(y == 0) {
  		System.out.println("0으로 나눌 수 없습니다.");
  		return 0; // 매개변수가 유효하지 않으므로 메서드를 종료한다.
  	}
  	return x / (float)y;
  }

3.7 JVM의 메모리 구조

재귀호출에서 종료조건이 체크되지 못하는 경우 StackOverflowError 발생

3.11 클래스 메서드(static메서드)와 인스턴스 메서드

인스턴스와 관계없는(인스턴스 변수나 인스턴스 메서드를 사용하지 않는) 메서드를 클래스 메서드(static메서드)로 정의한다.

• 클래스 메소드의 용도를 유틸리티성 메소드로 한정하는 것이 좋다. 단순히 호출 속도를 빠르게 하기 위해 쓰는것은 오용할 위험이 있다.(p.278)

class Fee() {
	public int payment;
	public static int calculatePayment(int amount) {
		return amount + 1;
	}
}

class Client() {
	public int getFee() {
		Fee fee = new Fee();
		fee.calculatePayment(100); // fee.payment = fee.calculatePayment(100);
		System.out.println("fee=" + fee.payment);
	}
}

알아두면 좋아요!(p.282) → 하지만 이런식으로 사용할거면 클래스 메소드로 만들어야 한다. 왜냐하면…

int result = new MemberCall().instanceMethod1();

4.4 메소드 오버로딩의 장점 : chain overloaded functions(5.4에서 생성자를 이런식으로 호출하고 있음)

public int calculate(int a) {
	return calculate(a, 0);
}

public int calculate(int a, int b) {
	return calculate(a, b, 0);
}

public int calculate(int a, int b, int c) {
	// 실제 로직
}

5.4 생성자에서 다른 생성자 호출하기 - this(), this

생성자에서 다른 생성자를 호출할 때는 첫 줄에서만 가능하다.

5.5 생성자를 이용한 인스턴스의 복사

class Car {
	String color;
	String gearType;
	int door;

	// 2줄 짧음. 메소드명만으로 로직을 알 수 없음
	Car(Car c) {
		color = c.color;
		gearType = c.gearType;
		door = c.door;
	}

	// 2줄 더 길다. 메소드명만으로 로직을 알 수 있음
	public Car copy() {
		Car copied = new Car();
		copied.color = color;
		copied.gearType = gearType;
		copied.door = door;
		return copied;
	}
}

...
Car original = new Car();
...
**Car copied = new Car(original);
Car copied = original.copy();**
...

6.변수의 초기화

무조건 최대한 빨리 초기화 하기

멤버변수(클래스변수와 인스턴스변수)와 배열의 초기화는 선택적이지만 지역변수의 초기화는 필수적이다

6.3 초기화 블럭(initialization block)

클래스 초기화 블럭 : 클래스 변수의 복잡한 초기화에 사용된다. 인스턴스 초기화 블럭 : 인스턴스 변수의 복잡한 초기화에 사용된다.

'Back Office' vs 'Back End'

IT프로젝트에서 back office와 back end를 혼용하면 망할 수 있다. front office와 front end도 마찬가지.

다음 두 문장을 비교해보자

‘백 오피스와 프론트 오피스를 별도의 인스턴스로 구성합시다’

와

‘백 엔드와 프론트 엔드를 별도의 인스턴스로 구성합시다.’ 는 전혀 다른 말이다.

back office는 운영자 화면(사이트)을 지칭한다고 보면 되고 front office는 사용자 화면이라고 생각하면 된다(front office는 한국 IT에서는 잘 쓰지 않는 용어).

https://www.webopedia.com/definitions/back-office/에서 언급한 “백 오피스는 백엔드의 지원을 받는다The back office is supported by a back end system.“는 말이 틀린것은 아니지만 오해를 불러올 수 있다. 백 오피스만 백엔드의 지원을 받는 것은 아니다. 당연히 ‘백 오피스와 프론트 오피스 모두 백엔드의 지원을 받는다’

정리하자면 back office와 front office는 사용자 타겟에 따른 서비스 영역 개념이며 back end와 front end는 시스템 아키텍처 개념이다.

Front-End,Back-End VS Front Office,Back Office

Docker로 Oracle12 설치하기

• oracle 12 enterprise 버전 설치에 대한 글이다.
• 다른 버전 설치는 이렇게 복잡하지 않은 듯. 아래 링크 참조
  • Docker로 Oracle xe 11g 설치 : https://romeoh.tistory.com/entry/Oracle-docker%EC%97%90-Oracle-11g-%EC%84%A4%EC%B9%98%ED%95%98%EA%B8%B0
  • [Docker] Oracle DB(Oracle 12c) 구성하기 : https://gomguk.tistory.com/69
• Docker를 어느 정도 사용할 수 있어야 아래 설명을 따라갈 수 있다.

리눅스에 오라클DB 설치는 정말 악몽이다(윈도우즈는 차라리 낫다). 만약 리눅스가 그래픽환경(X windows)가 아니라면 완전 낭패다.

그래서 X windows를 설치하기까지 했었다. 그래픽환경(X windows)은 시스템 리소스를 더 쓸 수 밖에 없는데 -.- 서버에 그래픽환경(X windows)을 설치할 필요는 없잖아~

고맙게도 Docker로 설치하면 이런 문제는 해결된다.

데이터 저장용 폴더 준비하기

데이터를 docker 내부에 저장하면 이후에 대이터를 백업하거나 다른 서버로 이전할 때 힘들어진다. 처음부터 데이터는 docker 컨테이너 외부에 저장하자.

1. 데이터 저장용 폴더 생성

   저장용 폴더는 본인 환경에 맞게 경로를 지정한다.

    $ mkdir /home/shed/util/data/oradata
   

2. 폴더에 권한 주기

   마운드될 폴더에 쓰기 권한이 없으면 기동자체가 되지 않는다 -.- 아래의 명령어로 쓰기 권한을 주자.

    $ chmod -R a+w /home/shed/util/data/oradata
   

   생성한 폴더는 도커 기동시 볼륨으로 연결할 것이다.

실행

$ docker run -d -it --name oracle -e ORACLE_CHARACTERSET=AL32UTF8 -p 1521:1521 -p 5500:5500 -v /home/shed/util/data/oradata:/ORCL store/oracle/database-enterprise:12.2.0.1

/oracle:/ORCL store/oracle/database-enterprise:12.2.0.1
Unable to find image 'store/oracle/database-enterprise:12.2.0.1' locally
12.2.0.1: Pulling from store/oracle/database-enterprise
4ce27fe12c04: Pull complete 
9d3556e8e792: Pull complete 
fc60a1a28025: Pull complete 
0c32e4ed872e: Pull complete 
b465d9b6e399: Downloading [============================>                      ]  1.538GB/2.739GB

다운로드가 끝나면 자동으로 실행된다. docker ps -a 명령으로 확인해보자.

$ docker ps -a
CCONTAINER ID        IMAGE                                       COMMAND                  CREATED              STATUS                        PORTS                                            NAMES
d4d851dea5b9        store/oracle/database-enterprise:12.2.0.1   "/bin/sh -c '/bin/ba…"   About a minute ago   Up About a minute (healthy)   0.0.0.0:1521->1521/tcp, 0.0.0.0:5500->5500/tcp   oracle

계정 생성

접속용 계정을 생성해야 각종 툴에서 사용가능하다.

1. sqlplus로 접속

    $ docker exec -it oracle bash -c "source /home/oracle/.bashrc; sqlplus /nolog"
    SQL*Plus: Release 12.2.0.1.0 Production on Wed Jul 14 15:42:57 2021
    Copyright (c) 1982, 2016, Oracle.  All rights reserved.
    SQL>
   

2. 로그인

    SQL> conn sys/oracle as sysdba
    Connected.
   

3. 세션 설정 변경

    SQL> alter session set "_ORACLE_SCRIPT"=true;
    Session altered.
   

4. 계정 생성 & 권한 주기

   acc01라는 계정을 만들어 보겠다.

    SQL> create user acc01 identified by passwd;
    User created.
    SQL> GRANT CREATE SESSION TO acc01;
    SQL> GRANT CONNECT, RESOURCE, DBA TO acc01;
    Grant succeeded.
   

5. 생성한 계정으로 sqlplus 접속 테스트

    $ docker exec -it oracle bash -c "source /home/oracle/.bashrc; sqlplus acc01/passwd@ORCLCDB"
    SQL*Plus: Release 12.2.0.1.0 Production on Wed Jul 14 16:00:51 2021
    Copyright (c) 1982, 2016, Oracle.  All rights reserved.
    Last Successful login time: Wed Jul 14 2021 15:59:45 +00:00
    Connected to:
    Oracle Database 12c Enterprise Edition Release 12.2.0.1.0 - 64bit Production
    SQL>
   

DBeaver로 접속

다음과 같이 접속 설정을 한다.

Docker기반 오라클12 정도면 개발 환경에서 사용하기에는 충분한것 같다.

Java 디자인 패턴-12.Composite

Composite 패턴

“하나의 주문은 여러 상품으로 구성될 수 있다. 이 상품들은 여러 개의 다른 박스에 담길 수 있으며 이 박스들 역시 더 큰 박스에 담길 수 있다. 이런 구조는 뒤집힌 트리형태와 같다.” (출처:https://refactoring.guru/design-patterns/composite)

해결하려는 문제

1. 클라이언트는 트리tree구조의 자료구조에 접근할 때 부모 노드와 leaf노드를 접근하는 api가 틀리다면 소스가 복잡해진다. 부모와 노드를 일관된 방법으로 접근할 수 있다면 클라이언트 구현,변경,테스트,재사용이 쉬워진다.

특징/용도

1. 트리tree구조의 자료구조에만 적용가능하다.
2. Composite 객체는 요청을 자식객체들에게 순차적으로 전달forward한다.

클래스 다이어그램

소스

1. Component : 공통 인터페이스로 leaf와 composition이 구현해야 할 메소드가 선언되어 있음
   • Menu.java

     1 2 3 4 5

     package net.dskim.desingpattern.composite; public interface Menu { public int getPrice(); }

   • AggregateMenu.java

     1 2 3 4 5

     package net.dskim.desingpattern.composite; public interface AggregateMenu extends Menu { public void addMenu(Menu menu); }

2. Leaf : 트리의 기본 요소로 하위 요소를 가지고 있지 않는다.
   • Noodle.java

     1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

     package net.dskim.desingpattern.composite; import lombok.extern.slf4j.Slf4j; @Slf4j public class Noodle implements Menu { int price; public Noodle(int price) { this.price = price; } @Override public int getPrice() { log.info("price=={}", price); return price; } }

   • Rice.java

     1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

     package net.dskim.desingpattern.composite; import lombok.extern.slf4j.Slf4j; @Slf4j public class Rice implements Menu { int price; public Rice(int price) { this.price = price; } @Override public int getPrice() { log.info("price=={}", price); return price; } }

3. Composite : Component를 구현implement. leaf의 container역할
   • SetMenu.java

     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

     package net.dskim.desingpattern.composite; import java.util.ArrayList; import java.util.List; import lombok.extern.slf4j.Slf4j; @Slf4j public class SetMenu implements AggregateMenu { List<Menu> menus ; public SetMenu() { menus = new ArrayList<>(); } @Override public void addMenu(Menu menu) { menus.add(menu); } @Override public int getPrice() { int price = 0; for(Menu menu : menus) { price += menu.getPrice(); } log.info("price=={}", price); return price; } }

참고

• wikipedia : Composite pattern
• refactoring.guru : Design Patterns / Structural Patterns / Composite

추천 Redmine Agile플러그인과 PurpleMine2 테마

Redmine은 꽤 오래된 웹기반 프로젝트 관리 툴이다. 그래서 기능이나 화면이 상당히 예스럽다. 이런 기능과 UI를 좋아하는 분들도 있겠지만 현재의 유행과는 많이 떨어져 있는게 사실이다.

(20세기말에 유행하던 게시판 UI를 닮았다. 아래쪽의 PurpleMine2 UI와 비교해보자)

하지만 기본 기능에 충실하고 오히려 예스러운 화면과 기능을 좋아하시는 분들께 훌륭한 툴이다.

레드마인을 사용하면서 기본으로 제공되지 않는 기능 중 아쉬운 기능이 Agile Kanban 기능이었다. 하지만 redmineup이라는 회사의 플러그인을 쓰면 기본적인 Kanban 기능은 쓸 수 있다.

• 다운로드 사이트 : https://www.redmineup.com/pages/plugins/agile

  

레드마인 기본 테마는 상당히 구식이다. 나같은 디알못이 봐도 역시나 그렇다.

그래서 몇가지 사용자 테마를 적용해봤는데 가장 만족스러운 테마는 mrliptontea라는 분이 만든 PurpleMine2 다.

• https://github.com/mrliptontea/PurpleMine2

  (가독성이 상당히 좋아졌다. 위쪽의 기본 테마와 비교해보자)

이제는 비추하는 플러그인이다. 바로 easyredmine.com의 gantt 플로그인이다.

• 사이트 주소 : https://www.easyredmine.com/redmine-gantt-plugin

이 플러그인을 쓰면 각종 검색의 옵션 저장시 오류가 발생한다 -.-

최신 레드마인 4.1.2의 간트차트기능이 많이 좋아져서 굳이 필요없는 플러그인이기도 하다.

레드마인 설치 없이 기능 체험을 원한다면 가입형 무료 레드마인 서비스 https://www.hostedredmine.com 을 추천한다. 레드마인 버전은 좀 오래된것 같지만(버전 정보를 알 수가 없다 -.-) 레드마인을 체험하기에는 충분하다.

Ubuntu 20.04 + VS Code 1.56.2에서 한글 입력 문제 해결하기

Ubuntu 20.04 환경에서 VS Code를 사용할 때 한글입력 시 기역으로 시작하는 글자에 받침이 붙으면 깨진다.

위의 이미지를 보면 타이틀바의 한글은 깨지지 않지만 편집기 내부의 한글이 깨진다.

vscode의 github에 issue를 올린지 3달이 넘어서 개발자가 이슈를 해결해주었다.

👈 이슈 내용 보기

원인은 기본 폰트에 있었다. Ubuntu용 VS Code는 ‘Droid Sans Mono’가 기본 폰트로 설정되어 있는데 이 폰트가 뭔가 충돌을 일이키는 것 같다.

이 폰트를 설정에서 제거하면 해결 된다.

CMD/CTRL + SHIFT + P 로 Command Palette 를 열고 settings json 이라고 타이핑한 후 ‘Open Settings (JSON)‘를 선택하면 설정 JSON파일을 편집할 수 있다(혹은 CTRL + Comma 단축키로 설정화면에서 수정할 수도 있다)

editor.fontFamily 속성에서 Droid로 시작하는 폰트들을 다 삭제 하고 저장하자.

이제 기역으로 시작하는 글자에 받침이 붙어도 깨지지 않는다.

이 증상은 github.dev의 웹기반 vs code에서도 동일하다(그렇다면 MS가 운영하는 github에서도 리눅스 계열 서버를 사용한다는?).

역시 해결 방법도 동일하다.

Java 디자인 패턴-11.Decorator

(Java 디자인 패턴 스터디 모집 중 : https://github.com/bluedskim/javaDesignPatterns)

Decorator 패턴

(출처:https://stefanhenneken.net/2019/02/16/iec-61131-3-the-decorator-pattern)

해결하려는 문제

특징/용도

1. 런타임에 객체에 동적으로 기능을 추가하기 위한 structural 패턴
2. 래퍼wrapper 클래스로 구현.
3. chain of responsibility pattern과 유사함
4. 생성자 혹은 다른 메소드에서 해당 클래스 자체를 인수로 받는 경우 데코레이터라 볼 수 있다(https://refactoring.guru/design-patterns/decorator/java/example)

고려사항

클래스 다이어그램

소스

• 꾸며질decorated 객체
  • BeverageBase.java : 부모 abstract 객체

    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

    package net.dskim.desingpattern.decorator; abstract class BeverageBase { protected String description = ""; public String getDescription() { return description; } /** * 가격을 계산하는 로직은 하위 객체가 구현해야 한다. * @return */ public abstract double getCost(); }

  • BlackTea.java

    1 2 3 4 5 6 7 8 9 10 11 12 13

    package net.dskim.desingpattern.decorator; class BlackTea extends BeverageBase { public BlackTea() { description = "Black tea from teabag"; } @Override public double getCost() { return 5; } }

  • Espresso.java

    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

    package net.dskim.desingpattern.decorator; abstract class BeverageBase { protected String description = ""; public String getDescription() { return description; } /** * 가격을 계산하는 로직은 하위 객체가 구현해야 한다. * @return */ public abstract double getCost(); }

  • GreenTea.java

    1 2 3 4 5 6 7 8 9 10 11 12 13

    package net.dskim.desingpattern.decorator; class GreenTea extends BeverageBase { public GreenTea() { description = "Green leaf tea"; } @Override public double getCost() { return 8; } }

• 꾸미는decorator 객체
  • CondimentsDecoratorBase.java : 부모 abstract 객체

    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

    package net.dskim.desingpattern.decorator; /** * 데코레이터 객체 */ abstract class CondimentsDecoratorBase extends BeverageBase { BeverageBase beverage; /** * 생성자에서 BeverageBase의 참조를 받아서 멤버변수에 할당 * @param beverage */ protected CondimentsDecoratorBase(BeverageBase beverage) { this.beverage = beverage; } }

  • CholateCondiment.java

    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

    package net.dskim.desingpattern.decorator; class ChocolateCondiment extends CondimentsDecoratorBase { /** * 생성자에서 해당 클래스 자체를 인수로 받는다 */ public ChocolateCondiment(BeverageBase beverage) { super(beverage); description = beverage.getDescription() + " + Chocolate"; } @Override public double getCost() { return beverage.getCost() + 4; } }

  • MilkCondiment.java

    1 2 3 4 5 6 7 8 9 10 11 12 13

    package net.dskim.desingpattern.decorator; class MilkCondiment extends CondimentsDecoratorBase { public MilkCondiment(BeverageBase beverage) { super(beverage); description = this.beverage.getDescription() + " + Milk"; } @Override public double getCost() { return beverage.getCost() + 3; } }

  • SugarCondiment.java

    1 2 3 4 5 6 7 8 9 10 11 12 13

    package net.dskim.desingpattern.decorator; class SugarCondiment extends CondimentsDecoratorBase { public SugarCondiment(BeverageBase beverage) { super(beverage); description = beverage.getDescription() + " + Sugar"; } @Override public double getCost() { return beverage.getCost() + 1; } }

참고

• baeldung : The Decorator Pattern in Java
• DZone : Decorator Design Pattern in Java

Java 디자인 패턴-10.Adapter

(Java 디자인 패턴 스터디 모집 중 : https://github.com/bluedskim/javaDesignPatterns)

Adapter(적응) 패턴

(출처:https://educationinaction.org/water-rocks-vocabulary/adaptation)

해결하려는 문제

1. 인터페이스의 불일치 해결.

용도/목적

1. 구조적Structural 패턴
2. 어떤 인터페이스를 다른 목적의 인터페이스로 만드는 패턴.
3. 클라이언트 소스 수정이 불가능한 경우 유용하다.

구성요소

1. adapter(wrapper) : adaptee의 interface를 클라이언트가 원하는 target의 인터페이스로 변경하는 객체
2. adaptee : 변경대상이 되는 객체
3. target : 클라이언트가 원하는 인터페이스를 가지고 있는 객체
4. 클라이언트 : target으로 변경된 adaptee를 사용하는 객체

고려사항

다른 유사한 패턴과 비교해보자 https://en.wikipedia.org/wiki/Adapter_pattern#Usage

1. Decorator : 원래의 소스를 감싸는 방식으로 인터페이스에 동적으로 기능을 추가한다.
2. Delegation : 상속을 통한 조합
3. Facade : 단순화된 인터페이스 제공

클래스 다이어그램

소스

1. adapter : LightningToMicroUsbAdapter.java

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23

   package net.dskim.desingpattern.adapter; import lombok.extern.slf4j.Slf4j; @Slf4j public class LightningToMicroUsbAdapter implements MicroUsbPhone { private final LightningPhone lightningPhone; public LightningToMicroUsbAdapter(LightningPhone lightningPhone) { this.lightningPhone = lightningPhone; } @Override public void useMicroUsb() { log.info("MicroUsb connected"); lightningPhone.useLightning(); } @Override public String recharge() { return lightningPhone.recharge(); } }

2. adaptee : LightningPhone.java

   1 2 3 4 5 6

   package net.dskim.desingpattern.adapter; public interface LightningPhone { String recharge(); void useLightning(); }

3. target : MicroUsbPhone.java

   1 2 3 4 5 6

   package net.dskim.desingpattern.adapter; public interface MicroUsbPhone { String recharge(); void useMicroUsb(); }

4. 클라이언트 : LightningToMicroUsbAdapterTest.java

   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

   package net.dskim.desingpattern.adapter; import static org.junit.jupiter.api.Assertions.assertEquals; import org.junit.jupiter.api.Test; import lombok.extern.slf4j.Slf4j; @Slf4j public class LightningToMicroUsbAdapterTest { // MicroUsbPhone 충전전용 메소드를 반드시 써야 한다고 가정한다. public String rechargeMicroUsbPhone(MicroUsbPhone microUsbPhone) { microUsbPhone.useMicroUsb(); return microUsbPhone.recharge(); } @Test public void lightningToMicroUsbAdapterTest() { Android android = new Android(); String androidRechargeResult = rechargeMicroUsbPhone(android); log.info("androidRechargeResult={}", androidRechargeResult); assertEquals("Recharge finished", androidRechargeResult); Iphone iPhone = new Iphone(); //rechargeMicroUsbPhone(iPhone); //iPhone에서 micro usb를 쓰려한다면 compile 에러 발생 String iphoneWithMicroUsbRechargeResult = rechargeMicroUsbPhone(new LightningToMicroUsbAdapter(iPhone)); log.info("iphoneWithMicroUsbRechargeResult={}", iphoneWithMicroUsbRechargeResult); assertEquals("Recharge finished", iphoneWithMicroUsbRechargeResult); } }

참고

• refactoring.guru : Adapter pattern
• wikipedia : Adapter pattern
• baeldung : The Adapter Pattern in Java

Java 디자인 패턴-09.Observer

(Java 디자인 패턴 스터디 모집 중 : https://github.com/bluedskim/javaDesignPatterns)

Observer 패턴 다이어그램

(출처:https://dev.to/danlee0528/design-pattern-the-observer-pattern-3oha)

해결하려는 문제 : 알림의 주체는 누구인가?

• push vs poll

  어떤 이벤트가 발생하면 진행되어야 할 후속 이벤트들이 있다면 이벤트를 발생하는쪽이 알려줘야(Push) 하는가? 아니면 이벤트를 수신하는 쪽이 이벤트를 관찰(Poll)하고 있어야 하는가?

• 알려줘야 할 대상(Subscriber)들을 소스코드에 하드코딩하여 관리해야 하는가

특징/용도

1. publisher-subscriber(pub-sub)이라고도 한다.
2. 객체들은 one(publisher)-to-many(subscriber) 관계를 가진다.
3. subscriber는 publisher알지만 publisher는 subscriber를 알지 못한다. 즉 관계는 단방향이다.

고려사항

1. event driven아키텍처의 분산 이벤트 관리에서 많이 사용된다(https://en.wikipedia.org/wiki/Observer_pattern)
2. 동시성 처리를 위해 observer가 subject-events를 수신할 때 멀티쓰레드로 동작할 필요도 있다.

클래스 다이어그램

소스

• PropertyChangeSupport 를 사용한 observer 패턴 샘플
• observable(Subject, Publisher) : NewsAgency.java

  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

  package net.dskim.desingpattern.observer; import java.beans.PropertyChangeListener; import java.beans.PropertyChangeSupport; /** * Subject(Publisher) */ public class NewsAgency { private String previousNews; private PropertyChangeSupport support; public NewsAgency() { support = new PropertyChangeSupport(this); } public void addPropertyChangeListener(PropertyChangeListener pcl) { support.addPropertyChangeListener(pcl); } public void removePropertyChangeListener(PropertyChangeListener pcl) { support.removePropertyChangeListener(pcl); } public void setNews(String news) { support.firePropertyChange("news", this.previousNews, news); this.previousNews = news; } }

• observer(Listener, Subscriber) : NewsChannel.java

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

  package net.dskim.desingpattern.observer; import java.beans.PropertyChangeEvent; import java.beans.PropertyChangeListener; /** * Listener(Subscriber) */ public class NewsChannel implements PropertyChangeListener { private String news; @Override public void propertyChange(PropertyChangeEvent evt) { news = (String) evt.getNewValue(); } public String getNews() { return news; } }

• client : ObserverTest.java

  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

  package net.dskim.desingpattern.observer; import static org.junit.jupiter.api.Assertions.assertEquals; import org.junit.jupiter.api.Test; import lombok.extern.slf4j.Slf4j; @Slf4j public class ObserverTest { @Test public void whenChangingPCLNewsAgencyState_thenONewsChannelNotified() { String newsName = "뉴스 제목"; NewsAgency observable = new NewsAgency(); NewsChannel observer1 = new NewsChannel(); NewsChannel observer2 = new NewsChannel(); observable.addPropertyChangeListener(observer1); observable.addPropertyChangeListener(observer2); observable.setNews(newsName); log.info("observer.getNews()={}", observer1.getNews()); assertEquals(observer1.getNews(), newsName); assertEquals(observer2.getNews(), newsName); } }

참고

• refactoring.guru : Observer
• baeldung : The Observer Pattern in Java
• wikipedia : Observer pattern

Java 디자인 패턴-08.Facade

(Java 디자인 패턴 스터디 모집 중 : https://github.com/bluedskim/javaDesignPatterns)

Facade 패턴 다이어그램

(출처:https://www.geeksforgeeks.org/facade-design-pattern-introduction/)

해결하려는 문제

1. 클라이언트에서 다른 객체들로의 참조들을 분리하여 클라이언트의 의존성을 줄이고 복잡성을 관리.

특징/용도

1. 구조적structural 디자인 패턴
2. 클라이언트에 Facade라는 단순화 된, 필요한 기능만 접근할 수 있는 레이어를 추가
3. 서드파티 라이브러리에 대한 직접적 의존성을 제거하여 교체를 쉽게 한다.
4. facade는 캡슐화된encapsulated 블랙박스.

구성요소

1. facade : target의 여러 인터페이스를 조합한 루틴이 정의된 객체
2. target : 원래는 클라이언트가 직접 참조해야 하는 객체
3. client : facade를 통해 target들을 사용(호출)하는 객체

고려사항

다른 유사한 패턴을 사용할 수도 있다.

1. Decorator : 원래의 소스를 감싸는 방식으로 인터페이스에 동적으로 기능을 추가한다.
2. Delegation : 상속을 통한 조합
3. Adapter : 어떤 인터페이스를 다른 인터페이스로 변환

클래스 다이어그램

소스

1. facade : ShapeMaker.java

   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

   package net.dskim.desingpattern.facade; /** * facade용 클래스 */ public class ShapeMaker { private Shape circle; private Shape rectangle; private Shape square; public ShapeMaker() { circle = new Circle(); rectangle = new Rectangle(); square = new Square(); } public String drawCircle() { return circle.draw(); } public String drawRectangle() { return rectangle.draw(); } public String drawSquare() { return square.draw(); } /** * 복잡한 로직을 감싼 facade 메소드 * @return */ public String drawAllShape() { return circle.draw() + rectangle.draw() + square.draw(); } }

2. target : Shape.java, Circle.java, Rectangle.java, Square.java
   • Shape.java

     1 2 3 4 5

     package net.dskim.desingpattern.facade; public interface Shape { String draw(); }

   • Circle.java

     1 2 3 4 5 6 7 8 9 10 11 12 13 14

     package net.dskim.desingpattern.facade; import lombok.extern.slf4j.Slf4j; @Slf4j public class Circle implements Shape { @Override public String draw() { String result = "Circle::draw()"; log.info(result); return result; } }

   • Rectangle.java

     1 2 3 4 5 6 7 8 9 10 11 12 13 14

     package net.dskim.desingpattern.facade; import lombok.extern.slf4j.Slf4j; @Slf4j public class Rectangle implements Shape { @Override public String draw() { String result = "Rectangle::draw()"; log.info(result); return result; } }

   • Square.java

     1 2 3 4 5 6 7 8 9 10 11 12 13 14

     package net.dskim.desingpattern.facade; import lombok.extern.slf4j.Slf4j; @Slf4j public class Square implements Shape { @Override public String draw() { String result = "Square::draw()"; log.info(result); return result; } }

3. client : ShapeMakerTest.java

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

   package net.dskim.desingpattern.facade; import static org.junit.jupiter.api.Assertions.assertEquals; import org.junit.jupiter.api.Test; public class ShapeMakerTest { @Test public void ShapeMakerFacadeTest() { ShapeMaker shapeMaker = new ShapeMaker(); assertEquals("Circle::draw()", shapeMaker.drawCircle()); assertEquals("Rectangle::draw()", shapeMaker.drawRectangle()); assertEquals("Square::draw()", shapeMaker.drawSquare()); assertEquals("Circle::draw()Rectangle::draw()Square::draw()", shapeMaker.drawAllShape()); } }

참고

• wikipedia : Facade pattern
• baeldung : Facade Design Pattern in Java
• tutorialspoint : Design Patterns - Facade Pattern

Java 디자인 패턴-07.State

(Java 디자인 패턴 스터디 모집 중 : https://github.com/bluedskim/javaDesignPatterns)

패턴 다이어그램

“어떤 객체의 상태에 따라 행위가 변경되는 경우 유용한 패턴” (출처:https://refactoring.guru/design-patterns/state)

해결하려는 문제

1. context의 상태에 따른 처리가 구분되는 경우 해당 구분로직을 context에 하드 코딩하게 되면 경우 확장성이 떨어진다.

특징/용도

1. 상태를 클래스화 하고 해당 동작들을 넣는다
2. 원래의 객체(context)는 현재 상태 객체의 참조를 가진다
3. context는 2개 이상의 상태를 동시에 가질 수는 없다

고려사항

1. State 패턴은 Strategy 패턴과 유사하다. 주요한 차이점은 상태객체들은 서로의 존재를 아는 반면 Strategy패턴에서는 Strategy간의 관련성은 없다는 것이다(https://refactoring.guru/design-patterns/state)

클래스 다이어그램

소스

1. Context : 상태를 가지고있는 객체(Package.java)

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

   package net.dskim.desingpattern.state.solution; /** * 주문 객체 */ public class Package { private PackageState currentState = new OrderedState(); public void setState(PackageState newState) { this.currentState = newState; } public PackageState getState() { return this.currentState; } /** * 상태 변경시 알려줄 대상 목록 반환 * @return */ public String getNotifyGetterList() { return currentState.getNotifyGetterList(); } }

2. State
   • OrderedState.java

     1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

     package net.dskim.desingpattern.state.solution; /** * 상태 객체-주문 */ public class OrderedState implements PackageState { /** * 알림 수신 대상자 목록 반환 */ @Override public String getNotifyGetterList() { return "shipper"; } @Override public String toString() { return "OrderedState"; } }

   • DelieveredState.java

     1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

     package net.dskim.desingpattern.state.solution; /** * 상태 객체-배송완료 */ public class DeliveredState implements PackageState { /** * 알림 수신 대상자 목록 반환 */ @Override public String getNotifyGetterList() { return "orderer"; } @Override public String toString() { return "DeliveredState"; } }

   • ReceivedState.java

     1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

     package net.dskim.desingpattern.state.solution; /** * 상태 객체-수령완료 */ public class ReceivedState implements PackageState { /** * 알림 수신 대상자 목록 반환 */ @Override public String getNotifyGetterList() { return "orderer,manager"; } @Override public String toString() { return "ReceivedState"; } }

3. client : StateTest.java

   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

   package net.dskim.desingpattern.state.solution; import static org.junit.jupiter.api.Assertions.assertEquals; import org.junit.jupiter.api.Test; import lombok.extern.slf4j.Slf4j; @Slf4j public class StateTest { @Test void stateTest() { Package pkg = new Package(); log.info("state={}", pkg.getState()); assertEquals("shipper", pkg.getNotifyGetterList()); pkg.setState(new DeliveredState()); log.info("state={}", pkg.getState()); assertEquals("orderer", pkg.getNotifyGetterList()); pkg.setState(new ReceivedState()); log.info("state={}", pkg.getState()); assertEquals("orderer,manager", pkg.getNotifyGetterList()); /* //CancelState를 추가하는 경우에도 Package 소스를 수정할 필요가 없다 pkg.setState(new CancelState()); log.info("state={}", pkg.getState()); assertEquals("shipper,manager", pkg.getNotifyGetterList()); */ } }

참고

• wikipedia : State pattern
• refactoring.guru : Design Patterns / Behavioral Patterns / State
• tutorialspoint : Design Patterns - State Pattern

Perl스크립트로 Http Get 요청하고 응답출력하기

리눅스/유직스 서버에서 http포트가 열려있는지, 웹서버가 떠있는지 등등을 확인 할 때 일반적으로 wget혹은 curl을 주로 사용한다.

wget도 curl도 없는 *nix서버는 보기 힘들지만 간혹 없는 경우도 있다 (JVM이라도 있다면 Java로 간단하게 프로그램을 짜서 돌리면 되지만 소스도 길고 컴파일도 해줘야 하니 불편하다 -.-).

그래서 perl스크립트는 없는지 구글링 해보니 역시나 있다.

다음은 Http Get 요청 수행 후 응답을 출력하는 perl 스크립트다.

1
2
3

#!/usr/bin/perl
use LWP::Simple;
getprint($ARGV[0]) if $ARGV[0];

실행은 다음과 같이 한다.

$ ./lwp-get.pl http://bluedskim.github.io

wget, curl은 없어도 perl이 없는 *nix서버는 없으니 그나마 다행이다.

Java 디자인 패턴-05.Proxy

(Java 디자인 패턴 스터디 모집 중 : https://github.com/bluedskim/javaDesignPatterns)

패턴 다이어그램

“특정 클래스 대신 그 클래스와 동일한 인터페이스를 구현한 래퍼 wrapper 클래스 Proxy 를 이용한다” (출처:https://refactoring.guru/design-patterns/proxy)

해결하려는 문제

1. 특정 객체에 대한 접근을 통제할 수 있는 일관된 방법이 필요할 때(보안, 권한 체크).
2. 네트워크 접속, 메모리에 탑재된 대형 객체, 파일, 그 외 생성에 큰 비용이 발생하거나 복제가 불가능한 리소스들 등에 대한 캐시가 필요할 때.

특징/용도

1. proxy클래스는 client의 요청을 subject에 단순히 전달하는 목적으로 사용하거나 subject의 메소드를 호출하기 이전, 이후에 특정 로직을 추가고자 할 때 사용한다.
2. client입장에서는 proxy를 사용하든 subject를 사용하든 기능상 차이는 없다(black box).
3. 지연된 초기화 Lazy initialization (virtual proxy) : 클래스 생성시 초기화 하는 것이 아니라 해당 객체의 메소드를 호출 할 때 초기화 하도록 함

고려사항

1. 유사한 패턴과 비교
   • 어댑터 패턴은 subject와는 다른 인터페이스를 제공하는 반면 프록시는 동일한 인터페이스을 제공한다. 데코레이터 패턴은 subject보다 향상된(기능 추가) 인터페이스를 제공한다.
   • 파사드 패턴은 복잡한 엔티티들의 초기화에 대한 버퍼를 제공한다는 점에서 proxy패턴과 유사하다. 하지만 프록시는 동일한 인터페이스을 제공한다는 점에서 차이가 있다.
   • 데코레이터 패턴과 프록시 패턴은 복합 composition 을 사용한다는 점에서는 동일하지만 프록시 패턴은 subject 에 대한 라이프 사이클을 proxy내부에서 관리하는 반면 데코레이터 패턴에서는 클라이언트가 대상의 라이프사이클을 관리한다는 차이가 있다.
2. Proxy내에서 클라이언트 목록을 관리할 수도 있다. 사용하는 클라이언트가 없다면 리소스를 해제하는 등의 처리작업 수행하고자 할 때 유용하다.

클래스 다이어그램

소스

1. Proxy : Subject를 대체하고자 하는 객체(Proxy.java)

   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

   package net.dskim.desingpattern.proxy.solution; import lombok.extern.slf4j.Slf4j; import net.dskim.desingpattern.proxy.HeavyResource; import net.dskim.desingpattern.proxy.Resource; /** * Proxy객체도 역시 Resource 인터페이스를 구현해야 한다. */ @Slf4j public class Proxy implements Resource { /** * Proxy객체가 다루어야 할 Subject객체 */ private HeavyResource heavyResource; public Proxy() { super(); log.info("Proxy 생성 완료"); } /** * 처리 메소드를 호출 시 * 지연된 초기화Lazy initialize 하도록 한다. */ @Override public String process() { // null check 하여 불필요한 초기화를 피한다. if (heavyResource == null) { this.heavyResource = new HeavyResource(); } return heavyResource.process(); } }

2. Subject : 숨기고자 하는 객체(HeavyResource.java)

   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

   package net.dskim.desingpattern.proxy; import lombok.extern.slf4j.Slf4j; /** * Subject 객체 * */ @Slf4j public class HeavyResource implements Resource { /** * 생성자 호출시 초기화에 많은 시간과 자원이 소모된다고 가정한다. */ public HeavyResource() { super(); log.info("HeavyResource 초기화 중..."); log.info("HeavyResource 초기화 완료"); } /** * 실제 어떤 처리를 하는 메소드 */ @Override public String process() { log.info("processing..."); return "processed"; } }

3. Resource : proxy와 subject가 구현해야 하는 인터페이스(Resource.java)

   1 2 3 4 5 6 7 8

   package net.dskim.desingpattern.proxy; /** * 모든 리소스가 구현해야 하는 인터페이스 */ public interface Resource { public String process(); }

참고

• wikipedia : Proxy pattern
• refactoring.guru : Design Patterns / Structural Patterns / Proxy
• tutorialspoint : Design Patterns - Proxy Pattern
• baeldung : The Proxy Pattern in Java

Java 디자인 패턴-04.Iterators

(Java 디자인 패턴 스터디 모집 중 : https://github.com/bluedskim/javaDesignPatterns)

패턴 다이어그램

“하나의 집합Collection의 모든 요소를 모두 접근하는 방법은 여러가지가 있을 수 있다” (출처:https://refactoring.guru/design-patterns/iterator)

해결하려는 문제

1. 집합collection의 각각 항목 모두를 접근할 수 있는 일관된 방법을 제공.

특징/용도

1. behavioral design patterns의 하나
2. iterator는 해당 집합의 실제 구현과는 무관하다(Information Hiding, Separation of concerns).

고려사항

1. Java 1.2 부터 Iterable, Iterator 인터페이스가 포함되어 있으므로 직접 만들 필요가 없다.

클래스 다이어그램

소스

1. target
   • MyIterable.java : 컨테이너가 구현해야하는 인터페이스

     1 2 3 4 5 6 7

     package net.dskim.desingpattern.iterator; import java.util.Iterator; public interface MyIterable extends Iterable<Object> { public Iterator<Object> reverseIterator(); }

   • ArrayContainer.java : 배열을 가지고 있는 객체

     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

     package net.dskim.desingpattern.iterator; import java.util.Iterator; /*** * 배열을 위한 컨테이너 */ public class ArrayContainer implements MyIterable { Iterator<Object> arrayIterator; Iterator<Object> reverseArrayIterator; public ArrayContainer(Object[] array) { arrayIterator = new ArrayIterator(array); reverseArrayIterator = new ReverseArrayIterator(array); } @Override public Iterator<Object> iterator() { return arrayIterator; } @Override public Iterator<Object> reverseIterator() { return reverseArrayIterator; } }

   • ArrayIterator.java : 배열학목을 순서대로 접근하기 위한 iterator

     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

     package net.dskim.desingpattern.iterator; import java.util.Iterator; import java.util.NoSuchElementException; import lombok.extern.slf4j.Slf4j; /*** * 배열을 위한 iterator */ @Slf4j public class ArrayIterator implements Iterator<Object>{ Object[] array; int index = 0; public ArrayIterator(Object[] array) { this.array = array; } @Override public boolean hasNext() { return index <= array.length - 1; } @Override public Object next() { if(!hasNext()) throw new NoSuchElementException(); return array[index++]; } }

   • ReverseArrayIterator.java : 배열학목을 역순으로 접근하기 위한 iterator

     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

     package net.dskim.desingpattern.iterator; import java.util.Iterator; import java.util.NoSuchElementException; /*** * 배열 index가 높은 항목에서 낮은 항목으로 탐색하는 iterator */ public class ReverseArrayIterator implements Iterator<Object>{ Object[] reverseArray; int nextIndex = 0; public ReverseArrayIterator(Object[] originalArray) { reverseArray = new Object[originalArray.length]; for(int reverseArrayIndex = 0 ; reverseArrayIndex < reverseArray.length ; reverseArrayIndex++){ reverseArray[reverseArrayIndex] = originalArray[originalArray.length - 1 - reverseArrayIndex]; } } @Override public boolean hasNext() { return nextIndex <= reverseArray.length - 1; } @Override public Object next() { if(!hasNext()) throw new NoSuchElementException(); return reverseArray[nextIndex++]; } }

2. client : IteratorTest.java

   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 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59

   package net.dskim.desingpattern.iterator; import static org.junit.jupiter.api.Assertions.assertEquals; import java.util.ArrayList; import java.util.Iterator; import java.util.List; import org.junit.jupiter.api.Test; import lombok.extern.slf4j.Slf4j; @Slf4j public class IteratorTest { /** * java.util.List의 iterator테스트 */ @Test void listIteratorTest() { List<String> names = new ArrayList<String>(); names.add("Ajay"); names.add("Vijay"); names.add("Martin"); names.add("Racheal"); names.add("Kim"); Iterator<String> namesIterator = names.iterator(); int i = 0; while (namesIterator.hasNext()) { assertEquals(names.get(i++), namesIterator.next()); } } @Test void arrayIteratorTest() { String[] names = { "Ajay" ,"Vijay" ,"Martin" ,"Racheal" ,"Kim" }; MyIterable arrayContainer = new ArrayContainer(names); int i = 0; Iterator<Object> arrayIterator = arrayContainer.iterator(); while (arrayIterator.hasNext()) { assertEquals(names[i++], arrayIterator.next()); } i = 0; Iterator<Object> reverseArrayIterator = arrayContainer.reverseIterator(); while (reverseArrayIterator.hasNext()) { assertEquals(names[names.length - (++i)], reverseArrayIterator.next()); } } }

참고

• wikipedia : Iterator pattern
• tutorialspoint : Design Patterns - Iterator Pattern
• dzone : Iterator Design Pattern In Java
• refactoring.guru : Design Patterns / Behavioral Patterns / Iterator

Java 디자인 패턴-03.Command

(Java 디자인 패턴 스터디 모집 중 : https://github.com/bluedskim/javaDesignPatterns)

(출처:https://refactoring.guru/design-patterns/command)

해결하려는 문제

1. view(presentation)과 비즈니스 로직의 직접 연관을 제거(행위가 소스에 하드코딩되어 있다면 런타임에 추가/변경이 불가능)

용도/목적

1. 조건문이 많은 복잡한 로직을 간단하게
2. invoker와 receiver 사이에 command를 두어 직접 연관을 제거하여 새로운 command가 추가되더라도 invoker를 수정할 필요가 없음

특징

1. 행위behavioral 패턴
2. 눈에 보이지 않는 무형의 개념(행위)도 객체화 할 수 있다.

고려사항

1. command용 interface(TextFileOperation.java)는 @FunctionalInterface로 할 수 있다.

클래스 다이어그램

소스

1. client : command를 초기화하고 invoker를 호출

   • TextFileOperationExecutorWithoutCommandTest.java : command를 사용하지 않은 샘플 테스트용

     1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23

     package net.dskim.desingpattern.command; import static org.junit.jupiter.api.Assertions.assertEquals; import org.junit.jupiter.api.Test; import lombok.extern.slf4j.Slf4j; @Slf4j public class TextFileOperationExecutorWithoutCommandTest { @Test public void executeOperationTest() { TextFileOperationExceutorWithoutCommand textFileOperationExecutor = new TextFileOperationExceutorWithoutCommand(); String openTextFileResult = textFileOperationExecutor.execute(new TextFile("file1.txt"), "open"); log.info("openTextFileResult={}", openTextFileResult); assertEquals("Opening file file1.txt", openTextFileResult); String saveTextFileResult = textFileOperationExecutor.execute(new TextFile("file2.txt"), "save"); log.info("saveTextFileResult={}", saveTextFileResult); assertEquals("Saving file file2.txt", saveTextFileResult); } }

   • TextFileOperationExecutorWithCommandTest.java : command를 사용한 샘플 테스트용

     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

     package net.dskim.desingpattern.command; import static org.junit.jupiter.api.Assertions.assertEquals; import org.junit.jupiter.api.Test; import lombok.extern.slf4j.Slf4j; @Slf4j public class TextFileOperationExecutorWithCommandTest { @Test public void executeOperationTest() { TextFileOperationExecutorWithCommand textFileOperationExecutor = new TextFileOperationExecutorWithCommand(); String openTextFileOperationResult = textFileOperationExecutor.executeOperation(new OpenTextFileOperation(new TextFile("file1.txt"))); log.info("openTextFileOperationResult={}", openTextFileOperationResult); assertEquals("Opening file file1.txt", openTextFileOperationResult); String saveTextFileOperation = textFileOperationExecutor.executeOperation(new SaveTextFileOperation(new TextFile("file2.txt"))); log.info("saveTextFileOperation={}", saveTextFileOperation); assertEquals("Saving file file2.txt", saveTextFileOperation); String udateTextFileOperation = textFileOperationExecutor.executeOperation(new UpdateTextFileOperation(new TextFile("file2.txt"))); log.info("udateTextFileOperation={}", udateTextFileOperation); assertEquals("Updating file file2.txt", udateTextFileOperation); } }

2. invoker : command를 받아 interface에 정의된 메소드를 호출하고 필요 시 이력 저장용 list에 저장

   • TextFileOperationExecutorWithCommand.java

     1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

     package net.dskim.desingpattern.command; import java.util.ArrayList; import java.util.List; /** * command 패턴 샘플 invoker 클래스 * 새로운 처리가 추가 되더라도 이 소스를 수정할 필요 없음 */ public class TextFileOperationExecutorWithCommand { /** * 실행 이력 저장용. 이 샘플에서는 불필요 */ private final List<TextFileOperation> textFileOperations = new ArrayList<>(); public String executeOperation(TextFileOperation textFileOperation) { textFileOperations.add(textFileOperation); return textFileOperation.execute(); } }

3. receiver : 실제 로직이 정의된 클래스

   • TextFile.java

     1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

     package net.dskim.desingpattern.command; public class TextFile { private String name; public TextFile(String name) { this.name = name; } public String open() { return "Opening file " + name; } public String save() { return "Saving file " + name; } public String update() { return "Updating file " + name; } }

4. command : command 객체

   • TextFileOperation.java : command용 interface

     1 2 3 4 5 6 7 8 9

     package net.dskim.desingpattern.command; /** * command용 interface */ @FunctionalInterface public interface TextFileOperation { String execute(); }

   • OpenTextFileOperation.java : 파일 open하기 command

     1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

     package net.dskim.desingpattern.command; /** * 파일열기 command */ public class OpenTextFileOperation implements TextFileOperation { private TextFile textFile; public OpenTextFileOperation(TextFile textFile) { this.textFile = textFile; } @Override public String execute() { return textFile.open(); } }

   • SaveTextFileOperation.java : 파일 save하기 command

     1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

     package net.dskim.desingpattern.command; /** * 파일저장 command */ public class SaveTextFileOperation implements TextFileOperation { private TextFile textFile; public SaveTextFileOperation(TextFile textFile) { this.textFile = textFile; } @Override public String execute() { return textFile.save(); } }

참고

• wikipedia : Command pattern
• baeldung : The Command Pattern in Java
• Alvin Alexander : A Java Command Design Pattern example
  • A Java Action, ActionListener, and AbstractAction example

Java 디자인 패턴-02.Factory Method

(Java 디자인 패턴 스터디 모집 중 : https://github.com/bluedskim/javaDesignPatterns)

(출처:Abstract Factory Design Pattern in C#)

해결하려는 문제

1. 생성자를 직접 호출해서 객체를 생성하는 경우 해당 객체와 클라이언트가 강하게 결합되게 되어 확정성이 떨어진다.

개요

• 생성자를 호출하지 않고 생성하기 위한 패턴(생성될 클래스를 지정하지 않는다)
• 해당 클래스를 사용하는 클래스에 하드코딩을 없앨 수 있다.

클래스 다이어그램

소스

• Shape.java : 도형(인터페이스)

  1 2 3 4 5

  package net.dskim.desingpattern.factorymethod; public interface Shape { String draw(); }

• 도형 객체들 : Shape.java 를 implement
  • Rectangle.java : 사각형

    1 2 3 4 5 6 7 8

    package net.dskim.desingpattern.factorymethod; public class Rectangle implements Shape { @Override public String draw() { return "draw Rectangle"; } }

  • Circle.java : 원

    1 2 3 4 5 6 7 8

    package net.dskim.desingpattern.factorymethod; public class Circle implements Shape { @Override public String draw() { return "draw Circle"; } }

  • Square.java : 정사각형

    1 2 3 4 5 6 7 8

    package net.dskim.desingpattern.factorymethod; public class Square implements Shape { @Override public String draw() { return "draw Square"; } }

• ShapeFactory.java : 도형 팩토리(Virtual Constructor)

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

  package net.dskim.desingpattern.factorymethod; public class ShapeFactory { // use getShape method to get object of type shape public Shape getShape(String shapeType) { if (shapeType == null) { return null; } if (shapeType.equalsIgnoreCase("CIRCLE")) { return new Circle(); } else if (shapeType.equalsIgnoreCase("RECTANGLE")) { return new Rectangle(); } else if (shapeType.equalsIgnoreCase("SQUARE")) { return new Square(); } return null; } }

• 클라이언트 : FactoryMethodTest.java

  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

  package net.dskim.desingpattern.factorymethod; import static org.junit.jupiter.api.Assertions.assertEquals; import org.junit.jupiter.api.Test; import lombok.extern.slf4j.Slf4j; @Slf4j public class FactoryMethodTest { @Test public void decoratorTest() { ShapeFactory shapeFactory = new ShapeFactory(); // get an object of Circle and call its draw method. Shape shape1 = shapeFactory.getShape("CIRCLE"); // call draw method of Circle String drawResult = shape1.draw(); log.info("className={}, drawResult={}", shape1.getClass().getSimpleName(), drawResult); assertEquals("draw Circle", drawResult); // get an object of Rectangle and call its draw method. Shape shape2 = shapeFactory.getShape("RECTANGLE"); // call draw method of Rectangle drawResult = shape2.draw(); log.info("className={}, drawResult={}", shape2.getClass().getSimpleName(), drawResult); assertEquals("draw Rectangle", drawResult); // get an object of Square and call its draw method. Shape shape3 = shapeFactory.getShape("SQUARE"); // call draw method of square drawResult = shape3.draw(); log.info("className={}, drawResult={}", shape3.getClass().getSimpleName(), drawResult); assertEquals("draw Square", drawResult); } }

참고

• refactoring.guru : Factory Method
• tutorialspoint : Design Pattern - Factory Pattern
• wikipedia : Factory method pattern
• baeldung : Introduction to Creational Design Patterns

Java 디자인 패턴-01.Singleton

(Java 디자인 패턴 스터디 모집 중 : https://github.com/bluedskim/javaDesignPatterns)

(출처 : refactoring.guru : Singleton pattern)

해결하려는 문제

1. 공유된 자원은 대체로 한정적이다. 이 자원을 무분별하게 사용하는 경우 쉽게 고갈될 수 있다.