도서 요약

좋은 코드, 나쁜 코드) 10장. 단위 테스트의 원칙

좋은 코드, 나쁜 코드 도서를 요약한 내용입니다. 10장. 단위 테스트의 원칙 코드가 처음 작성될 때 그리고 수정될 때마다 코드가 의도한 대로 작동한다는 것을 스스로 확신할 수 있는 방법이 필요하다. 테스트는 이러한 확신을 하기 위한 주된 방법이다. 10.1 단위 테스트 기초 테스트 중인 코드(code under test): '실제 코드'라고도 하고 테스트의 대상이 되는 코드 테스트 코드(test code): 단위 테스트를 구성하는 코드 테스트 케이스(test case): 특정 동작이나 시나리오를 테스트 준비(arrange): 테스트 값을 정의, 의존성 설정, 인스턴스 설정 실행(act): 동작을 실제로 호출하는 코드 단언(assert): 반환값이 예상한 값과 같은가 테스트 러너(test ..

2023. 1. 1. 19:55

도서 요약

좋은 코드, 나쁜 코드) 7장. 코드를 오용하기 어렵게 만들라

좋은 코드, 나쁜 코드 도서를 요약한 내용입니다. 7장. 코드를 오용하기 어렵게 만들라 코드를 잘못 사용할 수 있는 몇 가지 일반적인 경우는 다음과 같다. 호출하는 쪽에서 잘못된 입력을 제공 다른 코드의 부수 효과(입력 매개변수 수정 등) 정확한 시간이나 순서에 따라 함수를 호출하지 않음 관련 코드에서 가정과 맞지 않게 수정이 이루어짐 7.1 불변 객체로 만드는 것을 고려하라 객체가 생성된 후에 상태를 바꿀 수 없다면 이 객체는 불변(불가변) immutable이다. 불변성이 바람직한 이유를 이해하기 위해서는 그 반대인 가변(mutability) 객체가 어떻게 문제를 일으킬 수 있는지 고려해야 한다. 가변 객체는 추론하기 어렵다. 가변 객체는 다중 스레드에서 문제가 발생할 수 있다. 7.1.1 가변 클래스..

2023. 1. 1. 19:54

도서 요약

좋은 코드, 나쁜 코드) 6장. 예측 가능한 코드를 작성하라

좋은 코드, 나쁜 코드 도서를 요약한 내용입니다. 6장. 예측 가능한 코드를 작성하라 6.1 매직값을 반환하지 말아야 한다 매지값의 일반적인 예는 값이 없거나 오류가 발생했음을 나타내기 위해 -1을 반환하는 것이다. 매지값은 함수의 정상적인 반환 유형에 들어맞기 때문에 이 갑이 갖는 특별한 의미를 인지하지 못하고, 이에 대해 적극적으로 경계하지 않으면 정상적인 반환값으로 오인하기 쉽다. 6.1.1 매직값은 버그를 유발할 수 있다 값이 없음을 나타내기 위해 함수에서 -1을 반환하는 것을 접한 적이 있을 것이다. 일부 레거시 코드와 언어의 내장된 함수들(예: 자바스크립트에서 배열에 대해 indexOf()를 호출할 때) 중에 이런 경우가 있다. User 클래스 및 getAge() 함수 public class ..

2023. 1. 1. 19:53

도서 요약

좋은 코드, 나쁜 코드) 5장. 가독성 높은 코드를 작성하라

