코딩하는 지니

2025년 6년차 개발자 회고

균지니 — Sun, 18 Jan 2026 20:29:19 +0900

고용보험 합산 기준으로 6년 차였던 2025년.

지금 돌아보면, 내 2025년은 상반기와 하반기가 꽤 분명하게 갈린 해였다. 아니 극명하게 나뉜다.

상반기에는 취준을 하게 되었다.

원하는 결과가 나오지 않다 보니 “이제 개발자를 계속해야 하나?”라는 생각까지 들 정도로 마음이 많이 흔들렸다.

직업을 바꿔야 하나, 지금까지 해온 선택들이 맞았나—그런 고민을 정말 많이 했던 시기였다.

그러던 중 우연히 여의도에 있는 백엔드 개발자 공고를 보게 되었고 지원을 하게 되었다.

10년 차 핀테크 스타트업이고 좋은 기회로 이력서 합격이 되어 기술면접, 임원면접까지 이어졌다.

이번이 정말 마지막 기회일지도 모른다는 생각으로, 잘 보이려고 포장하기보다는 내가 해온 경험과 부족했던 부분까지 최대한 솔직하게 이야기했다. 그게 오히려 좋게 보였던 것 같다. CTO 면접이 끝나고 집에 가는 길에 바로 최종 합격 연락을 받았다.

그 순간의 안도감과 기쁨으로 버스에서 눈물 날 뻔했다.

입사 전, 또 하나의 기회가 있었다. 토스 이력서 합격으로 기술 면접을 보게 되었고,

결과는 탈락이었다.

아쉽긴 했지만, 개인적으로는 정말 많이 배운 면접이었다. 토스 면접을 한마디로 정리하면, “역시 토스였다.”

단순한 CS 지식 Q&A보다는 내가 실제로 일했던 회사의 구조를 바탕으로 대규모 트래픽 상황을 던져주고 “이 상황이라면 어떻게 설계하고 대응할 것인가?”를 계속 물어보는 방식이었다. 이론 지식, 실무 경험, 개인 학습이 자연스럽게 섞여야 답할 수 있는 질문들이었고, 그 답변 과정 자체로 지원자를 검증하는 느낌을 받았다.

‘아, 이런 방식의 면접도 있구나.’ 그리고 동시에, ‘아직 공부해야 할 게 정말 많다.’는 걸 다시 한번 느꼈다.

취업 준비로 마음고생을 꽤 많이 했던 터라, 입사 전에는 나 자신에게 보상하는 의미로 여행을 다녀왔다.

바다 보는 걸 좋아해서 강릉으로 갔다. 강릉 바다를 보면서 “하반기에는 새로운 회사에 잘 적응해 보자”

“너무 조급해하지 말고, 다시 차근차근 가보자” 이런 생각들을 정리하고 서울로 돌아왔다.

그리고 6월 1일, 설레는 마음으로 출근을 시작했다.

내가 맡게 된 서버는 코틀린 기반도 있었고 헥사고날 아키텍처도 처음 접해보며 (코틀린 짱!!!!!!)

MSA 환경에서 도메인 서버 간 연동, QA 프로세스 등 이전보다 훨씬 체계적인 방식으로 개발을 하게 되었다.

처음엔 낯설었지만, 디버깅, 연동 개발, 장애 원인 분석 같은 부분에서 확실히 많이 성장했다는 걸 스스로 느낄 수 있었다.

정말 말 그대로 불태우듯 일했던 몇 달이었다.

그러던 중, 회사 내부에서 좋지 않은 이야기들이 조금씩 들려오기 시작했다. 전반적인 시장 분위기도 그렇고, 회사 상황에 대한 소문까지 겹치니 마음이 다시 조금씩 불안해졌다. ‘가만히 있기보다는 준비는 해두자.’ 그런 마음으로 이직을 다시 고민하게 되었고, 동료 개발자의 추천으로 다른 회사 면접을 보게 되었다.

그 면접을 통해 느낀 점도 토스 때와 크게 다르지 않았다.

“내가 알고 있다고 생각했던 개념들을 정말 제대로 이해하고, 내 언어로 설명할 수 있어야겠구나.” 개발자 친구와 이야기하며 조언도 받았다.

지금 회사가 애자일 + 2주 단위 스프린트 체제라 병행이 쉽진 않겠지만, 완벽하려고 하지 말고 공부할 수 있는 시간을 조금씩이라도 확보해서 점진적으로 공부량을 늘려보라는 말이었다.

한 달 동안 회사 일과 이직 준비를 병행했었는데, 솔직히 정말 쉽지 않았다.

업무도 놓치고 싶지 않았고, 면접 기회도 내겐 소중했기 때문에 스스로에게 꽤 큰 압박을 줬던 것 같다.

결과는 아직 기다리는 중이지만, 내가 할 수 있는 만큼은 다 했다고 생각한다. 그래서 후회는 없다.

연말, 회사 겨울방학을 맞아 입사 전에도 갔던 강릉을 다시 찾았다.

초당옥수수 라떼도 너무 맛있었고, 초당순두부 짬뽕, 한식까지— 방문했던 곳 하나하나 다 좋았다.

그리고 역시, 바다는 좋다. 복잡한 생각들을 자연스럽게 정리해 준다.

2026년에는

조금 더 단단해진 사람으로,

조금 더 성장한 개발자로 나아갈 수 있기를 바란다.

천천히 가더라도 멈추지 말자.

잘해보자.

힘!!

[QueryDSL] Q클래스 생성 오류 해결 (Error, Unsupported Java)

균지니 — Sat, 16 Mar 2024 17:07:20 +0900

1. 개요

최근 QueryDSL 개발 중 Q 클래스 생성 오류 문제에 직면했는데, 해결해서 지금은 잘 작동을 하게 되었습니다.
그런데 골칫덩어리 빌드 생성 문제가 계속 나타날 것 같아 히스토리를 남기고 해결 방법을 공유하고자 합니다.

2. 오류

unsupported java. your build is currently configured to use java 21.0.1 and gradle 8.4.

위 오류 발생으로 Q 클래스 빌드 안됨

3. 해결과정

오류 스펙 : Java 21 (zulu 21) + Gradle 8.5 + lombok 1.8.30 스펙에서 빌드가 안돼서 구글링을 해보니 아래 스펙들의 버전이나 호환문제로 QueryDSL Q파일 생성 방법이 다르다고 하여 몇 차례 해결 시도 내용을 적어봅니다.

Spring boot

Java

Gradle

Lombok
IntelliJ

정말 위 스펙들의 버전이나 호환성 문제인가? 일단 구글링을 통해서 해결을 하고 찾을 수 있는 원인은 알아가보자!

3.1. 1차

Unsupported Java. Your build is currently configured to use Java 21.0.1 and Gradle 8.5. · Issue #27272 · gradle/gradle

Current Behavior When executing the build, it prompts: Unsupported Java. Your build is currently configured to use Java 21.0.1 and Gradle 8.5. Possible solution: - Use Java 20 as Gradle JVM: Open G...

github.com

Gradler과 lombok 버전의 문제가 있을 수도 있다 해서, 아래 버전으로 맞춰서 빌드를 해봤다.
Java 21 (zulu 21) + Gradle 8.4 + lombok 1.8.30

나이스 성공적~!

3.2. 2차

개발 수정으로 Q 클래스 다시 빌드해야 되는데, 빌드 과정에서 상위에 기입한 unsupported java. your build is currently configured to use java 21.0.1 and gradle 8.4. 빌드 오류가 났다.

