종합장

[SpringBoot + Nexacro] Nexacro 설치 및 프로젝트 생성과 연동

naahy — Mon, 15 Jun 2026 16:13:35 +0900

Nexacro 공부를 위해 SpringBoot + Oracle + Nexacro 토이 프로젝트를 진행하기로 함

재고 및 물품 관리 시스템으로, 현재 재고 상태를 보여주는 대시보드를 제작할 예정

기술 스택

Frontend	Nexacro N
Backend	SpringBoot 3.2.5 + MyBatis
DB	Oracle XE 21c (Docker)
빌드	Gradle

❗JPA가 아닌 MyBatis를 선택한 이유
MyBatis는 직접 SQL문을 작성할 수 있고, DBMS별 문법을 세밀하게 제어할 수 있음
또한 Oracle과의 궁합도 좋기 때문에 Oracle 공부도 더 할겸 MyBatis를 선택함

Nexacro 핵심 개념

Form
화면 하나 = Form 하나

React의 Page 컴포넌트와 비슷한 개념

Dataset
화면에서 데이터를 담는 그릇

SpringBoot API 응답을 받아서 저장하고, Grid 같은 컴포넌트에 연결

Dataset ← API 응답 데이터 저장
   ↓
Grid    ← Dataset 바라보며 화면에 표시

Transaction
Nexacro에서 SpringBoot API를 호출하는 방식

일반적인 fetch/axios 대신 Nexacro 전용 통신 방식을 사용함

// Nexacro 방식
this.transaction(
    "조회",                        // 트랜잭션 ID
    "SVC::getDashboard.do",        // 호출할 서비스 URL
    "",                            // 전송할 Dataset (없으면 빈칸)
    "dsDashboard=output",          // 응답 받을 Dataset
    "",                            // 파라미터
    "fn_callBack"                  // 콜백 함수명
);

Nexacro 설치

먼저 아래 링크에서 Nexacro 체험판과 라이선스를 다운 받음

https://www.tobesoft.com/product/nexacro

투비소프트

DEV.TOOL 비즈니스용 UI·UX 개발 소프트웨어의 공급부터 안정적 구축, 유지보수 수행까지 기업을 위한 서비스를 제공합니다.

www.tobesoft.com

설치 과정은 다른 거 건드릴 필요 없이 기본 세팅된 대로 설치하면 됨

Nexacro 라이브러리 다운로드

xapi 라이브러리와 uiadapter 라이브러리가 필요함

xapi는 클라이언트(화면)와 서버 간의 데이터를 송수신하고 처리하기 위해 필요한 자바 기반 서버 모듈
uiadapter는 넥사크로와 서버 간 데이터 구조 차이를 보완해주는 모듈

아래 링크에서 com/nexacro 폴더로 이동 후 xapi 라이브러리와 uiadapter 라이브러리 다운

https://mangosteen.tobesoft.co.kr/nexus/#browse/browse:maven-public

Nexus Repository Manager

mangosteen.tobesoft.co.kr

❗이때 SpringBoot 3로 프로젝트를 설정했다면 Nexacro 라이브러리는 반드시 jakarta 버전으로 다운받아야 함

jakarta 버전이 아닌 라이브러리를 다운 받으면 해당 라이브러리는 javax를 사용하기 때문에 java.lang.NoClassDefFoundError: javax/servlet/ServletOutputStream 오류가 발생함

Nexacro 프로젝트 설정

상단 메뉴에서 새 프로젝트 생성

넥사크로 프로젝트와 스프링부트 프로젝트를 같은 폴더에 두지 않고 분리할 것이기 때문에 프로젝트 위치는 본인이 편한 경로로 지정하면 됨

프로젝트 이름 설정하고 Next 클릭

이후 설정은 본인이 만들고 싶은 화면대로 설정하면 됨

나는 간단한 개인 공부용 프로젝트기 때문에 Screen은 Desktop, 템플릿은 Full로 지정함

이후 Finish 눌러 프로젝트 생성

TypeDefinition 경로 설정

nexacro에서 script를 작성할 때마다 일일이 모든 경로를 작성하기 어려우므로, 자주 쓰는 경로의 경우 별칭을 지정하면 편함

TypeDefinition - Services 클릭

User Service에서 아래 내용 등록

SVC - 백엔드 API 호출용. 본인의 로컬호스트 주소 e.g.) http://localhost:8080/
nexacrolib - 넥사크로 엔진 라이브러리

prefixID의 경우 본인이 편한대로 작성해도 됨

SpringBoot 프로젝트 설정

앞서 다운 받았던 nexacro 관련 라이브러리를 스프링부트 프로젝트에 직접 추가해야 함

본인은 루트 폴더에 libs 폴더 생성 후 필요한 jar 파일들을 넣어두었음

의존성 추가

build.gradle에 로컬 jar 의존성 추가 및 라이브러리 관련 추가 의존성 추가

관련 내용은 https://naahy0co.tistory.com/83 참고

dependencies {
    // 기존 의존성들 ...

    // Nexacro 라이브러리 (로컬 jar)
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    
    // Nexacro XAPI 의존성
    implementation 'jakarta.servlet.jsp:jakarta.servlet.jsp-api:3.1.1'
    implementation 'commons-lang:commons-lang:2.6'
}

로컬 jar에 대한 의존성을 새로 추가했으므로 gradle 빌드를 새로 해줘야 함

SpringBoot - Nexacro 연동

SpringBoot CORS 설정 추가

Nexacro Studio에서 localhost로 API를 호출할 때 CORS 에러가 나기 때문에 미리 열어둬야 함

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.CorsRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**")
                .allowedOriginPatterns("*")
                .allowedMethods("GET", "POST", "PUT", "DELETE")
                .allowedHeaders("*");
    }
}

Nexacro Config 작성

Spring MVC의 기본 JSON 기반 요청/응답 처리 체계를 Nexacro Dataset/XML 기반 처리 체계로 교체하는 설정 클래스

import com.nexacro.java.xapi.tx.PlatformType;
import com.nexacro.uiadapter.jakarta.core.context.ApplicationContextProvider;
import com.nexacro.uiadapter.jakarta.core.resolve.NexacroHandlerMethodReturnValueHandler;
import com.nexacro.uiadapter.jakarta.core.resolve.NexacroMappingExceptionResolver;
import com.nexacro.uiadapter.jakarta.core.resolve.NexacroMethodArgumentResolver;
import com.nexacro.uiadapter.jakarta.core.resolve.NexacroRequestMappingHandlerAdapter;
import com.nexacro.uiadapter.jakarta.core.view.NexacroFileView;
import com.nexacro.uiadapter.jakarta.core.view.NexacroView;
import org.springframework.boot.autoconfigure.web.servlet.WebMvcRegistrations;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Lazy;
import org.springframework.web.method.support.HandlerMethodArgumentResolver;
import org.springframework.web.method.support.HandlerMethodReturnValueHandler;
import org.springframework.web.servlet.HandlerExceptionResolver;
import org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter;

