⚛️ React

<img src="https://image.until.blog/morethanmin/article/1716115237924" alt="until-88"><p>react-query에서 useQuery를 사용하면 staleTime과 gcTime 을 이용해 데이터를 효율적으로 다룰 수 있다. 둘의 차이점을 알아보자.</p><h2>staleTime</h2><blockquote><ul><li><p>The time in milliseconds after data is considered stale. This value only applies to the hook it is defined on.</p></li><li><p>If set to <code spellcheck="false">Infinity</code>, the data will never be considered stale</p></li></ul></blockquote><p><code spellcheck="false">staleTime</code>은 불러온 데이터가 fresh한 시간을 나타낸다. defaultValue는 0으로, 리액트 쿼리에서는 기본적으로 불러온 데이터는 fresh하지 않다고 간주한다.</p><p>기본 값을 사용하게 된다면 해당 hook을 사용하는 컴포넌트가 mount 될 때마다 data fetching을 시도할 것이다.</p><p>데이터의 stale여부에 따라서 적절하게 조절해줌으로써 최적화 해줄 수 있다.</p><p>아래 예시는 until.lbog 에서 사용하는 특정 블로그 정보를 가져오는 훅이다.</p><pre spellcheck="false"><code class="language-typescript">import { useSuspenseQuery } from '@tanstack/react-query'
import { GetBlogResponse, createGetBlog } from 'src/apis/blog/[username]'
import { queryKeys } from 'src/constants/queryKeys'

const useBlogQuery = () =&gt; {
  const username = useUsername();
  const { data } = useSuspenseQuery&lt;GetBlogResponse&gt;({
    queryKey: queryKeys.blog.username.body(username),
    queryFn: createGetBlog(username),
    staleTime: Infinity,
  })
  return data
}

export default useBlogQuery</code></pre><p>staleTime을 <code spellcheck="false">Infinity</code>로 설정한 이유는 무엇일까?</p><p>기본적으로 블로그 정보는 서버사이드에서 불러온 이후 변경되는 경우가 거의 없다. 해당 훅은 블로그에서 전반적으로 사용하고 있기 때문에 staleTime이 0일 경우에는 화면을 전환될 때마다 비효율적인 데이터 패칭이 계속해서 일어날 것이라고 판단하였다.</p><p>프로필 수정, 팔로우, 팔로잉와 같이 데이터가 더이상 fresh하지 않은 경우에는 <code spellcheck="false">queryClient.invalidateQuery</code>를 통해 명시적으로 갱신해줌으로써 해결할 수 있다.</p><p>물론 위 방식의 경우 외부적인 요인에 의해 특정 블로그 정보가 변경되는 경우에는 해당 블로그에 재 접속하지 않는 이상 갱신되지 않을 수 있다는 점은 감안해야한다.</p><p>아래 예시는 게시글 리스트를 가져오는 훅이다.</p><pre spellcheck="false"><code>import { useSuspenseInfiniteQuery } from '@tanstack/react-query'
import { queryKeys } from 'src/constants/queryKeys'
import {
  GetArticlesParams,
  createGetUserArticles,
} from 'src/apis/blog/[username]/articles'
import useBlogData from 'src/blog/hooks/useBlogData'
import useArticleParams from './useArticleParams'

const useArticlesInfiniteQuery = () =&gt; {
  const blogData = useBlogData()
  const { order, query, tag } = useArticleParams()

  const params: GetArticlesParams = {
    order: order || undefined,
    query: query || undefined,
    tagSlug: tag || undefined,
  }

  const { data, ...infiniteQuery } = useSuspenseInfiniteQuery({
    queryKey: queryKeys.blog.username.articles.list(blogData.username, params),
    queryFn: async ({ pageParam }) =&gt; {
      const getUserArticles = createGetUserArticles(blogData.username)

      return await getUserArticles({ page: pageParam, ...params })
    },
    initialPageParam: 0,
    getNextPageParam: (data) =&gt; (data.hasMore ? data.page + 1 : undefined),
  })

  if (!data) throw new Error('Suspense Error')

  return { data, ...infiniteQuery }
}