갑자기 또 왜 안돼? ㅋㅋㅋㅋ
clean 누르고, 캐시도 비우고, 프로젝트 껐다 반복도 하고, 난리를 치다가 안돼서 결국 퇴근했다.
퇴근 후 헬스하고 단백질 섭취 한 다음에 TDD 수행을 했다.

TDD 팝콘 섭취 수행 이후, 다시 검색을 해봤다.
인프런에서 영한님 답변 + 여러 수강생분들이 해결한 사례를 토대로 설정 변경도 해봤지만 빌드 실패했다.

compileQuerydsl없음 - 인프런

안녕하세요현재 프로젝트 세팅부터 막혀서 질문 드립니다.질문은 크게 3가지입니다. build 잘됨Gradle Tasks other compileQuerydsl -> 없음 ( spring boot3이상으로 되면서 안보이는게 맞나요)?build.gradleplugins {.

www.inflearn.com

3.3. 3차

아침에 출근 후 차분히 구글링을 하다가 stack overflow에서 QueryDSL 릴리스 노트의 힌트를 얻었다는 답변을 보게 되었다.
내용 보니깐 querydsl-apt가 querydsl-jpa에 종속성으로 포함되어 있어 두 버전을 맞춰줘야 한다는 내용이었다.
dependencyManagement에서 querydsl 버전을 가져오지 못하는 것 같다.
jpa 버전에 맞춰서 apt 버전을 명시해 주니 다시 빌드가 잘됐다.ㅎㅎㅎㅎ

릴리스 노트 :
http://querydsl.com/releases.html

Querydsl - Unified Queries for Java

5.0 5.0.0 (22.7.2021) This release of QueryDSL targets Java 8 minimally and comes with various improvements to make QueryDSL ready for the modern Java ecosystem. This version also removes joda-time:joda-time, com.google.guava:guava and com.google.code.find

querydsl.com

https://github.com/querydsl/querydsl/issues/373

Make querydsl-apt dependency use "provided" scope in QueryDSL 3.0.0+ · Issue #373 · querydsl/querydsl

In QueryDSL 3.0.0, querydsl-jpa currently includes querydsl-apt as a dependency with scope provided, which is expected, since that would only be used at compile time and not needed otherwise. Howev...

github.com

matthewadams님, mr.cat님 덕분에 해결해서 정말 다행이다.
querydsl 좀 예민해서 빌드 생성 오류 문제가 종종 발생할 것 같은데, 해결하게 되면 해당 포스팅 글에 계속 업데이트할 예정이다.
실질적인 상세 해결 방법은 4번 항목을 참고해 주세요.

4. 해결방법

현재 나의 프로젝트 기술 스펙에는 아래와 같은 버전과 설정으로 사용하는 게 맞다는 걸 알게 되어 공유합니다.

Java 21 (zulu-21)
Spring boot 3.2.1
Gradle 8.5
Querydsl 5.0
Lombok 1.18.30
IntelliJ Idea
- Build and Run : IntelliJ
- Run tests using : IntelliJ
- 설정을 Gradle로 변경하고 빌드해 보라는 블로그 글을 봤었는데, 안돼서 IntelliJ로 설정해 줬다.

build.gradle 의존성 교체

# 기존
dependencies {
    .. 생략
    implementation 'com.querydsl:querydsl-jpa:5.0.0:jakarta'
    annotationProcessor "com.querydsl:querydsl-apt:${dependencyManagement.importedProperties['querydsl.version']}:jakarta"
    .. 생략
}

# 수정
dependencies {
    .. 생략
    implementation 'com.querydsl:querydsl-jpa:5.0.0:jakarta'
    annotationProcessor "com.querydsl:querydsl-apt:5.0.0:jakarta"
    .. 생략
}

의존성을 간략하게 보겠습니다.
- Querydsl 사용하려면 Q 클래스를 생성해야 하는데, 소스 코드 레벨에서 Querydsl 관련 어노테이션들을 처리하고 쿼리 타입 클래스들을 생성해 주는 역할을 querydsl-apt가 해줍니다.
- gradle 프로젝트에서는 Querydsl 처리를 위해 annotationProcessor가 필요하고 com.querydsl:querydsl-apt 그룹 및 아티팩트를 dsl 버전 기입, :jakarta는 QueryDSL이 사용하는 모듈 시스템을 지정합니다. (java ee -> jakarta ee로 명칭을 변경했죠)

Spring boot 3 with queryDSL

How i can to generate Q-classes using queryDSL with Spring Boot 3.0. part of build.gradle: plugins { id 'com.ewerk.gradle.plugins.querydsl' version '1.0.10' } configurations { querydsl.exten...

stackoverflow.com

build.gradle (상세 - Querydsl 빌드 옵션 포함)

plugins {
    id 'java'
    id 'org.springframework.boot' version '3.2.1'
    id 'io.spring.dependency-management' version '1.1.4'
}

group = 'com.exflyer'
version = '0.0.1-SNAPSHOT'

java {
    sourceCompatibility = '21'
}

configurations {
    compileOnly {
        extendsFrom annotationProcessor
    }
}

repositories {
    mavenCentral()
}

dependencies {
    // Web
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.boot:spring-boot-starter-validation'
    implementation 'org.springframework.boot:spring-boot-starter-webflux'
    implementation 'com.google.code.gson:gson:2.10.1'
    implementation 'com.googlecode.json-simple:json-simple:1.1.1'

    // DB
    //implementation 'com.mysql:mysql-connector-j:8.2.0'
    runtimeOnly 'com.mysql:mysql-connector-j:8.2.0' // 8.x 버전 이상
    runtimeOnly 'com.h2database:h2'

    // JPA
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'

    // QueryDSL
    implementation 'com.querydsl:querydsl-jpa:5.0.0:jakarta'
    annotationProcessor "com.querydsl:querydsl-apt:5.0.0:jakarta" // 수정
    annotationProcessor "jakarta.annotation:jakarta.annotation-api"
    annotationProcessor "jakarta.persistence:jakarta.persistence-api"

    // Lombok
    compileOnly 'org.projectlombok:lombok'
    annotationProcessor 'org.projectlombok:lombok'
    testAnnotationProcessor 'org.projectlombok:lombok'

    // Test
    testImplementation 'org.springframework.boot:spring-boot-starter-test'

    // Api Docs
    implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.3.0'

    // Slack
    implementation 'com.slack.api:slack-api-client:1.36.1'

    // Amazon SES
    implementation 'com.amazonaws:aws-java-sdk-ses:1.12.472'
    implementation 'com.amazonaws:aws-java-sdk-sesv2:1.12.512'
    implementation 'javax.mail:mailapi:1.4.3'

    // Amazon SQS
    implementation platform("io.awspring.cloud:spring-cloud-aws-dependencies:3.0.1")
    implementation 'io.awspring.cloud:spring-cloud-aws-starter-sqs'
    implementation group: 'org.springframework.cloud', name: 'spring-cloud-aws-messaging', version: '2.2.6.RELEASE'
    implementation group: 'org.springframework.cloud', name: 'spring-cloud-aws-autoconfigure', version: '2.2.6.RELEASE'


    //kafka
    implementation 'org.springframework.kafka:spring-kafka'
    testImplementation 'org.springframework.kafka:spring-kafka-test'
    implementation 'org.springframework.cloud:spring-cloud-stream'
    implementation 'org.springframework.cloud:spring-cloud-stream-binder-kafka'
    implementation 'org.springframework.kafka:spring-kafka'
    testImplementation 'org.springframework.cloud:spring-cloud-stream-test-binder'
    testImplementation 'org.springframework.kafka:spring-kafka-test'
}

ext {
    set('springCloudVersion', "2023.0.0")
}
dependencyManagement {
    imports {
        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"

    }
}
tasks.named('test') {
    useJUnitPlatform()
}

// QueryDSL 빌드 옵션 (선택) ~
def querydslSrcDir = 'src/main/generated'
clean {
    delete file(querydslSrcDir)
}
tasks.withType(JavaCompile) {
    options.generatedSourceOutputDirectory = file(querydslSrcDir)
}
// ~ Querydsl

gradle-wrapper.properties

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-bin.zip
networkTimeout=10000
validateDistributionUrl=true
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

마무리

Q파일 빌드 실패 시, QueryDSL 연관된 의존성 lib 종속성도 확인해야 한다는 것을 알았다.
관련 오류가 나는 분들이라면 jpa랑 apt 버전을 동일하게 맞추거나 호환 버전을 확인 후에 수정해 보시는 것도 해결하는데 도움이 되지 않을까 싶습니다. 도움이 되길 바라며 이상 글 마무리 하겠습니다.

[SpringBoot] 실행 시 오류 : Failed to configure a DataSource 해결방법

균지니 — Tue, 15 Aug 2023 23:28:15 +0900

SpringBoot 프로젝트에 JPA 의존성을 추가하고 나서 프로젝트를 기동을 하는데 다음과 같은 에러가 발생했다. 새로운 프로젝트를 설정하고 실행할 때 여러 에러들을 만나게 되는데, 그 중 '데이터 소스 구성 실패' 오류의 원인과 해결 방법에 대해 정리합니다.

문제상황

스프링 부트 3.1.2 + Java 17 + ORM로 개인 프로젝트를 시작했다.

프로젝트에 필요한 의존성을 설정하고 IntelliJ에서 Gradle import 시킨 후 애플리케이션을 실행했다.

기동을 하다가 다음 오류 메시지와 함께 실행이 되지 않았다.

build.gradle

plugins {
	id 'java'
	id 'org.springframework.boot' version '3.1.2'
	id 'io.spring.dependency-management' version '1.1.2'
}

group = 'com.yunjin'
version = '0.0.1-SNAPSHOT'

java {
	sourceCompatibility = '17'
}

configurations {
	compileOnly {
		extendsFrom annotationProcessor
	}
}

repositories {
	mavenCentral()
}

dependencies {
	implementation 'org.springframework.boot:spring-boot-starter-web'
	implementation 'org.springframework.boot:spring-boot-starter-data-jpa' 
	implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
	compileOnly 'org.projectlombok:lombok'
	annotationProcessor 'org.projectlombok:lombok'
	testImplementation 'org.springframework.boot:spring-boot-starter-test' 
}

tasks.named('test') {
	useJUnitPlatform()
}

Console

2023-08-15T21:43:39.364+09:00  WARN 5160 --- [           main] ConfigServletWebServerApplicationContext : Exception encountered during context initialization - cancelling refresh attempt: org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'dataSourceScriptDatabaseInitializer' defined in class path resource [org/springframework/boot/autoconfigure/sql/init/DataSourceInitializationConfiguration.class]: Unsatisfied dependency expressed through method 'dataSourceScriptDatabaseInitializer' parameter 0: Error creating bean with name 'dataSource' defined in class path resource [org/springframework/boot/autoconfigure/jdbc/DataSourceConfiguration$Hikari.class]: Failed to instantiate [com.zaxxer.hikari.HikariDataSource]: Factory method 'dataSource' threw exception with message: Failed to determine a suitable driver class
2023-08-15T21:43:39.367+09:00  INFO 5160 --- [           main] o.apache.catalina.core.StandardService   : Stopping service [Tomcat]
2023-08-15T21:43:39.387+09:00  INFO 5160 --- [           main] .s.b.a.l.ConditionEvaluationReportLogger : 

Error starting ApplicationContext. To display the condition evaluation report re-run your application with 'debug' enabled.
2023-08-15T21:43:39.418+09:00 ERROR 5160 --- [           main] o.s.b.d.LoggingFailureAnalysisReporter   : 

***************************
APPLICATION FAILED TO START
***************************

Description:

Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured.

Reason: Failed to determine a suitable driver class


Action:

Consider the following:
	If you want an embedded database (H2, HSQL or Derby), please put it on the classpath.
	If you have database settings to be loaded from a particular profile you may need to activate it (no profiles are currently active).


Process finished with exit code 1

원인

오류 내용을 파파고로 번역하면 아래와 같다.

설명:

데이터 소스를 구성하지 못했습니다. 'url' 특성이 지정되지 않았으며 내장된 데이터 소스를 구성할 수 없습니다.
이유: 적합한 드라이버 클래스를 결정하지 못했습니다.

작업:

다음 사항을 고려합니다:
내장된 데이터베이스(H2, HSQL 또는 Derby)를 원하는 경우 클래스 경로에 배치하십시오.
특정 프로파일에서 로드할 데이터베이스 설정이 있는 경우 활성화해야 할 수 있습니다(현재 활성화된 프로파일이 없음).

내용을 확인하고 다음과 같은 궁금증이 생겼습니다.

왜 때문에 JPA는 추가적인 데이터 소스를 구성해야 하는 것일까?

이 문제의 해결책으로 정리해논 여러 글을 읽어본 후 이해할 수 있었다. 답은 JPA에 있었다.

기본적으로 Spring Boot는 애플리케이션을 기동 할 때 설정된 정보를 바탕으로 빈을 자동으로 구성하려고 시도합니다.

프로젝트에 설정된 JPA 종속성(dependency)을 확인하며, JPA는 내부적으로 JDBC API를 사용하기 때문에 JPA DataSource의 자동 구성을 수행하는데 필요한 JDBC 연결 속성 정보를 Spring에 제공하지 않았다는 것입니다.

MySQL 및 MSSQL/Oracle 등 외부 데이터베이스로 작업을 할 때는 무조건 데이터베이스 설정을 해줘야 하며, 반면에 H2와 같은 인메모리 데이터베이스는 외부 연결 정보 없이 데이터 소스를 생성할 수 있으므로 의존성만 추가해 줘도 애플리케이션 실행은 됩니다.

요약하면 DataSource 구성에 필요한 데이터베이스가 설정되지 않아 발생하는 문제로 사용자가 원하는 데이터베이스 라이브러리 및 드라이버 설치 등 JDBC 설정을 해야 합니다.

해결책

1. 데이터 소스 정의

데이터베이스 연결이 누락되어 문제가 발생했으므로, 의존성 및 설정 정보를 추가하여 문제를 해결할 수 있습니다.

저의 경우 인메모리 데이터베이스 H2 DB를 사용합니다. 먼저 프로젝트의 build.gradle에 h2 의존성을 추가해 줍니다.

(Gradle Refresh 꼭 진행해 주세요. 의존성을 추가 또는 수정하면 build.gradle에서 버튼이 자동으로 나타납니다. 클릭~)

dependencies {
	... 생략
	runtimeOnly 'com.h2database:h2'
}

프로젝트가 생성될 때 src/main/resources 폴더 경로에 appliction.properties 빈파일이 자동 생성됩니다. 해당 파일에 데이터베이스 설정 정보를 기입하셔도 되고 application.yml 파일을 추가하여 설정 하셔도 됩니다. (저는 application.yml 사용)

spring:
  jpa:
    show-sql: true
    properties:
      hibernate:
        format_sql: true
    defer-datasource-initialization: true
  datasource:
    url: jdbc:h2:mem:testdb
  h2:
    console:
      enabled: true

위와 같이 데이터 소스 속성을 정의하여 문제를 해결할 수 있습니다.

2. DataSourceAutoConfiguration 제외

아직 데이터 소스를 정의할 준비가 되지 않은 상황이 있을 수도 있습니다.

즉, 어떤 데이터베이스를 사용할지 결정하지 않았으면 당장 JDBC 설정이 필요 없는 경우로 Spring Boot가 데이터 소스를 자동으로 구성하는 것을 방지하면 됩니다.

2.1 @SpringBootApplication

스프링부트 메인 클래스에 @SpringBootApplication 애노테이션의 exclude 속성을 사용하여 자동 구성을 비활성화합니다.

@SpringBootApplication(exclude={DataSourceAutoConfiguration.class})
public class SpringbootBlogApplication {

	public static void main(String[] args) {
		SpringApplication.run(SpringbootBlogApplication.class, args);
	}
}

DataSourceAutoConfiguration 클래스는 데이터 소스를 구성하기 위한 기본 클래스로 다른 빈을 자동 구성하는 데 영향을 미치지 않는다고 합니다.

2.2 application.yml

application.yml 파일을 사용하여 동일한 작업을 수행할 수 있습니다.

spring:
  autoconfigure:
    exclude:
    - org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration

2.1/2.2 두 가지 방법 중 하나를 사용하여 스프링 부트의 DataSource의 자동 구성을 비활성화할 수 있습니다.

마무리

스프링 부트 실행 시 '데이터 소스 구성 실패' 오류의 원인을 살펴보았습니다.

데이터 소스를 정의하여 문제를 해결할 수도 있고, 정의를 하지 않고 코드로 자동 구성을 비활성화하여 문제를 해결하는 방법에 대해 알아봤습니다. 저는 데이터 소스를 정의해서 문제를 해결했습니다. 각자 프로젝트 상황에 맞게 해결해주세요!

오류 해결에 도움이 되길 바라며 이상 코딩하는 지니였습니다.

참고

https://lemontia.tistory.com/586

[Lombok][Jackson] Naming convention for getters/setters in Java

균지니 — Sun, 16 Jul 2023 15:23:33 +0900

개요

대외서비스 연계 API 테스트를 하다가 특정 필드의 데이터가 null로 들어오는 이슈에 직면했습니다.
처음에 오타가 있는 줄 알고 연계 인터페이스 In/Out 정의서 토대로 변수명을 재차 확인했는데 틀리지 않았음.

잘못 구현했나 싶었으나 다른 필드는 다 잘 매핑됨. 띠용. 따로 샘플 코드 만들어서 테스트해 보고 구글링 통해서 알게 된 Jackson, Lombok, Java Beans 네이밍 규약에 대해서 정리합니다.

이슈내용

외부 API 응답 데이터를 Response 객체에 매핑하여 내부 서비스로 응답해줄 때, 특정 필드값이 null로 매핑되는 현상

{
  "prcssResult": "200",
  "requestId" : "124837",
  "aBCDNo": null
}

내용 : 위와 같은 데이터(샘플)를 응답받는데 특정 필드값이 null 값이 들어오는 것을 확인.

이슈 상세

대외서비스 연계 API 개발을 담당하고 있어서 외부 API 응답값을 그대로 내부 서비스로 보내주는 프로세스이고 내부 서비스에서 연계 서비스의 거래 내역을 확인할 수 있다. (내부 서비스에서 해당 값을 사용함)
외부 API 거래를 Spring Framework기반 HttpURLConnection 방식으로 구현하고 있어 응답 문자열을 로그로 출력해 봤다.
로그상 응답 문자열의 key와 value값도 제대로 나오고, 응답 문자열을 JSON 객체로 변환한 뒤 응답객체로 역직렬화하는 과정도 매핑이 잘된다.
그러나 내부 서비스에서 연계 서비스의 거래 내역을 확인해보면 응답값의 특정 필드가 null로 매핑된다.
정리하면, 외부 API 응답값을 응답객체에 잘 매핑하여 내부 서비스로 HTTP 응답을 주면 특정 필드가 null이 되는 것이다.

샘플코드 작성

원인분석을 위해 Spring Boot로 도메인과 컨트롤러를 테스트용으로 구현했습니다.
블로그에 모든 구현내용을 담을 수 없어서 간단하게 다음과 같이 테스트 코드를 작성했습니다.
- 요청값을 매핑해서, 입력한 대로 잘 매핑되어 출력하는지 확인

Domain

@Setter(AccessLevel.PRIVATE)
@Getter
@ToString
@NoArgsConstructor
public class NamingDto {

    private String aBCDNo;
    private String AAaa;
    private String BBBb;
    private String CCcC;
    private String DDDD;
    private String AAAAAAa;
    private String Aa;
    private String aaA;
    private String Fab;
}

Controller

@Slf4j
@RestController
public class NamingController {

  @PostMapping("/v1/issue/naming/lombok")
    public ResponseEntity<NamingDto> getValue(@RequestBody NamingDto dto) {
      log.info("Request v1/issue/naming/lombok POST/ getValue");
      log.info(String.valueOf(dto));
      return ResponseEntity.ok(dto);
  }
}

Postman 결과

결과를 보면 JSON Key값과 필드명도 다르고 null로 찍힘. 골 때림.
원인분석을 하다 보니깐 HTTP 메시지 컨버터의 쪽의 문제가 아닐까 해서 찾아봤다.
- HTTP 메시지 컨버터가 무엇인가요?
- 요청 본문에서 메시지를 읽어 들이거나(@RequestBody), 응답 본문에 메시지를 작성할 때(@ResponseBody) HTTP 메시지 컨버터가 동작한다.
- HTTP 헤더와 컨트롤러 요청 및 반환타입 정보를 조합해서 컨버터의 여러 종류 중 하나가 선택된다.
- API는 JSON 형태로 받기 때문에 MappingJackson2HttpMessageConverter가 선택되어 Jackson 컨버터가 실행된다.
- 그래서 Jackson 컨버터가 네이밍 규칙에 따라 데이터를 찰떡같이 매핑해준다.
- Jackson과 Jackson의 네이밍 규칙을 알아보자. ✨

원인분석

1. Jackson

스프링에서 JSON 데이터를 객체로 변환하거나 객체를 JSON 데이터로 변환해 주는 라이브러리로 스프링부트에서는 기본적으로 제공해 준다. Jackson 라이브러리는 ObjectMapper라는 클래스를 사용하여 데이터 변환하여 매핑을 해줍니다.

객체를 JSON으로 직렬화를 할 때 ObjectMapper 클래스의 writeValueAsString() 메서드를 사용하여 객체를 JSON 문자열로 변환한다.
객체의 필드 또는 속성 값을 가져와서 해당 값을 JSON 키와 매핑하여 JSON 객체를 생성하고 이를 문자열로 반환시켜 줍니다.

위 과정에서 Key 값을 매핑하는 규칙이 존재.

1.1 Jackson은 Getter의 이름을 기반으로 Json Key 값을 만든다.

필드명 대신에 Getter 이름으로 JSON key값이 설정됨.

Domain

public class JacksonDto {
    private String aBCDNo;

    public void setaBCDNo(String aBCDNo) {
        this.aBCDNo = aBCDNo;
    }

    public String getCheckaBCDNo(){
        return aBCDNo;
    }
}

Domain 테스트 코드

@Slf4j
class JacksonDtoTest {

    private ObjectMapper objectMapper;

    @BeforeEach
    public void setUp(){
        this.objectMapper = new ObjectMapper();
    }

    @Test
    public void Jackson_Getter() throws IOException {
        JacksonDto dto = new JacksonDto();
        dto.setaBCDNo("hello");

        String s = this.objectMapper.writeValueAsString(dto); 
        
        log.info(s);
    }
}

테스트 결과

{"checkaBCDNo":"hello"}
클래스에 선언된 필드는 aBCDNo이고, Getter메서드명은 getCheckaBCDNo()이다.
get다음으로 이어지는 이름을 CheckaBCDNo 가져와서 Jackson의 네이밍 규칙에 의해 변형하여 매핑시킨다.
이제 Jackson 네이밍 규칙을 알아보겠습니다.

1.2 Jackson 네이밍 규칙

모든 케이스에서는 첫 번째 문자 하나만 소문자로 변경합니다.
ex) CheckaBCDNo -> checkaBCDNo
예외 케이스로는 맨 앞 두 글자 모두 대문자인 경우 이어진 대문자를 모두 소문자로 변경합니다.
ex) AAaa -> aaaa , AAAAAAa -> aaaaaaa
기본적으로 JavaBeans 규약을 따르지만 다른 부분이 있음.