import java.util.List;

@Configuration
public class NexacroConfig extends WebConfig implements WebMvcRegistrations {

    /**
     * Spring Bean들을 Nexacro 내부에서도 참조할 수 있게 함
     */
    @Bean
    @Lazy(false)
    public ApplicationContextProvider applicationContextProvider() {
        return new ApplicationContextProvider();
    }

    /**
     * SpringAdapter를 NexacroAdapter로 교체
     * Spring MVC를 Nexacro용으로 교체
     */
    @Override
    public RequestMappingHandlerAdapter getRequestMappingHandlerAdapter() {
        return new NexacroRequestMappingHandlerAdapter();
    }

    /**
     * Controller 파라미터 해석기 등록
     * Dataset --> Java 객체 변환기
     */
    @Override
    public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
        NexacroMethodArgumentResolver nexacroResolver = new NexacroMethodArgumentResolver();
        resolvers.add(nexacroResolver);
        super.addArgumentResolvers(resolvers);
    }

    /**
     * 응답 처리기
     * Controller 반환값(NexacroResult)을 Nexacro Dataset/XML 응답으로 변환
     */
    @Override
    public void addReturnValueHandlers(List<HandlerMethodReturnValueHandler> handlers) {
        NexacroHandlerMethodReturnValueHandler returnValueHandler = new NexacroHandlerMethodReturnValueHandler();

        // 실제 응답 생성기
        NexacroView nexacroView = new NexacroView();
        nexacroView.setDefaultContentType(PlatformType.CONTENT_TYPE_XML);
        nexacroView.setDefaultCharset("UTF-8");
        returnValueHandler.setView(nexacroView);

        // 파일 다운로드 전용
        NexacroFileView nexacroFileView = new NexacroFileView();
        returnValueHandler.setFileView(nexacroFileView);

        handlers.add(0, returnValueHandler);    // 핸들러 순서 명시

        super.addReturnValueHandlers(handlers);
    }

    /**
     * 넥사크로플랫폼 에러 처리 ExceptionResolver 등록
     * Exception → Nexacro 에러 응답
     */
    @Override
    public void configureHandlerExceptionResolvers(List<HandlerExceptionResolver> resolvers) {

        NexacroView nexacroView = new NexacroView();
        nexacroView.setDefaultContentType(PlatformType.CONTENT_TYPE_XML);
        nexacroView.setDefaultCharset("UTF-8");

        NexacroMappingExceptionResolver nexacroException = new NexacroMappingExceptionResolver();

        nexacroException.setView(nexacroView);
        nexacroException.setShouldLogStackTrace(true);  // 서버 로그 출력
        nexacroException.setShouldSendStackTrace(true); // 클라이언트(Nexacro)에도 스택트레이스 전달
        nexacroException.setOrder(1);
        resolvers.add(nexacroException);

        super.configureHandlerExceptionResolvers(resolvers);
    }

}

Nexacro 전용 Controller 추가

Nexacro는 JSON이 아닌 자체 포맷으로 통신함

기존 REST API Controller와 별도로 Nexacro 전용 Controller를 만들어야 한다

-> 컨트롤러가 NexacroResult를 반환하도록 작성

import com.example.inventory.domain.DashboardDto;
import com.example.inventory.mapper.DashboardNexacroMapper;
import com.example.inventory.service.DashboardService;
import com.nexacro.uiadapter.jakarta.core.data.NexacroResult;
import lombok.RequiredArgsConstructor;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;

// 매핑용 URL은 원하는 내용으로 작성. 추후 nexacro script에 작성해야 하는 것만 알면 됨
@Controller
@ResponseBody
@RequestMapping("/nexacro")
@RequiredArgsConstructor
public class NexacroDashboardController {

    private final DashboardService dashboardService;

    @GetMapping("/dashboard")
    public NexacroResult getDashboard() {
    	// 1.
        DashboardDto dashboard = dashboardService.getDashboard();
        
        // 2.
        return DashboardNexacroMapper.toResult(dashboard);	// DTO를 NexacroResult로 변환
    }
}

service에서 대시보드 정보를 받아와 DTO에 저장 (각 service와 DTO는 본인 프로젝트에 맞게 작성)
해당 DTO를 NexacroResult로 변환하는 Mapper 클래스

DashboardNexacroMapper

DTO를 Dataset으로 변환하여 NexacroResult에 해당 데이터셋 추가 후 반환하는 클래스

Nexacro는 Dataset 단위로 데이터를 주고받으므로, 각각의 데이터셋 정보는 분리해서 넘겨주는 것이 좋음

import com.example.inventory.domain.DashboardDto;
import com.example.inventory.domain.DashboardSummary;
import com.nexacro.uiadapter.jakarta.core.data.NexacroResult;

import java.util.List;

public class DashboardNexacroMapper {

    public static NexacroResult toResult(DashboardDto dashboardDto) {
        NexacroResult result = new NexacroResult();

        // 요약 카드 - DataSet
        // DashboardSummary는 아래 내용을 담은 DTO
        DashboardSummary summary = new DashboardSummary(
                dashboardDto.getTotalItemCount(),
                dashboardDto.getTotalStockQty(),
                dashboardDto.getLowStockCount(),
                dashboardDto.getCategoryCount()
        );

        result.addDataSet("dsSummary", List.of(summary));
        
        /**
          * summary DTO를 새로 만들지 않고
          * 아래처럼 직접 데이터셋 생성 후 일일이 붙이는 방법도 있음
          * 관련 코드가 너무 길어지기 때문에 따로 DTO를 새로 선언한 것
        DataSet dsSummary = new DataSet("dsSummary");
        dsSummary.addColumn("totalItemCount", "INT");
        dsSummary.addColumn("totalStockQty",  "INT");
        dsSummary.addColumn("lowStockCount",  "INT");
        dsSummary.addColumn("categoryCount",  "INT");
        int row = dsSummary.newRow();
        dsSummary.set(row, "totalItemCount", dashboardDto.getTotalItemCount());
        dsSummary.set(row, "totalStockQty",  dashboardDto.getTotalStockQty());
        dsSummary.set(row, "lowStockCount",  dashboardDto.getLowStockCount());
        dsSummary.set(row, "categoryCount",  dashboardDto.getCategoryCount());
        outData.addDataSet(dsSummary);
        */

        // 카테고리별 재고
        result.addDataSet(
                "dsCategoryStock",
                dashboardDto.getCategoryStocks()
        );

        ...	// 이후 위와 같이 필요한 Dataset을 각각 추가

        return result;
    }

}

모두 작성 후 실행했을 때 문제 없이 실행 되면 연동이 잘 된 것

Nexacro 화면 작성

좌측 메뉴에서 FrameBase - Form_Work 클릭

프로젝트 생성 시 템플릿을 Full로 선택했기 때문에 빈 화면일 것

상단 메뉴에서 각 요소를 골라 화면을 꾸밀 수 있음