export default useArticlesInfiniteQuery
</code></pre><p>위 훅에서는 반대로 <code spellcheck="false">staleTime</code>을 설정하지 않고 기본값(0)을 사용했다.</p><p>그 이유는 훅의 영향 범위가 <code spellcheck="false">useBlogQuery</code> 와 같이 전반적인 블로그 페이지에서 사용되는 것이 아닌 하나의 특정된 페이지에서만 사용하기에 때문이다</p><h2>gcTime (cacheTime)</h2><blockquote><ul><li><p>The time in milliseconds that unused/inactive cache data remains in memory. When a query's cache becomes unused or inactive, that cache data will be garbage collected after this duration. When different garbage collection times are specified, the longest one will be used.</p></li></ul></blockquote><p><code spellcheck="false">gcTime</code> 은 데이터가 사용되지 않는 상황에서 memory에 유지될 수 있는 시간을 의미하고, defaultValue는 클라이언트 사이드에서는 5분, <strong>서버사이드에서는 Infinity</strong>로 지정된다.</p><p>일반적으로 클라이언트 사이드에서 해당 값을 변경하는 경우는 크게 없었던 것 같다.</p><p>데이터 패칭에 직접적인 영향을 주지 않기 때문이다.</p><p>다만 서버사이드에서는 Infinity로 설정되기 때문에 얘기가 달라진다. 메모리에 계속해서 데이터가 누적되는 경우에는 해당 값을 적절히 지정해 주는 것이 필요할 것 같다.</p><h2>결론</h2><p>어떻게 잡아주더라도 http 통신을 하는 웹페이지 안에서 데이터는 불일치하는 경우는 발생할 수 밖에 없다.</p><p>데이터의 특성에 따라 적절한 캐싱 시간을 조절함으로써 불일치하는 경우를 최소화 할 수 있도록 하는것이 최선인 것 같다.</p><p></p><p></p><p></p><p></p>

react-query에서 useQuery를 사용하면 staleTime과 gcTime 을 이용해 데이터를 효율적으로 다룰 수 있다. 둘의 차이점을 알아보자.staleTimeThe time in milliseconds after data is considered stale. This value only applies to the hook it is define

react-query의 staleTime과 gcTime

<p>테스트 단계에서 어노테이션 Transaction을 사용할 경우 삭제, 추가가 되지 않는 문제.</p><p>Transaction을 추가해놓지는 않았는지 확인하고 주석 처리 or 삭제하고 다시 실행하자.</p>

JPA 시에 어느 순간부터 추가, 삭제 등이 실행되지 않을 때

JPA Transaction

Spring

<p></p><h1>적용한 이유</h1><p><span>'Test는 어느 환경에서나 미리 구축할 필요없이 작동해야한다.'</span><br><span>라는 개념과 어디에서나 자동으로 동일한 테스트 환경을 구축하는 라이브러리가 없을까? 라는 생각으로 출발하여 Test 실행시 서버 테스트에 필요한 환경을 자동으로 구축해주는 라이브러리를 찾아보았습니다.</span></p><p></p><p><span>역시나 TestContainer 라는 착한 친구가 이미 만들어져 있었죠.</span><br></p><img src="https://velog.velcdn.com/images/itbuddy/post/33e9a70f-6458-4a6e-b8f4-00ae7619be43/image.png"><p>이 라이브러리를 사용하면 Docker container 를 통하여 테스트 실행시 자동으로 환경을 구축해 주고 테스트가 끝나면 자동으로 정리까지 해줍니다.<br>이를 통해 h2로 테스트하고 배포는 Mysql로 하면서 몰려오는 찝찝함 또한 해결이 가능합니다.</p><p>Testcontainers의 장점으로는 다음이 있습니다.</p><blockquote><ol><li><p>개발자 친화적: 테스트 코드를 작성하는데 필요한 의존성과 환경 구성을 최소화하여, 개발자가 테스트에만 집중할 수 있게 해줍니다.</p></li><li><p>환경 독립성: 도커사용으로 로컬환경, CI/CD 파이프라인, 프로덕션 환경 등에서 동일한 테스트 환경을 구축할 수 있습니다.</p></li><li><p>높은 확장성: 다양한 서비스와 애플리케이션을 지원하므로, 필요한 경우 새로운 서비스 추가와 기존 서비스를 업데이트하기 쉽습니다.</p></li></ol></blockquote><h2>적용</h2><h4>build.gradle</h4><pre spellcheck="false"><code class="language-java">dependencies {
	...
	// TestContainer 기본 의존성
    testImplementation "org.testcontainers:testcontainers:1.20.1"
	// MySQL 의존성
    testImplementation 'org.testcontainers:mysql:1.20.1'
	// Redis 의존성
    testImplementation "com.redis.testcontainers:testcontainers-redis-junit:1.6.4"
	// Kafka 의존성
    testImplementation "org.testcontainers:kafka:1.20.1"
    ...
    }</code></pre><h4><a target="_blank" rel="noopener noreferrer nofollow" href="http://TestContainerConfig.java">TestContainerConfig.java</a></h4><pre spellcheck="false"><code class="language-java">package org.kakaopay.coffee.config;