2. Java Bean

2.1 Java Beans 네이밍 규칙

Java Beans는 메서드 이름에서 필드명을 추출할 때 일정한 규칙이 존재함.
오라클에서 제공하는 Java Beans API specification 공식 문서에 설명되어 있습니다.

by Sun Microsystems

간단히 요약하면 아래의 설명과 같습니다.

1. 일반적으로는 첫 번째 문자 하나만 소문자로 변환하여 리턴합니다.
2. 예외 케이스로는 두 개 이상의 문자가 있고 첫번째 문자와 두 번째 문자 모두 대문자인 경우 그대로 다시 리턴합니다.

java.beans 패키지에 있는 Introspector 클래스의 decapitalize() 메서드를 확인해 보면 실제로 어떤 로직이 들어가 있는지 알 수 있습니다.

public class Introspector {
	public static String decapitalize(String name) {
	  if (name == null || name.length() == 0) {
	    return name;
	  }
	  if (name.length() > 1 && Character.isUpperCase(name.charAt(1)) &&
	          Character.isUpperCase(name.charAt(0))) {
	    return name;
	  }
	  char[] chars = name.toCharArray();
	  chars[0] = Character.toLowerCase(chars[0]);
	  return new String(chars);
	}         
}

IDE에서 제공하는 Getter and Setter 메서드 자동생성 기능이 Java Beans 네이밍 규약으로 만들어집니다.