컴포넌트와 버튼 등을 추가하여 화면을 꾸미자

노란 원으로 표시된 것이 왼쪽부터 button, static, grid

데이터 연동이 잘 이루어지는지만 먼저 확인할 것이기 때문에 간단하게 static 4개와 grid 1개만 화면에 배치함

이때 각각의 static은 dsSummary의 내용을, grid는 dsCategoryStock 내용을 저장할 것 -> 위의 DashboardNexacroMapper에서 nexacroResult에 추가한 dataset 정보가 표시되는 것

각 컴포넌트의 아이디를 다음처럼 바꾼다. (static 컴포넌트의 경우 화면에 표시될 text도 아래처럼 변경)

ID	컴포넌트	text
stTotalItem	Static	0 개
stTotalStock	Static	0 개
stLowStock	Static	0 개
stCategory	Static	0 개
grdCategory	Grid

상단 메뉴에서 Dataset 클릭 후, 페이지 아무 곳이나 클릭하면 하단에 dataset이 추가됨

dataset을 더블 클릭하여 id와 열 정보를 아래처럼 입력

이후 dataset을 마우스로 드래그하여 grid 컴포넌트에 놓으면 해당 ds가 grid 컴포넌트에 바인딩 됨

데이터셋이 바인딩 된 grid 컴포넌트를 더블 클릭하여, 표시될 텍스트를 아래처럼 변경해보자

Script 작성

페이지 하단을 보면 script 메뉴가 있을 것이다

해당 메뉴를 클릭하면 빈 화면이 뜰 건데, 그 화면에 아래 내용을 입력하면 됨

springBoot에서 받아온 정보를 form의 컴포넌트와 연결하는 것

// 화면 로드 시 자동 실행
this.Dashboard_onload = function(obj, e) {
    this.fn_getDashboard();
}

// 대시보드 조회
this.fn_getDashboard = function() {
    this.transaction(
        "getDashboard",                          // 트랜잭션 ID
        "SVC::nexacro/dashboard",          // 서비스 URL - SpringBoot Controller
        "",                                      // 전송 Dataset (없음)
        "dsSummary=dsSummary "
        + "dsCategoryStock=dsCategoryStock "
        + "추가 데이터셋 있으면 작성 ",           // 수신 Dataset
        "",                                      // 파라미터
        "fn_getDashboardCallBack"                // 콜백 함수
    );
}

// 조회 완료 콜백
this.fn_getDashboardCallBack = function(svcId, errorCode, errorMsg) {
    if (errorCode < 0) {
        alert("오류 발생: " + errorMsg);
        return;
    }

    // 요약 카드 수치 업데이트
    this.stTotalItem.set_text(this.dsSummary.getColumn(0, "totalItemCount") + " 개");
    this.stTotalStock.set_text(this.dsSummary.getColumn(0, "totalStockQty") + " 개");
    this.stLowStock.set_text(this.dsSummary.getColumn(0, "lowStockCount") + " 개");
    this.stCategory.set_text(this.dsSummary.getColumn(0, "categoryCount") + " 개");

    // Grid는 Dataset에 바인딩되어 있으면 자동으로 표시
}

실행

상단의 launch 버튼을 눌러 화면을 실행해보자

해당 버튼을 누르면 어떤 화면이 뜰 건데, 뭐 건드릴 필요 없이 Run 실행하면 됨

연동이 잘 된 것을 확인할 수 있다.

일단 데이터가 잘 주고받아지는지 확인하려 했던 것이기 때문에 나머지 화면 구현은 나중에...

참고

https://123okk2.tistory.com/538#google_vignette

[Nexacro + Spring Boot] 넥사크로(1/3) - 프로젝트 생성 및 설정

다음 프로젝트에서 프론트엔드로 넥사크로를 사용하기로 결정했다. 처음 사용해보는 개발툴이라 열심히 연습하며 느낀 점은... 이번에야 이미 결정된 일이라 어쩔 수 없다지만 솔직히 이걸 두

123okk2.tistory.com

https://blog.naver.com/goodee0205/224071956196

[개발자국비교육]Mybatis vs JPA 어떤걸 선택하지?

웹 백엔드 개발을 하다 보면 데이터베이스와 연결하는 방식으로 MyBatis 또는 JPA를 많이 접하게 됩니...

blog.naver.com

[트러블슈팅/SpringBoot] Nexacro Dataset 인식 안 됨

naahy — Sat, 13 Jun 2026 17:11:24 +0900

문제1

Nexacro와 SpringBoot를 연동하여 데이터를 주고 받으려는데 아래 에러가 발생함

Could not write JSON: Infinite recursion (StackOverflowError)
...
java.lang.IllegalStateException: getOutputStream() has already been called for this response

원인

아래는 내가 작성한 Nexacro 전용 Controller 코드

@RestController
@RequestMapping("/nexacro")
@RequiredArgsConstructor
public class NexacroDashboardController {

    @GetMapping("/dashboard")
    public NexacroResult getDashboard() {
        ...
        return result;
    }
}

이때 @RestController는 내부적으로 @Controller + @ResponseBody와 같음

따라서 NexacroResult를 JSON으로 변환하여 응답하려고 하는데, NexacroResult는 내부에 Dataset, PlatformData, View 등의 객체를 갖고 있기 때문에 JSON 직렬화를 시도하면 A --> B --> C --> A 식으로 순환 참조가 발생함

그래서 Infinite recursion (StackOverflowError) 에러가 발생한 것

첫 번째 오류 발생 후, NexacroMappingExceptionResolver가 예외 응답을 내려 하는데 이미 Spring이 JSON Writer를 사용하여 JSON 응답을 내기 시작함

그 상태에서 NexacroView가 XML OutputStream을 사용하려 시도했기 때문에 두 번째 오류가 발생한 것

해결

@RestController를 @Controller로 변경

이 경우 NexacroAdapter가 NexacroResult --> Dataset --> XML로 처리

결과

서버의 데이터가 잘 받아와지는 것 확인

문제2

DTO를 Dataset으로 변환하여 NexacroResult로 보내는 코드를 아래와 같이 작성

public static NexacroResult toResult(DashboardDto dashboardDto) {
    NexacroResult result = new NexacroResult();

    // 요약 카드
    DashboardSummary summary = new DashboardSummary(
            dashboardDto.getTotalItemCount(),
            ...
    );

    result.addDataSet("dsSummary", List.of(summary));

    // 카테고리별 재고
    result.addDataSet(
            "dsCategoryStock",
            dashboardDto.getCategoryStocks()
    );

    ...

    return result;
}

그러나 Nexacro에서 dsSummary를 인식하지 못하는 상황 발생

trace()를 통해 데이터셋의 상태를 확인해보았더니 아래와 같이 비어있는 것을 확인할 수 있었다

위 데이터셋을 제외한 다른 데이터셋은 인식이 잘 되는 상황이었기에 연동 자체가 실패한 것은 아니었음

