사붐이개발일기

[Obsidian] Obsidian으로 자동 Git Commit 하기

sabeom — Mon, 20 Apr 2026 10:54:34 +0900

Obsidian에 정리한 문서를 Git으로 관리하고 싶다면 Obsidian Git 플러그인을 활용하는 방법이 가장 간단합니다.
별도의 터미널 작업을 자주 하지 않아도 주기적으로 commit, push, pull을 자동화할 수 있어서, 기록 흐름이 끊기지 않는 점이 특히 편했습니다.

이번 글에서는 Obsidian에 Git Plugin을 설치하고, Vault를 GitHub 저장소와 연결한 뒤 자동 커밋 설정까지 적용하는 과정을 정리해보겠습니다.

Obsidian에서 Git Plugin 설치하기

먼저 Obsidian에서 Community Plugin 기능을 활성화한 뒤 Git 플러그인을 설치합니다.

1. Community Plugins 활성화

Settings에서 Community plugins 메뉴로 이동한 뒤 Turn on community plugins를 선택합니다.

Turn on community plugins 클릭

2. Browse 선택

플러그인 목록을 보기 위해 Browse를 클릭합니다.

Browse 클릭

3. Git Plugin 검색

검색창에 Git을 입력한 뒤, Obsidian Git 플러그인을 선택합니다.

Plugin 검색

4. Plugin 설치

Install 버튼을 눌러 플러그인을 설치합니다.

Plugin Install

5. Plugin 활성화

설치가 끝나면 Enable을 눌러 플러그인을 활성화합니다.

Plugin Enable

Git 저장소 연동하기

플러그인 설치가 끝났다면, 이제 Obsidian Vault를 Git 저장소와 연결해야 합니다.

1. Vault 루트에 `.gitignore` 파일 만들기

먼저 Vault 경로에 .gitignore 파일을 생성합니다.
사용 중인 환경에 따라 제외할 파일은 달라질 수 있으니, 자신의 Vault 구조에 맞게 관리하면 됩니다.

Add .gitignore

2. Git 저장소 초기 연결

이제 Vault 경로에서 아래 명령어를 실행해 Git 저장소를 연결합니다.

git init
git add .
git commit -m "git init"
git branch -M main
git remote add origin "깃허브 저장소 주소"
git push -u origin main

각 명령어의 의미는 다음과 같습니다.

git init
현재 폴더를 Git 저장소로 초기화합니다.
git add .
현재 파일들을 스테이징합니다.
git commit -m "git init"
첫 커밋을 생성합니다.
git branch -M main
현재 브랜치 이름을 main으로 변경합니다.
git remote add origin "깃허브 저장소 주소"
원격 저장소를 등록합니다.
git push -u origin main
원격 저장소에 최초 푸시를 하고, 이후 기본 업스트림 브랜치로 설정합니다.

Git 자동 커밋 설정하기

저는 아래처럼 설정해서 사용하고 있습니다.

1. 30분마다 자동 Commit & Push

commit과 sync가 주기적으로 실행되도록 30분 간격으로 설정했습니다.

Auto commit-and-sync interval: 30

2. 10분마다 자동 Pull

원격 저장소 변경사항을 너무 늦지 않게 가져오기 위해 10분 간격으로 pull 설정을 적용했습니다.

Auto pull interval: 10

이렇게 설정해두면 기록에만 집중해도 주기적으로 변경 사항이 정리되기 때문에, 수동으로 커밋하고 푸시하는 번거로움이 많이 줄어듭니다.

마무리

정리한 내용을 Git에 올릴 때마다 별도로 터미널을 열고 커밋하는 과정이 생각보다 흐름을 많이 끊었습니다.
그런데 Obsidian에서 Git Plugin으로 자동화해두니 시간도 줄고, 기록에만 집중할 수 있어서 꽤 만족스러웠습니다.

Obsidian을 메모 도구를 넘어 지식 저장소처럼 운영하고 있다면, Git Plugin은 한 번쯤 꼭 써볼 만한 플러그인이라고 생각합니다.

[Spring] Global Exception Handler (Controller Advice)

sabeom — Wed, 4 Dec 2024 09:37:46 +0900

서론

에러메시지 일관성 유지

나중에 추가 작성하겠음.. 지금은 개발기한 및 감리로 인하여..

코드 구현

에러 핸들러

@Slf4j
@RestControllerAdvice
public class GlobalExceptionHandler {

    /**
     * Handle all uncaught exceptions.
     */
    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleGenericException(Exception ex) {
        log.error("Unhandled exception occurred: {}", ex.getMessage(), ex);
        ErrorResponse response = new ErrorResponse(
                HttpStatus.INTERNAL_SERVER_ERROR.value(),
                "An unexpected error occurred.",
                LocalDateTime.now()
        );
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(response);
    }

    /**
     * Handle custom not found exceptions.
     */
    @ExceptionHandler(BizExceptionMessage.class)
    public ResponseEntity<ErrorResponse> handleBizExceptionMessage(BizExceptionMessage ex) {
        log.warn("Resource not found: {}", ex.getMessage());
        ErrorResponse response = new ErrorResponse(
                HttpStatus.NOT_FOUND.value(),
                ex.getMessage(),
                LocalDateTime.now()
        );
        return ResponseEntity.status(HttpStatus.NOT_FOUND).body(response);
    }

    /**
     * Handle validation errors from @Valid annotations.
     */
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<ValidationErrorResponse> handleValidationExceptions(MethodArgumentNotValidException ex) {
        List<Violation> violations = ex.getBindingResult().getFieldErrors()
                .stream()
                .map(this::toViolation)
                .collect(Collectors.toList());

        ValidationErrorResponse response = new ValidationErrorResponse(
                HttpStatus.BAD_REQUEST.value(),
                "Validation failed",
                LocalDateTime.now(),
                violations
        );

        log.debug("Validation errors: {}", violations);
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(response);
    }

