나도 ai를 로컬에 띄워서 간단한건 공짜로 써보고싶다!!!

도커 띄우기

자자 시놀로지 서버에 띄워봅시다. 올라마 이미지 다운로드 딸깍

docker 으로 띄워보자

• 포트는 통상적으로 11434 쓰는것같아서 따라했다.
• /root/.ollama 에 데이터가 저장되는것 같아 볼륨도 따로 잡아줬다.

docker run -d -p 11434:11434 -v /volume1/docker/ollama:/root/.ollama --name ollama-pack ollama/ollama:latest

도커 띄우기 -완-

모델 다운받기

처음에 들어가서 보면 사용할수 있는 모델이 없다는걸 확인할 수 있다.

ollama list

다음 사이트를 들어가보자 https://ollama.com/search

아주 많은 모델들이 있는데, 이름이 예쁜걸로 다운받아보자

나는 llava 를 선택했다.

해당 모델을 설치하는데 한참 걸리고있다.

ollama pull [이미지명]

다운로드 -완-

이제 확인해보면 내가 설치한 모델이 뜬다.

ai 질문해보기

먼저, 홈페이지에서 사용법이 나와있다.

모델 사용하기 (모델에 접속)

해당 모델에 접속 해보자

ollama run [모델명]

이제 이녀석에게 질문을 해보자.

• 2 + 3이 뭔지아니?

(감격의 눈물...)

이미지 내부에서 명령어가 어떤게 있는지 알려면 다음으로 볼 수 있는데, 이것저것 나오긴 한다.

/?

모델 사용하기(api 요청)

모델에서 정상 동작하는걸 봤으니, 이제 내가 사용하는 api 형태로 사용하도록 요청해보자.

홈페이지의 예시처럼 curl 명령어로 요청할 예정

이벤트 스트림 형태로 요청이 오는걸 확인할 수 있다!

이제 개인 프로젝트에서 간단한 ai 는 공짜로 사용할수 있겠다!

터미널에서 클로드코드를 실행하려면 claude. 한글로는 치명ㄷ 입니다.

• 이왕 돈내고 쓰는거 기능을 좀더 잘 써보자!

설치

npm install -g @anthropic-ai/claude-code

다음 URL 에서 확인할 수 있다. https://www.claude.com/product/claude-code

최초 실행

claude

바로 claude code 가 실행된다. 클로드코드 버전, 사용하고있는 모델, 현재 위치를 확인할 수 있다.

이전 세션 가져오기

claude -r
또는
claude --resume

클로드 코드로 개발하다보면 하루에 토큰수도 정해져있고... 오늘은 여기까지만 하고싶기도하고... 뭐 그런 이유들로 마무리하지않고 다음번에 또다시 해야하는 경우가 있다. 그때 터미널에서 위 옵션을 통해 과거의 세션에 연결할 수 있다.

• 폴더마다 세션 히스토리가 각자 저장된다.

가장 최근 세션 불러오기

claude -c
또는
claude --continue

--resume 은 히스토리를 불러와서 고른다고 한다면, 해당 명령어는 가장 최근에 실행했던 세션을 다시 열어준다.

모델 선택하기

/model

claude code cli 에 입장하고나서, 모델을 고를 수 있다

• Opus 모델은 비싼 요금제에서만 되는것 같다....
• 분명히 글쓸땐 안됬었는데, 지금은 됩니다.

(2025.10.5 기준)

(2025.12.19 기준)

사용량 확인

/usage

• 현재 기준으로 얼만큼 사용했는지 확인할 수 있다.
• Current Session 은 약 4-5시간마다, Current week 는 일주일마다 초기화 된다.

줄바꿈 활성화

/terminal-setup

• 해당 명령어로 줄바꿈을 활성화하고, windows 는 shift+enter, mac은 option+enter 으로 줄바꿈을 할 수 있다.

내 레포 읽게 하기

/init

바로 "해줘" 를 할수 있겠지만, 먼저 내 레포를 읽고 정리할 시간을 주자.

혼자서 여기저기 들쑤시며 볼수있게 권한을 열어달라고 요청한다.

혼자 만족하고 나면, CLAUDE.md 마크다운 파일을 생성한다.

init 의 결과물을 확인할 수 있다.

잠깐잠깐 CLAUDE.md 가 뭐냐면

claude code 에게 지침을 적어두는 메모라고 보면 된다. -> 메모리에 저장시키는 느낌으로! 대화를 시작할 때 마다 이 마크다운 파일을 먼저 읽게되고, /init 명령어로 만들어진 CLAUDE.md 파일을 보면 그냥 구어체로 적혀있는걸 볼 수 있다 -> 형식에 제한이 없음

다음과 같은 기본 값들을 미리 넣어줄 수 있다.

• 코드 포맷팅 스타일
• 자주 쓰는 명령어
• 중요한 파일
• 선호하는 코딩 패턴

그리고 # 을 누르면 메모에 빠른 추가를 할 수 있다!

해당 프로젝트에만 적용할지, 전체로 적용할지 지정할 수 있는 모습이다.

명령어 권한 쥐어주기

/permissions

사용하다보면 뭔가 자꾸 권한을 달라고 하는데, 생성/수정/삭제 요청뿐만아니라 읽기 권한도 달라고 한다. 좀 귀찮은 일인데, 권한을 처음부터 지정해서 줄 수 있다.

어떤룰을 추가할지

어떤 명령어에 대해

범위는??

• Project settings (local) : git 에 올리지 않고 로컬에서만 사용하도록 저장
• Project settings : git 에 까지 세팅을 올리도록 저장
• User settings : 내 컴퓨터에 글로벌 세팅으로 저장

글로벌 세팅으로 했었고, 확인해보면 ls 명령어가 allow permissions 에 들어간걸 확인할 수 있다.

특정 파일만 읽게 하기

@

프로젝트 전체를 읽지 않아도 될때, 토큰을 적게 사용하기위한 컨트롤 이라 볼수있다. 혹시 다른 파일을 더 읽어야 할것 같다면 알아서 읽어도되냐고 접근권한을 물어본다.

글자 말고 더 추가하고싶다!

URL

• URL 을 그대로 붙여넣으면, 해당 웹페이지의 내용을 읽는다!

이미지 추가하기

• 터미널에 이미지를 드래그 앤 드롭을 하면 파일이 인풋으로 들어간다!

나만의 커스텀 명령어 만들기

.claude/commands/ 디렉토리에 마크다운 파일 추가

디렉토리에 마크다운 파일 추가를 해보자

/ 를 하면 나만의 커스텀 명령어가 나온다!!

그리고 마크다운 파일에 $ARGUMENTS 를 통해 인자값도 넘겨줄 수 있다.

cat babi.md
> refactoring code in $ARGUMENTS.

이 외에 많은것들이 존재하는데, 생각날때마다 추가하도록 하겠다.

mac 기준 설치 brew install jmeter

또는 여기서 설치 https://jmeter.apache.org/download_jmeter.cgi

mac 기준으로 설치 완료이후 터미널에 그냥 치면 창이 뜬다

jmeter

jmeter 실행 완료~

설정값 추가 a-z

부하테스트를 하기 전에 스레드를 추가해보자

• Number of Threads(users) : 몇명이?
• Ramp-up period (seconds) : 몇초동안?
• Loop Count : 몇번?

추가로 헤더값이 필요하다면 헤더 매니저도 추가해보자

하단에 Add 버튼으로 추가 가능하다. key-value 형태로 넣자

이제 테스트할 서버 정보 및 엔드포인트 추가하자

주요 데이터로는 다음처럼이 있을수 있겠다

• 서버 DNS 또는 IP
• port
• http method
• 엔드포인트
• 데이터

그럼 결과를 받아보는것도 추가해보자. 좀 여러가지가 있는데 직접 추가해서 비교해보면 좋을것 같다.

결과 화면 까지 추가한 뒤 상단에 시작 버튼을 누르면 여태 준비한대로 테스트가 실행된다.

경고 팝업창이 뜨긴하는데, 저장하라는 것 일뿐 안 해도 상관없다.

• 만들어둔대로 실행되고, 성공/실패 값이 결과 화면값에 노출된다. (결과 리스너를 여러개 붙여놨다면, 모든 리스너에 기록된다)