원인

인식되지 않은 데이터셋의 DTO를 아래와 같이 immutable 스타일로 작성함

import lombok.AllArgsConstructor;
import lombok.Getter;

@Getter
@AllArgsConstructor
public class DashboardSummary {

    private int totalItemCount;
    private int totalStockQty;
    private int lowStockCount;
    private int categoryCount;

}

Nexacro Adapter가 내부적으로 Java Bean --> Dataset 변환을 할 때 다음 조건들을 기대하는 경우가 많음

기본 생성자(NoArgsConstructor)
setter/getter
일반적인 JavaBean 형태
복합 타입이 아닌 단순 DTO

그러나 내가 작성한 summary DTO는 기본 생성자와 setter가 없는 읽기 전용 객체이기 때문에, 어댑터가 데이터셋으로 제대로 변환하지 못한 것

반면 다른 DTO는 완전한 JavaBean 형태이기 때문에 Dataset 생성에 성공함

해결

@Setter, @NoArgsConstructor를 추가하여 일반 DTO로 변경

결과

원래 데이터를 인식하지 못하고 '0개'로 뜨던 값들이 제대로 뜨는 것을 확인할 수 있음

[트러블슈팅/SpringBoot] Nexacro 연동 시 발생한 의존성 문제

naahy — Fri, 12 Jun 2026 00:00:40 +0900

SpringBoot 3와 Nexacro N을 연동하여 transaction 통신을 구현하던 중 서버 실행 및 통신 과정에서 여러 오류가 순차적으로 발생했다.

개발 환경

Java 17
SpringBoot 3.2.5
MyBatis 3.0.3
Nexacro N
gradle

문제1 - javax.servlet.ServletOutputStream

필요한 코드를 작성하고 SpringBoot 프로젝트를 실행했는데 아래와 같은 오류 발생

Caused by: java.lang.NoClassDefFoundError: javax/servlet/ServletOutputStream

원인

프로젝트에 사용하기 위해 다운받았던 Nexacro uiadapter 라이브러리가 Spring Boot 2.x 환경용(javax.servlet 기반)이었기 때문

현재 개발 환경은 SpringBoot3이기 때문에 javax 패키지를 찾을 수 없어 'NoClassDefFoundError'가 발생한 것

해결

아래 링크에서 버전에 맞는 라이브러리 다운

https://mangosteen.tobesoft.co.kr/nexus/#browse/browse:maven-public

Nexus Repository Manager

mangosteen.tobesoft.co.kr

com/nexacro 폴더로 이동하여 필요한 라이브러리의 jakarta 버전 다운로드

다운 받고 싶은 파일의 버전을 확인하고, 해당 jar 파일 링크를 클릭하면 다운 받을 수 있음

다운 받은 파일을 프로젝트 폴더에 삽입

(Nexacro 라이브러리는 gradle을 통해 다운 받을 수 없기 때문에 직접 라이브러리 파일들을 넣어줘야 함)

문제2 - jakarta.servlet.jsp.JspWriter

위 오류는 해결 됐으나 아래와 같이 추가 오류가 발생함

java.lang.ClassNotFoundException: jakarta.servlet.jsp.JspWriter

원인

Nexacro XAPI가 응답 데이터를 생성하는 과정에서 JSP API를 참조함. 아래 위치에서 오류 발생

com.nexacro.java.xapi.tx.HttpPlatformResponse.sendData()

Controller 실행 -> 에러 발생 -> NexacroView가 에러 응답 생성 -> XAPI가 응답을 XML/SSV로 변환 -> JspWriter 클래스를 찾으려 함 -> 없음 -> 실패

Spring Boot 3는 JSP 관련 라이브러리를 기본 제공하지 않기 때문에 ClassNotFoundException 에러가 발생한 것

해결

build.gradle에 JSP 의존성 추가

implementation 'jakarta.servlet.jsp:jakarta.servlet.jsp-api:3.1.1'

문제3 - org.apache.commons.lang.StringUtils

이어서 아래 오류 발생

ClassNotFoundException: org.apache.commons.lang.StringUtils

원인

Nexacro XAPI가 개발되었을 때엔 'org.apache.commons.lang.StringUtils'를 많이 사용했다고 한다

다만 Apache에서 commons-lang을 commons-lang3로 변경하면서, 구버전 의존성을 가진 nexacro와 충돌이 일어난 것

해결

gradle 의존성 추가

implementation 'commons-lang:commons-lang:2.6'

결과

데이터가 잘 불러와지는 것을 확인할 수 있음

[SpringBoot] Flyway로 DB 마이그레이션 및 DDL 작성

naahy — Mon, 8 Jun 2026 17:06:05 +0900

SpringBoot와 Oracle, MyBatis를 이용하여 재고/물품 관리 시스템을 개발하던 중, DDL 스크립트를 저장하고 관리할 필요성을 느끼게 되었다

특히 MyBatis는 SQL 실행 도구로 스키마를 자동 생성해주지 않기 때문에, 테이블 생성 시 DDL 스크립트를 필수로 작성해야 함 --> Flyway가 필수적

❗JPA 사용 시에도 Flyway를 사용한다
JPA 사용 시 Hibernate가 테이블 생성 및 수정을 자동으로 해주기 때문에 Flyway가 필요 없다고 생각할 수 있으나, Flyway 없이 `ddl-auto` 기능만을 사용하면 테이블 변경 시 누가 언제 어떤 컬럼을 추가했는지 추적 불가함
따라서 실수를 방지하고 sql 버전 관리를 위해 JPA + Flyway 조합도 많이 사용함

Flyway

DB 마이그레이션 버전 관리 도구

코드를 Git으로 버전 관리하듯이, DB 스키마 변경 이력도 파일로 관리할 수 있게 해줌

Flyway가 실행한 이력은 FLYWAY_SCHEMA_HISTORY 테이블에 자동으로 기록됨

각 SQL 파일에 버전 번호를 붙임 --> Flyway가 아직 실행되지 않은 파일만 골라서 순서대로 자동 실행

마이그레이션 파일명 규칙

Prefix + Version 번호 + __(언더바 2개) + 설명 + 확장자 ==> V<번호>__설명.sql

prefix: V(버전 마이그레이션), R(반복 마이그레이션), U(취소 마이그레이션 - 유료)
version: 버전 마이그레이션에서만 사용됨. 숫자, 점(.), 언더바(_) 조합
- V2, V2.1, V2_1
separator: 버전과 설명을 구분하는 구분자. 언더바 2개 사용 (__)
description: schema_version 테이블에 저장시 설명 컬럼에 저장됨
suffix: 확장자 기본은 .sql

DDL 관리 방법 비교

방법	도구	특징
DDL 직접 실행	sqlplus / DBeaver	가장 직접적, but 이력이 남지 않음
schema.sql 자동 실행	SpringBoot 내장	앱 기동 시 SQL 파일 자동 실행 --> 매번 DROP, CREATE 필요
Flyway	마이그레이션 툴	버전 관리 가능