3. Jackson와 Java Beans 차이점

둘 다 공통적으로 첫 번째 문자 하나만 소문자로 변환하여 리턴한다.
다른 점은 맨 앞 두 글자(첫 번째, 두 번째) 모두 대문자인 경우
- Jackson은 이어지는 모든 대문자 -> 소문자로 변경하여 반환
- Java Beans은 원래 문자 그대로 반환

4. Lombok의 Getter 생성 규칙

롬복은 맨 앞 글자를 대문자로 바꿔서 만들어줍니다.
롬복의 Getter 이름으로 Jackson 네이밍 규칙에 의해 JSON key값이 설정됨.
필드명 -> Lombok -> Jackson 점진적으로 변경되는 과정을 보자.

필드명 >>	Lombok >>	Jackson
aBCDNo	getABCDNo	abcdno
AAaa	getAAaa	aaaa
BBBb	getBBBb	bbbb
CCcC	getCCcC	cccC
DDDD	getDDDD	dddd
AAAAAAa	getAAAAAAa	aaaaaaa
Aa	getAa	aa
aaA	getAaA	aaA (해당 필드명만 매핑됨)
Fab	getFab	fab

맨 처음 작성했던 샘플코드의 테스트 결과와 동일합니다.

결국, 원인은 Jackson HttpMessageConverter 네이밍 규칙에 의해서
객체의 필드와 JSON Key값 불일치로 매핑 안됨
aBCDNo(필드명) >> getABCDNo(롬) >> abcdno(Jackson)