    /**
     * Handle validation errors from @Validated annotations or ConstraintViolation.
     */
    @ExceptionHandler(ConstraintViolationException.class)
    public ResponseEntity<ValidationErrorResponse> handleConstraintViolation(ConstraintViolationException ex) {
        List<Violation> violations = ex.getConstraintViolations()
                .stream()
                .map(cv -> new Violation(
                        cv.getPropertyPath().toString(),
                        cv.getInvalidValue(),
                        cv.getMessage()
                ))
                .collect(Collectors.toList());

        ValidationErrorResponse response = new ValidationErrorResponse(
                HttpStatus.BAD_REQUEST.value(),
                "Validation failed",
                LocalDateTime.now(),
                violations
        );

        log.debug("Constraint violations: {}", violations);
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(response);
    }

    private Violation toViolation(FieldError fieldError) {
        return new Violation(fieldError.getField(), fieldError.getRejectedValue(), fieldError.getDefaultMessage());
    }

    /**
     * Response structure for general errors.
     */
    public static class ErrorResponse {
        private final int status;
        private final String message;
        private final LocalDateTime timestamp;

        public ErrorResponse(int status, String message, LocalDateTime timestamp) {
            this.status = status;
            this.message = message;
            this.timestamp = timestamp;
        }

        // Getters
        public int getStatus() { return status; }
        public String getMessage() { return message; }
        public LocalDateTime getTimestamp() { return timestamp; }
    }

    /**
     * Response structure for validation errors.
     */
    public static class ValidationErrorResponse extends ErrorResponse {
        private final List<Violation> violations;

        public ValidationErrorResponse(int status, String message, LocalDateTime timestamp, List<Violation> violations) {
            super(status, message, timestamp);
            this.violations = violations;
        }

        // Getter
        public List<Violation> getViolations() { return violations; }
    }

    /**
     * Represents a single validation error.
     */
    public static class Violation {
        private final String fieldName;
        private final Object rejectedValue;
        private final String message;

        public Violation(String fieldName, Object rejectedValue, String message) {
            this.fieldName = fieldName;
            this.rejectedValue = rejectedValue;
            this.message = message;
        }

        // Getters
        public String getFieldName() { return fieldName; }
        public Object getRejectedValue() { return rejectedValue; }
        public String getMessage() { return message; }
    }
}

예외 유형별 처리:
- Exception: 예기치 못한 일반 오류 처리.
- CustomNotFoundException: 사용자 정의 예외 처리.
- MethodArgumentNotValidException: @Valid 유효성 검증 실패 처리.
- ConstraintViolationException: 유효성 검증 실패 (주로 @Validated에서 발생) 처리.
응답 구조:
- ErrorResponse: 일반 오류 응답 구조.
- ValidationErrorResponse: 검증 오류 응답 구조, 필드별 오류 세부 정보 포함.
로깅:
- 각 예외 처리 블록에서 적절한 로깅(log.error, log.warn, log.debug).
재사용 가능한 구조:
- Violation 클래스와 ValidationErrorResponse를 사용해 일관된 검증 오류 응답 제공.
에러 메시지 노출 최소화:
- 사용자에게 불필요한 시스템 정보를 숨기고 명확한 메시지를 제공.

커스텀 에러 메시지

public class BizExceptionMessage extends RuntimeException {
    private int code;
    private ErrorType errorType;
    private String msgTypCod; //Q : Question, C : Critical, I : Information, E : Exclamation , B : system
    private String msgCaption;
    private Locale msgLocale;

    public BizExceptionMessage(ErrorType errorType) {
        super(errorType.getMessage());
        this.errorType = errorType;
        this.code = errorType.getCode();
        this.msgTypCod = "";
        this.msgCaption = "";
        this.msgLocale = Locale.KOREA;
    }

    public BizExceptionMessage(ErrorType errorType, Locale localeInfo) {
        super(errorType.getMessage());
        this.errorType = errorType;
        this.code = errorType.getCode();
        this.msgTypCod = "";
        this.msgCaption = "";
        this.msgLocale = localeInfo;
    }

    public BizExceptionMessage(ErrorType errorType, String subMessage) {
        super(errorType.getMessage() + " (" + subMessage + ")");
        this.errorType = errorType;
        this.code = errorType.getCode();
        this.msgTypCod = "";
        this.msgCaption = "";
        this.msgLocale = Locale.KOREA;
    }

    public BizExceptionMessage(String msgTypCod, ErrorType errorType, String subMessage) {
        super(errorType.getMessage() + " (" + subMessage + ")");
        this.errorType = errorType;
        this.code = errorType.getCode();
        this.msgTypCod = msgTypCod;
        this.msgCaption = "";
        this.msgLocale = Locale.KOREA;
    }

    public BizExceptionMessage(String msgTypCod, ErrorType errorType, String subMessage, String msgCaption) {
        super(errorType.getMessage() + " (" + subMessage + ")");
        this.errorType = errorType;
        this.code = errorType.getCode();
        this.msgTypCod = msgTypCod;
        this.msgCaption = msgCaption;
        this.msgLocale = Locale.KOREA;
    }

    public int getCode() {
        return code;
    }

    public String getMsgTypCod() {
        return msgTypCod;
    }

    public String getMsgCaption() {
        return msgCaption;
    }

    public ErrorType getErrorType() {
        return this.errorType;
    }

    public Locale getMsgLocale() {
        return msgLocale;
    }
}

에러타입 정의

public enum ErrorType {

    // 성공
    SUCCESS(0, "Success", "Operation completed successfully", "SUCCESS"),