프로젝트

구조

src/main/resources/
├── db/
│   └── migration/
│       ├── V1__create_sequences.sql      ← Sequence 생성
│       ├── V2__create_tables.sql         ← 테이블 + 컬럼 COMMENT 생성
│       ├── V3__create_trigger.sql        ← 트리거 생성
│       └── V4__insert_sample_data.sql    ← 샘플 데이터
├── mapper/
│   └── item/
└── application.yml

설정 방법

build.gradle 의존성 추가

// Flyway
implementation 'org.flywaydb:flyway-core'
implementation 'org.flywaydb:flyway-database-oracle'  // Oracle 전용

application.yml 설정

oracle: sqlplus: true 설정이 없으면 V3의 트리거(PL/SQL 블록) 실행 시 에러 발생

spring:
  flyway:
    enabled: true
    locations: classpath:db/migration   # SQL 파일 위치
    baseline-on-migrate: true           # 기존 테이블이 있어도 에러 안 남
    oracle:
      sqlplus: true                     # PL/SQL 블록(BEGIN~END) 실행 허용

SQL 파일 목록

V1__create_sequences.sql
- 각 테이블의 PK용 시퀀스 생성 파일
- Oracle은 AUTO\_INCREMENT 대신 Sequence로 PK를 생성함
V2__create_tables.sql
- 테이블 + 각 테이블/컬럼 COMMENT 작성
V3__create_trigger.sql
- 1:1 관계인 두 테이블 A, B가 있을 때, A테이블에서 데이터가 삽입된 경우 B 테이블에 자동으로 관련 행이 생성되도록 트리거 작성
- 데이터 무결성 보장 위함
V4__insert_sample_data.sql
- 테스트용 샘플 데이터 입력

앱 실행 시 동작 흐름

앱 실행
  └─ Flyway 활성화
       └─ FLYWAY_SCHEMA_HISTORY 테이블 확인 (없으면 자동 생성)
            └─ db/migration/ 폴더 스캔
                 └─ 미실행 파일만 순서대로 Oracle에 자동 실행
                      └─ 실행 이력 기록

정상 실행 로그 예시

Flyway Community Edition - Flyway by Redgate
Database: jdbc:oracle:thin:@localhost:1521/XEPDB1 (Oracle 21.0)
Successfully validated 4 migrations (execution time 00:00.025s)
Migrating schema to version 1 - create sequences
Migrating schema to version 2 - create tables
Migrating schema to version 3 - create trigger
Migrating schema to version 4 - insert sample data
Successfully applied 4 migrations (execution time 00:02.503s)

확인 쿼리

-- Flyway 실행 이력 확인
SELECT version, description, success, installed_on
FROM flyway_schema_history
ORDER BY installed_rank;

-- 샘플 데이터 + 트리거 동작 확인
-- 이 부분은 각자 작성한 테이블 정보에 맞게 작성
SELECT i.item_name, i.item_code, s.current_qty
FROM item i JOIN stock s ON i.item_id = s.item_id;

나중에 스키마를 변경해야 할 때

기존 파일은 절대 수정하지 않고 새 버전 파일 추가

이미 실행된 파일을 수정하면 Flyway가 체크섬 불일치 에러를 냄

V5__add_column_item.sql       ← 컬럼 추가
V6__create_index.sql          ← 인덱스 추가

DB 초기화가 필요할 때

# 컨테이너 + 데이터 볼륨 모두 삭제 후 재시작
docker compose down -v
docker compose up -d

# 이후 앱 재실행 → Flyway가 V1~V4 처음부터 다시 실행

참고

https://velog.io/@hyun-jii/Flyway-%EC%A0%95%EC%9D%98-DB-%EB%A7%88%EC%9D%B4%EA%B7%B8%EB%A0%88%EC%9D%B4%EC%85%98-%EB%8F%84%EA%B5%AC

Flyway 정의, DB 마이그레이션 도구

이번 신규 프로젝트에 Flyway 를 적용하게되어 Flyway 관련 세미나를 진행하게 되었다. 그래서 세미나를 준비하며 정리했던 Flyway 개념에 대해 간단히 소개해보고자 한다. 그리고 프로젝트 적용기는

velog.io

https://hu-bris.tistory.com/243

유용한 DB 마이그레이션 도구, Flyway

Flyway란 무엇인가?Flyway는 데이터베이스 마이그레이션 툴이다.그렇다면 마이그레이션은 뭘까? 마이그레이션은 이주하다라는 뜻으로, 데이터베이스 마이그레이션이라면 MySQL에서 PostgreSQL로 데이

hu-bris.tistory.com

[SpringBoot] Swagger를 이용한 API 문서 자동화

naahy — Sun, 31 May 2026 22:09:45 +0900

Swagger

REST API를 문서화하고 테스트할 수 있게 해주는 도구/명세

API 개발 시 프론트엔드 개발자나 외부 팀에게 아래 정보를 전달해야 함

요청 URL
HTTP 메서드 (GET, POST 등)
요청 파라미터/바디
응답 형태

위 내용을 수동 작성하면 코드가 바뀔 때마다 문서도 일일이 따로 수정해야 함

Swagger는 이 과정을 코드에서 자동으로 생성, Controller에 작성된 내용이 Swagger UI에 자동으로 API 표시됨

Swagger UI 제공

브라우저에서 시각적으로 API를 확인할 수 있는 인터랙티브 문서 페이지를 제공함

http://localhost:8080/swagger-ui.html

모든 API 엔드포인트 목록 확인
요청/응답 스펙 확인
직접 API 호출 테스트 가능 (Postman 필요 X)

OpenAPI 명세 생성

API 구조를 표준화된 JSON/YAML 형식으로 내보냄

http://localhost:8080/api-docs

이 파일을 활용해서

프론트엔드에서 자동으로 API 클라이언트 코드 생성
Postman으로 import해서 테스트
다른 팀/서비스와 API 스펙 공유 가능

Springdoc vs Springfox

Spring Boot 프로젝트에서는 springdoc-openapi 라이브러리를 사용하여 Swagger UI 기반으로 API 문서를 자동화 함

예전엔 Springfox Swagger가 많이 사용되었으나, 현재는 springdoc-openapi가 표준처럼 사용됨

Springfox Swagger

OpenAPI 2.0 (Swagger 2) 기반
2020년 이후 사실상 개발 중단 상태
Spring Boot 2.6+ 버전과 호환 문제 발생
Spring Boot 3.x와는 호환 불가
설정이 다소 복잡 (별도 Docket Bean 등록 필요)

Springdoc

OpenAPI 3.0 기반
활발하게 유지보수 중
Spring Boot 2.x, 3.x 모두 호환
설정이 매우 간단 (의존성 추가만 해도 바로 동작)
Spring Security, WebFlux, Actuator 등과 잘 통합됨

Swagger 설정

프로젝트 사양

Spring Boot 3.3.5
Gradle
Java 17