해결방법

필드명을 변경할 수 없는 경우

1. @JsonProperty 애노테이션 사용

@JsonProperty("aBCDNo")
private String aBCDNo;

@JsonProperty 사용하기 위해 Jackson 라이브러리를 사용해야 합니다.
라이브러리가 없는 경우 com.fasterxml.jackson.core 패키지가 필요합니다.
@JsonProperty(name)은 JSON 속성 이름을 Java 필드명에 매핑하도록 Jackson ObjectMapper에 지시하여 지정한(name)으로 getter 및 setter 메서드를 지정하는 데 사용합니다.

2. Getter/Setter 직접 생성

public void setaBCDNo(String aBCDNo) {
    this.aBCDNo = aBCDNo;
}
public String getaBCDNo() {
    return aBCDNo;
}

롬복 @Getter 또는 @Data 애노테이션 사용 대신 Getter와 Setter 메서드를 직접 생성합니다.
Getter/Setter 직접 생성을 하면 자바빈 규약에 의해서 기존 필드명 그대로 유지가 됩니다. ex) aBCDNo -> getaBCDNo()
저의 경우 인텔리제이가 제공하는 Getter and Setter 메서드 자동생성 기능을 사용해서 해결했습니다.
- 첫번째가 문자가 대문자인 AAaa, Bbb 같은 필드명은 @JsonProperty 애노테이션을 사용해야 해결 가능합니다.
- Getter/Setter 직접 생성으로 해결하지 못하는 필드명이 존재할 수도 있다는 생각에 모든 API 요청 및 응답 필드를 확인해 보니, 필드명의 첫번째 문자가 대문자로 오는 경우는 없었다.

필드명을 변경할 수 있는 경우

1. 네이밍 잘 짓기 ✨

지양해야 하는 필드명(컬럼명)
case 1) 첫번째 소문자, 두번째 대문자 : aBCDNo(Field) -> getABCDNo(롬복) -> abcdno(Jackson)
case 2) 첫번째 대문자, 두번째 대문자 : BBbb(Field) -> getBBbb(롬복) -> bbbb(Jackson)
지향해야 하는 필드명(컬럼명)
필드명의 첫번째, 두번째는 소문자인 케이스로 지향합시다.
카멜 표기법 중 LCC(Lower Camel Case)를 사용하자.
첫 단어는 소문자로 표기하며 이후 연결되는 단어부터는 첫 글자를 대문자로 표기한다.

해결방법으로 테스트

class NamingDtoTest {

    private static String jsonStr = "{\"aBCDNo\":\"hello world\"}";
    private ObjectMapper objectMapper;

    @BeforeEach
    public void setUp(){
        this.objectMapper = new ObjectMapper();
    }

    @Test
    public void 롬복사용() throws IOException {
        NamingDto result = this.objectMapper.readValue(jsonStr, NamingDto.class);
        assertThat(result.getABCDNo(), is("hello world"));
    }

    @Test
    public void Getter_Setter_직접생성() throws IOException {
        NamingDtoV2 result = this.objectMapper.readValue(jsonStr, NamingDtoV2.class);
        assertThat(result.getaBCDNo(), is("hello world"));
    }

    @Test
    public void 롬복_잭슨애노테이션적용() throws IOException {
        NamingDtoV3 result = this.objectMapper.readValue(jsonStr, NamingDtoV3.class);
        assertThat(result.getABCDNo(), is("hello world"));
    }

}

테스트 결과

위 (1), (2) 해결방법으로 테스트 코드를 작성해서 검증해 봤습니다.
롬복의 @Getter 사용한 객체는 테스트 실패가 옳은 테스트입니다.
- (Jackson 네이밍 규약에 의해서 필드와의 매핑 안 되는 게 정상)
1.@JsonProperty 애노테이션 사용, 2. Getter/Setter 직접으로 통한 해결은 테스트 통과가 됩니다.

API 요청 결과

원인분석을 위해 작성했던 상단의 샘플코드에도 @JsonProperty 추가하여 확인했습니다.