import jakarta.validation.constraints.NotNull;
import java.io.File;
import java.util.HashMap;
import java.util.Map;
import org.junit.jupiter.api.extension.BeforeAllCallback;
import org.junit.jupiter.api.extension.ExtensionContext;
import org.springframework.boot.test.util.TestPropertyValues;
import org.springframework.context.ApplicationContextInitializer;
import org.springframework.context.ConfigurableApplicationContext;
import org.springframework.test.context.ActiveProfiles;
import org.testcontainers.containers.DockerComposeContainer;
import org.testcontainers.containers.KafkaContainer;
import org.testcontainers.containers.wait.strategy.Wait;
import org.testcontainers.utility.DockerImageName;

@ActiveProfiles("test")
public class TestContainerConfig implements BeforeAllCallback {

    private static final DockerComposeContainer&lt;?&gt; DOCKER_COMPOSE = new DockerComposeContainer&lt;&gt;(
        new File("src/test/resources/docker-compose.yml"))
        .withExposedService("mysql", 3306, Wait.forLogMessage(".*ready for connections.*", 1))
        .withExposedService("redis", 6379,
            Wait.forLogMessage(".*Ready to accept connections.*", 1));

    private static final KafkaContainer KAFKA_CONTAINER = new KafkaContainer(
        DockerImageName.parse("confluentinc/cp-kafka:7.5.0"));

    @Override
    public void beforeAll(ExtensionContext extensionContext) throws Exception {
        // MySQL 컨테이너 시작
        // Redis 컨테이너 시작
        DOCKER_COMPOSE.start();

        // Kafka 컨테이너 시작
        KAFKA_CONTAINER.start();
    }

    public static class IntegrationTestInitializer implements
        ApplicationContextInitializer&lt;ConfigurableApplicationContext&gt; {

        @Override
        public void initialize(@NotNull ConfigurableApplicationContext applicationContext) {
            Map&lt;String, String&gt; properties = new HashMap&lt;&gt;();

            // 각 서비스의 연결 정보 설정
            setKafkaProperties(properties);
            setDatabaseProperties(properties);
            setRedisProperties(properties);

            // 애플리케이션 컨텍스트에 속성값 적용
            TestPropertyValues.of(properties).applyTo(applicationContext);
        }

        // Kafka 연결 정보 설정
        private void setKafkaProperties(Map&lt;String, String&gt; properties) {
            properties.put("spring.kafka.bootstrap-servers", KAFKA_CONTAINER.getBootstrapServers());
        }

        // 데이터베이스 연결 정보 설정
        private void setDatabaseProperties(Map&lt;String, String&gt; properties) {

            String rdbmsHost = DOCKER_COMPOSE.getServiceHost("mysql", 3306);
            int rdbmsPort = DOCKER_COMPOSE.getServicePort("mysql", 3306);
            properties.put("spring.datasource.url",
                "jdbc:mysql://" + rdbmsHost + ":" + rdbmsPort + "/coffee-test");
            properties.put("spring.datasource.username", "root");
            properties.put("spring.datasource.password", "1234");
        }

        // Redis 연결 정보 설정
        private void setRedisProperties(Map&lt;String, String&gt; properties) {

            String redisHost = DOCKER_COMPOSE.getServiceHost("redis", 6379);
            Integer redisPort = DOCKER_COMPOSE.getServicePort("redis", 6379);
            properties.put("spring.data.redis.host", redisHost);
            properties.put("spring.data.redis.port", redisPort.toString());
        }
    }
}
</code></pre><h4>docker-compose.yml</h4><pre spellcheck="false"><code class="language-yaml"># Use root/example as user/password credentials
version: '3.1'