의존성 추가

build.gradle에 의존성 추가

이때 SpringBoot 버전마다 호환 가능한 springdoc 버전이 다르므로 아래 공식 문서를 확인할 것. 맞지 않는 버전을 사용할 시 프로젝트가 빌드되지 않고 오류가 날 수 있음

https://springdoc.org/#what-is-the-compatibility-matrix-of-springdoc-openapi-with-spring-boot

dependencies {
    # 현재 프로젝트는 SpringBoot 3.3.5이므로 springdoc 2.6.0 사용
    implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.6.0'
}

SpringSecurity 사용 시 허용 경로

SpringSecurity 사용 시 SecurityConfig에 Swagger 경로 허용 필요 (사용하지 않으면 필요 X)

@Bean
public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {

    http
        .csrf(csrf -> csrf.disable())
        .authorizeHttpRequests(auth -> auth
            .requestMatchers(
                "/swagger-ui/**",
                "/v3/api-docs/**"
            ).permitAll()
            .anyRequest().authenticated()
        );

    return http.build();
}

접속

아래 링크로 접속 시 Swagger 접속 가능

이때 application.properties에서 포트 번호나 Context Path를 따로 설정한 경우 적용 필요

http://localhost:8080/swagger-ui/index.html

# 예) Context path로 /api를 설정한 경우
http://localhost:8080/api/swagger-ui/index.html

Swagger 설정 클래스

API의 기본 정보 설정 가능

@Configuration
@OpenAPIDefinition(
    info = @Info(
        title = "My API",	// 문서 제목
        version = "v1",		// 버전
        description = "Spring Boot Swagger API 문서"	// 상세설명
    )
)
public class SwaggerConfig {
}

Swagger 문서 상세화

Controller 설명

@Tag

@Tag(name = "User API", description = "사용자 관련 API")	// 어노테이션 추가
@RestController
@RequestMapping("/users")
public class UserController {

API 설명

@Operation

@Operation(summary = "회원 조회", description = "ID로 회원 정보를 조회합니다.")
@GetMapping("/{id}")
public UserResponse getUser(@PathVariable Long id) {
    return new UserResponse(id, "hayeon");
}

Response DTO 설명

@Schema

@Getter
@AllArgsConstructor
@Schema(description = "회원 응답 DTO")
public class UserResponse {

    @Schema(description = "회원 ID", example = "1")
    private Long id;