    // 인증 및 권한 오류 (10000 ~ 10999)
    INVALID_CREDENTIALS(10001, "Invalid credentials", "The provided username or password is incorrect", "INVALID_CREDENTIALS"),
    UNAUTHORIZED_ACCESS(10002, "Unauthorized access", "You do not have the required permissions to access this resource", "UNAUTHORIZED_ACCESS"),
    TOKEN_EXPIRED(10003, "Token expired", "The authentication token has expired", "TOKEN_EXPIRED"),
    TOKEN_INVALID(10004, "Invalid token", "The provided token is invalid", "TOKEN_INVALID"),
    ACCOUNT_LOCKED(10005, "Account locked", "This account is locked due to too many failed login attempts", "ACCOUNT_LOCKED"),

    // 입력 값 오류 (20000 ~ 20999)
    INVALID_INPUT(20001, "Invalid input", "One or more input values are invalid", "INVALID_INPUT"),
    MISSING_REQUIRED_FIELD(20002, "Missing required field", "A required field is missing in the request", "MISSING_REQUIRED_FIELD"),
    INVALID_FORMAT(20003, "Invalid format", "The input format is incorrect", "INVALID_FORMAT"),
    DUPLICATE_ENTRY(20004, "Duplicate entry", "The provided value already exists", "DUPLICATE_ENTRY"),

    // 데이터베이스 오류 (30000 ~ 30999)
    DATABASE_ERROR(30001, "Database error", "An error occurred while interacting with the database", "DATABASE_ERROR"),
    DATA_NOT_FOUND(30002, "Data not found", "The requested data could not be found in the database", "DATA_NOT_FOUND"),
    CONSTRAINT_VIOLATION(30003, "Constraint violation", "A database constraint was violated", "CONSTRAINT_VIOLATION"),
    QUERY_TIMEOUT(30004, "Query timeout", "The database query took too long to execute", "QUERY_TIMEOUT"),

    // 파일 관련 오류 (40000 ~ 40999)
    FILE_NOT_FOUND(40001, "File not found", "The requested file could not be located", "FILE_NOT_FOUND"),
    FILE_UPLOAD_ERROR(40002, "File upload error", "An error occurred while uploading the file", "FILE_UPLOAD_ERROR"),
    FILE_SIZE_EXCEEDED(40003, "File size exceeded", "The uploaded file exceeds the maximum allowed size", "FILE_SIZE_EXCEEDED"),
    UNSUPPORTED_FILE_FORMAT(40004, "Unsupported file format", "The uploaded file format is not supported", "UNSUPPORTED_FILE_FORMAT"),

    // 네트워크 및 통신 오류 (50000 ~ 50999)
    NETWORK_ERROR(50001, "Network error", "An error occurred while communicating with the server", "NETWORK_ERROR"),
    SERVICE_UNAVAILABLE(50002, "Service unavailable", "The requested service is temporarily unavailable", "SERVICE_UNAVAILABLE"),
    TIMEOUT_ERROR(50003, "Timeout error", "The request timed out while waiting for a response", "TIMEOUT_ERROR"),

    // 서버 내부 오류 (60000 ~ 60999)
    INTERNAL_SERVER_ERROR(60001, "Internal server error", "An unexpected error occurred on the server", "INTERNAL_SERVER_ERROR"),
    NULL_POINTER_EXCEPTION(60002, "Null pointer exception", "A null pointer exception occurred", "NULL_POINTER_EXCEPTION"),
    ILLEGAL_STATE(60003, "Illegal state", "The application encountered an illegal state", "ILLEGAL_STATE"),
    CONFIGURATION_ERROR(60004, "Configuration error", "A configuration issue was detected", "CONFIGURATION_ERROR"),

    // 기본 및 알 수 없는 오류 (90000 ~ 90999)
    UNKNOWN_ERROR(90001, "Unknown error", "An unknown error occurred", "UNKNOWN_ERROR");

    private final int code;
    private final String message;
    private final String detailMessage;
    private final String messageKey;

    ErrorType(int code, String message, String detailMessage, String messageKey) {
        this.code = code;
        this.message = message;
        this.detailMessage = detailMessage;
        this.messageKey = messageKey;
    }

    public int getCode() {
        return code;
    }

    public String getMessage() {
        return message;
    }

    public String getDetailMessage() {
        return detailMessage;
    }

    public String getMessageKey() {
        return messageKey;
    }
}

인증 및 권한 오류 (10000 ~ 10999)
- 로그인 실패, 토큰 문제, 접근 권한 부족 등.
입력 값 오류 (20000 ~ 20999)
- 입력 데이터 누락, 형식 문제, 중복 데이터 등.
데이터베이스 오류 (30000 ~ 30999)
- SQL 에러, 데이터 미존재, 제약 조건 위반 등.
파일 관련 오류 (40000 ~ 40999)
- 파일 업로드, 형식, 크기 제한 등.
네트워크 및 통신 오류 (50000 ~ 50999)
- 네트워크 연결 문제, 서비스 비가용성 등.
서버 내부 오류 (60000 ~ 60999)
- 서버의 예기치 못한 문제, 설정 오류 등.
알 수 없는 오류 (90000 ~ 90999)
- 모든 예상치 못한 문제.

[JS/Svelte] Excel파일 다운로드 기능 구현하기 - Excel.js

sabeom — Wed, 14 Aug 2024 16:56:10 +0900

서론

회사 프로젝트에서 정산현황의 기간 별 데이터를 엑셀 파일로 만들어 내려받게 해달라는 요구사항이 들어왔다. 엑셀파일 변환은 처음이라 여기저기 구글링하다 xlsx 라이브러리 보단 excel.js 가 좀 더 간단한것같아서 후자로 라이브러리를 선택했다.

나중에 더 찾아보니 xlsx 라이브러리는 css가 유료라고 한다.

사용하기

1. exceljs 라이브러리 설치

npm install exceljs;

2. exceljs 객체 가져오기

import ExcelJS from 'exceljs';

3. workbook 객체 생성

엑셀파일은 여러개의 sheet를 포함한다. workbook은 worksheet를 담는 그릇이다.

const workbook = new ExcelJS.Workbook();

4. worksheet 객체 생성

worksheet는 엑셀파일에서 sheet에 해당한다.