@Setter(AccessLevel.PRIVATE)
@Getter
@ToString
@NoArgsConstructor
public class NamingDto {

    @JsonProperty(value = "aBCDNo")
    private String aBCDNo;

    @JsonProperty(value = "AAaa")
    private String AAaa;

    @JsonProperty("BBBb")
    private String BBBb;

    @JsonProperty("CCcC")
    private String CCcC;

    @JsonProperty("DDDD")
    private String DDDD;

    @JsonProperty("AAAAAAa")
    private String AAAAAAa;

    @JsonProperty("Aa")
    private String Aa;

    private String aaA;

    @JsonProperty("Fab")
    private String Fab;

    @JsonProperty("aA")
    private String aA;
}


이슈	해결 (@JsonProperty 적용)

회고

애초부터 필드명(컬럼명)의 네이밍 컨벤션을 잘 정의하면 이런 일을 겪지 않는다는 걸 배웠음.
외부 API 응답을 받아서 처리하는 프로세스인데 파악해 보니 해당 API가 여러 외부 수행사에서도 쓰임
거래하고 있는 몇 개 API에서도 포스팅 주제와 같은 이슈인 필드명이 여러 개 존재한다는 것도 확인 ㅠ
팀 내부적으로 해당 이슈를 공유드리면서 자체 코드 수정으로 해결을 봤다.
역시 네이밍의 중요성을 느끼는 이슈였다.

정리

지금까지 정리한 내용을 요약하면 아래와 같습니다.

1. Spring의 JSON Message Converter는 Jackson 라이브러리를 사용
2. Jackson 라이브러리는 Getter의 맨 앞 두 글자가 대문자인 경우 이어진 대문자를 모두 소문자로 변경하여 리턴함
3. Lombok의 Getter는 필드명 맨 앞 첫 번째 글자를 항상 대문자로 만든다.
4. Controller 단에서 Json 데이터와 Target Entity를 매핑할 때 Lombok와 Jackson의 네이밍 규칙에 따른 필드명 불일치 사태가 일어나 key 매핑이 안됨.
5. 필드명(컬럼명)을 수정하거나, Getter/Setter 직접 생성하거나, @JsonProperty 애노테이션을 사용해서 해결하면 된다.

윈도우키 먹통 현상 해결

균지니 — Sun, 18 Jun 2023 20:35:21 +0900

윈도우키 잠금 되어 있어서 윈도우키 먹통되었다가 해결했다.

[Fn] + [Win/윈도우 로고키] 눌러 잠금을 해제 했다.

다행이다. 키보드 망가진 줄.

[Maven] profile이용한 배포 환경별(local, dev, prod) 빌드 설정

균지니 — Sun, 5 Mar 2023 02:15:34 +0900

pom.xml profile, build 속성을 이용해 배포 환경별(local, dev, prod) 설정 및 Maven Build 방법에 대해 알아보겠습니다.

프로젝트 환경

Project : Maven Project
java : 1.8
Spring : 4.3.x
Packaging : war
IDE : IntelliJ

1.환경별 리소스 폴더 구분

메인 폴더 하위에 환경별 리소스 폴더를 만들고 각 환경에 맞는 설정 파일을 생성합니다.

개발자 서버 환경(local), 개발 서버 환경(dev), 운영 서버 환경(prod) 총 3가지로 환경에 따라 구분합니다.

src/main/resources-local
src/main/resources-dev
src/main/resources-prod

src/main/resources 폴더는 무엇인가요?

src/main/resources 폴더는 xml 및 속성 파일과 같은 리소스 파일을 포함하도록 되어 있습니다. ~~spring framework~~ maven 또는 gradle의 표준 레이아웃이며, 일반적으로 스프링 프로젝트 생성 시 기본적으로 구성되어 있습니다. 해당 src/main/resources 폴더를 개발자 서버 환경(local)으로 정의하는 경우도 많습니다. 저의 경우는 환경별로 폴더명을 구분하면 가시성 확보에 이점을 느껴 실제론 총 4가지로 나눴습니다. src/main/resources과 src/main/resources-local 폴더를 동일하게 로컬 환경으로 설정해두고 상황에 따라 resources는 개인 테스트용으로 활용하기도 합니다. 굳이 나눌 필요성이 없다 생각하시면 resources(로컬) , resources-dev(개발), resources-prod(운영)으로 구분해도 무방합니다! (스테이징 서버도 존재한다면 src/main/resources-stage로 추가해 주시면 됩니다. 인프라 환경별 및 프로젝트 아키텍처가 케바케이기 때문에 프로젝트에 맞게 구성해 주시면 됩니다.)

Maven 표준 레이아웃 (기본 구조)

maven-project-root
|-- src
|   |-- main
|   |   |-- java          // Java 소스 코드
|   |   |-- resources     // 리소스 파일 (프로퍼티 파일, XML 파일 등)
|   |   |-- webapp        // 웹 애플리케이션 관련 리소스 (JSP, HTML, CSS, JavaScript 등)
|   |-- test
|       |-- java          // 테스트용 Java 소스 코드
|       |-- resources     // 테스트 리소스 파일
|-- target                // 빌드 결과물이 생성되는 디렉토리
|-- pom.xml               // Maven 프로젝트 설정 파일

Gradle 표준 레이아웃 (기본 구조)
- Gradle을 사용하는 프로젝트에서도 Maven과 유사하게 'src/main/resources' 디렉터리가 주로 사용됩니다.

gradle-project-root
|-- src
|   |-- main
|   |   |-- java          // Java 소스 코드
|   |   |-- resources     // 웹 애플리케이션 관련 리소스 파일 (프로퍼티 파일, XML 파일 등, HTML, CSS, JavaScript 등)
|   |-- test
|       |-- java          // 테스트용 Java 소스 코드
|       |-- resources     // 테스트 리소스 파일
|-- build                 // 빌드 결과물이 생성되는 디렉토리
|-- build.gradle          // Gradle 프로젝트 설정 파일

2. pom.xml 설정

메이븐 프로젝트에서는 pom.xml 설정 파일의 profile속성을 이용하여 빌드 시 외부에서 넣어주는 파라미터를 기준으로 설정 파일을 참조하게 하여 환경별로 다른 설정 파일을 선택하도록 해줄 수 있습니다. 설정 방법은 아래와 같습니다.

2.1 pom.xml에 profiles 추가

profile id와 properties.environment 설정 (환경별 구분)

위에서 환경별로 리소스 폴더를 다르게 생성했습니다. 빌드 시 외부에서 넣어주는 파라미터 토대로 환경별 리소스가 참조되기 위해서는 pom.xml의 profiles 속성을 환경별로 설정해야 합니다.

profiles.profile.id와 profiles.profile.properties.environment 속성 추가
id와 environment가 환경별과 동일해야 합니다. (src/main/resources-{환경별})

<profiles>
   <!-- local: 로컬개발 (기본 값) -->
   <profile>
      <id>local</id>
      <activation>
         <!--<activeByDefault>true</activeByDefault>-->
      </activation>
      <properties>
         <environment>local</environment>
      </properties>
   </profile>
   <!-- dev: 개발 -->
   <profile>
      <id>dev</id>
      <properties>
         <environment>dev</environment>
      </properties>
   </profile>
   <!-- prd: 운영 -->
   <profile>
      <id>prod</id>
      <properties>
         <environment>prod</environment>
      </properties>
   </profile>
</profiles>

profile을 설정해 주면 인텔리제이에서 Profiles 폴더와 설정한 profile.id가 나타납니다. id명과 동일하게 설정값을 생성해 줍니다.

2.2 pom.xml에 build 추가

resource.directory 와 resource.filtering 설정 (환경별 참조)