좋은 코드, 나쁜 코드 도서를 요약한 내용입니다. 5장. 가독성 높은 코드를 작성하라 가독성은 본질적으로 주관적인 것이며 그것이 정확히 무엇을 의미하는지 확실하게 정의하기 어렵다. 가독성의 핵심은 개발자가 코드의 기능을 빠르고 정확하게 이해할 수 있도록 하는 것이다. 5.1 서술형 명칭 사용 토스터라는 단어는 부엌에 있는 가전제품을 고유하게 식별하면서 그것이 무엇을 하는지도 많은 힌트를 준다. 즉, 그것은 무엇인가를 굽는 것이다. 만약 토스터를 토스터라고 부르는 대신 '객체 A'라고 주장한다면 '객체 A'가 정확히 무엇이고 무엇을 하는지 기억하기 쉽지 않을 것이다. 5.1.1 서술적이지 않은 이름은 코드를 읽기 어렵게 만든다. public class T { Set pns = ..

2023. 1. 1. 19:51

spring

Spring REST docs 만들기

Spring REST docs 작성법 Spring으로 작성된 코드를 아래형식으로 문서화 파일을 만들어보자. 소개 Spring REST docs는 restful 서비스의 문서를 정교하고 읽기 쉽게 하는데 도움을 주는데 목적이 있다. 기본적으로 asciidoctor를 사용하지만 markdown으로 구성을 할 수도 있다. Spring MVC의 테스트 프레임워크로 작성된 테스트케이스로 스니펫(snippets)을 사용한다. Spring의 기본적인 설명을 하면 내용이 너무 길어지므로 REST docs 작성을 위한 내용이 아니면 제외하였다. 필요사항 Java 8 Spring Framework 5 빌드 환경 구성 빌드환경은 maven으로 구성을 해보겠다. gradle로 구성할 경우 spring 공식문서를 참조하길 바란..

2022. 12. 31. 20:34

elasticsearch

[elasticsearch] nested object 추가,수정 시 docs 수 변화

nested object`로 구성되어 있는 index는 nested 유형에 대해 새로운 document를 생성한다. 예를 들어 nested object를 가지고 있는 문서(부서)에 하나의 값(직원)을 추가하면 1개의 document가 생성될 것 같지만 실제로는 2개의 document가 생성이 된다. 예제를 통해 확인해보자. [문서 구조] department (document) employees (nested) 부서(department) 인덱스 생성 PUT department { "mappings": { "properties": { "name": { "type": "text" }, "employees": { "type": "nested" } } } } mapping 정보 확인 GET department/_..

2022. 12. 31. 14:52

여러가지

맥북에서 트랙패드가 정상동작하지 않을 때

맥북쓰다가 화면전환이 필요해서 손가락으로 화면이동을 해도 먹지 않는 경우가 종종 발생한다. 그럴때 마다 재부팅을 하곤 했었는데 Dock을 간단하게 복원하는 명령어이다. $ killall Dock 이 명령어로 맥의 Dock이 재기동이 되고 손가락 4개 터치가 다시 정상적으로 작동 한다.

2022. 12. 30. 19:12

front-end

textarea에 syntax highlighter 적용하기

textarea에 하이라이팅 기능을 적용할 일이 있었는데 기본적으로 하이라이팅을 적용할 수가 없다. 그래서 자료를 참고해서 만들어 보았다. 우선 textarea에 영역을 덮어서 변경되는 값을 표시하면서 하이라이팅을 적용하는 방법을 알아냈다. 하이라이팅은 highlight.min.js를 이용하여 적용하였다. 1. style 적용 2. script 적용 html 적용 curl 'http://localhost:8080/users' -i -X PUT \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -d '{ "name" : "rudaks", "comment" : "user comment" }' 결과 화면) 기본화면 적용하고 나면 아..

2022. 12. 29. 09:48

파워포인트,키노트

파워포인트 배경색 스타일 30개

파워포인트 작성 시 배경색과 폰트를 어떤 색으로 해야 할지 항상 고민이 된다. 흰색 바탕으로 그냥 작성을 해도 되지만 발표용으로 작성할때는 뭔가 색깔을 넣으면 좀 있어 보이기도 하고, 잘 작성된 문서를 보면 엄청 이뻐 보이지만 내가 만드는 문서는 도무지 이쁘게는 잘 되지 않는다. 항상 같은 고민이지만 파워포인트 만들 때 도대체 무슨 색으로 해야 할까 하는 생각에 많은 시간을 허비한다. (고민한다고 별루 좋아지지는 않더라~) 그래서 이런 고민을 하는 시간을 좀 줄여보고자 자주 사용할 만한 배경화면으로 사용할 색을 30개 만들어 보았다. 여러가지 색깔로 구성된 배경화면으로 최초 파워포인트 작성 시 유용하게 사용할 수 있지 않을까 생각된다. 필요하신 분들은 파일을 다운받아서 사용하셔도 됩니다.

2022. 12. 27. 20:13

database

varchar (5) 가 char일까? byte일까?

db 버전별로 다름 직접 확인이 필요하다. mysql varchar(10)로 생성 시 v4까지는 byte로 인식 v5부터 char로 인식 https://extbrain.tistory.com/43 postgresql varchar(10) — 10byte가 아니라 10문자수를 의미한다. (한글/영문 모두) 실제로는 utf-8이면 3 byte로 인식 select length(‘가’), lengtb(‘가’); https://www.postgresdba.com/bbs/board.php?bo_table=B10&wr_id=95 oracle varchar(10) - 10 byte, 한글은 3byte, 영문자/숫자 - 1byte varchar(10 char) - 10문자 varchar(4000 char) - 테이블 생성..

2022. 12. 26. 20:58

spring

spring cloud config refresh 적용

spring cloud config를 사용하는 경우 config 설정이 변경될 때 적용하는 방법에 대한 설명이다. 1. Spring Boot Application Properties Spring application은 파일 혹은 config server에서 propertes를 읽어 들인다. 2. refreshing properties 스프링 컨텍스트에서 properties를 갱신할 때 2가지 단계가 있다. Environment에서 property source를 reloading하는 것과 Spring beans의 속성을 refreshing하는 것. Spring Cloud Config Server를 사용하는 경우에 Spring Cloud는 config client에서 property를 refresh하기 위해..

2022. 12. 23. 07:44

도서 요약

[실용적인 프로그래머] 내용 정리

실용적인 프로그래머 도서를 요약한 내용입니다. 서문 도구 벤더 - 자신의 제품이 수행할 수 있는 기적같은 일들을 자랑. 방법론 도사 - 자신의 기법이 좋은 결과를 보장한다고 약속 도구든, 언어든, 운영체제든 상관없이 최고의 해결방안 같은 것도 없다. 특정한 환경 조건의 집합마다 각 집합에 가장 적절한 시스템들이 있을 뿐이다. ==> 이것이 실용주의가 뜻하는 바다. 어떤 특정 기술에 매이면 안 되며, 개별 상황마다 그 상황에서 좋은 해결방안을 고를 수 있도록 충분한 배경지식과 경험을 가져야 한다. 배경지식은 컴퓨터 과학의 기본 원리들을 이해하는 것에서 나오고, 경험은 다양한 범위의 실제 프롲게트들을 수행해보는 것에서 나온다. 이론과 실천의 결합이 여러분을 강하게 만든다. 이 책은 누가 읽어야 할까? 이 책..

2022. 12. 23. 07:43

java

Json을 flat하게 표시하는 방법

Json을 계층구조로 표시하지 않고 1depth로 flat하게 표시하는 방법이다. 하나의 예를 보자. 다음과 같이 User는 UserName을 속성으로 가지고 있다. @AllArgsConstructor @Getter public class User implements JsonSerializable { private String id; private UserName userName; public static void main(String[] args) { User user = new User("rudaks94", new UserName("rudaks", "han")); System.out.println(user); } @Override public String toString() { return JsonU..

2022. 12. 23. 07:42

maven

[intelli] intellij build outofmemoryerror gc overhead limit exceeded

VM Options에 메모리를 설정 -Xms1024m -Xmx1024m Build, Execution, Deployment > Build Tools > Maven > Runner > VM options Build, Execution, Deployment > Build Tools > Maven > Importing > VM options for importer

2022. 12. 23. 07:40

maven

mvn의 plugin의 goal 실행

아래와 같이 maven에서 특정 plugin의 id를 실행하려면 아래와 같이 명령어를 실행하면 된다. 방법) mvn [plugin]:[goal]@[execution_id] mvn asciidoctor:process-asciidoc@generate-docs org.asciidoctor asciidoctor-maven-plugin ${asciidoctor-maven-plugin.version} org.asciidoctor asciidoctorj ${asciidoctorj.version} org.springframework.restdocs spring-restdocs-asciidoctor ${spring-restdocs.version} generate-docs prepare-package process-asc..

2022. 12. 23. 07:40

개발도구(Intellij, vscode 등)

intellij에서 target 폴더가 안보이면

Project > show options menu에서 "Show Excluded Files"를 체크하면 된다.

2022. 12. 23. 07:39

개발도구(Intellij, vscode 등)

[intelli] intellij build outofmemoryerror gc overhead limit exceeded

VM Options에 메모리를 설정 -Xms1024m -Xmx1024m Build, Execution, Deployment > Build Tools > Maven > Runner > VM options Build, Execution, Deployment > Build Tools > Maven > Importing > VM options for importer

2022. 12. 23. 07:39

spring

zuul filter를 이용해서 http method 변경하기

금융권에서는 보안상의 이유로 GET, POST만 허용하고 PUT, DELETE를 사용하지 못하게 하는 경우가 있다. zuul gateway를 사용하는 경우 zuul filter를 사용하여 http method를 변경하는 방법이 있다. 예를 들어 UI -> Gateway(zuul) -> App 방식으로 호출하는 경우 UI에서는 GET, POST만 사용하고 Gateway에서 App을 호출하는 경우 실제 HTTP Method로 변경해주는 방법이다. 요청 헤더에 change-method=PUT 으로 요청하면 Gateway 호출시는 POST로 호출하고 zuul에서 App 호출할 때는 PUT으로 변경한다. 예) UI에서 아래와 같이 호출한다. POST http://localhost:8080/users/users c..

2022. 12. 23. 07:37

kafka

KafkaListener에서 서로 다른 message mapping하기

다른 2개의 서비스에서 동일 토픽을 다른 클래스(서비스내 클래스)로 매핑하는 방법이다. [A서비스에서 메시지 발행] topicId: message-topic message는 2가지 발행: service1.model.TextMessage, service1.model.FileMessage [B서비스에서 메시지 구독] topicId: message-topic message는 2가지 발행: service2.model.TextMessage, service2.model.FileMessage spring kafka에서 발행한 메시지의 헤더를 보면 __TypeID__라는 것이 있다. 이것은 메시지를 보낼 때의 데이터 객체 타입을 매핑하여 전송하게 되고 실제 수신받는 컨슈머는 이 객체타입을 사용하여 deserialize..

2022. 12. 23. 07:36

spring

스프링 클라우드 어노테이션

스프링 클라우드 어노테이션 https://javatechonline.com/spring-cloud-annotations-with-examples/ 위의 문서를 번역한 내용이다. @EnableEurekaServer 여러분이 스프링 부트 & 스프링 클라우드를 사용하여 마이크로서비스 기반 프로젝트를 개발한다면, 유레카(Eureka) 서버를 만들기 위해서 마이크로서비스의 메인 클래스에 적용하게 되는 첫 번째 어노테이션이 될 것이다. 이것은 이름에서 알 수 있듯이 유레카(Eureka) 서버를 가능하게 하는 것이다. 이 어노테이션을 서비스 레지스트리(Service Registry) & 디스커버리(Discovery)의 문맥(Context)에서 이 어노테이션을 사용할 것이다. 서비스 레지스트리(Service Regis..

2022. 12. 23. 07:32