const worksheet = workbook.addWorksheet('정산데이터');

5. worksheet 컬럼명 등록

worksheet 첫번째 줄에 컬럼명을 추가한다.

header : 컬럼명

key : 데이터 key 값

style : 데이터 포맷 or style 설정

worksheet.columns = [
      {header: '순번', key: 'rowNum', style: {numFmt: '0'}},
      ...
      {header: '승인일자', key: 'appDt'},
      {header: '승인시간', key: 'appTm'},
      {header: '취소일자', key: 'ccDt'},
      {header: '취소시간', key: 'ccTm'},
      {header: '금액', key: 'amt'},
      {header: '과세', key: 'taxAmt'},
      {header: '비과세', key: 'taxFreeAmt'},
      {header: '일반수수료', key: 'generalFee'},
      {header: '일반부가세', key: 'generalVat'},
      {header: '입금금액', key: 'depositAmt'},
      {header: '정산일자', key: 'settlmntDt'}
    ];

6. worksheet 데이터 추가

worksheet 2번째줄 부터 데이터를 추가한다.

const data = {'rowNum' = 1, 'appDt' = '20240814', 'appTm' = '164011', ... }
worksheet.insertRows(2, data);

7. workbook 객체를 Blob 객체로 변환하여 다운받기

const fileName = '파일명.xlsx';