환경별 리소스 폴더에 참조되어 빌드될 수 있도록 설정을 해줍니다. 리소스 경로를 지정해 주고 리소스 폴더 하위의 설정파일들 내에서 환경값을 참조할 수 있게 설정해 줍니다.

build.resources.resource.directory와 build.resources.resource.filterting 속성 추가
2.1에서 설정한 profile.environment 환경별 설정값과 동일해야 합니다. (src/main/resources-${environment})

${environment} 속성은 pom.xml에 정의된 profile.properties.environment 속성 값으로 environment 변수입니다. Maven 빌드 시 외부에서 넣어주는 파라미터 값과 환경별 리소스를 매핑하기 위해 ${environment} 구문을 사용하여 포함할 속성값에 대한 참조를 리소스 파일에 넣습니다. 환경별 리소스 파일에 빌드 시에만 제공할 수 있는 값을 포함할 수 있도록 filterting 속성을 다음의 리소스 디렉터리에 대해 true로 설정하면 됩니다.

<build>
   <resources>
      <resource>
         <directory>src/main/resources</directory>
      </resource>
      <!-- 환경별 리소스 포함 -->
      <resource>
         <directory>src/main/resources-${environment}</directory>
         <filtering>true</filtering>
         <includes>
            <include>**/*.properties</include>
            <include>**/*.xml</include>
         </includes>
      </resource>
   </resources>
</build>

3. 배포 환경별 빌드

3.1 IntelliJ IDE

원하는 배포 환경 체크 후 Lifecycle 항목에서 ⚙️install 클릭하여 빌드해 줍니다. 인텔리제이 경우 pom.xml profiles 설정값과 Maven 설정창의 Profiles 값이 자도으로 매핑됩니다. 아주 편리합니다.

src/main/resources를 개발환경으로 설정한 경우

기본 리소스로 빌드하고자 한다면 pom.xml 에서 profile의 activateByDefault 속성에 true를 설정해 줍니다.

<!-- local: 로컬개발 (기본 값) -->
<profile>
   <id>local</id>
   <activation>
      <activeByDefault>true</activeByDefault>
   </activation>
   <properties>
      <environment>local</environment>
   </properties>
</profile>

3.2 Eclipse IDE

Run Configuration 설정창에서 Maven Build를 환경별로 Goals 항목에 설정해 줍니다.

local build
- goals : clean install -P local
dev build
- goals : clean install -P dev
prod build
- goals : clean install -P prod

src/main/resources를 개발환경으로 설정한 경우

goals : clean install로 세팅해 줍니다. base path가 src/main/resources 이기 때문에 해당 resources 폴더 안 설정파일을 빌드하게 됩니다.

마무리

메이븐 빌드를 하면 resources 아래의 파일과 폴더들이 myapp/target/classes 아래로 복사되는 것을 볼 수 있습니다.

이상 코딩하는 지니였습니다. 감사합니다.

[Java] 차근차근 Java 설치하기 (JDK17, Window 11)

균지니 — Sat, 25 Feb 2023 19:16:02 +0900

자바 개발 도구 설치 방법에 대해서 알아보겠습니다. Java17은 LTS(Long Term Support : 장기 지원) 릴리즈로 1년 후까지 기술 지원 및 버그를 개선한 서비스를 제공받을 수 있습니다. 업데이트 버전을 꾸준히 제공받을 수 있어 최소 2024년 9월까지 업데이트를 받게 됩니다. 저는 개발 및 학습용으로 사용하기 위해 Oracle JDK 설치를 했습니다. Open JDK와 기능의 차이점은 크게 없습니다. 다만, 상업용으로 사용할 때 무료인 Open JDK 쓸지, 유료인 Oracle JDK를 사용할 지의 차이입니다.

1. JDK 17 설치

오라클 홈페이지에서 원하는 버전을 선택 후 다운로드 합니다.

1.1. 오라클 웹사이트 접속

Oracle JDK 17 설치 파일을 다운로드를 위해 아래(↓) 오라클 웹사이트에 접속합니다.

Download the Latest Java LTS Free

Subscribe to Java SE and get the most comprehensive Java support available, with 24/7 global access to the experts.

www.oracle.com

+ update

Oracle JDK 17은 Java 17.0.13 이후부터 “Oracle Technology Network License Agreement for Java SE”에 따라 제공되며, 라이선스 동의를 위한 계정 로그인을 필수화하고 있다고 합니다.

로그인 없이도 다운로드 받으려면 아래 링크의 17.0.12를 다운로드 받아주시면 됩니다.

Java Archive Downloads - Java SE 17.0.12 and earlier

WARNING: Older versions of the JDK are provided to help developers debug issues in older systems. They are not updated with the latest security patches and are not recommended for use in production. For production use Oracle recommends downloading the late

www.oracle.com

1.2. 운영체제 선택

PC 운영체제 사양에 맞는 파일을 다운로드합니다. 저의 경우는 64비트 윈도우 운영체제를 사용하므로 Windows(x64)설치파일을 선택합니다.

‍♀️ 윈도우 운영체제 사양 확인?
파일 탐색기를 열고 [내 PC]에서 마우스 오른쪽 버튼을 클릭한 수 [속성]을 선택합니다.

1.3. JDK 다운로드

x64 MSI Installer 설치 프로그램인 [msi] 확장자가 있는 파일(jdk-17_windows-x64_bin.msi)을 다운로드 합니다.

‍♀️ [msi] 파일을 다운 받는 이유?
자동설치 프로그램을 사용하기 위해 Microsoft Windows의 표준 설치 패키지로 안전하게 설치합니다. 실무에서는 Linux 운영체제를 많이 사용하기 때문에 리눅스 RPM Package(설치형) 또는 Compressed Archive(압축형) 버전을 다운로드하여 경로를 지정해서 설치합니다. 보통 압축형을 많이 사용합니다.

1.5. JDK 설치

1.5.1 JDK 설치파일 실행

파일 탐색기에서 다운로드 받은 jdk-17_windows-x64_bin.msi 설치파일을 더블클릭하여 실행해 주세요.

1.5.1 JDK 설치

각 Setup창에서 [Next] 버튼 클릭해서 설치를 진행합니다. Java SE 17일 경우 다음과 같습니다.

Successfully Installed 메시지가 나오면 Java SE 17 설치에 성공했습니다 :)

‍♀️ 기본 설치 경로?

기본 설치 경로는 C:/Program Files/Java/jdk-17입니다. 경로 변경 시 [Change...] 버튼을 눌러 원하는 경로로 설치해 주세요.

2. 환경 변수 설정

2.1 JAVA_HOME 등록

변수 이름(N) : JAVA_HOME
변수 값(V)   : C:/Program Files/Java/jdk-17 (설치경로)

JAVA_HOME은 JDK가 설치된 경로입니다. 설치 경로를 시스템 변수에 설정을 하면 현재 사용자뿐 아니라 다른 사용자 계정으로도 해당 변수를 사용할 수 있습니다. 또한, 다른 프로그램에서 JAVA_HOME 환경 변수를 이용해 JDK의 위치를 찾기도 합니다.

2.1.1. 내 PC 마우스 우클릭하여 [속성]을 클릭합니다.

2.1.2. 시스템 정보 [고급 시스템 설정]을 클릭합니다.

2.1.3. 시스템 변수 새로 만들기

시스템 속성 [환경 변수]을 클릭 후 [환경 변수] 대화 상자가 나타나면 [시스템 변수]에서 [새로 만들기] 버튼을 클릭합니다.

2.1.4. 새 시스템 변수 추가

변수 이름(N) : JAVA_HOME
변수 값(V)   : C:/Program Files/Java/jdk-17 (설치경로)