• 조금씩 올려가면서 vuser 및 loop 를 늘려가며 부하테스트를 해보자

예전에 관짝닫고 들어간녀석 아니었나요?

2022년부터 지원을 안한다곤 하긴하지만, 관공서등 아직도 쓰는곳이 있다고 한다

사내에서도 지원을 안한다고 나와있긴하지만 간혹 VOC 로 internet explorer 로 하면 안된다는 이슈가 인입되고있어, 최소한으로 지원을 하고있긴하다

왜안켜져

어휴 이놈 켜지지도 않는다

• 병합됬다고 이제는 엣지가 켜진다. 관공서에서는 도대체 어케 사용하나요

지원하지 않는다고 발표한 2022년부터 많은 edge 대신 internet explorer 켜기 블로그 글이 존재하는데, 나는 성공한게 없었다...

여태 해봤는데 실패 매드무비 리스트

• BHO 폴더 삭제
• 기본 프로그램 설정
• Edge 자동 실행 레지스트리 변경
• PC 업데이트 다운그레이드

대신 edge에서 internet explorer 모드에서 켜기로 켜줬다.

internet explorer 모드로 켜기

edge 로 사이트 이동한 뒤, 우측 상단의 ... 버튼을 눌러 Internet Explorer 모드에서 다시 로드 버튼을 누른다

대부분의 페이지는 Edge에서 잘 작동한다는 기가막힌 팁이 있으니 다들 꼭 기억하자.

콘솔창을 보면서 디버깅해야하는데 콘솔창에 아무것도 안나오네;;

Edge 의 IE 모드는 내부적으로 Internet Explorer 엔진을 사용하기 때문에, 일반적인 Edge 개발자 도구에서는 콘솔 로그가 표시되지 않습니다.

다 방법이 있습니다

ctrl + r 을 눌러 실행창을 켜서 다음을 입력하자

• %systemroot%\system32\f12\IEChooser.exe

그럼 IE 중에 선택할수있는 대상이 나오는데, 콘솔창을 띄우고싶은걸 선택하자

캬;; 이제 해피 디버깅타임

• 다들 부탁입니다. 이제 인터넷 익스플로어는 보내주자구요

mkfile

man mkfile 을 보면 세부적인 내용을 확인할수있는데 옵션이 많은 명령어는 아니다. mkdir 이랑 비슷하군

사용

mkfile [옵션] [파일크기] [파일명]

• 파일 크기는 바이트 기준이다.
• suffix 에 b, k, m, g 등이 올수있다.

ex) mkfile 100m 100m.txt : 100m.txt 이름을 가진 100mb 크기의 파일을 생성

옵션

com.mongodb.MongoCommandException: Command failed with error 20 (IllegalOperation): 'Transaction numbers are only allowed on a replica set member or mongos' on server 127.0.0.1:27017. The full response is {"ok": 0.0, "errmsg": "Transaction numbers are only allowed on a replica set member or mongos", "code": 20, "codeName": "IllegalOperation"}

spring boot 와 mongodb를 사용하고 있는데 @Transactional 어노테이션을 쓰니 위와같은 에러가 발생한다.

에러에서 확인할 수 있듯, replica set 에서만 동작이 가능하다는 의미다.

• 해당 내용은 여기 블로그와 저기 블로그에서 정리를 기가막히게 해놓았으니 참고하면 좋을것같다.

로그 확인...

디버그 모드로 로그를 찍고, 서버 연결시 수초마다 한번씩 다음과 같이 로그가 찍히는데 type=STANDALONE 이라는 로그를 확인할 수 있다.