    @Schema(description = "회원 이름", example = "hayeon")
    private String name;
}

[트러블슈팅/SpringBoot] 415 오류: Content-Type 'application/octet-stream' is not supported

naahy — Tue, 19 May 2026 20:54:39 +0900

문제

게시글을 작성할 때 사용자의 로그인이 필요하도록 코드를 작성함

그런데 기능 테스트 시 사용자 회원가입 및 로그인은 문제 없이 되나, 게시글 작성만 403 오류가 뜨며 진행이 되지 않음

원인

403 오류가 떴으므로 인증 관련 문제일 거라고 생각했으나, 로그를 보면 다음 단계를 거치는 걸 확인할 수 있음

게시글 작성 요청
인증 확인
415 오류 발생
Spring이 /error로 POST 요청
SecureConfig에서 해당 url을 처리하는 부분이 없어 403 에러 발생

즉 사용자 인증에 실패하여 403 에러가 뜨는 것이 X

오류메시지를 자세히 들여다보면 아래와 같이 Content-Type 'application/octet-stream' is not supported 라는 문구가 있음

Could not resolve parameter [0] in public org.springframework.http.ResponseEntity<?> 프로젝트.controller.DiaryController.createDiary(프로젝트.dto.diary.DiaryCreateRequest,java.util.List<org.springframework.web.multipart.MultipartFile>,org.springframework.security.core.userdetails.UserDetails): Content-Type 'application/octet-stream' is not supported
Resolved [org.springframework.web.HttpMediaTypeNotSupportedException: Content-Type 'application/octet-stream' is not supported]

해당 메서드의 첫 번째 파라미터의 콘텐츠 유형이 지원되지 않아 이를 해결할 수 없다는 내용

application/octet-stream

HTTP에서 사용하는 MIME 타입(Content-Type) 중 하나
이 데이터가 어떤 형식인지 알 수 없을 때의 바이너리 데이터를 나타냄

서버가 파일의 형식을 알 수 없을 때 그 파일을 바이너리 데이터로 보내고, 브라우저는 해당 파일을 화면에 표시하는 대신 다운로드를 진행함 --> zip,. exe, pdf 등을 다운로드 시키고 싶을 때 사용

문제가 발생한 코드는 아래와 같다

@PostMapping(path = "/post", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
public ResponseEntity<?> createDiary(
        @RequestPart("diary") DiaryCreateRequest request,
        @RequestPart(value = "images", required = false) List<MultipartFile> images,
        @AuthenticationPrincipal UserDetails userDetails
) {
    // 코드 내용 ....
}

여기서 @RequestPart("diary")로 JSON을 받고 있는데, 클라이언트가 요청을 보낼 때 diary 파트의 Content-Type을 application/json으로 명시하지 않아 기본값인 application/octet-stream으로 전송되었음

이 타입을 Spring이 DiaryCreateRequest로 역직렬화 할 수 없기 때문에 415 Unsupported Media Type 에러가 발생한 것

해결

클라이언트에서 요청을 보낼 때, diary 파트에 Content-Type을 명시적으로 application/json으로 지정해야 함

다만 나는 지금 백엔드 개발 중이고, 당장 테스트 해봐야 하므로 서버 측에서 해결하는 방향으로 진행... (--> 추후 프론트엔드 개발 시 이 부분은 수정하기)

@RequestPart로 데이터를 받는 대신 String으로 먼저 받고 직접 파싱하기로 함

@PostMapping(path = "/post", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
public ResponseEntity<?> createDiary(
        @RequestPart("diary") String diaryJson,   // String으로 받기
        @RequestPart(value = "images", required = false) List<MultipartFile> images,
        @AuthenticationPrincipal UserDetails userDetails
) {
    // 입력 받은 String을 DTO로 직접 파싱함
    DiaryCreateRequest request = objectMapper.readValue(diaryJson, DiaryCreateRequest.class);

    // ...
}

추가로, 컨트롤러에서 따로 처리한 예외가 아니라면 오류 코드가 403으로만 보이는 현상도 피해야 함

전역 예외 핸들러 클래스를 작성하여 각각의 오류 코드가 정확히 보이도록 명시한다

@RestControllerAdvice
public class GlobalExceptionHandler {

    // @Valid 검증 실패 시 (400)
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<?> handleValidationException(MethodArgumentNotValidException e) {
        Map<String, String> errors = new LinkedHashMap<>();
        e.getBindingResult().getFieldErrors()
                .forEach(error -> errors.put(error.getField(), error.getDefaultMessage()));
        return ResponseEntity.badRequest().body(errors);
    }

    // 지원하지 않는 Content-Type (415)
    @ExceptionHandler(HttpMediaTypeNotSupportedException.class)
    public ResponseEntity<?> handleMediaTypeNotSupported(HttpMediaTypeNotSupportedException e) {
        return ResponseEntity.status(HttpStatus.UNSUPPORTED_MEDIA_TYPE)
                .body(Map.of("error", e.getMessage()));
    }

}

결과

postman에서도, swagger에서도 게시글이 잘 작성되는 것을 확인할 수 있음

비밀번호 기준을 맞추지 못했을 때 에러코드가 400이 아닌 403이 떴었으나, 이젠 오류 메시지와 함께 400 에러코드가 뜨는 것을 확인할 수 있음

[AWS] SpringBoot + AWS EC2 Ubuntu 서버 생성 및 배포

naahy — Tue, 7 Apr 2026 02:54:28 +0900

AWS 준비

인스턴스 설정

1. AWS 로그인 후 우측 상단의 AWS Region에서 지역 설정

본인이 현재 위치한 지역으로 설정
‼️ 인스턴스 생성 후엔 지역 바꿀 수 없으므로 반드시 미리 지역 설정 후 인스턴스 생성할 것

2. EC2 서비스로 이동 후 '인스턴스 시작' 클릭

3. 인스턴스명 작성 후 AMI(Amazon Machine Image) 설정

이름은 자유 입력
AMI는 Ubuntu 서버를 사용할 것이므로 Ubuntu 선택

4. 키 페어 설정

키 페어
AWS EC2 인스턴스에 연결하기 위한 암호화 파일

우측의 '새 키 페어 생성' 버튼 클릭

키 페어 이름은 알아볼 수 있는 선에서 자유롭게 작성
유형 및 파일 형식은 기본 설정 사용

5. 나머지 값은 기본값으로 설정 후 우측의 '인스턴스 시작' 버튼 클릭

보안 그룹의 경우 추후 설정할 것이므로 기본값으로 두어도 무관

6. 보안 그룹 생성

좌측 메뉴바에서 네트워크 및 보안 > 보안 그룹으로 이동
우측 상단의 '보안 그룹 생성' 버튼 클릭
기본 세부 정보 작성 후 인바운드 규칙 작성 --> '규칙 추가' 버튼 클릭

Spring 서버용 포트, SSH 포트 설정 (이외에도 필요한 부분은 추가 설정)

7. 인스턴스에 생성한 보안 그룹 설정

인스턴스 > 작업 > 보안 > 보안 그룹 변경

연결된 보안 그룹 메뉴 안에서 아까 생성한 보안 그룹 검색 후 추가

8. 탄력적 IP 주소 할당

생성한 인스턴스를 재시작해도 IP 주소가 바뀌지 않도록 탄력적 IP 주소 할당

좌측 메뉴에서 네트워크 및 보안 > 탄력적 IP 이동
우측 상단의 '탄력적 IP 주소 할당' 클릭
기본값 그대로 두고 우측 하단의 '할당' 버튼 클릭
작업 > 탄력적 IP 주소 연결

EC2 접속

1. 인스턴스로 이동 후 '연결' 버튼 클릭

2. 'SSH 클라이언트' 탭으로 이동 후 아래 단계 순차적으로 시행

윈도우의 경우:
- 다운된 pem 파일이 위치한 폴더에서 cmd 실행
- 맨 아래의 명령어(ssh -i ~) 입력하여 우분투 접속

3. 서버에 Java 설치

서버에 jar 파일을 올려 실행할 것이기 때문에 설치 필요

프로젝트의 자바 버전에 맞춰 설치
‼️ EC2 apt 저장소 목록을 업데이트 해주지 않으면 404 에러가 뜸

sudo apt update
sudo apt install openjdk-17-jdk -y

프로젝트 빌드

1. 프로젝트 jar 파일 생성

로컬에서 프로젝트의 jar 파일 생성
인텔리제이의 경우 우측 메뉴에서 손쉽게 생성 가능 (Tasks > build > bootJar)

2. jar 파일을 우분투 서버에 업로드

jar 파일이 위치한 폴더로 이동 (프로젝트 > build > libs)
cmd 실행 후 아래 명령어 입력
- pem 파일의 경우, 현재 폴더 내에 존재하는 게 아니면 절대 경로로 입력
- ‼️퍼블릭 DNS 뒤에 :/home/ubuntu/ 빠트리지 않도록 주의

scp -i "키파일.pem" "프로젝트.jar" ubuntu@EC2_IP:/home/ubuntu/

EC2에서 실행

1. 서버에서 실행

java -jar 프로젝트.jar

2. 접속

http://EC2_IP:8080

문제 없이 접속되는 것을 확인할 수 있음

[AWS] RDS DB 인스턴스 생성(PostgreSQL) 및 SpringBoot 연동

naahy — Tue, 7 Apr 2026 02:50:58 +0900

RDS 생성

1. AWS에서 RDS 검색 후 해당 서비스로 이동 (Aurora and RDS)

2. 데이터베이스 메뉴로 이동 후 우측 상단의 '데이터베이스 생성 - 전체 구성' 버튼 클릭

3. 데이터베이스 설정

엔진 옵션은 PostgreSQL로 설정
템플릿은 프리티어로 설정

DB 인스턴스 이름 설정 후 자격 증명 설정
- 마스터 사용자 이름은 자유롭게 작성
- 자격 증명 관리는 자체 관리 설정 후 비밀번호 입력

스토리지는 기본값 그대로 설정
- 스토리지 자동 조정 활성화 란은 체크 해제해야 과금 위험 줄어들음

4. DB 생성 완료

엔드포인트 확인
- 데이터베이스 세부 정보 > 연결 및 보안 > 다음을 사용하여 연결: 엔드포인트

5. 연결 설정

초기에 외부에서 데이터베이스에 접근 가능하도록 퍼블릭 액세스를 가능하게 설정해야 함 (추후 불가능으로 변경)

데이터베이스 수정 > 연결 > 추가 구성
퍼블릭 액세스 가능으로 설정

6. 보안 그룹 설정

인스턴스 세부 정보 > 연결 및 보안 > 보안 그룹 규칙
보안 그룹 클릭

인바운드 규칙 > 인바운드 규칙 편집
'규칙 추가' 버튼 클릭
- 타입: PostgreSQL
- 소스는 0.0.0.0/0으로 설정 (이미지 속 내 IP 말고 anywhere로 설정)

'규칙 저장' 버튼 클릭

SpringBoot 설정

1. application.properties 설정

‼️ 이때 db명은 인스턴스명 아님 주의
연결 및 보안 > 다음을 사용하여 연결(엔드포인트) 에서 db명 확인 가능

# ===============================
# Database Configuration (PostgreSQL)
# ===============================
spring.datasource.url=jdbc:postgresql://엔드포인트:5432/db명
spring.datasource.username=마스터 사용자명
spring.datasource.password=비밀번호
spring.datasource.driver-class-name=org.postgresql.Driver

# ===============================
# JPA/Hibernate Configuration
# ===============================
spring.jpa.hibernate.ddl-auto=update

spring.jpa.show-sql=true

2. 의존성 추가

build.gradle 파일에 아래 내용 추가

implementation 'org.postgresql:postgresql'

실행

로컬에서 실행해보면 문제 없이 서버가 열리는 것을 볼 수 있음

[백준/Java] 3273: 두 수의 합

naahy — Wed, 18 Mar 2026 13:59:34 +0900

https://www.acmicpc.net/problem/3273

문제

n개의 서로 다른 양의 정수(a1, a2, ..., an)로 이루어진 수열 존재

자연수 x가 주어졌을 때, ai + aj = x (1 ≤ i < j ≤ n)을 만족하는 (ai, aj)쌍의 수를 구해야 함

제한사항

1 ≤ ai ≤ 1,000,000
1 ≤ 정수 개수 n ≤ 100,000
1 ≤ 자연수 x ≤ 2,000,000

풀이1 (정렬 + 투 포인터)

1. 수열 오름차순 정렬

값의 크기 비교를 통해 포인터 이동 방향을 결정해야 하기 때문

2. 투 포인터 사용

p1: 배열의 시작 (가장 작은 값)
p2: 배열의 끝 (가장 큰 값)

3. 반복하면서 합 비교

sum = arr[p1] + arr[p2]

sum이 x보다 작은 경우
- 값이 작으므로 더 큰 값 필요
- p1++
sum이 x보다 큰 경우
- 값이 크므로 더 작은 값 필요
- p2--
sum이 x와 같은 경우
- p1++, p2-- (이미 사용한 값이므로 둘 다 이동)

투 포인터는 합의 크기에 따라 이동 방향이 달라야 함

코드

import java.io.*;
import java.util.Arrays;
import java.util.StringTokenizer;

public class Main {

    public static void main(String args[]) throws IOException {
        BufferedReader br = new BufferedReader(new InputStreamReader(System.in));

        int n = Integer.parseInt(br.readLine());
        int[] arr = new int[n];

        StringTokenizer st = new StringTokenizer(br.readLine());

        for (int i = 0; i < n; i++) {
            arr[i] = Integer.parseInt(st.nextToken());
        }

        int x = Integer.parseInt(br.readLine());

        Arrays.sort(arr);   // 입력 받은 배열 정렬

        // 포인터 위치 지정
        int p1 = 0;
        int p2 = n - 1;

        int ans = 0;    // 쌍의 개수

        while (p1 < p2) {
            if (arr[p1] + arr[p2] > x) {    // 합이 x보다 작은 경우 p1 증가
                p2--;
            } else if  (arr[p1] + arr[p2] < x) {    // 합이 x보다 큰 경우 p2 감소
                p1++;
            } else {
                ans++;
                p1++;
                p2--;
            }
        }

        System.out.println(ans);
    }

}

풀이2 (boolean 배열 사용)

현재 숫자 ai를 봤을 때, x - ai 값이 존재하는지 확인

--> boolean 배열로 확인 가능

1. visited 배열 생성

수열의 숫자가 이미 등장했는지 체크하는 배열

ai의 최대값이 1,000,000이므로 boolean[1000001] 배열 생성

2. 수열을 하나씩 순회하며 visited[x - ai] 값이 존재하면 쌍 발견

현재 숫자와 대응되는 수가 수열에 존재한다는 뜻이므로, 쌍의 개수 +1

3. 존재하지 않는 경우 현재 값을 visited에 저장

값의 범위가 제한되어 있고 작으므로 boolean 배열을 사용하는 것이 빠름
이미 수열이 정렬 되어있는 경우엔 투 포인터를 사용해도 무관

코드

import java.io.*;
import java.util.Arrays;
import java.util.StringTokenizer;

public class Main {

    public static void main(String args[]) throws IOException {
        BufferedReader br = new BufferedReader(new InputStreamReader(System.in));

        int n = Integer.parseInt(br.readLine());
        int[] arr = new int[n];

        StringTokenizer st = new StringTokenizer(br.readLine());

        for (int i = 0; i < n; i++) {
            arr[i] = Integer.parseInt(st.nextToken());
        }

        int x = Integer.parseInt(br.readLine());
        //////////////////
        boolean[] visited = new boolean[1000001];   // 숫자 존재 여부 저장. ai 최대값
        int ans = 0;

        for (int ai : arr) {
            int target = x - ai;

            // target이 범위 안이고 이미 등장했다면
            if (target > 0 && target <= 1000000 && visited[target]) {
                ans++;
            }

            visited[ai] = true;
        }

        System.out.println(ans);
    }

}

[트러블슈팅/SpringBoot] WebMvcTest로 Controller 테스트 시 JwtUtil 인식 안 됨

naahy — Wed, 11 Mar 2026 12:09:00 +0900

문제

이미지와 함께 게시글 업로드 기능 관련 테스트 코드를 작성하는데, 계속 JwtUtil을 발견할 수 없다는 에러가 뜸

Caused by: org.springframework.beans.factory.UnsatisfiedDependencyException
Error creating bean with name 'jwtAuthenticationFilter'
...
Caused by: NoSuchBeanDefinitionException:
No qualifying bean of type 'com.ahy.diarybackend.security.JwtUtil' available

게시글 관련 controller에서 사용자가 로그인 상태일 때만 게시글이 업로드 되도록 설정해두었는데,
Controller 테스트에선 JWT 검증이 필요 없도록 @AutoConfigureMockMvc(addFilters = false)로 Security 필터를 껐음에도 계속 같은 오류가 떴다

원인

결론은 SecurityConfig를 직접 작성했기 때문

테스트 코드를 작성할 때 @WebMvcTest(DiaryController.class)로 작성을 했는데,
이는 컨트롤러 관련 Bean만 로딩을 하기 때문에 Security 관련 Bean은 일부만 로딩되면서 의존성이 깨질 수 있다 한다

필터를 껐음에도 Spring Security가 실행되는 이유는 addFilters = false가 MockMvc 요청 시 Filter 실행만 끄는 것이기 때문에 Spring Security 자체는 여전히 ApplicationContext에 로딩됨

SpringSecurity를 끄기 위해 @WebMvcTest에 excludeAutoConfiguration = SecurityAutoConfiguration.class 값을 줘도 이 설정은 Spring Boot가 자동으로 등록하는 Security 설정만 제외함

JwtAuthenticationFilter가 @Component로 등록되어 있는 경우

ComponentScan --> JwtAuthenticationFilter 발견 -> Bean 생성 -> JwtUtil 필요 -> 에러

해결

간단하게 필요한 것들을 @MockBean으로 등록하면 됨

@MockBean
private JwtUtil jwtUtil;

@MockBean
private UserDetailsService userDetailsService;

결과

작성한 2개의 테스트가 모두 잘 실행됨