[새 시스템 변수] 대화상자가 나타나면 [변수 이름]에 JAVA_HOME을 입력하고, [변수 값]에 JDK 17 설치 경로를 입력합니다. 두 항목을 입력 후 [확인] 버튼을 클릭하여 적용합니다.

2.2. Path 편집

%JAVA_HOME%/bin

[시스템 변수] Path를 편집하여 첫 번째 항목으로 JAVA_HOME 시스템 변수를 추가해 줍니다.

‍♀️ Path 환경 변수에 JAVA_HOME 등록을 왜 해야 하는지?

[파일 탐색기]에서 JDK 17 설치 경로(C:\Program Files\Java\jdk-17)를 열어봅니다. 해당 경로의 [bin] 폴더로 이동합니다. bin 폴더에는 다양한 명령어들이 있습니다. 대표적인 명령어 2가지가 있습니다. 자바 소스를 컴파일해 주는 javac 명령어와 컴파일된 자바를 실행해 주는 java 명령어가 있습니다. 개발자가 명령 프롬프트(cmd.exe)에서 명령 라인에 사용되는 명령어로 컴파일하고 실행할 때 사용됩니다. 그러나 bin 폴더 안에 있기 때문에 환경변수 bin 폴더 경로를 등록하여 다른 폴더에서도 실행 가능하게 환경변수에 %JAVA_HOME%/bin(C:\Program Files\Java\jdk-17\bin)를 추가해 줍니다. 다음은 윈도우 11에서 Path 환경 변수에 bin 폴더를 등록하는 순서입니다.

2.2.1. Path 시스템 변수 편집

[환경 변수] 대화상자의 [시스템 변수(S)]에서 Path 변수 항목을 선택하고 [편집]을 클릭합니다.

2.2.2. 시스템 변수 새로 만들기

%JAVA_HOME%/bin

[환경 변수 편집] 대화상자가 나타나면 [새로 만들기] 버튼을 클릭하고 항목이 추가되면 %JAVA_HOME%\bin 입력합니다.

2.2.3. 시스템 변수 위로 이동

등록한 % JAVA_HOME%\n을 선택하고 [위로 이동] 버튼을 클릭해서 첫 번째 항목으로 올려줍니다. 그 후 모든 대화 상자의 [확인] 버튼을 클릭하여 환경 변수 설정을 마칩니다.

‍♀️ 첫 번째 항목으로 위치시키는 이유?
등록된 환경 변수 순서가 중요합니다. 명령 라인에서 명령어를 찾을 때, Path 환경 변수에 등록된 순서대로 찾기 때문입니다. 만약 다른 버전의 Java 명령어가 먼저 등록되어 있다면 다른 버전의 Java 명령어가 사용될 수도 있습니다.

3. 설정 확인

java -version

명령 프롬프트(CMD)에서 java -version 명령어를 입력하면 설치한 자바 버전을 확인 할 수 있습니다.

[시작] 버튼을 클릭하고 [프로그램 및 파일 검색] 검색창에 cmd 또는 명령 프롬프트를 입력 후 [명령 프롬프트]를 실행합니다. 다음 아래와 같이 java 버전 정보가 출력된다면 정상적으로 환경 변수가 설정 되었습니다.

‍♀️버전 정보가 출력되지 않는 경우?
환경 변수가 제대로 설정되지 않아 출력되지 않는 현상입니다. 침착하게 환경변수 JAVA_HOME과 Path를 확인 후 수정해야 합니다. 수정을 하고 나면 명령 프롬프트(CMD)를 닫고 재시작 후 java -version 명령어로 테스트 해주세요.

참고문헌

1. 강경미『모두의 자바』길벗 2020
2. 신용권『혼자 공부하는 자바』한빛미디어 2019
3. 신용권『이것이 자바다』한빛미디어 2015

[IntelliJ] 인텔리제이 라이센스 등록 및 변경

균지니 — Wed, 15 Feb 2023 22:16:40 +0900

JetBrains 새로운 계정을 가입하게 되어서 인텔리제이에서 사용 중인 라이센스를 삭제하고 새로운 계정 로그인 후 라이센스 갱신하는 방법을 공유하고자 합니다. 라이센스 만료되어 갱신할 때도 하기 내용을 참고해주시면 됩니다.

(JetBrains 학생용 계정을 사용하다 라이센스 만료되어, 학생용 계정은 삭제 후 새로운 계정 파서 Ultimate Personal annual 구매했습니당)

인텔리제이 계정 변경 및 라이센스 등록

1. 상단의 [Help] 메뉴에 진입하여 [Register...]을 클릭합니다.

2. Licenses 팝업창에서 [Remove License] 버튼을 클릭해 라이센스를 삭제합니다.

3. 계정 이모티콘을 누르면 [Log Out..] 메뉴가 나타납니다. [Log Out..] 메뉴를 클릭해 계정을 로그아웃 합니다.

4. [Log in...] 링크를 눌러 JetBrains Account 사이트에서 계정 로그인을 합니다.

인증 성공!!

5. 인증이 성공되면 Reference No* 및 [Activate] [Cancel] 버튼이 나옵니다. 해당 [Activate] 버튼을 눌러주면 계정과 함께 라이센스 활성화 됩니다!

인텔리제이 라이센스 변경(갱신)

1. "Activate new license with:"의 3가지 방법 중 원하는 방법으로 라이센스를 등록합니다.

온라인 환경일 경우에는 JB Account 방식으로 웹사이트에서 인증하시면 되고, 오프라인 환경일 경우 Activation code, License server 둘 중에 선택하셔서 라이센스 갱신 하시면 됩니다.

(실무에선 오프라인 환경의 경우가 대다수 이므로 Activation code를 많이 이용합니다.)

[IntelliJ] 마우스 휠로 폰트 사이즈 조절하는 방법 (Zoom In/Out)

균지니 — Tue, 7 Feb 2023 18:36:17 +0900

️인텔리제이 IDE 기본 설정으로 폰트 사이즈 키우는 것이 설정되어 있지 않습니다. 설정을 통해 Ctrl + 마우스 휠을 사용하여 모든 문서의 글꼴(Editor) 크기를 변경할 수 있습니다. 시력저하, 코드리뷰, 강의 시 매우 유용하며 마우스 휠로 Zoom In/Out 할 수 있습니다. 마우스 휠로 글자 크기 키우기/줄이기 조절하는 방법에 대해서 알아보겠습니다.

먼저 단축키 Ctrl + Alt + s 를 눌러 설정(Settings) 화면에 들어갑니다.

설정

1. Settings > Preference > Editor > General 에 들어갑니다.

3. Mouse Control > "Chage font size with Ctrl+Mouse Wheel in: " 옵션을 체크하여 활성화합니다.

4. [Apply] 버튼 눌러 적용 후 [OK] 확인을 눌러줍니다.

마무리

위와 같이 Mouse Control 기능을 ON 시켜주면 Ctrl + 마우스 휠 사용해서 편하게 글꼴 크기 조절할 수 있습니다!

Ref

Change editor font size | JetBrains Rider

www.jetbrains.com

[git] git init 되돌리기

균지니 — Sun, 29 Jan 2023 22:02:10 +0900

1. git init 되돌리기

rm -r .git

엉뚱한 디렉토리안에서 git init을 해버렸는데, 되돌리는 명령어를 다시 상기시키고자 합니다.

2. git init 명령어에 대해서 간단히 살펴보자.

git init

해당 명령어 실행 시 해당 폴더에 git 저장소를 초기화 하며 로컬 저장소로 지정된다. (빈 저장소로 초기화)

기본 설정 폴더인 .git 디렉토리를 생성한다.