2025-05-29T17:18:31.092+09:00 DEBUG 46252 --- [127.0.0.1:27017] org.mongodb.driver.cluster               : Updating cluster description to  {type=STANDALONE, servers=[{address=127.0.0.1:27017, type=STANDALONE, roundTripTime=13.6 ms, state=CONNECTED}]
2025-05-29T17:18:31.093+09:00 DEBUG 46252 --- [127.0.0.1:27017] org.mongodb.driver.cluster               : Checking status of 127.0.0.1:27017

해당 타입을 replica set 으로 동작하도록 변경해보자!

로컬에서도 복제본으로..!

일단 나는 MongoDB를 homebrew 으로 설치했었었다.

그리고 설정파일은 /opt/homebrew/etc/mongod.conf 경로에 있었다.

설정파일 하위에 다음과 같이 레플리카 설정을 추가하자.

replication:
  replSetName: rs0

그리고 mongodb를 재시작 해주자.

리스트를 확인하고 mongodb 에 해당하는 서비스를 재시작

brew services list

brew services restart mongodb-communitiy

그리고 다시 로그 확인해봤는데 뭔가 이상하다. type=REPLICA_SET이 되긴 했는데, 내부 설정이 TYPE=REPLICA_SET_GHOST 라고 되어있고 여전히 동작하지 않는다.

찾아보니 최초에 한번 초기화작업을 해줘야한다고 한다.

mongosh 접속해서 설정해주자.

// mongosh 접속 (없으면 설치)
mongosh

// 상태값 확인
rs.status()

// 초기화
rs.initiate()

이제 헐레벌떡 로그확인 하러 가자

성공~

왜 나한테만 이런 시련이

흠....

사실 왜 발생했는지는 모른다. Intellij 에서 스프링 서버를 실행하려고 했는데, 다음과 같은 에러가 발생한다

Gradle could not start yout build.
> could not create service of type FileHasher using BuildSessionService.createFileHasher()
  > cannot lock file hash cache as it has already been locked by this process

해결....

• 껐다켜봤다 -> 안된다
• .gradle 폴더 삭제했다 -> 안된다
• intellij 캐시 삭제했다 -> 안된다
• 재부팅했다 -> 안된다

그래서 구글에 찾아보니 스택오버플로우에서 다음과 같이 하라고 한다.

// gradle 과 관련된 실행 프로세스 찾기
ps aux | grep gradle

// 해당 실행 프로세스 삭제
kill -9 <PID>

• ps aux | grep gradle 명령어를 통해 다음 두가지 프로세스가 백그라운드에서 실행되고 있는걸 확인했다.

• 아무리봐도 44540 PID 프로세스가 gradle 관련 프로세스처럼 보이는데, 62363 PID 프로세스를 죽이려하니 failed: no such process 가 발생한다 (왜인지 아는 사람은 알려주면 감사하겠습니다..)

• 다행히 이제 gradle 으로 실행이 가능해졌다!

실행중인 스프링 어플리케이션에서 힙덤프 파일을 뜨고싶다

JCMD

공식문서에서 자세한 정보를 확인할 수 있다.

• JVM 환경을 진단 명령을 하는 용도로 사용된다.
• 로컬에서 실행중인 Java 프로세스
• JDK 에 포함되어있다.

힙덤프뜨기!!!

일단 지금 실행중인 프로세스가 어떤게 있는지 확인해보자.

jcmd -l

기본으로 떠있는게 다음과 같다.

이제 스프링 프로젝트를 실행한뒤, 실행중인 프로세스를 확인해보자 39117 라는 PID를 가진 어플리케이션이 떴다!

어떤 명령어들을 할수 있을지 확인해보자 다음 명령어로, jcmd에 어떤 command를 사용할수있는지 확인할 수 있다. 중간에 보면 우리가 하려는 힙덤프 명령어도 있다.

jcmd <PID> help

다음 명령어로 힙덤프를 떠보자

jcmd <PID> GC.heap_dump <저장경로>

힙덤프파일 완성~ 이제 힙덤프파일 분석하러가자....

포트포워딩 하고싶다!!!!!

내 공유기의 IP를 알아보자

공유기에 접속하려면 IP를 알아야한다. 통상적으로 각 통신사에서는 다음과 같은 주소로 접속할 수 있다 (잘 모름)

직접 확인하고 싶다면 다음과 같은 명령어로 확인하자

• 본인 컴퓨터는 MAC 이라 netstat -nr | grep default 으로 확인했다.

접속해서 바꿔보자

공유기 개인정보 빼고 가렸지만, 하여간 접속했다. (LG 공유기임)

접속하면 로그인해라고 팝업이 뜨는데, 공유기에 찾아보면 관리자 비밀번호가 따로 기재되어있다. 적어주자

• GNB - 네트워크 설정 - NAT 설정으로 들어가면

• 짜잔 포트포워딩을 할수있다.

• 손글씨 힘드네 하여간 서비스 포트 = 외부에서 들어오는 포트 라고 생각하면 된다
• 나는 내부 시놀로지로 들어가도록 해야하기 때문에 내부 IP 주소에는 시놀로지 IP를 기재했다

• 정상적으로 설정하면 목록에선 다음과 같이 확인할 수 있다.

올해초에 시놀로지 구매해서 이것저것 서버 띄우면서 잘 놀다가, 이사오고나서 놓았었다. 오랜만에 다시 들어가서 하려니 도커로 띄워놓은 젠킨스 설정 바꾸고 젠킨스 들어가니 처음부터 세팅하라는 화면이 나온다.

• 난 예전에 다 했던건데;;

아 왜날라가요

젠킨스의 설정파일을 내가 따로 저장을 안했으니까!!! 당연하게도 젠킨스의 설정파일은 도커에서 젠킨스를 실행하여 어딘가에 저장될텐데 내가 따로 외부에 저장한게 없었다. 그냥 컨테이너 내리고 재시작하니 다시 초기세팅이 되어버린것.

공식문서에서도 한글로 안해줬을뿐 말해줬다.

다시 붙여보자

• 공식문서에서도 도커 볼륨 잡아라고 했으니 직접 볼륨 붙여본다.
• 시놀로지는 Contianer Manager 를 통해 CLI 가 아니라 마우스 딸깍으로 설정 가능하다.
• 볼륨도 붙였겠다 다시 시작한다.
• 권한 이슈면 해당 폴더는 누구든 접근할수 있도록 하자!
• 권한을 nobody로 변경하여 해치웠다.
• 그래도 똑같이 Permission Denied 권한 에러가 발생해서 좀 찾아봤다. nobody 가 아니라 Jenkins 컨테이너의 UID 로 변경해야 한다고 한다.

UID 확인 : docker exec -it %젠킨스_컨테이너_ID% id

• 사용자 ID도 1000이고 그룹 ID도 1000이다.

권한 변경 : chown -R %사용자ID%:%그룹ID% %경로%

이제 진짜 해치웠다.

이제 세팅 다시하러가자.....

얼마전에 AI로 어플을 직접 만든 이후, 이것저것 만들어보는 취미가 생겼다. 따봉 GPT야 고마워~ 그러다보니 로컬에서 관리하기엔 한계도 있고... 무엇보다도 빌드-배포를 직접하는게 귀찮다!!

Github

솔직히 나는 깃헙에 손이 잘 안간다.

매일매일 공부를 하며 잔디관리를 하는분도 계시긴하지만, 뭔가 의무감처럼 느껴지는 느낌이랄까 🧐

이번에 혼자 어플을 만들며 놀다보니, 사내와 같이 특정 브랜치에 올리기만하면 자동배포가 되는 그런 환경을 구축하고싶다! 라는 생각이 들었다.

그리고 내가 배포할때 사용했었던 firebase에서는 아주 쉽게 해당 기능을 쓸수있다!

as-is

그러니깐 여태까지는 Firebase 공식문서를 확인하면서 손수 배포를 진행했는데, 그 과정은 간략하게 다음과 같다

# Flutter 패키지 설치
flutter pub get
# Flutter 웹으로 빌드
flutter build web
# Firebase 배포
firebase deploy

쓰고나니깐 간단하긴한데 오탈자 하나 수정하고나서 저 과정을 맨날 해야하는게 쉽지않다 ...

to-be

배포할 어플 뚝딱

• 일단 간단하게 페이지 하나 뚝딱 만들어보자.
• 뚝딱

Firebase 홈페이지

• 배포할 프로젝트는 만들었고, Firebase 홈페이지에서 프로젝트를 만들자! Firebase 홈페이지

• 이름도 내가 원하는걸 지정해보고

• 분석 예... 해주십시오

• 기본계정으로 뚝딱

• 하면 만들어준다!

Firebase와 내 어플을 연결하자!

• 배포할 내 어플의 루트폴더로 다시가서 다음과 같은 명령어를 치자! firebase init

• 그럼 다음과 같은 화면이 나올텐데 천천히 해석하면 알아들을수 있다. 물론 나는 해석안하고 넘겨서 github에서 자동배포는 나중에 알았다

• 우리는 배포용으로 사용하니 Hosting 선택

• 우리는 Firebase 홈페이지에서 프로젝트를 만들고 왔기 때문에 Use an existing project 선택

• 이후 입맛에 맞게 선택 몇개하다보면 다음과 같은 문항이 나온다.

• Github 자동배포.. 해주십시오...

github 배포될 프로젝트 만들기

• github에서 사용자 인증을 하고 다음과 같이 github repository를 달라고 한다.

• 그렇담 github가서 하나 뚝딱 만들자

• 방금 만든 github 주소를 넣어주면 배포되기전 빌드를 하겠냐고 물어봐준다.

• 빌드가 필요하다면 넣어주자!

• 예... 이것도 부탁드립니다.

• 어느 브랜치에 될때인지 지정해주기

• 여기까지 하면 뭔가 다된것처럼 보인다!

자동으로 생성된 파일들 커스텀하기

• 루트폴더에 생성되어있는 .github/workflow 를 살펴보자

• 두가지 파일이 생성되어있는데, 이것들을 내 프로젝트에 맞게 커스텀해줘야한다.

• Flutter 를 사용하며 내게 필요한 빌드 과정들을 jobs.build_and_deploy.steps 에서 순차적으로 변경해준다.

  # firebase-hosting-merge.yml
  name: Deploy to Firebase Hosting on merge
  on:
  push:
    branches:
      - main
  jobs:
  build_and_deploy:
    runs-on: ubuntu-latest
    steps:
      # Flutter 설치
      - name: Set up Flutter
        uses: subosito/flutter-action@v2
        with:
          flutter-version: '3.27.1'
  
      # Flutter 패키지 설치
      - name: Install dependencies
        run: flutter pub get
  
      # Flutter 웹 빌드
      - name: Build Flutter Web App
        run: flutter build web
  
      # Firebase Hosting 배포
      - uses: FirebaseExtended/action-hosting-deploy@v0
        with:
          repoToken: ${{ secrets.GITHUB_TOKEN }}
          firebaseServiceAccount: ${{ secrets.FIREBASE_SERVICE_ACCOUNT_PANG_DEPLOY_TEST }}
          channelId: live
          projectId: pang-deploy-test
  

- 그리고 하나더 루트에 생성된 `firebase.json` 도 수정이 필요할수 있다!
- 나같은경우는 `flutter` 를 웹으로 빌드하기때문에 `build/web` 하위를 배포해야한다

```yml
# firebas.json
{
  "hosting": {
    "public": "build/web", # 수정
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ],
    "rewrites": [
      {
        "source": "**",
        "destination": "/index.html"
      }
    ]
  }
}

준비는 끝났다

• 이제 git에 올려보자!!!

• 내가 설정했던 main 브랜치에 올리니 아주 잘되어보인다. 만족스럽다

• firebase로 배포된 URL을 보자

• 캬

  

깃헙잔디들 딱대

• ChatGPT 를 활용해서 만들었다는 그냥저냥의 회고록이랍니다

이래 봬도 돈 관리를 열심히 하기 위해서 가계부를 꾸준히 작성 중이다. 며칠 전 집에 살림이 늘어나다 보니 공용으로 쓸 수 있는 가계부 앱을 다운로드했다. 아니 근데 이놈의 앱은 광고가 왜 이리 많은 것인가

JSON싸개 호칭이 붙어있는 나로썬 어떻게 시작해야할지 막막했다.

심지어 뷰 영역은 그냥 HTML 개발자라고 할수있다.

나도쓴다 ChatGPT

구글링을 하면서 하나하나 해볼수도 있겠지만 궁금해졌다.

요즘 그렇게 대세라고하는 AI를 어디까지 활용해볼수있을까?

chatgpt 한테 질문들이 여기 올리기 부끄럽긴한데 대부분 요렇게 사용하고있었다

• 변수이름 추천좀요

• 이거 설명좀요

일단 교육부터 시키자

언제부터 적용되었는지 모르겠지만 나름 최근에 chatgpt에 메모리 업데이트됨 이라는게 생겼다. 내가 한 말을 기억한다? 뭐 이런식으로 이해하고있다.

• 왕초보방입니다. (전적봄)
• 한국인 패치좀요
• 질문 세개째 만에 왕초보인걸 인지했나보다. 다음 스텝도 알려주려고 한다.

이젠 나도 기획자

내가 구상한 기획을 chatgpt 에게 쏟아내보자.

• 가계부 어플 달력으로 만들어줘
• 흠... 입력하는방식 바꿔줘
• 조회 결과 나오게 해줘
• 에러 왜남!!!!!!
• DB 연동해줘
• 진짜 초보만 제발
• 추가기능 넣어서 2차개편 해줘
• 한 파일의 볼륨이 너무 커지는데 파일 분리해줘
• 너가만든 코드 직접보고 기능추가해줘

따봉GPT야 고마워

이번에 AI를 통해 어플리케이션을 만들어봤는데 JSON 싸개로써 아주 재미있는 작업이었다. 기계부수기 운동 드가자

추후에 또 이런 재미난 작업이 생각난다면 다시한번 해봐야겠다.

앞으로 돈에 관련된 프로젝트를 맡게 될 예정이라 조금 찾아보다보니 BigDecimal 자료형을 사용해야한다고 한다. DataSize 를 사용하는것처럼 직관적이게 사용하기위해 그런걸까 싶어서 관련 내용을 조금 찾아봤다.

java에서 실수(mistake 아님)를 표현하는 방식으로 double, float 등을 사용할수있다. 그런데 이녀석들은 정확하지 않다.

double

0.1 과 0.2를 더하면 0.3이 된다.

아주 간단한 테스트다.

@Test
void wrong_double_test(){
    double a = 0.1;
    double b = 0.2;
    assertThat(a + b).isEqualTo(0.3);
}

아니, 틀렸다!

float

그렇담 이건 어떨까

0.1을 100번 더한다!

그렇담 당연히 10이 아닐까?

@Test
void wrong_float_test(){
    float result = 0f;
    for(int i = 0; i < 100; i++){
        result += 0.1f;
    }
    assertThat(result).isEqualTo(10f);
}

그렇게 생각했다면 역시 틀렸다!

10진수를 2진수로~

정수부

위와같은 실수 타입의 계산은 2진법을 사용하는 컴퓨터의 이슈로 생각하면 된다.

그러니깐 간단히 예를들면, 정수부는 다음 그림처럼 2진수로 깔끔하게 떨어질수있게 표현할수있다. (10진수 19를 2진수로 바꾸는 작업! )

그림 출처

소수부

그렇다면 소수부를 10진수에서 2진수로 변환해보자.

10진수를 2진수로 변환할때 정수부에서는 2를 나누어준것처럼, 소수부에서는 2를 곱하여 나오는 정수를 차례로 쓰는걸로 변환을 할수있다.

10진수 0.625 를 2진수로 변환하는 과정은 다음과 같다.

1) 0.625 * 2 = 1.250  >  1
2) 0.250 * 2 = 0.50   >  0
3) 0.50  * 2 = 1.0    >  1

깔끔하게 10진수 0.625는 2진수 0.101로 변환되는것을 확인했다.

하지만 아주 운이 좋았다고 할수있다.

동일한 방법으로 10진수 0.1을 2진수로 변환해보자.

1) 0.1 * 2 = 0.2   >  0
2) 0.2 * 2 = 0.4   >  0
3) 0.4 * 2 = 0.8   >  0
4) 0.8 * 2 = 1.6   >  1
5) 0.6 * 2 = 1.2   >  1
6) 0.2 * 2 = 0.4   >  0 
...

동일하게 구하려고 했는데 2단계에서 나온 0.2가 6단계에서도 동일하게 나온걸 본다면 깔끔하게 떨어지지 않고 다음과 같이 구질구질하게 나올 예정이다. 0.1₍₁₀₎ = 0.000110011001100...₍₂₎

여기에서 위 테스트가 실패한 이유를 알 수 있다. 컴퓨터는 제한된 메모리에 데이터를 저장하기 때문에, 2진수로 변환했을때 무한소수로 나오는 값들은 근사값을 저장하게 된다.

고정소수점과 부동소수점 용어정리

일단 용어부터 정리를 하겠다. 고정 과 부동 은 같은말처럼 생겨서 헷갈린다...

• 고정(固定)

• 부동(浮動)

고정소수점

• 간단하게 설명하고 넘어가겠다. 저장할 공간에 정수부를 저장하는 비트와 실수부를 저장하는 공간이 고정되어있다는것.
• 예를들면 다음 그림은 32bit를 저장하는 공간에서 정수부에는 16bit만큼, 소수부에는 15bit만큼 넣겠다고 고정한 자료형이 되겠다.
• 하지만 숫자를 사용하다보면 아주 큰수를 사용할때가 있고, 소수점으로 아주 세밀하게 사용할 때도 있기때문에 해당 메모리를 효율적으로 사용할 수 없을때가 있다.

부동소수점

• 그래서 컴퓨터에서는 메모리를 효율적으로 사용하기 위해 부동소수점 방식을 택하게 된다.
• 일단 부동소수점을 사용한다라는건 정규화에 대해 알아야하는데, 2진법으로 변환하여 정수부를 1로 만든다! 라고 생각해주면 좋을것 같다.

10진수 19.125 를 2진수로 변환하여 정규화를 해보자!

19.125₍₁₀₎
= 10011.001₍₂₎
= 1.0011001₍₂₎ * 2⁴    << 이게 정규화된거다!

정규화된 1.0011001₍₂₎ * 2⁴ 를 IEEE 754 표준에 맞게 넣어보자.

일단 IEEE 754의 메모리 할당은 다음 그림과 같다.

그림 출처

부호 비트, 지수 비트, 가수 비트의 계산은 다음과 같다.

1) 양수/음수에 따라 부호 비트에 넣는다
  - 양수 : 0
  - 음수 : 1
2) 자릿수를 나타내는 2⁴의 지수인 4와 127을 더하여 지수 비트에 넣는다.
  - 127₍₁₀₎ = 01111111₍₂₎
3) 소수 부분은 가수 비트에 차례대로 넣는다.
  - 0.0011001₍₂₎

계산 결과값은 다음과 같다
(부호) (지수)           (소수)
  0  10000011  00110010000000000000000

다른 언어에서는 어떤걸 쓰나

2진수로 표현했을때 무한소수를 표현할 수 없어서 위와같은 이슈가 있는걸 알아봤다.

그리고 다른 언어에서도 세밀한 실수를 표현하기위해서는 사용하는 대체제가 따로 존재하는것 같다.

그러니깐 내가 원하는대로 동작을 하지않는다. 이벤트 리스너에서 데이터 변경이 반영되지 않는다...

간단한 코드를 보겠다.

• GroupService.kt 에서 Group 을 삭제하고 삭제 이벤트를 발행한다.

    /**
    * GroupService.kt
    */
    @Transactional
    fun deleteGroupPublish(id: Long){
        groupRepository.deleteById(id)
        applicationEventPublisher.publishEvent(
                DeleteGroupEvent(id)
        )
    }

• 발행한 이벤트를 받아서 Group 에 속하는 GroupMember 를 삭제한다.

    /**
    * GroupMemberService.kt
    */
    @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT)
    fun deleteGroupMemberEventHandler(event: DeleteGroupEvent){
        groupMemberRepository.deleteByGroupId(event.id)
    }

• 그에따른 간단한 테스트를 다음처럼 구성해봤다.

@SpringBootTest
class GroupServiceTest{

    @Autowired
    lateinit var groupService: GroupService
    @Autowired
    lateinit var groupRepository: GroupRepository
    @Autowired
    lateinit var groupMemberRepository: GroupMemberRepository

    @Test
    fun delete_group_and_publish_event(){
        // given
        val group = groupRepository.save(Group())
        val groupMember = groupMemberRepository.save(GroupMember(group.no))
        // when
        groupService.deleteGroup(group.no)
        // then
        val groupList = groupRepository.findAll()
        val groupMemberList = groupMemberRepository.findAll()
        assertThat(groupList).isEmpty()
        assertThat(groupMemberList).isEmpty()
    }
}

• 왜 실패하는거야

이벤트 문제가 아니고 Transaction를 보자

그러니깐 ORM 에 등록해서 데이터베이스가 실제로 변경되게 하려면 commit, rollback 등의 기능이 되어야하고, 그걸 편하게 하기위해서 TransactionManager 인터페이스가 존재하고, 이걸 대부분 구현해놓은 AbstractPlatformTransactionManager 추상클래스가 존재하고, 이걸 또 각자 사용하는 ORM에서 TransactionManager 를 구현해놓았는데... 나중에 블로그를 따로 정리하겠다.

구글링으로 좀 이것저것 찾아봤었는데 여기 블로그를 좀 참고했다.

어디서 커밋을 하나요

일단 내부구조를 슥 한번 보겠다.

변경사항이 반영되는doCommit() 을 실행하는 부분은 여기 한군데 밖에 없다

AbstractPlatformTransactionManager 클래스의 processCommit() 메서드이다.

코드를 보아 status.isNewTransaction() 이 true 여야 doCommit() 이 실행되어 데이터베이스 변경이 반영할수있다는걸 알수 있다.

언제 커밋을 하나요

그렇다면 status.isNewTransactiion() 의 상태값이 세팅 부분을 찾아보겠다.

동일한 클래스의 getTransaction() 에서 현재 실행중인 Transaction 이 새로운 트랜잭션인지 분기한다는걸 확인했다.

현재 Transactional 의 propagation이 기본값 (Propagation.REQUIRED)으로 되어있으니 하단의 조건문에 걸려 트랜잭션을 시작하게 된다.

그리고 해당 메서드는 트랜잭션을 생성하며 newTransaction이 true로 들어가는걸 확인할수 있다.

AbstractPlatformTransactionManager 클래스의 processCommit() 메서드의 status.isNewTransaction()이 true 로 들어갈수가 있겠다. (중복된 사진)

그래서 리스너에서는 외않되

동일하게 getTransaction()으로 현재 트랜잭션의 상태값을 받아오는건 동일하지만, 상위 클래스에서 전파된 트랜잭션이 존재하기 때문에 handleExistingTransaction() 메서드를 타게 된다.

그리고 handleExistingTransaction 내부를 확인하면 definition.getPropagationBehavior() 에 따라서 트랜잭션의 newTransaction 의 상태값이 다르게 들어가는걸 확인할수 있다.

그리고 해당 값의 기본값은 Transactional의 기본값인 REQUIRED

PROPAGATION_REQUIRED 상태값을 따라가면 마지막에 newTransaction 이 false 로 생성되게 되고 아까 확인했었던 commit이 일어나지 않게 된다.

그럼 어케해!!!

상위클래스에서 전파된 트랜잭션은뭐 그거대로 두고 새로운 트랜잭션을 열면 된다.

아까 확인했었던 handleExistingTransaction 에서 트랜잭션 PROPAGATION이 REQUIRES_NEW 라면 최초에 트랜잭션을 열때와 동일하게 여는 방식을 사용하는걸 볼수 있다.

그렇지만 여기 블로그 도 한번 확인해보도록 하자.

jpa dirty checking is not working 말그대로 JPA 에서 더티 체킹이 되지 않는다. 물론 더티체킹 사용하는걸 좋아하진 않지만 왜 안되는건지 알고싶다.

상황 설명

코드로 보는게 편할듯하여 코드부터 살짝 본다면 문제의 엔티티는 다음과 같다.

@Entity
@Table(name = "company", catalog = "slave_babi_01")
data class SlaveCompany(
        ...

        @Column(name = "name")
        private var name: String = ""
){
        fun changeName(name: String){
                this.name = name
        }
}

그리고 그 문제의 서비스 코드는 다음과 같다.

@Service
@Transactional
class CompanyService(
        private val masterCompanyRepository: MasterCompanyRepository,
        private val slaveCompanyRepository: SlaveCompanyRepository
) {

    ...

    fun changeSlaveCompanyName(id: Long, name: String){
        val company = slaveCompanyRepository.findById(id)
                .orElseThrow()
        company.changeName(name)
    }

}

그럼 이 문제의 코드를 실행해보자

@Test
fun change_slave_name_test(){
    // given
    val id = 1L
    val changeName = "change slave name"
    // when
    companyService.changeSlaveCompanyName(id,changeName)
    // then
    val slaveCompany = slaveCompanyRepository.findById(id)
            .orElseThrow()
    assertThat(slaveCompany.name).isEqualTo(changeName)
}

이녀석 진짜 문제네

아니 왜죠

그러게 말이다. 한번 이것저것 시도를 해봤었다.

save() 를 직접해주면 되는가?

fun changeSlaveCompanyName(id: Long, name: String){
    val company = slaveCompanyRepository.findById(id)
            .orElseThrow()
    company.changeName(name)
    // 직접 save 추가
    slaveCompanyRepository.save(company)
}

예 됩니다. update 쿼리 잘날라가네요

혹시 EntityManager에 등록되어있을까요

@Service
@Transactional
class CompanyService(
        private val masterCompanyRepository: MasterCompanyRepository,
        private val slaveCompanyRepository: SlaveCompanyRepository,
        // EntityManager 추가
        private val entityManager: EntityManager
) {

    ...

    fun changeSlaveCompanyName(id: Long, name: String){
        val company = slaveCompanyRepository.findById(id)
                .orElseThrow()
        // 추가
        entityManager.contains(company)
        company.changeName(name)
    }

}

안되어 있었네요.

정답은 다중 datasource 였습니다~

혼날까봐 미리 이야기안했었는데, 사내 프로젝트에서 다중 datasource 를 만들어서 사용하고 있었고, slaveDatasource, masterDatasource 를 각각 선언해서 사용중이다.

그리고 config 파일을 찾아보니 다음과 같이 설정되어 있었다.

그리고 당연하게 @Primary 붙은 masterDatasource 를 기본으로 사용하게되어 내가 원하는 Slave 관련 entity 는 관리 대상이 아니어서 더티체킹이 나가지 않았던것...

아오 @Primary

그래서 트랜잭션에 직접 내가 사용할 Transaction Manager를 기재해주면 더티체킹을 사용할수있다~

// 내가 사용할 transactionManager 명시 
@Transactional(transactionManager = "slaveTransactionManager")
fun changeSlaveCompanyName(id: Long, name: String){
    val company = slaveCompanyRepository.findById(id)
            .orElseThrow()
    company.changeName(name)
}

update도 기똥차게 나가는걸 확인할수있다

@Enumerated 어노테이션과 @Convert 어노테이션은 공존할 수 없는걸까

아니 분명히 달아줬다니깐요?

기존 존재하는 php 코드를 spring 으로 전환하는 업무가 최근에 꽤나 들어오는 편이다.

그러니깐 마이그레이션과 같은 데이터베이스 모델링부터 시작이 아닌, 기존 사용하던 데이터베이스를 사용하며 그대로 호환성을 맞추는 그런 업무들!

사내에서 기존에 사용하는 데이터베이스에서는 enum 타입으로 사용되는것들이 많았다.

간단히 @Enumerated를 달아볼까?

데이터베이스에서 Notnull 필드인걸 확인하고, 다음과 같이 @Enumerated(value = EnumType.STRING) 을 추가해줬다.

@Column(name = "type")
@Enumerated(value = EnumType.STRING)
private YorN type;

그리고 간단한 CRUD 테스트를 진행하니 enum 타입으로 변환을 할수 없다는 다음과 같은 에러가 발생한다...

nested exception is org.springframework.dao.InvalidDataAccessApiUsageException: No enum constant

확인해보니 데이터베이스의 enum 데이터타입이 enum('Y', 'N') 으로 선언되어있지만, 실제로는 빈 스트링("")으로 들어가있었음!!!

해당 이슈는 MYSQL 5.7에서 만나볼수있는 이슈로, enum에 맞지않는 값은 빈 스트링으로 들어간다고 한다 😠 참고 페이지

그럼 컨버터를 달아볼까?

이번에는 Converter 를 달아주도록 결심했다. 내가 사용하는 YorN enum에 대하여AttributeConverter 를 null에 대한 방어코드도 추가하여 구현해주고 Entity는 다음과 같이 Converter 어노테이션을 추가해줬다

@Column(name = "type")
@Convert(converter = YorNConverter.class)
@Enumerated(value = EnumType.STRING)
private YorN type;

그리고 여전히 만나볼수있는 enum 타입으로 변환 못한다는 그에러...

nested exception is org.springframework.dao.InvalidDataAccessApiUsageException: No enum constant 

아니 컨버터 달아줬다니깐요? 😡

내부로직 구경하기

그래서 한번 들어가봤습니다.

닭이 먼저냐 달걀이 먼저냐

hibernate에서 얻어낸 value를 Entity 로 맵핑해주는 클래스가 BasicResultAssembler.java 라는것을 알게되었고, 해당 함수를 확인했을때 생겨난 이슈를 확인할 수 있었다.

/**
 * BasicResultAssembler.java
 */
@Override
public J assemble(
        RowProcessingState rowProcessingState,
        JdbcValuesSourceProcessingOptions options) {
    // 이놈
    final Object jdbcValue = extractRawValue( rowProcessingState );

    ResultsLogger.RESULTS_LOGGER.debugf( "Extracted JDBC value [%d] - [%s]", valuesArrayPosition, jdbcValue );
    ...
    // converter는 여기 있어요
}

extractRawValue() 함수를 통해 엔티티에 삽입되어야 할 데이터를 변환하여 가지고 오게 되는데, @Enumerated 어노테이션이 선언된 필드들은 다음 BasicValueBinder.java 에서 최초에 hibernate 에서 JdbcType이 enum타입으로 등록되게 된다

/**
 * BasicValueBinder.java
 */ 
private void prepareBasicAttribute(String declaringClassName, XProperty attributeDescriptor, XClass attributeType) {

    ...

    final Enumerated enumeratedAnn = attributeDescriptor.getAnnotation( Enumerated.class );
    if ( enumeratedAnn != null ) {
        this.enumType = enumeratedAnn.value();
    }

    ...

}

값을 추출할때 JdbcType 별로 다르게 맵핑하여 가지고 오기 때문에, 데이터베이스값이 enum에 맞지 않다면 추출할때 부터 enum타입으로 선언되어있으면 converter 와는 무방하게 에러가 발생한다

타입별 컨버터의 실제 구현은 다음과 같은 차이가 존재한다

• EnumJavaType 컨버터

  /*
  * EnumJavaType.java
  */
  @Override
  public <X> T wrap(X value, WrapperOptions options) {
    ...
    else if ( value instanceof String ) {
        return fromName( (String) value );
    }
    ...
  }
  

public T fromName(String relationalForm) { if ( relationalForm == null ) { return null; } // 에러 잘나게 생긴녀석 return Enum.valueOf( getJavaTypeClass(), relationalForm.trim() ); }

- StringJavaType 컨버터
```java
public <X> String wrap(X value, WrapperOptions options) {
    ...
    // String 이라면 String 반환. 아주 군더더기 없는 녀석
    if (value instanceof String) {
        return (String) value;
    }
    ...
}

이번 섹터 제목이 닭이 먼저냐 달걀이 먼저냐 라고 지었던것도, 컬럼에 @Enumerated 어노테이션을 추가해준것 만으로, converter 를 추가한것은 아무런 도움이 안된다는 뜻에서 정해봤다(설명이 필요한 드립은 실패한 드립)

컨버터 여기 뒤에있어요

BasicResultAssembler.java 에서의 assemble() 메서드를 대량 생략했었는데 전체 구현부는 다음과 같다.

컨버터가 존재한다면 비로소 우리가 구현한 AttributeConverter 컨버터를 사용하게 된다.

/**
 * BasicResultAssembler.java
 */
@Override
public J assemble(
        RowProcessingState rowProcessingState,
        JdbcValuesSourceProcessingOptions options) {
    final Object jdbcValue = extractRawValue( rowProcessingState );

    ResultsLogger.RESULTS_LOGGER.debugf( "Extracted JDBC value [%d] - [%s]", valuesArrayPosition, jdbcValue );

    if ( valueConverter != null ) {
        if ( jdbcValue != null ) {
            // the raw value type should be the converter's relational-JTD
            if ( ! valueConverter.getRelationalJavaType().getJavaTypeClass().isInstance( jdbcValue ) ) {
                throw new HibernateException(
                        String.format(
                                Locale.ROOT,
                                "Expecting raw JDBC value of type `%s`, but found `%s` : [%s]",
                                valueConverter.getRelationalJavaType().getTypeName(),
                                jdbcValue.getClass().getName(),
                                jdbcValue
                        )
                );
            }
        }

        // 이놈
        return (J) ( (BasicValueConverter) valueConverter ).toDomainValue( jdbcValue );
    }

    return (J) jdbcValue;
}

그러면 어떻게 하죠

결론... 이라고하기엔 좀 그렇지만 데이터베이스에 값이 꼬여있는 경우가 아니라면 @Enumerated로도 커버가 가능하며, 굳이굳이 둘다 혼용을 한다면, 빈 문자열또한 어플리케이션 로직에 추가하여 Converter로 정상값으로 변환시켜주자.

환경 Spring Boot 3.3.2 hibernate 6.5.2

로그를 남기는것은 아주 중요한 일이다. 추후 오류를 찾을때 추적하기도 쉬우며...(주절주절)

로그가 중요하다는것은 모두 알거고, 그럼 어떠한 방식으로 로그를 남기는게 좋을까? 라는 다음 단계가 있을수 있겠다.

사내에서는 다양한 프레임워크를 사용하고 있기에, 전사적으로 사용하기 위해 처음 구상한 내용은, 로깅용 데이터베이스를 따로 구축하여(nosql) 카프카 등 이벤트로 처리하도록 하는걸 생각해봤었다.

하지만 트래픽이 적지도않을뿐더러, 솔루션마다 주요하게 저장할 로깅 데이터가 달라 정형화하기 힘들다 라는 이슈...

스프링부터 천천히...

전사적으로 가장 많이 채택되어 사용되고있는 스프링 모듈로부터 따로 생각해봤다.

그리고 아주 편리하게 사용할수있는 AbstractRequestLoggingFilter 이 있다고 할수 있겠다.

OncePerRequestFilter을 상속받고 있으며, 해당 클래스를 조금만 손보면 요청 전후로 로그를 받을수 있다.

당장 구현

해당 모듈을 구현하며, 사용자가 커스텀하게 할수있도록 하고 싶었다. 예를들면 특정 사용자별 로그를 찍고싶지 않은 엔드포인트를 정하는느낌으로!

그리고 AbstractRequestLoggingFilter에서 커스텀하게 지정해줄수 있는 세팅값들은 다음과 같다. (message prefix, suffix 데코레이터는 제외!)

    public void setIncludeQueryString(boolean includeQueryString) {
        this.includeQueryString = includeQueryString;
    }

    public void setIncludeClientInfo(boolean includeClientInfo) {
        this.includeClientInfo = includeClientInfo;
    }

    public void setIncludeHeaders(boolean includeHeaders) {
        this.includeHeaders = includeHeaders;
    }

    public void setIncludePayload(boolean includePayload) {
        this.includePayload = includePayload;
    }

    public void setHeaderPredicate(@Nullable Predicate<String> headerPredicate) {
        this.headerPredicate = headerPredicate;
    }

    public void setMaxPayloadLength(int maxPayloadLength) {
        Assert.isTrue(maxPayloadLength >= 0, "'maxPayloadLength' must be greater than or equal to 0");
        this.maxPayloadLength = maxPayloadLength;
    }

다들 메서드가 직관적이라 이해하기가 아주 좋다.

그리고 사용자가 설정값을 커스텀하게 할수 있도록 ConfigurationProperties으로 받도록 구성하였다.

@Component
@ConfigurationProperties(LoggingProperties.LOGGING_PREFIX)
data class LoggingProperties(
        var excludePath: MutableList<String> = mutableListOf("**/health/**"),
        var maxPayloadLength: Int = 1000,
        var includeHeaders: Boolean = true,
        var includePayload: Boolean = true,
        var includeQueryString: Boolean = true,
){
    companion object{
        const val LOGGING_PREFIX="logging.config"
    }
}

그리고 AbstractRequestLoggingFilter를 구현해주도록 한다. 구현해야할 주요 메서드들은 다음 세개가 있다.

로그를 찍을지 여부 판단

• protected boolean shouldLog(HttpServletRequest request)

before 로그

• protected abstract void beforeRequest(HttpServletRequest request, String message)

after 로그

• protected abstract void afterRequest(HttpServletRequest request, String message)

sholudLog 메서드를 재정의하지 않는다면 k8s에서 health 체크등 불필요한 요청들도 다 찍혀서 오히려 보기가 힘들수 있기에, 제외하고싶은 엔드포인트들을 받을수 있도록 하였다.

class RequestLoggingFilter(
        private val excludePath: List<String>
): AbstractRequestLoggingFilter() {

    private val matcher = AntPathMatcher()

    override fun shouldLog(request: HttpServletRequest): Boolean {
        return !excludePath.any {
            matcher.match(it, request.requestURI)
        }
    }

    override fun beforeRequest(request: HttpServletRequest, message: String) {
        this.logger.info(message)
    }

    override fun afterRequest(request: HttpServletRequest, message: String) {
        this.logger.info(message)
    }
}

이후 해당 로깅 내용을 Bean 설정까지만 해주면 뚝딱!

@Configuration
class RequestLoggingConfig{

    @Bean
    fun requestLoggingFilter(
            properties: LoggingProperties
    ):RequestLoggingFilter{
        val filter = RequestLoggingFilter(properties.excludePath);
        filter.setMaxPayloadLength(properties.maxPayloadLength)
        filter.setIncludeHeaders(properties.includeHeaders)
        filter.setIncludePayload(properties.includePayload)
        filter.setIncludeQueryString(properties.includeQueryString)

        return filter
    }
}

해당 모듈을 사용자가 가져오기만 하더라도 기본적인 로깅이 찍히도록 구성하였다. 물론 모듈을 만들때 사용자가 커스텀하게 설정하는것도 @ConfigurationProperties value로 설정한 값들을 yml 에 설정해줄수 있다고 할 수 있다.

사내에서 데이터베이스를 마이그레이션할때 항상 스크립트를 작성했었는데, mysql의 이런 기능도 있었다

오래전부터 사용되던 데이터베이스들은 테이블 구조가 구린경우가 많다.

• 더이상 사용하지 않는 컬럼
• 과한 정규화
• 엄청난 반정규화

하여간 다양한 상황에 직면하게 되는데, 개선건으로 테이블의 정규화가 필요하다고 생각하고, 스크립트를 준비하려했는데, 옆에서 그거 쿼리 한줄이면 끝나는데 라며 직접 쿼리를 작성해줬다.

Insert - Select

• 그러니깐 select 된 결과값들을 모두 insert 할 수 있다.
• 예를들면 다음과 같은 쿼리가 있겠다

insert into table_1 (name)
  select table_2.name
  from table_2 where table2.id > 10;

• 다음 select 절의 결과값을 table_1.name 필드에 전부 넣겠다 라는 뜻이다.

  select table_2.name
  from table_2 where table2.id > 10;

• 그리고 전체 테이블을 옮기는 방법도 있는데

  insert into table_1 table table_2

• 위의 sql 문은 다음 쿼리와 동일하다

  insert into table_1
  select * from table_2

• 모종의 사유로 insert 처리중 에러가 발생한다면 롤백과 동시에 종료를 하게 되는데, 이때 insert ignore를 사용하면 에러를 발생할 수 있는 레코드를 제외하고 구문을 실행하게 된다

insert ignore into table_1
  select * from table_2

• 동일한 테이블에 서브쿼리로 insert 하는것은 안된다-로 읽히는데 재현이 안된다...

  고수들의 도움이 필요

당장써보자?

• 아주 좋다 그래서 당장 쓰고싶긴하지만 사내에 쿼리를 날리기에는 조금 찜찜한 부분이 있기에 조금 수정을 해보도록 하자

• 기존 테이블 구조

• address 필드를 정규화 하여, 다음과 같은 테이블 구조를 갖고싶다!

• 사실 다음과 같은 select-insert 쿼리로 한번에 가능하긴하다!

  insert into `정규화 할 테이블` (new_address, fk_id)
  select name, id from `기존 테이블`
  

- 하지만 중간에 에러가 터진다면..!!
**멱등성**이 보장되는 쿼리로 좀더 편안하게 쿼리를 변경하자

```sql
insert into `정규화 할 테이블` (new_address, fk_id)
    select name, id from `기존 테이블`
    where not exists (
                    select * from `정규화 할 테이블` 
                      where `정규화 할 테이블`.fk_id = `기존 테이블`.id
                    )

• 존재하지 않는 레코드만 삽입이 가능하다!

출처 : mysql 문서

여기의 내용을 번역하여 정리했습니다

Null 반환을 조심하라

• 우리는 Java를 사용할때, nullpointerexception 의 굴레에서 살아간다.
• 특정 메서드의 리턴값이 null 을 반환하기 보다는 Optional을 사용하자

Bad Practice

public String getString(){
    return null;
}

Good Practice

public Optional<String> getString(){
    return Optional.empty();
}

String 자료형으로 변환

• + 연산자를 통하여 특정 자료형을 String 으로 변환할수도 있다
• 하지만 이러한 방식은 많은 수의 변수를 문자열로 변환할 때 비효율적이니 내장 메서드를 사용하자

Bad Practice

double d = 3.141592;
String s = "" + d;

Good Practice

double d = 3.141592;
String s = String.valueOf(d);

배열을 복사할때도 스마트하게

• 배열 길이를 할당하고, 모든 인덱스에 반복문을 돌며 하나씩 값을 넣어주는게 아니라 만들어져있는 메서드를 사용하자.
• 코드적으로도 이해하기 쉽다

Bad Practice

int[] = sourceArray = {1, 2, 3, 4, 5};
int[] = targetArray = new int[sourceArray.length]; // 배열 길이 할당
for (int i = 0; i < sourceArray.length; i++){
    targetArray[i] = sourceArray[i];
}

Good Practice

int[] originalArray = {1, 2, 3, 4, 5};
int[] copiedArray = Arrays.copyOf(originalArray, originalArray.length);

자료형의 상태를 확인할 수 있는 메서드를 사용하자

• 리스트가 비어있는지, 문자열이 존재하는지 등 자료형의 상태를 어떻게 확인을 하고있나?
• 리스트가 비어있는지 if(list.size() == 0) 와 같이 확인하기 보다는 해당 자료형에서 상태값을 확인할 수 있는 메서드가 있다

Bad Practice

String text = "Hello!";
if(text.length() == 0){
    // do
}

List<Long> numbers = new ArrayList<>();
if(numbers.size() == 0){
    // do
}

Good Practice

String text = "Hello!";
if(text.isEmpty()){
    // do
}

List<Long> numbers = new ArrayList<>();
if(numbers.isEmpty()){
    // do
}

리스트에 대한 수정을 조심

• 다음과 같이 리스트를 순회하며 수정하는 로직은 ConcurrentModificationException 에러를 만날 수 있다

Bad Practice

List<String> words = new ArrayList<>();
words.add("A");
words.add("B");
words.add("C");

for(String word: words){
    if(word.equals("A")){
        words.remove(word);
    }
}

• ArrayList 객체 내부를 확인해보면 엘리먼트의 추가 및 삭제마다 modCount 가 1씩 증가하게 되는데, next()를 호출할때마다 다음 checkForComodification 함수를 호출하게 된다.
• modCount 는 배열의 수정으로 인하여 expectedModCount 와 달라졌기 때문에 ConcurrentModificationException 에러가 발생하는것
• 좀더 자세한 설명은 여기로~

Good Practice

• iterator 에서 지원하는 remove 함수의 사용을 권장!

  List<String> words = new ArrayList<>();
  words.add("A");
  words.add("B");
  words.add("C");
  

Iterator iterator = words.iterator();

while (iterator.hasNext()){ String word = iterator.next(); if(word.equals("A")){ iterator.remove(); } }

- 혹은 간단하게 `removeIf` 함수의 사용하는 법도 있겠다. (자바8 이상)
```java
List<String> words = new ArrayList<>();
words.add("A");
words.add("B");
words.add("C");

words.removeIf(word -> word.equals("A"));

정규 표현식은 미리 정의하기

• 반복되는 정규 표현식들을 사용할때마다 사용하지않고 미리 정의하자

Bad Practice

String text = "Hello!";
if (text.matches("Hello.*")) {
    System.out.println("Matched!");
}
String replaced = text.replaceAll("\\s", "");

Good Practice

final Pattern PATTERN1 = Pattern.compile("Hello.*");
final Pattern PATTERN2 = Pattern.compile("\\s");

String text = "Hello!";
if (PATTERN1.matcher(text).matches()){
    System.out.println("Matched!");
}
String replaced = PATTERN2.matcher(text).replaceAll(""");

검색하기 전 미리 데이터의 존재 여부를 확인하지 마라

• 바로 코드를 본다면

  Bad Practice

  public static String findNameById(Map<Integer, String> idNameMap, int id){
    if (idNameMap.containsKey(id)){
        return idNameMap.get(id);
    }
    else {
        return "Unknown";
    }
  }
  

- `Map` 에서 내가 원하는 데이터가 있는지 존재여부 확인 후, 내가 원하는 데이터를 반환하는 로직으로 확인이 가능하다.
- 하지만 이런 코드는 중복된 로직으로써 다음과 같이 수정 가능하다

##### Good Practice

```java
public static String findNameById(Map<Integer, String> idNameMap, int id){
    String name = idNameMap.get(id);
    if (name != null){
        return name;
    }
    else {
        return "Unknown";
    }
}

컬렉션을 배열로 변경하기

Bad Practice

• 내부 배열을 선언할때 컬렉션의 크기를 직접 지정해주고 있다

  List<String> stringList = new ArrayList<>();
  stringList.add("a");
  stringList.add("b");
  stringList.add("c");
  

String[] array = stringList.toArray(new String[stringList.size()]);

##### Good Practice

- 하지만 컬렉션의 `toArray` 내부를 확인해보면 다음과 같이 선언되어 있어, 크기 조정을 직접 해줄 필요가 없다는걸 알 수 있다.
![](https://velog.velcdn.com/images/pang_e/post/de8144a3-df89-4004-8f4d-960772ab1c83/image.png)

```java
List<String> stringList = new ArrayList<>();
stringList.add("a");
stringList.add("b");
stringList.add("c");

String[] array = stringList.toArray(new String[0]);

디폴트 메서드도 사용하자

• 만약 내가 오픈소스를 만들었는데 너무 잘 만들어서 전 세계 사람들이 사용하고 있다고 하자. 그런데 인터페이스에서 필수적으로 구현해줘야할 메서드가 생겨버린다면 ?
• 인터페이스에 메서드를 추가뒤 배포했다. 내 오픈소스를 사용하는 사람들은 버전업을 함과 동시에 추가된 메서드를 구현해야한다...(죄송)
• 그럴때 구현할 필요없이 바로 사용할 수 있는 디폴트 메서드 잠수함패치!

Bad Practice

interface Logger {
    void log(String message);
}

Good Practice

interface Logger {
    void log(String message);

    default void logError(String errorMessage){
        System.err.println("Error: " + errorMessage);
    }
}

Date 클래스는 이제 놓아주자

• LocalDate, LocalDateTime 이 훨씬 직관적이다

  Bad Practice

import java.util.Date;

public class DateUtil {
    public static void main(String[] args){
        Date currentDate = new Date();
        System.out.println("Current date: " + currentDate);
    }
}

Good Practice

import java.time.LocalDate;

public class DateUtil {
    public static void main(String[] args){
        LocalDate currentDate = LocalDate.now();
        System.out.println("Current date: " + currentDate);
    }
}

제네릭 타입을 써주자

• 컴파일 시점에 에러를 확인할 수 있게 해주는 제네릭타입을 적극 활용하자

Bac Practice

ArrayList list = new ArrayList();
list.add(10);
list.add("Hello");    // Runtime Error!

Good Practice

ArrayList<Integer> list = new ArrayList();
list.add(10);
list.add("Hello");    // Compile Error!

자바를 사용할때 생각할만한 것들을 정리한 블로그를 읽으면서, 사실상 당연한것들이라고 생각을 했던것들이 대부분이긴 하다. 그래도 생각만 하고있는것보다 한번 정리해보는 기회로 그래도 나쁘진 않은것 같다.

항상 들리는 그이름 프록시

프록시가 뭔가요

몇몇 블로그를 봤었는데, 비서 와 같은 개념으로 이해하는게 가장 쉬웠다 사장님에게 직접 이야기 하기 전, 비서에게 먼저 물어보는 개념이다.

이와같이 중간에 비서 역할의 매개체가 존재함에 따라, 생각해볼수 있는 장점과 단점이 몇가지 있다.

장점

1. 보안 강화
   • 중간에 위치하여 데이터 확인. 마치 차단 기능 수행
2. 트래픽 최적화
   • 동일한 데이터를 반복하여 요청하는 경우, 캐시 형태로 데이터를 저장하여 서버 부담 감소
3. 사용자 익명성
   • 서버는 프록시에 의해 호출되기 때문에 클라이언트의 익명성 보장

단점

1. 성능 저하의 원인이 될수도
   • 중간 매개체가 생겨, 속도가 감소할 가능성 존재

프록시 패턴

아주 좋다. 프록시가 무엇인지는 느낌적인 느낌으로 이해를 했는데, 프록시 패턴 이란 무엇일까

우선 위키백과에서는 다음과 같이 나와있다

... 간단하게 예제를 만들어보자

File 이라는 인터페이스

interface File {
    fun read(): String
}

RealFile 클래스는 File 인터페이스의 구현체이다

class RealFile(private val fileInfo: String): File {

    init {
        println("${fileInfo} - RealFile Constructor Call")
    }
    override fun read(): String {
        return "${this.fileInfo} - Read Call"
    }
}

사실 여기까지 일반적으로 우리가 사용하는 방식이지만, 다음 ProxyFile을 추가해보겠다

ProxyFile은 File 인터페이스의 실제 구현체 RealFile의 일을 위임받아 대신 처리한다.

또한 File 인스턴스를 갖고있어, 캐시 형태로 데이터를 저장하여 실제 서버(RealFile) 의 부담을 줄임과 동시에 지연로딩으로 동작한다

class ProxyFile(private val fileInfo: String):File {

    private var file: File? = null
    init {
        println("${fileInfo} - ProxyFile Constructor Call")
    }
    override fun read(): String {
        if(this.file == null){
            this.file = RealFile(fileInfo)
        }
        return this.file?.read() ?: throw RuntimeException()
    }
}

위와 같은 관계에서 사용자는 프록시 객체 ProxyFile를 호출하였지만, 실제로 동작하는 구현부는 RealFile가 실행된다.

@Test
fun `프록시 객체를 생성하여 호출한다`(){
    val file = ProxyFile("file1")

    println("> Constructor End")

    println(file.read())
}

데코레이터 패턴은 또 뭐임

찾아보다가 데코레이터 패턴과도 굉장히 유사하다고 느꼈다.

실제로 둘다 원본 객체를 건들이지 않으며 동작한다는게 헷갈릴수도 있는데, 가장 큰 차이점은 두 패턴의 목적 이다

데코레이터 패턴

• 객체의 새로운 기능의 추가

• 기존 객체의 응답에 대한 변경

프록시 패턴

• 기존 객체에 대한 접근 제어 및 부가기능의 제공

• 기존 객체에 대한 불변성

데코레이터 패턴과 프록시 패턴의 차이 는 여기 블로그에서 아주 야무지게 정리해놨다. 여기보다 잘쓸 자신이 없어서 이러는거 아님

코드 : https://github.com/superpangE/oneday_study/tree/design-pattern