workbook.xlsx.writeBuffer()
    .then((data) => {
      const blob = new Blob([data], {type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"});
      const url = window.URL.createObjectURL(blob);
      const anchor = document.createElement('a');
      anchor.href = url;
      anchor.download = fileName;
      anchor.click();
      window.URL.revokeObjectURL(url);
    })
    .catch((error) => {
        console.error('Error creating Excel file:', error);
	});

이슈사항

서버에서 VO 값을 String으로 뿌려주니 excel로 변환했을때도 값들이 String으로 들어가 정렬이 안되는 문제가 있었다.
number로 변경하려면 클라이언트에서 json을 int로 변경해주거나 서버에서 int로 보내주면된다. 나는 서버에서 int로 변경했다.

# 24-08-21

기존데이터를 가공해야할 일이 생겼다. 컬럼꾸미기, 정렬, 데이터 형식 변경 등 수정 요청

엑셀 컬럼 설정

worksheet.columns = [
      {header: '순번', key: 'rowNum', style: {numFmt: '0', alignment: {horizontal: 'center'}}},
      ...
      {header: '결제자명', key: 'mpayMbrName', style: {alignment: {horizontal: 'center'}}},
      {header: '결제상태', key: 'padjStatDesc', style: {alignment: {horizontal: 'center'}}},
      {header: '승인일자', key: 'appDtDesc', width: 15, style: {alignment: {horizontal: 'center'}}},
      {header: '승인시간', key: 'appTmDesc', width: 15, style: {alignment: {horizontal: 'center'}}},
      {header: '취소일자', key: 'ccDtDesc', width: 15, style: {alignment: {horizontal: 'center'}}},
      {header: '취소시간', key: 'ccTmDesc', width: 15, style: {alignment: {horizontal: 'center'}}},
      {header: '금액', key: 'amt', style: {numFmt: '#,##0', alignment: {horizontal: 'center'}}},
      {header: '과세', key: 'taxAmt', style: {numFmt: '#,##0', alignment: {horizontal: 'center'}}},
      {header: '비과세', key: 'taxFreeAmt', style: {numFmt: '#,##0', alignment: {horizontal: 'center'}}},
      {header: '일반수수료', key: 'generalFee', width: 10, style: {numFmt: '#,##0', alignment: {horizontal: 'center'}}},
      {header: '일반부가세', key: 'generalVat', width: 10, style: {numFmt: '#,##0', alignment: {horizontal: 'center'}}},
      {header: '입금금액', key: 'depositAmt', style: {numFmt: '#,##0', alignment: {horizontal: 'center'}}},
      {header: '정산일자', key: 'settlmntDtDesc', width: 15, style: {alignment: {horizontal: 'center'}}}
    ];

엑셀 데이터 변경

// 기존 JSON 데이터 + 가공데이터 추가
const data = excelData.map(item => {
  return {
    ...item,
    appDtDesc: changeDateForExcel(item.appDt),
    appTmDesc: changeTimeForExcel(item.appTm),
    ccDtDesc: changeDateForExcel(item.ccDt),
    ccTmDesc: changeTimeForExcel(item.ccTm),
    settlmntDtDesc: changeDateForExcel(item.settlmntDt)
  };
});

컬럼 꾸미기

// 컬럼 배경색 설정
const headerFill = {
  type: 'pattern',
  pattern: 'solid',
  fgColor: {argb: '6666ff'},
}
// 컬럼 폰트 설정
const headerFont = {bold: true, color: {argb: 'ffffff'}}

// 모든 컬럼에 적용
for (let i = 1; i <= worksheet.columnCount; i++) {
  const headerEachCell = worksheet.getCell(`${String.fromCharCode(i + 64)}1`);
  headerEachCell.fill = headerFill;
  headerEachCell.font = headerFont;
  headerEachCell.alignment = { horizontal: 'center' };
}

Reperence

1. ExcelJS 사용법

https://blckchainetc.tistory.com/entry/Nodejs-Exceljs-%EC%82%AC%EC%9A%A9%EB%B2%95-%EC%B4%9D%EC%A0%95%EB%A6%AC-How-to-use-Exceljs-%ED%85%8C%EC%9D%B4%EB%B8%94-%EB%A7%8C%EB%93%A4%EA%B8%B0-insertRows-columns-value-%EB%93%B1

2. ExcelJS 다운로드

https://developer-talk.tistory.com/328

[RockyLinux] 사설 네트워크 브릿지 구성하기 (사설 IP)

sabeom — Fri, 24 May 2024 15:45:36 +0900

네트워크 브릿지

사설 네트워크 브리지: 사설 네트워크 브리지는 가상 라우터와 같습니다. 자체적으로 사설 IP 주소를 할당하고 DHCP 서버를 생성합니다. 이 네트워크 브리지에 연결된 KVM 가상 머신은 브리지의 DHCP 서버를 통해 IP 주소를 얻습니다. 네트워크 브리지는 NAT(Network Address Translation)를 사용하여 KVM 가상 머신에 대한 인터넷 연결을 제공합니다. 사설 네트워크 브리지에 연결된 KVM 가상 머신은 서로 통신할 수 있습니다. KVM 호스트(가상 머신이 실행 중인 위치)도 가상 머신에 직접 액세스할 수 있습니다. 그러나 가상 머신은 외부 네트워크에서 액세스할 수 없습니다.

사설 네트워크 브릿지

공용 네트워크 브리지: 공용 네트워크 브리지는 가상 스위치와 같습니다. 하나의 물리적 네트워크 인터페이스를 브리지에 연결할 수 있으며 네트워크 브리지를 사용하는 KVM 가상 머신은 물리적 네트워크 인터페이스가 연결된 라우터에서 실행되는 DHCP 서버를 사용하여 자체적으로 IP 주소를 할당합니다. 공용 네트워크 브리지를 사용하는 경우 연결된 KVM 가상 머신은 물리적 라우터 또는 네트워크 장치에서 IP 주소를 가져옵니다. KVM 가상 머신은 KVM 호스트와 외부 네트워크에서 서로 액세스할 수 있습니다.

공용 네트워크 브릿지

KVM으로 사설 네트워크 브릿지 만들기

본인 ip 확인하기

$ ip a

$ sudo virsh net-list --all

Default 네트워크 브릿지 XML구성파일의 기본값 확인하기

$ sudo virsh net-edit default

사설 네트워크 브릿지 XML 구성파일 생성하기

$ vim private.xml

<network>
  <name>private</name>
  <forward mode='nat'/>
  <bridge name='virbr1' stp='on' delay='0'/>
  <ip address='10.0.0.1' netmask='255.255.255.0'>
    <dhcp>
      <range start='10.0.0.2' end='10.0.0.254'/>
    </dhcp>
  </ip>
</network>

<name>
네트워크 이름
<forward mode='nat' />
브리지는 KVM 가상머신의 인터넷 연결을 위해 네트워크 주소 변환을 사용합니다.
<bridge name='virbr1' stp='on' delay='0' />
네트워크 브릿지 인터페이스 이름은 virbr1입니다.
<ip address='10.0.0.1' netmask='255.255.255.0' >
네트워크 브릿지는 10.0.0.0/24 사설 네트워크 서브넷을 사용하고 브릿지 인터페이스 virbr1에 대해 IP 주소 10.0.0.1을 할당합니다.
<dhcp>
<range start='10.0.0.2' end='10.0.0.254'>
</dhcp>
KVM은 네트워크 브릿지용 DHCP서버를 실행합니다. 이 네트워크 브릿지를 사용하여 가상머신에 IP주소를 제공합니다. KVM 가상머신에는 10.0.0.2부터 10.0.0.254범위 내의 IP주소가 할당됩니다.

private.xml 파일을 사용하여 개인 네트워크 브릿지 생성

$ sudo virsh net-define private.xml

현재 사설 네트워크 브릿지 상태확인하기

$ sudo virsh net-list --all

사설 네트워크 브릿지 활성화하기

$ sudo virsh net-start private

사설 네트워크 브릿지 활성화 확인

$ sudo virsh net-list --all

$ ip a

네트워크 브릿지 부팅 시 자동 시작

$ sudo virsh net-autostart private

자동시작 활성화 확인

$ sudo virsh net-list --all

KVM HostOS에서 GuestOS(VM) 사설 네트워크 설정

GuestOS(VM)에서 nmtui로 고정IP 설정하기

nmtui로 VM 인터넷 설정

$ nmtui

$ ip a

$ ping 8.8.8.8

Reference

1. KVM + QEMU로, 직접 구성한 NAT 네트워크에 연결된 가상머신 생성하기
https://blog.naver.com/love_tolty/222650880951
2. CentOS8 KVM 네트워크 브릿지 인터페이스를 생성하는 방법
https://ko.linux-console.net/?p=16671

[MyBatis] Update Join - table끼리 join해서 update 하기

sabeom — Thu, 2 May 2024 14:32:26 +0900

내가 사용한 방법

환경
- java 8
- mybatis
- postgreSQL

<update id="updateJoinAdjmCompleted" parameterType="String">
    /* SmartroPay.xml updateJoinAdjmCompleted */
    UPDATE tb_mbr_pay SET
        mpay_sadj_id = temp.padj_sadj_id
        , mpay_sadj_stat = #{mpayAdjmStat}
        , mpay_adjm_dttm = temp.adj_date
        , mpay_updt_dttm = now()
    FROM (
        SELECT a.*, c.adj_date 
        FROM tmp_mpay_adjm a
        LEFT JOIN tb_shp_adjm b
        ON a.padj_sadj_id = b.sadj_id
        LEFT JOIN tb_adjm c
        ON b.sadj_adjm_id = c.adj_id
        where a.tid not in (select tid from tmp_mpay_adjm where state_cd != '0')
    ) as temp
    WHERE tb_mbr_pay.mpay_id = temp.padj_mpay_id
</update>

[MyBatis] Insert Join - table끼리 join해서 insert하기

sabeom — Thu, 2 May 2024 14:22:59 +0900

Insert into + Join 쿼리

우선 join은 select용이다.
insert문에 join을 결합하여 사용한다는 말은, join하여 select한 특수한 값을 골라 insert 한다는 말과 같다.

다음과 같은 상황일때 사용할 수 있다.

Q. TB1 에는 있고, TB2에는 없는 레코드만 TB2에 추가하기

sql

INSERT INTO TB2 (코드, 년도)
(
  SELECT A.코드, A.년도 -- 추가할 필드
  FROM TB1 A LEFT JOIN TB2 B 
  ON A.코드 = B.코드
  WHERE B.코드 IS NULL -- join한 TB2테이블의 필드가 NULL이라는 말은 TB2에는 없는 값을 의미한다.
)

내가 사용한 방법

환경
- java 8
- mybatis
- postgreSQL

<insert id="insertPadjData" parameterType="com.bit.bizportal.common.voCommon.pay.adjm.AdjmDataVO">
    /* SmartroPay.xml insertPadjData */
    INSERT INTO tb_mpay_adjm
        (
        padj_mpay_id, padj_sadj_id, padj_reg_dttm, padj_updt_dttm,
        tid, otid, app_dt, app_tm, cc_dt,
        cc_tm, mid, moid, svc_cd, pin_no,
        goods_nm, amt, tax_amt, tax_free_amt, discount_amt,
        pay_amt, coupon_amt, cpx_amt, fn_cpx_amt, green_deposit,
        instmnt_mon, no_int_cl, point_cl, card_cl, bc_card_cl,
        state_cd, general_fee, general_vat, no_int_fee, no_int_vat,
        pnt_fee, pnt_vat, ec_fee, ec_vat, auth_fee,
        auth_vat, coupon_fee, coupon_var, cpx_fee, cpx_vat,
        deposit_amt, settlmnt_dt, isu_cd, fn_cd, fn_no,
        app_no, ccy_cd, trans_cl
        )
    (
    SELECT
        temp.padj_mpay_id, temp.padj_sadj_id, temp.padj_reg_dttm, temp.padj_updt_dttm,
        temp.tid, temp.otid, temp.app_dt, temp.app_tm, temp.cc_dt,
        temp.cc_tm, temp.mid, temp.moid, temp.svc_cd, temp.pin_no,
        temp.goods_nm, temp.amt, temp.tax_amt, temp.tax_free_amt, temp.discount_amt,
        temp.pay_amt, temp.coupon_amt, temp.cpx_amt, temp.fn_cpx_amt, temp.green_deposit,
        temp.instmnt_mon, temp.no_int_cl, temp.point_cl, temp.card_cl, temp.bc_card_cl,
        temp.state_cd, temp.general_fee, temp.general_vat, temp.no_int_fee, temp.no_int_vat,
        temp.pnt_fee, temp.pnt_vat, temp.ec_fee, temp.ec_vat, temp.auth_fee,
        temp.auth_vat, temp.coupon_fee, temp.coupon_var, temp.cpx_fee, temp.cpx_vat,
        temp.deposit_amt, temp.settlmnt_dt, temp.isu_cd, temp.fn_cd, temp.fn_no,
        temp.app_no, temp.ccy_cd, temp.trans_cl
        FROM tmp_mpay_adjm temp
        LEFT JOIN tb_mpay_adjm tma
        ON temp.tid = tma.tid and temp.state_cd = tma.state_cd
        WHERE tma.padj_id is null
    )
</insert>

Reference

1. 인파 - insert into join 사용해보기
https://inpa.tistory.com/entry/MYSQL- -INSERT-INTO-JOIN-사용해보기

[MyBatis] Batch Insert - 대용량 데이터 insert

sabeom — Thu, 2 May 2024 13:59:31 +0900

내용

1. SqlSession 의 ExecutorType.BATCH
ExecutorType.BATCH 를 사용하면 바로 DB 로 쿼리를 날리지 않고 쿼리를 미리 쌓아뒀다가 commit 시 connection에 모든 쿼리를 넘겨준다.
2. flushStatements
MyBatis에서는 flushStatements라는 설정 옵션을 제공합니다. 이 옵션을 활용하면 일정량의 SQL 문을 배치 처리하고 커밋하기 전에 임시로 버퍼에 저장하는 방식으로 대용량 데이터 처리 작업의 성능을 개선할 수 있습니다. 대용량 데이터 작업을 수행하는 동안 많은 SQL문을 생성하고 실행할 수 있습니다. 이때 flushStatement를 사용하면, 일정한 개수나 시간 간격으로 SQL 문을 배치로 처리하고 커밋하므로 다음과 같은 장점이 있습니다.

메모리 사용 최적화: 많은 SQL 문을 한 번에 메모리에 보관하지 않고 일부분씩 처리하므로 메모리 부하가 줄어듭니다.
작업 속도 향상: 일정한 간격마다 SQL문을 배치로 처리하기 때문에 작업이 빨라집니다.
트랜잭션 관리: 일정한 간격마다 커밋하므로 큰 트랜잭션 범위에서 발생하는 장애의 영향을 줄일 수 있습니다.

예시

1. 기본 insert

<!-- 데이터를 한 건씩 Insert 하는 쿼리 -->
<insert id="insertItem" parameterType="com.example.batchjob.dto.ItemDto">
    INSERT INTO item_list
    VALUES ( #{itemCode}, #{name}, #{kindCode}, #{price})
</insert>

INSERT INTO item_list
        VALUES ( '0', '0', '0', 0)
 {executed in 6 msec}
INSERT INTO item_list
        VALUES ( '1', '1', '1', 1)
 {executed in 5 msec}
INSERT INTO item_list
        VALUES ( '2', '2', '2', 2)
 {executed in 4 msec}
INSERT INTO item_list
        VALUES ( '3', '3', '3', 3)
 {executed in 4 msec}
INSERT INTO item_list
        VALUES ( '4', '4', '4', 4)
 {executed in 4 msec}

2. Mybatis <foreach> 태그사용

<!-- foreach를 이용한 다건의 데이터 Insert -->
<insert id="insertItemList" parameterType="com.example.batchjob.dto.ItemDto">
    INSERT INTO item_list
    VALUES
    <foreach collection="list" item="item" open="(" close=")" separator="), (">
        #{item.itemCode}, #{item.name}, #{item.kindCode}, #{item.price}
    </foreach>
</insert>

하나의 insert문으로 다 건의 데이터가 입력된다.

INSERT INTO item_list
    VALUES
        ( '0', '0', '0', 0 )
        , ( '1', '1', '1', 1)
        , ( '2', '2', '2', 2)
        , ( '3', '3', '3', 3)
        , ( '4', '4', '4', 4)
 {executed in 13 msec}

3. SqlSession ExcuteType.BATCH 사용

// mapper.XML
<!-- 데이터를 한 건씩 Insert 하는 쿼리 -->
<insert id="insertItem" parameterType="com.example.batchjob.dto.ItemDto">
    INSERT INTO item_list
    VALUES ( #{itemCode}, #{name}, #{kindCode}, #{price})
</insert>

@Test
@DisplayName("SqlSession Execute.BATCH 를 이용한 배치처리")
void BulkInsertUsingSqlSession() {

    SqlSession sqlSession = sqlSessionFactory.openSession(ExecutorType.BATCH);
    ItemMapper mapper = sqlSession.getMapper(ItemMapper.class);

    for (ItemDto itemDto : inputDataList) {
        retValue = mapper.insertItem(itemDto); // 리턴값으로 row와 상관없는 값이 나옴
    }
    sqlSession.flushStatements();
    sqlSession.Commit()
}

batching 5 statements:
1:  INSERT INTO item_list#
        VALUES ( '0', '0', '0', 0)
2:  INSERT INTO item_list
        VALUES ( '1', '1', '1', 1)
3:  INSERT INTO item_list
        VALUES ( '2', '2', '2', 2)
4:  INSERT INTO item_list
        VALUES ( '3', '3', '3', 3)
5:  INSERT INTO item_list
        VALUES ( '4', '4', '4', 4)
 {executed in 13 msec}

4. 각 방식의 성능비교
sqlSession batch < mybatis <forEach> < 기본 insert 순으로 속도가 느려짐

내가 사용한 방법 !

환경
- java 8
- mybatis
- postgreSQL
순서
1. sqlSession ExecutorType.BATCH 선언
2. batchMapper 선언
3. batch insert할 임시테이블 생성 (temporary table)
4. batch insert 하기 전 가맹점 마다 임시테이블 데이터 모두 삭제 (truncate)
5. batch insert
6. batch insert를 한꺼번에 저장시 속도가 떨어지므로 1000건씩 끊어 넣기 (1000건이 퍼포먼스 제일 높게 나옴)
7. 반드시 finally 에 sqlSession을 닫는 기능을 넣어야함. 오류가 나더라도 finally는 실행됌.

public class service {
    private final SqlSessionFactory sqlSessionFactory;
    private final PlatformTransactionManager transactionManager;
    private final SmartroPayRepo smartroPayRepo;
    private final int BATCH_SIZE = 1000;  // batch insert size 1000건씩 끊어 넣기

    
    public Boolean insertAdjmData(AdjmResVO adjmResVO, String payDate) {
        SqlSession sqlSession = sqlSessionFactory.openSession(ExecutorType.BATCH);
        SmartroPayRepo batchMapper = sqlSession.getMapper(SmartroPayRepo.class);
        /* Transaction Start */
        // TransactionStatus status = transactionManager.getTransaction(new DefaultTransactionDefinition());
        try {
            /* 임시테이블 생성 */
            // smartroPayRepo.createTempMpayAdjm();
            batchMapper.createTempMpayAdjm();	// create temporary table
            sqlSession.flushStatements();	// commit
        } catch (Exception e) {
            log.info("already createTempMpayAdjm On insertAdjmData()");
        }

        try {
            /* 임시테이블에 있는 데이터 모두 삭제 */
            // sqlSession.update("com.bit.bizportal.admin.modules.smartroPay.SmartroPayRepo.truncateTempMpayAdjm");
            batchMapper.truncateTempMpayAdjm();	// truncate temporary table

            int batchInsertCount = 0;

            List<AdjmDataVO> adjmList = batchMapper.selectAdjmList();
            for (AdjmDataVO adjmDataVO : adjmList) {
                // sqlSession.insert("com.bit.bizportal.admin.modules.smartroPay.SmartroPayRepo.insertTempPadjData", adjmDataVO);
                batchMapper.insertTempPadjData(adjmDataVO);	// batch insert

                /* BATCH_SIZE 만큼 끊어 넣기 (1000건) */
                batchInsertCount++;
                if (batchInsertCount % BATCH_SIZE == 0) {
                    sqlSession.flushStatements();	// commit
                    batchInsertCount = 0;
                }
            }

            // sqlSession.insert("com.bit.bizportal.admin.modules.smartroPay.SmartroPayRepo.insertPadjData");
            batchMapper.insertPadjData();	// batch insert
            sqlSession.flushStatements();	// commit
            /* Transaction Commit */
            // transactionManager.commit(status);
        } catch {
        /* Transaction Rollback */
        // transactionManager.rollback(status);
        } finally {
            sqlSession.flushStatements();
            sqlSession.close();	// SqlSession 종료
            sqlSession.clearCache();	// SqlSession 리소스 반납
        }

        return true;
    }
}

mapper.xml
insert, update, select 등 기존 방식과 동일하게 사용하면 됌

// mapper.xml
<!--    create temporary table, 임시테이블 생성 -->
<update id="createTempMpayAdjm">
    CREATE temp table tmp_mpay_adjm (
    padj_id int,
    padj_mpay_id int,
    padj_sadj_id int,
    padj_reg_dttm timestamp,
    padj_updt_dttm timestamp,
    tid text,
    otid text        
    );
</update>

<!-- truncate table, 테이블 내 모든 데이터 삭제 -->
<update id="truncateTempMpayAdjm">
    TRUNCATE TABLE tmp_mpay_adjm;
</update>

Reference

1. mybatis 대량 데이터 INSERT - sqlSessionFactory 이용!
https://jy-note.tistory.com/26
2. [bulk insert/update] mybatis 배치작업과 리턴값(returnValue)
https://velog.io/@aszxvcb/Bulk-InsertUpdate-%EB%B0%B0%EC%B9%98%EC%9E%91%EC%97%85%EC%97%90%EC%84%9C%EC%9D%98-%EB%8D%B0%EC%9D%B4%ED%84%B0%EC%B2%98%EB%A6%AC-%EB%A6%AC%ED%84%B4%EA%B0%92returnValue
3. myBatis에서 대량의 데이터를 넣을때 bulk insert를 사용하자
https://javairus.tistory.com/18
4. [Oracle] Spring, Mybatis에서 대량 데이터 INSERT 수행. multirow, 다건 삽입 수행하기
https://infjin.tistory.com/192

[Spring] Enum , Optional 참고자료

sabeom — Thu, 28 Mar 2024 17:56:53 +0900

에러사항.
Spring에서 객체 필드데이터가 List일때 Null인지 아닌지 체크가 필요할때 Optional 사용이 불가하다.
이럴경우, Optioanl이 아닌 org.springframework.uril 라이브러리에서 제공하는 Objectutils.isEmpty()를 사용하면 null과 빈 배열을 동시에 체크할수 있다.

Reference

1. Enum 사용법 - 응용하기 - 망나니개발자
https://mangkyu.tistory.com/74
2.Java Enum 활용기 - 우아한
https://techblog.woowahan.com/2527/
3.[Java] 스트림 활용 - anyMatch, noneMatch, findAny, reduce
https://m.blog.naver.com/adamdoha/222199320102
4.[Java] Optional이란? 개념 및 사용법
https://mangkyu.tistory.com/70

[RockyLinux] 윈도우에서 Rocky Linux 원격접속 하기 (원격데스크톱)

sabeom — Wed, 6 Mar 2024 14:27:10 +0900

1. epel 설치

$ yum install epel-release

2. xrdp 및 tigervnc 설치

$ yum install xrdp tigervnc-server

$ rpm -qa |grep tigervnc

3. 방화벽 설정 및 재실행

$ firewall-cmd --permanent --zone=public --add-port=3389/tcp

$ firewall-cmd --reload

# 방화벽 확인
$ firewall-cmd --list-ports

4. xrdp 서비스 재실행

$ systemctl enable xrdp.service

$ systemctl start xrdp.service

$ systemctl status xrdp.service

5. 포트 확인

$ netstat -nap | grep 3389

6. window에서 원격 데스크톱 연결

username, password에 리눅스계정 입력하기

[RockyLinux] Rocky Linux 설치하기

sabeom — Wed, 6 Mar 2024 14:16:54 +0900

ISO 다운로드

https://rockylinux.org/ko/download

Minimal : 간편설치 (옵션 선택폭이 좁음)
DVD : 전체설치 (옵션 선택이 많음)

ISO 부팅 USB 만들기 - Rufus

https://rufus.ie/ko/

Rufus 다운로드

rufus download

Rufus로 부팅 USB 만들기

rufus

Rocky Linux 설치

1. 설치 전 iso파일 무결성 검사하기

iso 파일의 무결성을 검사하기 위해 Test this media & install Rocky Linux 선택

2. 설치환경 언어 선택하기

3. 설치요약

언어지원: 한국어 또는 영어
시간과날짜: 아시아/서울
설치목적지: 사용자정의

사용자정의

수동 파티션 설정

설정이 완료됬으면 Accept Changes 클릭

인터넷 설정

설치

설치가 완료되면 시스템 재시작

설치완료

사붐이개발일기

[Obsidian] Obsidian으로 자동 Git Commit 하기

Obsidian에서 Git Plugin 설치하기

1. Community Plugins 활성화

2. Browse 선택

3. Git Plugin 검색

4. Plugin 설치

5. Plugin 활성화

Git 저장소 연동하기

1. Vault 루트에 .gitignore 파일 만들기

2. Git 저장소 초기 연결

Git 자동 커밋 설정하기

1. 30분마다 자동 Commit & Push

2. 10분마다 자동 Pull

마무리

[Spring] Global Exception Handler (Controller Advice)

서론

코드 구현

에러 핸들러

커스텀 에러 메시지

에러타입 정의

[JS/Svelte] Excel파일 다운로드 기능 구현하기 - Excel.js

서론

사용하기

1. exceljs 라이브러리 설치

2. exceljs 객체 가져오기

3. workbook 객체 생성

4. worksheet 객체 생성

5. worksheet 컬럼명 등록

6. worksheet 데이터 추가

7. workbook 객체를 Blob 객체로 변환하여 다운받기

이슈사항

# 24-08-21

Reperence

[RockyLinux] 사설 네트워크 브릿지 구성하기 (사설 IP)

네트워크 브릿지

KVM으로 사설 네트워크 브릿지 만들기

Reference

[MyBatis] Update Join - table끼리 join해서 update 하기

내가 사용한 방법

[MyBatis] Insert Join - table끼리 join해서 insert하기

Insert into + Join 쿼리

Q. TB1 에는 있고, TB2에는 없는 레코드만 TB2에 추가하기

내가 사용한 방법

Reference

[MyBatis] Batch Insert - 대용량 데이터 insert

내용

예시

내가 사용한 방법 !

Reference

[Spring] Enum , Optional 참고자료

Reference

[RockyLinux] 윈도우에서 Rocky Linux 원격접속 하기 (원격데스크톱)

[RockyLinux] Rocky Linux 설치하기

ISO 다운로드

ISO 부팅 USB 만들기 - Rufus

Rocky Linux 설치

1. 설치 전 iso파일 무결성 검사하기

2. 설치환경 언어 선택하기

3. 설치요약

설치

1. Vault 루트에 `.gitignore` 파일 만들기