services:

  mysql:
    image: mysql:latest
    restart: always
    environment:
      MYSQL_DATABASE: coffee-test
      MYSQL_ROOT_PASSWORD: 1234
    ports:
      - 33066:3306 # 테스트 환경에서 호스트 매칭(예: 3306:3306) 을 생략하면 포트 충돌을 피할 수 있습니다. - 외부와 포트와 연결한다면 외부 클라이언트에서 접속이 가능합니다

  redis:
    image: redis:6
    restart: always
    ports:
      - 63799:6379 # 테스트 환경에서 호스트 매칭(예: 6379:6379) 을 생략하면 포트 충돌을 피할 수 있습니다. - 외부와 포트와 연결한다면 외부 클라이언트에서 접속이 가능합니다
</code></pre><h4>사용법</h4><p>@ExtendWith(TestContainerConfig.class) 로 해당 Config 파일을 사용하고</p><p>@ContextConfiguration(initializers = TestContainerConfig.IntegrationTestInitializer.class) 를 통하여 yaml 설정을 덮어 씁니다.</p><pre spellcheck="false"><code class="language-java">package org.kakaopay.coffee.api.order;

import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.tuple;

import java.util.ArrayList;
import java.util.List;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Nested;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.kakaopay.coffee.api.order.request.OrderServiceRequest;
import org.kakaopay.coffee.api.order.response.OrderResponse;
import org.kakaopay.coffee.config.TestContainerConfig;
import org.kakaopay.coffee.db.menu.MenuEntity;
import org.kakaopay.coffee.db.menu.MenuJpaManager;
import org.kakaopay.coffee.db.menu.MenuJpaReader;
import org.kakaopay.coffee.db.order.OrderJpaManager;
import org.kakaopay.coffee.db.order.OrderJpaReader;
import org.kakaopay.coffee.db.ordermenu.OrderMenuEntity;
import org.kakaopay.coffee.db.ordermenu.OrderMenuJpaManager;
import org.kakaopay.coffee.db.ordermenu.OrderMenuJpaReader;
import org.kakaopay.coffee.db.user.UserEntity;
import org.kakaopay.coffee.db.user.UserJpaManager;
import org.kakaopay.coffee.db.user.UserJpaReader;
import org.kakaopay.coffee.db.userpointhistory.UserPointHistoryEntity;
import org.kakaopay.coffee.db.userpointhistory.UserPointHistoryJpaManager;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.ActiveProfiles;
import org.springframework.test.context.ContextConfiguration;

@ActiveProfiles("test")
@SpringBootTest
@ExtendWith(TestContainerConfig.class)
@ContextConfiguration(initializers = TestContainerConfig.IntegrationTestInitializer.class)
class OrderServiceTest {

    private Long MENU_ID = null;
    private final Integer CONCURRENT_COUNT = 10;
    private final int INIT_USER_POINT = 10000;



</code></pre><h4>spring boot test log</h4><p>로그를 잘 보시면 Docker container를 올리는 과정에 대한 로그를 확일할 수 있습니다.</p><pre spellcheck="false"><code class="language-null">
...

18:39:13.253 [main] INFO org.testcontainers.DockerClientFactory -- Testcontainers version: 1.20.1
18:39:13.328 [main] INFO org.testcontainers.dockerclient.DockerClientProviderStrategy -- Loaded org.testcontainers.dockerclient.UnixSocketClientProviderStrategy from ~/.testcontainers.properties, will try it first
18:39:13.444 [main] INFO org.testcontainers.dockerclient.DockerClientProviderStrategy -- Found Docker environment with local Unix socket (unix:///var/run/docker.sock)
18:39:13.445 [main] INFO org.testcontainers.DockerClientFactory -- Docker host IP address is localhost
18:39:13.453 [main] INFO org.testcontainers.DockerClientFactory -- Connected to docker: 
  Server Version: 26.1.4
  API Version: 1.45
  Operating System: OrbStack
  Total Memory: 15966 MB
18:39:13.453 [main] INFO org.testcontainers.utility.RyukResourceReaper -- Ryuk started - will monitor and terminate Testcontainers containers on JVM exit
18:39:13.453 [main] INFO org.testcontainers.DockerClientFactory -- Checking the system...
18:39:13.453 [main] INFO org.testcontainers.DockerClientFactory -- ✔︎ Docker server version should be at least 1.6.0
18:39:13.469 [main] INFO tc.testcontainers/ryuk:0.8.1 -- Creating container for image: testcontainers/ryuk:0.8.1
18:39:13.556 [main] INFO org.testcontainers.utility.RegistryAuthLocator -- Credential helper/store (docker-credential-osxkeychain) does not have credentials for https://index.docker.io/v1/
18:39:13.692 [main] INFO tc.testcontainers/ryuk:0.8.1 -- Container testcontainers/ryuk:0.8.1 is starting: a4d620da1113b2d46f28a94f9b4ff4c4ed423c114af995f9600197de7c3d560d
18:39:13.894 [main] INFO tc.testcontainers/ryuk:0.8.1 -- Container testcontainers/ryuk:0.8.1 started in PT0.424823S
18:39:13.896 [main] INFO org.testcontainers.containers.ComposeDelegate -- Preemptively checking local images for 'mysql:latest', referenced via a compose file or transitive Dockerfile. If not available, it will be pulled.
18:39:13.897 [main] INFO org.testcontainers.containers.ComposeDelegate -- Preemptively checking local images for 'redis:6', referenced via a compose file or transitive Dockerfile. If not available, it will be pulled.
18:39:13.899 [main] INFO tc.docker/compose:1.29.2 -- Copying all files in /Users/itbuddy/github/kakaopay-coffe/src/test/resources into the container
18:39:13.900 [main] INFO tc.docker/compose:1.29.2 -- Creating container for image: docker/compose:1.29.2
18:39:14.216 [main] INFO tc.docker/compose:1.29.2 -- Container docker/compose:1.29.2 is starting: 14b6d71b42e36249d0a2d8aea847fd9149200db7052223b719b4e1b631015ce3
18:39:14.308 [main] WARN tc.docker/compose:1.29.2 -- The architecture 'amd64' for image 'docker/compose:1.29.2' (ID sha256:32d8a4638cd83922fdd94cadf4f1850b595d29757488c73adf05f4b99ebd1318) does not match the Docker server architecture 'arm64'. This will cause the container to execute much more slowly due to emulation and may lead to timeout failures.
18:39:15.400 [main] INFO tc.docker/compose:1.29.2 -- Container docker/compose:1.29.2 started in PT1.499759S
18:39:15.401 [main] INFO tc.docker/compose:1.29.2 -- Docker Compose container is running for command: up -d
18:39:15.404 [docker-java-stream-2029356766] INFO tc.docker/compose:1.29.2 -- STDERR: Creating network "a8zq7zhzpnah_default" with the default driver
18:39:15.404 [docker-java-stream-2029356766] INFO tc.docker/compose:1.29.2 -- STDERR: Creating a8zq7zhzpnah_redis_1 ... 
18:39:15.405 [docker-java-stream-2029356766] INFO tc.docker/compose:1.29.2 -- STDERR: Creating a8zq7zhzpnah_mysql_1 ... 
18:39:15.405 [docker-java-stream-2029356766] INFO tc.docker/compose:1.29.2 -- STDERR: Creating a8zq7zhzpnah_mysql_1 ... done
18:39:15.405 [docker-java-stream-2029356766] INFO tc.docker/compose:1.29.2 -- STDERR: Creating a8zq7zhzpnah_redis_1 ... done
18:39:15.408 [main] INFO tc.docker/compose:1.29.2 -- Docker Compose has finished running
18:39:15.408 [main] INFO tc.alpine/socat:1.7.4.3-r0 -- Creating container for image: alpine/socat:1.7.4.3-r0
18:39:15.442 [main] INFO tc.alpine/socat:1.7.4.3-r0 -- Container alpine/socat:1.7.4.3-r0 is starting: ea9eb968711ccf44106d2ec3a184809d58935c41d60e33ea90ecbcc2a382768e
18:39:15.618 [main] INFO tc.alpine/socat:1.7.4.3-r0 -- Container alpine/socat:1.7.4.3-r0 started in PT0.209128S
18:39:19.349 [main] INFO tc.confluentinc/cp-kafka:7.5.0 -- Creating container for image: confluentinc/cp-kafka:7.5.0
18:39:19.409 [main] INFO tc.confluentinc/cp-kafka:7.5.0 -- Container confluentinc/cp-kafka:7.5.0 is starting: 96158a8797752a2fdc11717b7874d74255ffd5dd871fbfa9aa89cc0fe941a9c7
18:39:21.672 [main] INFO tc.confluentinc/cp-kafka:7.5.0 -- Container confluentinc/cp-kafka:7.5.0 started in PT2.323717S
18:39:21.680 [main] INFO org.springframework.test.context.support.AnnotationConfigContextLoaderUtils -- Could not detect default configuration classes for test class [org.kakaopay.coffee.api.user.UserServiceTest]: UserServiceTest does not declare any static, non-private, non-final, nested classes annotated with @Configuration.
18:39:21.683 [main] INFO org.springframework.boot.test.context.SpringBootTestContextBootstrapper -- Found @SpringBootConfiguration org.kakaopay.coffee.CoffeeApplication for test class org.kakaopay.coffee.api.user.UserServiceTest$Login
18:39:21.686 [main] INFO org.testcontainers.containers.ComposeDelegate -- Preemptively checking local images for 'mysql:latest', referenced via a compose file or transitive Dockerfile. If not available, it will be pulled.
18:39:21.686 [main] INFO org.testcontainers.containers.ComposeDelegate -- Preemptively checking local images for 'redis:6', referenced via a compose file or transitive Dockerfile. If not available, it will be pulled.
18:39:21.686 [main] INFO tc.docker/compose:1.29.2 -- Copying all files in /Users/itbuddy/github/kakaopay-coffe/src/test/resources into the container
18:39:21.686 [main] INFO tc.docker/compose:1.29.2 -- Creating container for image: docker/compose:1.29.2
18:39:21.778 [main] INFO tc.docker/compose:1.29.2 -- Container docker/compose:1.29.2 is starting: 7ca84f83d1799d311632c78faeee10aed080ad8cb57127f9aec64934019529ac
18:39:21.865 [main] WARN tc.docker/compose:1.29.2 -- The architecture 'amd64' for image 'docker/compose:1.29.2' (ID sha256:32d8a4638cd83922fdd94cadf4f1850b595d29757488c73adf05f4b99ebd1318) does not match the Docker server architecture 'arm64'. This will cause the container to execute much more slowly due to emulation and may lead to timeout failures.
18:39:22.660 [main] INFO tc.docker/compose:1.29.2 -- Container docker/compose:1.29.2 started in PT0.973538S
18:39:22.661 [main] INFO tc.docker/compose:1.29.2 -- Docker Compose container is running for command: up -d
18:39:22.662 [docker-java-stream--1092898408] INFO tc.docker/compose:1.29.2 -- STDERR: a8zq7zhzpnah_redis_1 is up-to-date
18:39:22.662 [docker-java-stream--1092898408] INFO tc.docker/compose:1.29.2 -- STDERR: a8zq7zhzpnah_mysql_1 is up-to-date
18:39:22.664 [main] INFO tc.docker/compose:1.29.2 -- Docker Compose has finished running

.....</code></pre><h2>적용후 장단점</h2><h3>장점</h3><ol><li><p>CI/CD 에서도 문제없이 작동한다는 점 (물론 설정 미스 때문에 한번에 성공하지는 못했습니다.)</p></li><li><p>테스트를 위해 따로 mysql, Kafka, redis를 구축할 필요가 없어졌습니다.</p></li><li><p>h2 로 테스트 중에는 디버깅으로 진행 단계를 멈추고 데이터 베이스를 확인 하고 싶어도 h2 서버에 접근할 수가 없었지만, TestContainer는 외부 포트 설정만 해주면 Datagrip으로 접근하여 데이터를 두눈으로 직접 확인이 가능합니다.</p></li></ol><h3>단점</h3><ol><li><p>테스트가 속도가 눈에 띄게 느려졌습니다. 테스트 환경구성에 필요한 Docker Image를 이미 모두 다운 받았더라도 컨테이너 4개 기준 7초 정도 걸리고, 도커 이미지를 모두 새로 다운 받아야 한다면 1분 이상의 시간이 더 소요 됩니다. (특히 CI/CD 에서는 매번 새로운 이미지를 받아 실행합니다. 이를 해결할 방법도 찾아봐야 겠습니다.)</p></li></ol><h3>느낀점</h3><p>단점도 있지만 개발자가 구축해야 하는 테스트 환경 TestContainer가 직접 해주니 편안합니다. 시간이 7초나 더 소요 되지만 개발자가 직접 구축한다면 개발자 마다 1~2시간은 족히 걸릴 일입니다.</p><p>이제 저와 같이 일하는 동료가 TDD와 TestContainer 까지 2명이 되었네요.</p><p>참고<br><a target="_blank" rel="noopener noreferrer nofollow" href="https://dev.gmarket.com/76">지마켓 Testcontainers로 통합테스트 만들기</a></p><p></p>

TestContainers 적용기

<h1>이 글은…</h1><blockquote><p>이 글은 IntelliJ를 처음 사용하는 사람, 그리고 IntelliJ를 통해 Spring Boot 프로젝트를 처음 만드는 사람들을 위해서 작성되었다. (=나다.)</p><p>작성자가 다시 보기 위한 글이니 두서가 없어도 양해 바란다.</p><p>또, 기본적으로 Ultimate를 기준으로 한다.</p></blockquote><h1>IntelliJ 설치</h1><p>인텔리제이는<a target="_blank" rel="noopener noreferrer nofollow" href="https://www.jetbrains.com/idea/?_gl=1*1x5ogyx*_gcl_au*MTQ3NjU3MTk4LjE3MTkzODgyMTE.*_ga*MjA2OTU2NDYyNS4xNzE5Mzg4MjA3*_ga_9J976DJZ68*MTcxOTg3OTY3NS4yLjEuMTcxOTg4MTkzOC41MC4wLjA."> 다음 링크</a>에서 설치해주자. </p><p>해당 링크로 들어가면 아래와 같은 화면이 뜰텐데, 여기서 다운로드를 눌러주면 알아서 사이트가 운영체제를 인식하고 알맞는 다운로드 파일이 있는 링크로 보내준다. 그대로 다운로드 해주자.</p><img src="https://image.until.blog/brightdawn/article/1719882108188" alt="until-693"><p>다운로드는 금방 진행된다. 약 2분 가량 소요되며, 다운로드가 완료되면 실행하자.</p><p></p><h2>설치 파일 실행</h2><p>실행하면 다음과 같은 창이 뜰 것이다.</p><p>쭉쭉 진행해주자.</p><img src="https://image.until.blog/brightdawn/article/1719882311865" alt="until-694"><img src="https://image.until.blog/brightdawn/article/1719882339057" alt="until-695"><p>나는 아래와 같이 전부 추가해주었다. 그 뒤로는 달리 선택할 것 없이 설치를 진행하면 된다.</p><img src="https://image.until.blog/brightdawn/article/1719882376757" alt="until-696"><p>이 뒤에 <code spellcheck="false">Import</code> 할지 말지를 물어보는데 나는 <code spellcheck="false">skip</code> 해주었다. </p><p>그럼 아래와 같은 화면을 볼 수 있는데, 그냥 새 프로젝트를 만들어주자.</p><img src="https://image.until.blog/brightdawn/article/1719883095803" alt="until-697"><p>그리고 다음과 같이 설정해주자.</p><p>사실상 건드릴 것은 거의 없다. <code spellcheck="false">이름</code>, <code spellcheck="false">위치</code>, <code spellcheck="false">Git 저장소 생성</code>, <code spellcheck="false">그룹</code>, <code spellcheck="false">JDK</code> 정도?</p><img src="https://image.until.blog/brightdawn/article/1719883133462" alt="until-698"><p>다음으로 넘어가고, 나는 이 정도 선택하였다.</p><img src="https://image.until.blog/brightdawn/article/1719883307168" alt="until-699"><h3>Spring Boot DevTools</h3><blockquote><p>Spring Boot Application을 개발하고 디버깅하는데 도움이 되는 도구 모음.</p></blockquote><ul><li><p>개발 단계에서 세이브 시 변경사항이 있다면 자동으로 다시 로드되는 기능을 제공한다.</p><ul><li><p>유사 기능: 라이브 서버 등</p></li></ul></li><li><p>자세한 것은 <a target="_blank" rel="noopener noreferrer nofollow" href="https://docs.spring.io/spring-boot/docs/1.5.16.RELEASE/reference/html/using-boot-devtools.html">해당 링크</a>를 참고</p></li></ul><h3>Lombok</h3><blockquote><p>어노테이션을 기반으로 코드를 자동완성 해주는 라이브러리.</p></blockquote><ul><li><p><code spellcheck="false">@Getter</code>, <code spellcheck="false">@Setter</code>, <code spellcheck="false">@Data</code>  등을 사용할 수 있다.</p></li><li><p>훨씬 간단하게 세팅할 수 있고, 코드의 길이가 확실히 줄어든다.</p></li></ul><h3>Spring Web</h3><blockquote><p>주로 RESTful 웹 애플리케이션 및 일반적인 웹 애플리케이션 개발에 사용. HTTP 요청과 응답을 처리하는 데 중점을 둠</p></blockquote><ul><li><p>REST API를 쉽게 개발할 수 있는 기능을 제공</p></li><li><p><code spellcheck="false">@RestController</code>, <code spellcheck="false">@RequestMapping</code> 등의 애너테이션을 사용하여 RESTful 엔드포인트를 정의</p></li></ul><h3>Spring Web Service</h3><blockquote><p>SOAP 기반의 웹 서비스 개발에 사용. XML 메시지 처리와 WSDL 기반의 서비스 계약을 중점.</p></blockquote><ul><li><p>WSDL (Web Services Description Language) 파일을 사용하여 웹 서비스 계약을 정의</p></li><li><p>스키마 기반의 XML 메시지를 처리</p></li><li><p>XML 메시지의 유효성 검사, 변환, 처리 등을 지원</p></li></ul><h2>프로젝트 생성</h2><p>프로젝트 생성을 누르면 아래와 같이 뜬다. 바로 뜨지 않을 경우 조금 기다려주면 된다.</p><img src="https://image.until.blog/brightdawn/article/1719890999592" alt="until-700"><p>이후부터는 이클립스와 유사하게 개발하면 되는 듯 하다.</p><p></p><hr><h2>만일 Ultimate 버전이 아니라면</h2><p><a target="_blank" rel="noopener noreferrer nofollow" href="https://spring.io/quickstart">해당 사이트</a>를 이용하여 스프링 부트 프로젝트를 만들자.</p>

이클립스로 개발하다가 IntelliJ로 Spring Boot를 개발하려는 사람들에게

IntelliJ로 Spring Boot를 처음 사용할 때

<h1>Lombok</h1><blockquote><p>Annotation(어노테이션)을 기반으로 코드를 자동완성 해주는 라이브러리</p></blockquote><hr><h1>발생한 문제</h1><h2>Lombok의 Annotation 적용이 되지 않는 문제</h2><p>Lombok을 설치하고 적용하였음에도 불구하고 적용되지 않음.</p><p>아래와 같이 코드를 작성하였을 때 outline에 getter와 생성자가 생기지 않는 문제.</p><img src="https://image.until.blog/brightdawn/article/1718853117896" alt="until-622"><h2>사용 환경</h2><p>SpringToolSuite4, gradle, JDK-17 등</p><p>lombok.jar 파일을 통해서 SpringToolSuite가 설치된 폴더를 선택해 설치해주었음.</p><p>build.gradle의 dependencies 내부에 아래와 같이 코드 역시 작성하였음.</p><pre spellcheck="false"><code>// https://mvnrepository.com/artifact/org.projectlombok/lombok
compileOnly 'org.projectlombok:lombok' 
annotationProcessor 'org.projectlombok:lombok' </code></pre><p></p><hr><h1>해결 방법</h1><p>상단 툴바 → Help → Install New Software</p><img src="https://image.until.blog/brightdawn/article/1718853539240" alt="until-623"><p>Install 창이 뜨면 아래와 같이 검색해준다.</p><p><code spellcheck="false">https://projectlombok.org/p2</code></p><p>그럼 아래와 같이 Lombok이 나오는 것을 확인할 수 있다. 그 후 Lombok을 선택해 설치를 진행하고 sts를 재시작하면 된다.</p><img src="https://image.until.blog/brightdawn/article/1718853625000" alt="until-624"><h2>무사 작동 확인!</h2><p>오른쪽 Outline에 getter와 생성자가 생긴 것을 확인할 수 있다.</p><img src="https://image.until.blog/brightdawn/article/1718853745030" alt="until-625">

Lombok 라이브러리 적용 안 되는 오류