나홀로 싸우면서 만드는 프로젝트의 여정을 시작하려고한다!

1. IntelliJ 내에서 프로젝트 생성

나는 플랫폼을 만들어 보기위해 프로젝트 구조를 아래와 같이 설계했다. 또한 프로젝트를 구별하기위해 D드라이브에 진행하니 참고하길 바란다.

cleans-platform/        # 메인 프로젝트 루트 폴더
│── cleans-bo-api/      # Spring Boot 백엔드 프로젝트
│   ├── src/           
│   │   ├── main/      
│   │   │   ├── java/com/example/ # Java 소스 코드
│   │   │   ├── resources/        # 설정 파일 (application.yml 등)                
│
│── cleans-bo-app/       # Vue.js 프론트엔드 프로젝트
│   ├── src/            # Vue 컴포넌트 및 소스 코드
│   │   ├── assets/     
│   │   ├── components/
│   │   ├── views/
│   │   ├── router/index.js   # Vue Router 설정
│   │   ├── store/index.js    # Vuex 또는 Pinia 상태 관리
│   │   ├── App.vue           
│   │   ├── main.js           
│   ├── public/          # 정적 파일
│   ├── package.json     # npm 패키지 설정
│   ├── vite.config.js   # Vite 또는 Webpack 설정
│   ├── node_modules/    # npm dependencies
│   ├── README.md        
│
│── README.md            # 전체 프로젝트 설명서

1.1 Spring Boot 백엔드 프로젝트 생성

⬆️ 프로젝트 이름과 언어, 타입, jdk 설정 후 다음

⬆️ 나는 기본적으로 위 3개정도 설정하고 생성한다.

⬆️ 이후 Main으로 들어가면 위와 같이 생성되어 있다.

⬆️ port 설정을 따로 하고싶으면 위와 같이 하면된다.

⬆️ 그리고 Boot 를 run하면 잘 뜬것을 확인 할 수 있다.

⬆️ localhost:9090으로 접속하면 이 화면이 뜨면 정상접속이다!

ex) 시큐리티 설정한 사람들을 위해

⬆️ 시큐리티 설정 후 run을 하게되면 console에 password가 생겨난 것을 볼 수 있다. Using generated security password: edd03d18-b169-4502-a69c-047666bdbe94

⬆️ 그리고 web을 확인하면 위와 같은 화면이 뜨는데 Username - user Password - 콘솔에서 알려준 password를 치고 진입하면 된다.

2. View 설정

방법은 여러 가지이다. 나는 기존 방법에서 vue를 사용하는 방법을 택했다.

2.1 정적 리소스 설정 커스터마이징 - WebConfigurer

기본적으로 스프링 부트에서 web의존성 추가 후 localhost:9090으로 접근하면 resources/static/index.html을 읽게된다.

만약 resources/templates/index.html로 위치하려면 스프링 부트에서 제공하는 WebMvcConfigurer를 implements 한 후 addResourceHandlers를 override 해야한다.

package com.example.ilapofol.config;

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

@Configuration
public class ViewConfiguration implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/**")
                .addResourceLocations("classpath:/templates/", "classpath:/static/");
    }
}

2.2 Thymeleaf설정

application.properties 를 아래와같이 thymeleaf 추가

spring.application.name=cleans
server.port = 9090

#thymeleaf
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html
spring.thymeleaf.cache=false
spring.thymeleaf.check-template-location=true

build.gradle 에 thymeleaf 의존성 추가

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

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

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(17)
    }
}

configurations {
    compileOnly {
        extendsFrom annotationProcessor
    }
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-security'
    implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
    implementation 'nz.net.ultraq.thymeleaf:thymeleaf-layout-dialect'
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.thymeleaf.extras:thymeleaf-extras-springsecurity6'
    compileOnly 'org.projectlombok:lombok'
    developmentOnly 'org.springframework.boot:spring-boot-devtools'
    annotationProcessor 'org.projectlombok:lombok'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
    testImplementation 'org.springframework.security:spring-security-test'
    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
}

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

2.3 vue project 셋팅

2.3.1 nodejs 다운

https://nodejs.org/ko/

2.3.2 node 및 npm version 확인

(참고, 명령프롬포트를 관리자권한으로 실행하면 C드라이브가 디폴트일때 D로 가려면 :D 입력하면된다)

D:\>node -v
v22.14.0

D:\>npm -v
10.9.2

2.3.3 프로젝트 내에 vue를 설치한다.

D:\>cd project

D:\project>cd cleans-platform

D:\project\cleans-platform>npm install vue

added 23 packages in 4s

3 packages are looking for funding
  run `npm fund` for details
npm notice
npm notice New major version of npm available! 10.9.2 -> 11.2.0
npm notice Changelog: https://github.com/npm/cli/releases/tag/v11.2.0
npm notice To update run: npm install -g npm@11.2.0
npm notice

2.3.4 vue version 확인

D:\project\cleans-platform>npm vue -v
10.9.2

2.3.5 Vue CLI 설치하기

npm install -g @vue/cli c

added 834 packages in 39s

76 packages are looking for funding
  run `npm fund` for details

D:\project\cleans-platform>

위처럼 packages 받으면 된것!

이후 차례대로 설치해주기!

npm install -D webpack webpack-cli

npm install -D vue-loader vue-template-compiler

npm install -D @babel/core @babel/preset-env babel-loader

다 설치후 vue -v를 확인하면 아래와 같이 잘뜬다.

D:\project\cleans-platform>vue -V
@vue/cli 5.0.8

2.3.6 이후 원하는 경로에 project를 만든다

(경로는 맨위 참조)

D:\>cd project

D:\project>cd cleans-platform

D:\project\cleans-platform>vue create cleans-bo-app

위와 같이 생긴 것을 알 수 있다.

2.3.7 Spring Boot 프로젝트 연동 (분리된 프로젝트 연동하기)

2.3.7.1 package.json 수정

Vue.js에서 사용할 port 3000으로 변경 "serve" : "vue-cli-service serve --port 3000" 코드 변경 시 자동 재빌드 옵션 추가 "build" : "vue-cli-service build --watch"

2.3.7.2 vue.config.js 파일 수정

const { defineConfig } = require('@vue/cli-service')
module.exports = defineConfig({
  transpileDependencies: true,
  // npm run build target (backend - api쪽)
  outputDir: "../cleans-bo-api/src/main/resources/static",
  // npm run server 개발 진행시 포트가 다르기 때문에 프록시 설정해줘야 한다
  // target : 백엔드 port
  // changeOrigin : true로 해야지 cros 문제 해결할 수 있다.
  devServer: {
    proxy: {
      '/': {
        target: "http://localhost:9090",
        changeOrigin: true,
      }
    }
  }
})

2.3.7.3 Vue project build

프로젝트 폴더에서 npm run build 입력

2.3.7.4 Spring Boot project 내 index.html 생성 확인

2.3.7.5 Spring Boot project 실행

1) AWS CloudFront

• 웹 사이트, API, 동영상 콘텐츠 또는 기타 웹 자산의 전송을 가속화하는 글로벌 전송 네트워크(CDN) 서비스
• Front에서 미리 Request를 처리
• DDOS 방어 제공(AWS Shield)
• 사용자 입장에서 가장 가까운 곳에서 컨텐츠를 받게 해주는 서비스

reference https://mk-jung.tistory.com/190

1) AWS EC2(Elastic Computing Cloud)

• 컴퓨팅 서버를 애플리케이션 수요에 따라 늘리거나, 줄이거나 가능한 서버
• 탄력적(Elastic), EC2 인스턴스

2) AWS ECS(EC2 Container Service)

• 도커 컨테이너를 지원하는 컨테이너 관리 서비스
• 클러스터 관리 인프라 설치, 운영 및 확장

3) AWS EC2 Container Registry

• 개발자가 도커 컨테이너 이미지를 손쉽게 저장, 관리, 및 배포할 수 있게 해주는 완전관리형 도커 컨테이너 레지스트리

4) AWS Lightsail

• AWS에서 가상 프라이빗 서버를 시작하고 관리할 때 사용할 수 있는 간편한 방법
• 프라이빗 서버 인스턴스, 컨테이너, 스토리지, 데이터베이스 등 서비스를 저렴하고 예측 가능한 비용으로 사용가능

5) AWS Batch

• 개발자가 AWS에서 수많은 배치 컴퓨팅 작업을 효율적으로 손쉽게 실행할 수 있도록 도와주는 서비스

6) AWS Elastic Beanstalk

• AWS에 애플리케이션을 배포하는 가장 빠르면서 간편한 서비스
• AWS 상에 코드 업로드 시 용량 프로비저닝, 로드 밸런싱, Auto Scaling, 애플리케이션 상태 모니터링에 대한 정보를 자동으로 처리해주는 서비스
• NET, JAVA, Node.js, PHP, Python, Ruby등 다양한 애플리케이션 지원

7) AWS Lambda : 서버리스 컴퓨팅

• 서버리스, 서버를 프로비저닝하거나 관리하지 않고도 코드를 실행할 수 있게 해주는 컴퓨팅 서비스
• 서버 없이 코드만으로 특정 업무를 처리(이벤트 처리 기반)
• Lambda 비용 청구 기준 : 실행시간 기준 / 요청 수 기준

8) Auto Scaling

• 애플리케이션 가용성을 유지하는데 도움이 되고 정의한 조건에 따라 Amazon EC2 용량을 자동으로 확장하거나 축소할 수 있는 기능

reference https://mk-jung.tistory.com/190

https://velog.io/@hyeri_hello/Java-3-%EB%94%94%EC%9E%90%EC%9D%B8%ED%8C%A8%ED%84%B4

2. Prototype Pattern

처음부터 일반적인 원형을 만들어놓고 그것을 복사한 후 필요한 부분만 수정하여 사용하는 패턴 기존 객체를 복제함으로써 객체를 생성 한다.

3. Prototype Pattern 장점 및 특징

재사용성: 프로토타입 패턴을 사용하면 기존 개체를 새 개체를 만들기 위한 청사진으로 재사용할 수 있으므로 시간과 각각의 새 객체를 생성하는 데 필요한 노력.

유연성: 패턴을 사용하면 런타임에 새 객체를 생성할 수 있으므로 응용 프로그램의 요구 사항에 따라 객체를 생성할 수 있는 유연성이 제공됩니다.

성능: 프로토타입을 복제하여 새 개체를 만드는 것이 처음부터 새 개체를 만드는 것보다 빠르고 효율적입니다. 특히 개체의 구조가 복잡한 경우에는 더욱 그렇습니다.

결합 감소: 프로토타입 패턴은 객체 자체의 실제 구현에서 객체 생성 프로세스를 분리하여 나머지 코드에 영향을 주지 않고 향후 객체 생성 방식을 쉽게 변경할 수 있습니다. .

추상화: 프로토타입 패턴은 객체 생성 프로세스를 추상화하여 코드를 이해하고 유지하기 쉽습니다.

4. 코드예제

/** Prototype Class **/
public class Cookie implements Cloneable {

   public Object clone() {
      try {
         Cookie copy = (Cookie)super.clone();

         //In an actual implementation of this pattern you might now change references to
         //the expensive to produce parts from the copies that are held inside the prototype.

         return copy;

      }
      catch(CloneNotSupportedException e) {
         e.printStackTrace();
         return null;
      }
   }
}

/** Concrete Prototypes to clone **/
public class CoconutCookie extends Cookie { }

/** Client Class**/
public class CookieMachine {

   private Cookie cookie;//could have been a private Cloneable cookie;

   public CookieMachine(Cookie cookie) {
      this.cookie = cookie;
   }
   public Cookie makeCookie() {
      return (Cookie)cookie.clone();
   }
   public Object clone() { }

   public static void main(String args[]) {
      Cookie tempCookie =  null;
      Cookie prot = new CoconutCookie();
      CookieMachine cm = new CookieMachine(prot);
      for (int i=0; i<100; i++)
         tempCookie = cm.makeCookie();
   }
}

1) 성능 데이터 모델링

데이터베이스 성능 향상을 목적으로, 설계 단계의 데이터 모델링 때부터 성능과 관련된 사항이 데이터 모델링에 반영될 수 있도록 하는 것

2) 성능 데이터 모델링 고려사항

1. 데이터 모델링을 할때 정규화를 정확하게 수행한다. (분산효과)

2. 데이터베이스 용량 산정을 수행한다. [테이블 (엔티티) 데이터 집중 파악]

3. 데이터베이스에 발생되는 트랜잭션의 유형을 파악한다.

4. 용량과 트랜잭션의 유형에 따라 반정규화를 수행한다. (테이블, 속성, 관계에 대한 포괄적인 반 정규화)

5. 이력모델의 조정, PK/FK 조정, 슈퍼타입/서브타입 조정 등을 수행한다. (우수한 컬럼순위 지정)

6. 성능 관점에서 데이터 모델을 검증한다.

   
   ## 3) *트랜잭션 유형 파악

7. *CRUD 매트릭스를 보고 파악, 객체지향 모델링을 적용한다면 시퀀스 다이어그램을 이용

8. 입력, 수정, 삭제, 조회에 따라 테이블 데이터 추리 유추

9. SQL문 조인관계 테이블에서 데이터 조회의 컬럼 파악에 따른 성능고려

   
   

✔️ CRUD 매트릭스란?

2차원 형태의 표로서, 행에는 프로세스를, 열에는 테이블을, 행과 열이 만나는 위치에는 프로세스가 테이블에 발생시키는 변화를 표시하는 업무 프로세스와 데이터 간 상관 분석표이다.

2. 정규화와 성능

• 데이터 중복(이상현상)을 최소화 하기 위해 릴레이션을 분해하는 과정

• 제 1정규형 ~ 제 6정규형, BCNF가 있지만 대체적으로 실무에서는 대체로 1~3 정규화까지의 과정을 거친다.
• 정규화는 논리적 설계 단계에서 수행
• 정규형의 차수가 높아질수록 데이터 중복이 줄어 이상현상이 발생하지 않는 릴레이션이 됨
• 즉, 정규형의 차수가 높아질수록 제약조건이 높다.

  ✔️ 이상현상 ?

  불필요한 데이터 중복으로 인해 릴레이션에 대한 데이터 삽입, 수정, 삭제 연산을 할 때 발생할 수 있는 부작용

1) 정규화 수행과 성능

• 조회 성능 : 처리 조건에 따라 향상될 수 있고 아닐 수 있다.
• 입력, 수정, 삭제 성능 : 성능이 향상 된다.
  

2) 정규화

(1) 제 1정규화 (1NF) : 종속 속성 제거, 일반 속성 대상

릴레이션에 속한 모든 속성의 도메인이 원자값으로만 구성되어 있어야 한다. 즉, 모든 속성은 반드시 하나의 값만 가져야 한다.

테이블(Relation)이 제 1정규형을 만족했다는 것은 아래 세 가지 조건를 만족했다는 것을 의미한다.

• 어떤 Relation에 속한 모든 Domain이 원자값(atomic value)만으로 되어 있다.
• 모든 attribute에 반복되는 그룹(repeating group)이 나타나지 않는다.
• 기본 키를 사용하여 관련 데이터의 각 집합을 고유하게 식별할 수 있어야 한다.
  

예시 1. 다중값을 가진다 (1번 사항 위배)

• 비정규화 테이블
  • 고객아이디, 이름은 복합 기본키 (기본키 : {고객아이디, 이름})

예시 2. 반복 그룹을 가진다 (2번사항 위배)

• 비정규화 테이블
  • 고객아이디, 이름은 복합 기본키 (기본키 : {고객아이디, 이름})

🌱 제 1 정규화

단, 기본키가 유일하지 않다는 것을 알 수 있다. 
따라서 3번 조건을 만족하기 위해서 아래와 같이 테이블을 나누어 디자인 하는 것이 좋다. 
(예시가 전화번호 테이블이기 때문에 실 업무에서는 더 생각해 볼 필요가 있음)

• 정규화 테이블 (1정규화)

위 테이블은 고객정보 테이블과 고객 전화번호 테이블이 1 : N 관계를 형성하는 것을 알 수 있다.

(2) 제 2정규화 (2NF) : 부분적 함수종속 제거, 복합식별자만 대상

• 테이블의 모든 컬럼이 완전함수적 종속을 만족한다. 즉, 모든 속성은 반드시 모든 기본키에 종속되어야 한다. (기본키 일부에만 종속 되어서는 안됨)

• 주문 테이블
  • 주문번호, 상품코드는 복합 기본키이다. (기본키 : {주문번호, 상품코드})
  • 상품명은 상품코드에만 종속된다. (상품코드 : 결정자, 상품명 : 종속자)
  • 즉, 상품코드는 상품명을 결정하고 상품코드는 상품명에 종속된다 할 수 있다. (상품코드 → 상품명)
    • ‘부분함수 종속성’

위 주문 테이블은 이상현상이 발생한다.

1. 입력이상 : 주문이 발생하지 않으면 상품명이 입력 불가
2. 수정이상 : 상품명이 변경될 경우 해당되는 주문 ROW UPDATE 필요
3. 삭제이상 : 상품 삭제시 주문까지 삭제

🌱 제 2 정규화

주문과 관계없이 상품의 데이터입력, 수정, 삭제가 가능하다.
따라서 현재 테이블의 핵심 주제와 상관없는 컬럼을 제거하면 된다.

(3) 제 3정규화 (3NF) : 이행함수 종속성 제거

기본키가 아닌 모든 속성간에는 서로 종속될 수 없다.

테이블(Relation)이 제 3정규형을 만족한다는 것은 아래 두 가지 조건을 만족하는 것을 의미한다.

1. 테이블이 제 2정규형을 만족해야한다.
2. 테이블 내의 모든 속성이 기본키에만 의존해야하며, 다른 후보키에 의존하지 않는다.

즉, 이행적 함수종속은 기능적 종속으로 X⟶ Y 이고 Y⟶ Z 에 의해서 X⟶ Z (X가 Z를 결정한다) 가 되는 것이다.

• 상품 테이블
  • 상품코드는 유일한 기본키이다. (기본키 : 상품코드)
  • 제공업체는 상품코드에 종속되지 않고 상품명(후보키)에 종속된다.
  • 데이터 이상 현상 발생 가능!

🌱 제 3 정규화

제공업체는 주문번호(기본키)와 상관이 없는 컬럼이기 때문에 제거하면된다.

(4) BCNF 정규화 : 결정자가 후보키가 아닌 함수 종속성 제거 → BCNF를 만족한다.

릴레이션의 함수 종속관계에서 모든 결정자가 후보키이면 보이스/코드 정규형에 속한다.

결정자가 후보키가 아니고 종속자가 기본키의 부분집합인 속성을 분해 BCNF 정규형인 모든 릴레이션은 제 3정규형에 속한다. 그 역은 성립되지 않는다.

• 주문테이블

제공업체가 상품을 제공하겠다고 결정해야 주문번호가 일어난다. 만약 주문이 일어났는데 제공업체가 상품을 제공하지 않는다면 주문을 받을 수가 없다. 즉, 제공업체도 후보키가 되어야한다. (결정자가 후보키가 아닌 속성 분리)

🌱 BCNF

따라서 상품테이블이 먼저 결정이된 후 주문테이블이 생성될 수 있게 만들어 주는 구조를 BCNF라고한다.

(5) 제 4정규화 (4NF) : 다중값 종속성을 제거한다

하나의 결정자가 다른속성에서 여러 종속자를 결정할 때 다치종속 이라고한다.

한 릴레이션에서 1:N, 1:N 두 개 이상으로 다치종속이 구성되어 있을때 이상현상이 발생한다. 중심이 되는 속성을 기준으로 릴레이션을 분리해줘야한다.

• 개발자 테이블

🌱 제 4정규화

개발자마다 자격증 값들이 여러개 존재하고, 개발자마다 언어 값들이 여러개 존재하는 경우 다치 종속 관계라고 한다. 이러한 경우 개발자, 자격증 / 개발자, 언어 테이블로 분리하여 관리하며 다치종속 관계를 제거하기 때문에 4차 정규화를 만족한다.

(6) 제 5정규화 (5NF) : 조인 종속성을 제거한다

릴레이션을 셋으로 분해 하여야만 조인을 통해서 원본 조회가 가능하다.

4차정규화 테이블에 대해 조인연산을 수행하면 4차 정규화 수행전 데이터와 다르게 되는 문제인 조인 종속이 발생한다.

• 4차 정규화 테이블

🌱 제 5정규화

조인 종속 관계를 제거하기 위해서는 모든 속성 관계인 개발자,자격증 / 개발자, 언어 / 자격증, 언어 관계에 대한 테이블을 만들어 줌으로써 조인을 했을때 정확히 원래의 데이터로 복원할 수 있게 한다.

3. 반정규화 (De-Normalization)와 성능

* 중복 데이터를 데이터베이스에 추가하여 데이터 검색에 필요한 조인 수를 줄여 성능을 향상시키는 프로세스
* 정규화된 엔티티, 속성, 관계에 대해 성능 향상과 개발 운영의 단순화를 위해 중복, 통합, 분리 등을 수행하는 데이터 모델링 기법
* 비정규화, 역정규화라고 불린다.
* 조회 성능 향상 - 중복성의 원리를 활용하여 데이터 조회시 성능을 향상시키는 역할을 할 수 있음.
(테이블의 중복성,  컬럼의 중복성, 관계의 중복성)

(1) 반정규화 절차

1. 반정규화 대상조사

   범위처리빈도수 조사 대량의 범위처리 조사 통계성 프로세스 조사(통계성 테이블생성) 테이블 조인 개수

2. 다른 방법유도 검토

   뷰테이블 클러스터링 적용(조회중심- 인덱스로 안될경우) 인덱스의 조정 파티셔닝 기법 적용 응용 애플리케이션 반정규화 적용(기법)

(2) 반정규화 적용(기법)

1) 모델링 정의

• 정의 : 복잡한 현실세계를 일정한 표기법에 의해 표현하는 일
  
• 특징 :
  1. 추상화 : 일정한 형식 에 맞춰 표현함
  2. 단순화 : 제한된 표기법이나 언어로 표현함
     3. 명확성 : 이해가 쉽게 표현함
        
• 관점
  1. 데이터 관점 : 업무와 데이터 및 데이터 사이의 관계
     2. 프로세스 관점 : 진행되고 있거나 진행 되어야 하는 업무
     3. 상관 관점 : 데이터에 대한 업무 처리 방식의 영향

2) 데이터 모델링 3요소

• 정의 : 정보 시스템 구축을 위한 데이터 관점의 업무 분석 기법

1. 개체 : 업무가 관여하는 어떤 것 (Things)
2. 속성 : 어떤 것이 가지는 성격 (Attribute)
3. 관계 : 업무가 관여하는 어떤 것 간의 관계 (Relationships)

3) 데이터 모델링 3단계

1. 개념적 모델링 : 엔터티와 속성을 도출하고 ERD를 작성함
2. 논리적 모델링 : 식별자를 도출하고 속성과 관계 등을 정의함
3. 물리적 모델링 : DB 구축, 성능 및 보안 등 물리적인 성격 고려

<body >
    <form id="signup-form">    
      <select class="stm-select" th:name = "keyword" style = "width: 18em;" >
        <option value="선택">지역선택</option>
        <option th:each="addr , i : ${addr}" th:text="|${addr.sido} ${addr.gungu}|" th:value="|${addr.sido} ${addr.gungu}|"></option>
      </select>
      <input class="addr" type="hidden">
      <button type="submit" id="search_btn">조회</button>
    </form>

</body>

<script src="https://code.jquery.com/jquery-1.12.4.min.js"></script>
<script src="/assets/js/main2.js"></script>
<script type="text/javascript">
    $("#search_btn").click(
            function() {
                //option 값 가져오기
                var keyword = $("select option:selected").val();
                console.log(keyword);
                }
            );
</script>

https://velog.io/@hyeri_hello/Java-3-%EB%94%94%EC%9E%90%EC%9D%B8%ED%8C%A8%ED%84%B4

2. Builder Pattern

builder pattern은 객체 생성을 위해 사용되며, 필수 필드를 생성자에서 설정하고, 선택적 필드를 설정하는 메서드를 통해 설정할 수 있게 해준다. 즉, 객체의 생성 방법과 표현 방법을 분리한다.

빌더 패턴은 생성에서 어떤 문제를 해결하기 위해 고안되었나? : 객체 생성 시 생성자(Constructor)만 사용할 때 발생할 수 있는 문제를 개선하기 위해 고안됐다.

즉 필수 값에 대해서는 생성자를 통해, 선택 값에 대해서는 메소드를 통해 차례로 값을 입력 받은 후 build() 메소드를 통해 최종적으로 하나의 인스턴스를 return 하는 방식이다.

3. Builder Pattern 장점 및 특징

빌더 패턴은 많은 Optional 한 멤버변수, 파라미터, 지속성 없는 상태 값들에 대해 처리해야 하는 문제들을 해결한다.

4. 코드 예제

예를들어 여행 계획을 세우는 앱을 개발한다고 할때 다음과 같은 요구사항이 있다.

✅ 요구사항1 : 여행 제목, 여행 출발 일, 몇 박, 며칠, 장소, 스케줄

요구사항 1을 만족 하기 위해 아래와 같은 도메인 으로 구성된다.

(1) domain code

public class TourPlan{
    private String title; // 여행 제목
    private LocalDate startDate; // 여행 출발 일
    private int nights; // 몇 박
    private int days; // 며칠
    private String places; // 장소
    private List<DetailPlan> plans; // n일차 할 일
}

/**
 * n일차 할 일
 */
public class DetailPlan {
    private int day; // n일차
    private String plan; // 할 일
}

✅ 요구사항2 : 당일 치기 계획도 필요함

요구사항 2 같은경우는 몇박 며칠인지 필요가 없다. 필수적인 정보와 선택적인 정보가 생겼을 땐 어떻게 처리해야 할까?

* Builder 패턴 특징

1. 필요한 객체를 직접 생성하는 대신, 먼저 필수 인자들을 생성자에 전부 전달하여 빌더 객체를 만든다.
2. 그리고 선택 인자는 가독성이 좋은 코드로 인자를 넘길 수 있다.
3. setter가 없으므로 객체 일관성을 유지하여 불변 객체로 생성할 수 있다.

(2) Interface - TourPlanBuilder

public interface TourPlanBuilder {

    TourPlanBuilder nightsAndDays(int nights, int days);

    TourPlanBuilder title(String title);

    TourPlanBuilder startDate(LocalDate localDate);

    TourPlanBuilder whereToStay(String whereToStay);

    TourPlanBuilder addPlan(int day, String plan);

    TourPlan getPlan();

}

(3) class - ConcreteBuilder

public class DefaultTourBuilder implements TourPlanBuilder {

    private String title;

    private int nights;

    private int days;

    private LocalDate startDate;

    private String whereToStay;

    private List<DetailPlan> plans;

    @Override
    public TourPlanBuilder nightsAndDays(int nights, int days) {
        this.nights = nights;
        this.days = days;
        return this;
    }

    @Override
    public TourPlanBuilder title(String title) {
        this.title = title;
        return this;
    }

    @Override
    public TourPlanBuilder startDate(LocalDate startDate) {
        this.startDate = startDate;
        return this;
    }

    @Override
    public TourPlanBuilder whereToStay(String whereToStay) {
        this.whereToStay = whereToStay;
        return this;
    }

    @Override
    public TourPlanBuilder addPlan(int day, String plan) {
        if (this.plans == null) {
            this.plans = new ArrayList<>();
        }

        this.plans.add(new DetailPlan(day, plan));
        return this;
    }

    @Override
    public TourPlan getPlan() {
        return new TourPlan(title, startDate, days, nights, whereToStay, plans);
    }
}

(4) 생성

(1) ConcreteBuilder에 바로생성

return tourPlanBuilder.title("미국 여행")
        .nightsAndDays(5, 6)
        .startDate(LocalDate.of(2023, 01, 25))
        .whereToStay("리조트")
        .addPlan(0, "체크인하고 짐 풀기")
        .addPlan(0, "저녁 식사")
        .getPlan();

(2) Director 통해서 생성

public class TourDirector {

    private TourPlanBuilder tourPlanBuilder;

    public TourDirector(TourPlanBuilder tourPlanBuilder) {
        this.tourPlanBuilder = tourPlanBuilder;
    }

    public TourPlan cancunTrip() {
        return tourPlanBuilder.title("칸쿤 여행")
                .nightsAndDays(2, 3)
                .startDate(LocalDate.of(2020, 12, 9))
                .whereToStay("리조트")
                .addPlan(0, "체크인하고 짐 풀기")
                .addPlan(0, "저녁 식사")
                .getPlan();
    }

    public TourPlan longBeachTrip() {
        return tourPlanBuilder.title("롱비치")
                .startDate(LocalDate.of(2021, 7, 15))
                .getPlan();
    }
}


public static void main(String[] args) {
    TourDirector director = new TourDirector(new DefaultTourBuilder());
    TourPlan tourPlan = director.cancunTrip();
}

빌더 패턴은 굉장히 자주 사용되는 생성 패턴 중 하나로, 실무에서는 Stream.Builder API, StringBuilder, UriComponentsBuilder 등에 활용된다.

reference https://dev-youngjun.tistory.com/197

회사에서 물리적 온프레미스 컴퓨팅 서버를 AWS 서버리스 컴퓨팅 서비스로 교체할 계획입니다. 회사는 마이그레이션 후 신속하게 고급 기술을 활용할 수 있기를 원합니다. 이 계획이 나타내는 AWS Well-Architected 프레임워크의 기둥은 무엇입니까?

2. 보기

A. 보안 B. 성능 효율성 C. 운영 우수성 D. 신뢰성

3. 답, 해설

B. 성능 효율성 또는 C. 운영 우수성

AWS Well-Architected 프레임워크는 AWS 클라우드에서 안정적이고 안전하며 효율적이고 비용 효율적인 시스템을 구축하기 위한 일련의 모범 사례 및 아키텍처 원칙입니다. 이를 통해 조직은 다양한 설계 결정의 장단점을 이해하고 비즈니스 및 기술 요구 사항을 충족하기 위해 AWS 서비스를 사용하는 방법에 대해 정보에 입각한 선택을 할 수 있습니다.

프레임워크는 5개의 기둥으로 구성됩니다.

운영 우수성: 조직의 시스템이 원활하게 실행되고 시간이 지남에 따라 쉽게 관리 및 유지될 수 있도록 도와줍니다.

보안: 조직의 시스템과 데이터를 무단 액세스, 사용, 공개, 중단, 수정 또는 파괴로부터 보호하는 데 도움이 됩니다.

안정성: 조직 시스템의 가용성, 확장성 및 자가 복구 기능을 보장하는 데 도움이 됩니다.

성능 효율성: 조직의 시스템이 리소스(컴퓨팅, 메모리, 스토리지 및 네트워크)를 최적의 방식으로 사용하고 있는지 확인하는 데 도움이 됩니다.

비용 최적화: 조직이 가장 비용 효율적인 방식으로 AWS 서비스를 사용하고 있으며 사용 가능한 유연한 요금 및 결제 옵션을 활용하고 있는지 확인하는 데 도움이 됩니다.

프레임워크의 모범 사례와 원칙을 따르면 조직은 안전하고 안정적이며 고성능이며 비용 효율적이고 변화하는 비즈니스 요구 사항에 쉽게 적응할 수 있는 시스템을 구축할 수 있습니다.

프레임워크의 목표는 조직이 AWS 서비스를 최대한 활용하여 비즈니스 목표를 지원하도록 하는 것입니다.

https://aws.amazon.com/blogs/apn/the-6-pillars-of-the-aws-well-architected-framework/

다음 중 AWS 클라우드로 마이그레이션할 때의 이점은 무엇입니까? (두 가지를 선택하세요.)

2. 보기

A. 운영 탄력성 B. Amazon.com 제품 할인 C. 비즈니스 민첩성 D. 비즈니스 우수성 E. 직원 보유 증가

3. 답, 해설

A. 운영 탄력성 C. 비즈니스 민첩성

(1) AWS 마이그레이션 이란?

AWS 마이그레이션은 데이터, 애플리케이션 또는 기타 비즈니스 요소 를 사내 또는 다른 클라우드 환경에서 AWS(Amazon Web Services) 클라우드 플랫폼으로 이동 하는 프로세스를 말합니다. 여기에는 데이터를 AWS 스토리지 서비스로 마이그레이션하거나, AWS 컴퓨팅 서비스에서 실행할 애플리케이션을 이동하거나, AWS 도구 및 서비스를 사용하여 마이그레이션 프로세스를 관리하고 최적화하는 작업이 포함될 수 있습니다. AWS로 마이그레이션하면 확장성, 유연성 및 비용 절감과 같은 이점을 제공할 수 있지만 원활한 전환을 위해 신중한 계획과 실행이 필요합니다.

(2) AWS 마이그레이션의 주요 이점

AWS 클라우드는 동적 기술 환경에 빠르게 적응할 수 있도록 해주는 이상적인 클라우드 컴퓨팅 플랫폼 역할을 합니다.

다음은 AWS 클라우드 솔루션으로 마이그레이션할 때 얻을 수 있는 몇 가지 주요 이점입니다.

1. 높은 유연성

AWS 클라우드 컴퓨팅은 여러분이 기다려온 최고의 솔루션입니다. 이는 높은 수준의 유연성을 제공하기 때문입니다. 운영 체제(OS), 데이터베이스, 웹 애플리케이션 플랫폼 및 프로그래밍 언어를 선택할 수 있습니다. AWS 클라우드 마이그레이션 의 주요 이점 중 하나는 요구 사항에 따라 애플리케이션을 로드할 수 있다는 것입니다. 가상 환경에서 애플리케이션에 필요한 요소를 디자인할 수 있습니다. 따라서 마이그레이션 프로세스가 정말 간단하고 편리해집니다.

2. 사용이 간편하다

AWS 클라우드 플랫폼을 사용하면 벤더와 애플리케이션 공급자가 애플리케이션을 안전하고 빠르게 호스팅할 수 있습니다. 따라서 새로운 애플리케이션이든 기존 애플리케이션이든 상관없이 플랫폼은 프로세스를 단순화합니다. 이는 IT 리소스와 기능을 최적으로 사용하는 데 도움이 되는 AWS 마이그레이션 의 주요 이점 중 하나입니다.

3. 확장성

현 시대에 운영되는 비즈니스는 진화하는 시장 트렌드와 수요에 적응해야 합니다. AWS 마이그레이션 의 주요 이점 중 하나 는 변화하는 수요에 따라 애플리케이션을 확장할 수 있도록 다양한 요소를 사용할 수 있다는 것입니다 . 예를 들어 애플리케이션이 최적의 성능을 발휘할 수 있도록 AWS 도구, Elastic Load Balancing 및 Auto Scaling을 사용할 수 있습니다.

4. 최고의 성능

AWS 마이그레이션 의 주요 이점 중 하나는 비즈니스 성능 향상입니다. AWS 클라우드 플랫폼을 사용하면 원하는 목표를 달성하기 위해 IT 애플리케이션을 원활하게 사용할 수 있습니다. 애플리케이션과 작동 방식을 쉽게 배포, 관리 및 모니터링할 수 있습니다. 따라서 애플리케이션 활용도와 비즈니스 성과를 더 잘 조정할 수 있습니다.

5. 높은 수준의 보안

보안은 기업과 개인을 괴롭히는 주요 측면 중 하나입니다. AWS는 클라우드 인프라가 최고 수준의 보안 프레임워크를 갖도록 종단 간 접근 방식을 사용합니다. AWS에서 활용하는 접근 방식은 물리적 운영 및 소프트웨어 조치를 포함하여 전체 IT 인프라를 강화하는 데 도움이 됩니다. 따라서 보안 문제에 대한 걱정 없이 AWS 클라우드 마이그레이션 기술 을 사용할 수 있습니다 . 강력한 보안 요소 세트를 통해 모든 비즈니스 요구 사항을 충족할 수 있습니다.

6. 비용 효율성

AWS 클라우드로 마이그레이션하는 데 비용이 많이 든다고 생각한다면 다시 생각해야 합니다. 실제로는 비용 관리가 훨씬 더 간단해질 것입니다. 이것이 어떻게 가능할지 궁금하다면 여기에 답이 있습니다. 스토리지, 컴퓨팅 성능 및 사용해야 하는 기타 리소스에 대해서만 비용을 지불하면 됩니다. 귀하는 장기 계약이나 약속의 일부가 될 필요가 없습니다.

따라서 AWS 마이그레이션의 주요 이점 중 하나는 인프라 비용 부담이 없다는 것입니다. 효율적이고 효과적인 방식으로 비즈니스 운영에 집중할 수 있습니다.

7. 믿을 수 있는 자연

AWS 클라우드 솔루션의 주요 특징 중 하나는 높은 수준의 안정성과 의존성입니다. AWS 마이그레이션 서비스 를 선택 하면 안전하고 신뢰할 수 있는 글로벌 인프라를 활용할 수 있습니다. 여전히 클라우드 환경이 불안하다면 긴장을 풀 필요가 있습니다. AWS 클라우드는 Amazon의 가상 백본 역할을 하므로 신뢰할 수 있는 인프라입니다.

AWS 클라우드 솔루션은 다른 서비스에 비해 훨씬 안정적입니다. 에코시스템은 애플리케이션과 소프트웨어에 필요한 지원을 제공하도록 설계되었습니다. 따라서 IT 인프라를 최대한 활용하기 위해 클라우드 설정으로 마이그레이션할 수 있습니다.

8. 높은 탄력성과 민첩성

AWS 클라우드 컴퓨팅 기술은 IT 리소스를 최적으로 활용할 수 있도록 보장합니다. 따라서 실제로 불필요하므로 리소스를 과도하게 프로비저닝할 필요가 없습니다. 비즈니스를 운영하는 데 실제로 필요한 IT 리소스와 기능을 활용할 수 있습니다. 금상첨화는 비즈니스 요구 사항을 효율적으로 충족할 수 있도록 리소스를 조정할 수 있다는 것입니다.

9. 운영 탄력성

AWS 마이그레이션 의 핵심 이점 중 하나는 비즈니스가 더 안전하고 덜 위험한 공간에서 운영될 수 있다는 것입니다. AWS 클라우드로의 마이그레이션에 대해 생각해 본 적이 없다면 비즈니스를 위험에 빠뜨리는 것입니다. 안전한 클라우드 플랫폼으로 마이그레이션하면 비즈니스 운영이 탄력적인 IT 배경으로 이동할 수 있습니다. 이러한 움직임은 자연스럽게 운영 탄력성에도 긍정적인 영향을 미칠 것입니다.

매우 예측하기 어려운 IT 시나리오에서 AWS 솔루션은 비즈니스에 가장 탄력적인 환경을 제공할 수 있습니다. 비즈니스 위험을 최소화하고 지속 가능성을 높이려면 AWS로 마이그레이션하는 것이 이상적인 선택일 수 있습니다. 보다 안전한 환경을 통해 IT 리소스를 생산적으로 사용하고 운영 분야에서 탁월할 수 있습니다.

10. 가능한 데이터 저장

현재 적절한 데이터 저장은 대부분의 비즈니스 사업에서 주요 관심사일 수 있습니다. 하지만 AWS 클라우드 솔루션을 선택하면 데이터 저장 문제에 대해 걱정할 필요가 없습니다. AWS 마이그레이션 의 주요 이점 중 하나 는 데이터 스토리지와 관련하여 높은 유연성이 있다는 것입니다. 다양한 종류의 전자기기에서 다양한 파일에 쉽게 접근할 수 있습니다. 장소가 다르거나 시간이 달라 걱정되더라도 걱정하지 않으셔도 됩니다. AWS 클라우드 컴퓨팅은 이러한 측면을 처리합니다.

https://www.easydeploy.io/blog/benefits-of-aws-migration/

AWS Well-Architected 프레임워크의 핵심 요소 중 인프라 또는 서비스 중단으로부터 복구하고 수요를 충족하기 위해 컴퓨팅 리소스를 동적으로 확보하는 시스템의 기능?

2. 보기

A. 보안 (Security) B. 신뢰성 (Reliability) C. 성능 효율성 (Performance efficiency) D. 비용 최적화 (Cost optimization)

3. 답, 해설

B. 신뢰성

안정성 원칙은 의도한 기능을 수행하는 워크로드와 요구 사항을 충족하기 위해 실패로부터 신속하게 복구하는 방법에 중점을 둡니다. 주요 주제에는 분산 시스템 설계, 복구 계획 및 변화하는 요구 사항에 대한 적응이 포함됩니다.

https://aws.amazon.com/ko/architecture/well-architected/?nc1=h_ls&wa-lens-whitepapers.sort-by=item.additionalFields.sortDate&wa-lens-whitepapers.sort-order=desc&wa-guidance-whitepapers.sort-by=item.additionalFields.sortDate&wa-guidance-whitepapers.sort-order=desc

4. 다른 보기 정의

1) 보안 (Security)

보안 원칙은 정보 및 시스템 보호에 중점을 둡니다. 주요 주제에는 데이터의 기밀성 및 무결성, 사용자 권한 관리, 보안 이벤트 감지를 위한 제어 설정이 포함됩니다.

2) 성능 효율성 (Performance Efficiency)

성능 효율성 원칙은 IT 및 컴퓨팅 리소스의 체계적이고 능률적인 할당에 중점을 둡니다. 주요 주제에는 워크로드 요구 사항에 최적화된 리소스 유형 및 크기 선택, 성능 모니터링 및 비즈니스 요구 사항의 변화에 ​​따른 효율성 유지가 포함됩니다.

3) 비용 최적화 (Cost Optimization)

비용 최적화 원칙은 불필요한 비용을 피하는 데 중점을 둡니다. 주요 주제에는 시간 경과에 따른 지출 이해 및 자금 할당 제어, 올바른 유형 및 수량의 리소스 선택, 초과 지출 없이 비즈니스 요구 사항에 맞게 확장하는 것이 포함됩니다.

4) 운영 우수성 (Operational Excellence)

운영 우수성 원칙은 시스템 실행 및 모니터링과 프로세스 및 절차를 지속적으로 개선하는 데 중점을 둡니다. 주요 주제에는 변경 자동화, 이벤트 대응, 일상 운영 관리를 위한 표준 정의가 포함됩니다.

5) 지속 가능성 (Sustainability)

지속 가능성 원칙은 클라우드 워크로드 실행이 환경에 미치는 영향을 최소화하는 데 중점을 둡니다. 주요 주제에는 지속 가능성에 대한 공동 책임 모델, 영향 이해, 활용도 극대화를 포함하여 필요한 자원을 최소화하고 다운스트림 영향을 줄입니다.

회사는 AWS 클라우드에서 글로벌 마케팅 애플리케이션을 실행할 계획입니다. 이 애플리케이션은 사용자가 볼 수 있는 동영상을 제공합니다. 회사는 모든 사용자가 짧은 대기 시간으로 이러한 비디오를 볼 수 있도록 해야 합니다. 회사에서 이 요구 사항을 충족하려면 어떤 AWS 서비스를 사용해야 합니까?

2. 보기

A. AWS Auto Scaling B. Amazon Kinesis 비디오 스트림 C. 탄력적 로드 밸런싱 D. 아마존 클라우드프론트

3. 답, 해설

D. 아마존 클라우드프론트

AWS에서는 콘텐츠 전송 네트워크(CDN)인 Amazon CloudFront를 사용할 수 있습니다. CloudFront는 전 세계 여러 지역에 위치한 캐시 서버를 사용하여 콘텐츠를 제공합니다. 사용자가 인터넷에 접속할 때, CloudFront는 사용자의 위치에 가장 가까운 캐시 서버를 찾아 콘텐츠를 제공하기 때문에, 짧은 대기 시간으로 동영상을 제공할 수 있습니다.

4. 다른 보기 정의

1) AWS Auto Scaling

AWS Auto Scaling은 인프라 구성 요소의 수를 자동으로 조정하는 서비스입니다.

예를 들어, 웹 서버 인스턴스가 증가한 트래픽을 처리할 수 있도록 인스턴스를 추가할 수 있고, 적은 트래픽을 처리할 때는 인스턴스를 제거할 수 있습니다. Auto Scaling은 인스턴스의 수를 조정하기 위해 설정한 임계치(threshold)를 기반으로 작동합니다. 임계치는 정해진 작업(scaling policy)을 수행하기 위한 상태를 지정합니다. 예를 들어, 인스턴스의 CPU 사용률이 80% 이상일 경우 인스턴스를 추가하거나, 인스턴스의 CPU 사용률이 10% 이하일 경우 인스턴스를 제거할 수 있습니다. Auto Scaling을 사용하면 인프라 구성 요소의 수를 자동으로 조정할 수 있기 때문에, 서비스의 유연성과 가용성을 향상시킬 수 있습니다.

2) Amazon Kinesis Video Streams

Amazon Kinesis Video Streams는 실시간 비디오 스트림을 전송, 저장, 처리할 수 있는 AWS 서비스입니다. Kinesis Video Streams는 실시간 영상과 오디오를 전송할 수 있는 소프트웨어 개발 키트(SDK)를 제공하고, 스트림을 저장하고 재생할 수 있는 기능을 제공합니다. Kinesis Video Streams는 실시간 비디오 스트림을 전송하고 저장할 수 있기 때문에, 실시간 영상 스트리밍 애플리케이션을 구축할 때 유용합니다. 예를 들어, 인터넷 생중계, 원격 진료, 전자정부 서비스 등의 실시간 영상 제공 서비스를 구축할 때 사용할 수 있습니다.

3) 탄력적 로드 밸런싱 (Dynamic Load Balancing)

탄력적 로드 밸런싱(Dynamic Load Balancing)은 시스템이 요청을 처리할 수 있는 자원의 상태를 계속 모니터링하고, 요청을 적절한 자원에게 전달하는 기능을 제공합니다. 이를 통해 시스템의 처리량과 응답 속도를 개선할 수 있습니다.

탄력적 로드 밸런싱은 정적 로드 밸런싱과 달리 요청을 처리할 수 있는 자원의 상태를 실시간으로 모니터링하기 때문에, 시스템의 처리량과 응답 속도를 좀 더 효과적으로 개선할 수 있습니다. 예를 들어, 요청이 많은 시간대에는 추가 자원을 사용하고, 요청이 적은 시간대에는 자원을 절약할 수 있습니다. 탄력적 로드 밸런싱은 시스템의 처리량과 응답 속도를 개선할 수 있기 때문에, 서비스의 가용성과 스케일 성을 개선할 수 있습니다.

Simple Mail Transfer Protocol의 약자로, 이메일 전송에 사용되는 네트워크 프로토콜이다.

2. Google Gmail SMTP 활용

(1). 계정 생성

나는 테스트용 구글 계정을 새로 만들었다! (과정은 생략)

계정 생성 후 Google계정관리로 이동 https://myaccount.google.com/

(2). 보안 2단계 인증 사용

하단의 2단계 인증이 사용안함 → 사용으로 변경해 줘야한다. 인증사용절차는 인증코드만 하면 간단하니 넘어가도록 하겠다!

(3). 앱 비밀번호 생성

아래의 앱 비밀번호를 클릭후 아래와 같이 기타를 선택한다. 이름은 SMTP 로 해주고 (원하는데로 지으면됨) 생성 후 자동 발급된 기기용 앱 비밀번호를 기억한다!

3. Spring Setting

(1). dependencis 추가

프로젝트로 돌아와서 의존성을 추가해준다. (gradle사용)

implementation 'org.springframework.boot:spring-boot-starter-mail'

(2). application.properties 추가

#mail
spring.mail.host=smtp.gmail.com
spring.mail.port=587
spring.mail.username=(user email)
spring.mail.password=(위에서 셋팅했던 앱 비밀번호)
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true

(3). 프로젝트 셋팅!

Controller에서 DTO 객체로 담아 서비스로 보낸다는 가정하에 설명한다.

MailController.java

    @PostMapping("/contact/send")
    @ResponseBody
    public String mail(@RequestBody MailDto data) {

        String    res = this.mailService.sendSimpleMessage(data);
        return    res;
    }

MailService.java

package com.example.ilapofol.business;

import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.stereotype.Service;

import com.example.ilapofol.model.MailDto;

import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;

@Service
@RequiredArgsConstructor
@Slf4j
public class MailService {

    private final JavaMailSender emailSender;

    public String sendSimpleMessage(MailDto data) {

        System.out.println(data);

        SimpleMailMessage message = new SimpleMailMessage();
        message.setFrom(data.getEmail());
        message.setTo("보낼 메일 즉 나의 메일!");
        message.setSubject(data.getName());
        message.setText(data.getMessage() + data.getEmail());
        emailSender.send(message);

        log.info("성공 메세지 {} : ", message);
        return "전송 성공!";
    }
}

MailDto.java

package com.example.ilapofol.model;

import lombok.Data;

@Data
public class MailDto {

    private int id;
    private String name;
    private String email;
    private String message;
}

4. 구현

MVC 패턴을 기본으로 하는 Springboot Project를 구성함

2. 프로젝트 생성

1. Setting

이클립스(또는 STS) 기준으로 함

1) Spring Starter Project

File > New > Spring Starter Project 위와 같이 세팅 후 Next

2) Dependencies

Lombok, Spring Web 선택 (원하는 의존성 추가 가능) 후 next → Finish

3) application.properties 추가

# 사용할 포트 :: port
server.port = 9090

#spring :: 스프링 setting
spring.application.name=ila-pofol
spring.application.sql=mysql

2. View 설정

방법은 두 가지 이다.

1) 정적 리소스 설정 커스터마이징 - WebConfigurer

기본적으로 스프링 부트에서 web의존성 추가 후 localhost:9090으로 접근하면 resources/static/index.html을 읽게된다.

만약 resources/templates/index.html로 위치하려면 스프링 부트에서 제공하는 WebMvcConfigurer를 implements 한후 addResourceHandlers를 override 해야한다.

package com.example.ilapofol.config;

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

@Configuration
public class ViewConfiguration implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/**")
                .addResourceLocations("classpath:/templates/", "classpath:/static/");
    }
}

2) Thymeleaf설정

application.properties 를 아래와같이 thymeleaf 추가

#port
server.port = 9090

#spring
spring.application.name=ila-pofol
spring.application.sql=mysql

#thymeleaf
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html
spring.thymeleaf.cache=false
spring.thymeleaf.check-template-location=true

build.gradle 에 thymeleaf 의존성 추가

plugins {
    id 'org.springframework.boot' version '2.7.5'
    id 'io.spring.dependency-management' version '1.0.15.RELEASE'
    id 'java'
}

group = 'com.example.ila-pofol'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '17'

configurations {
    compileOnly {
        extendsFrom annotationProcessor
    }
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'

    // 타임리프 아래 3개 implementation 추가
    implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
    implementation 'nz.net.ultraq.thymeleaf:thymeleaf-layout-dialect'
    implementation 'org.thymeleaf.extras:thymeleaf-extras-springsecurity5'

    compileOnly 'org.projectlombok:lombok'
    annotationProcessor 'org.projectlombok:lombok'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

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

3. Database Setting

create database ilapofol;

CREATE TABLE brewerypg (
  id int(11) NOT NULL auto_increment PRIMARY KEY,
  commend varchar(100) NOT NULL,
  regularvisit char(1) CHECK (regularvisit in ('Y','N')),
  time time NOT NULL,
  brnm varchar(50) NOT NULL,
  braddr varchar(50) NOT NULL,
  brtel varchar(20) NOT NULL,
  resevisit char(1) CHECK (resevisit in ('Y','N')),
  placenm varchar(20) NOT NULL,
  kind varchar(10), 
  programnm varchar(20),
  cost int(10),
  url varchar(20)
);

CREATE TABLE translang ( 
id int (11) NOT NULL auto_increment PRIMARY KEY, 
langcode char(20), 
langnm varchar(20))

https://velog.io/@hyeri_hello/%EB%A6%AC%EB%88%85%EC%8A%A4-MySQL-%EC%84%A4%EC%B9%98

이전에 생성한 MySql을 관리/사용하기 위해 관리도구에 연결하는 방법을 설명한다. 나는 DBeaver 를 사용 했으나, 다른 툴도 동일하게 적용 가능하다.

2. 연결

DBeaver 설치 방법은 생략 한다.

1) Connection

목록에서 오른쪽 마우스 클릭 후 Connection 선택 → 관련 DB선택 → 아래 화면과 같이 setting 후 일단 완료

오른쪽 마우스 클릭 후 Edit Connection 선택 → SSH 선택 → 아래 화면과 같이 setting → Test Connection

• Host/IP : 외부 IP (이전 클라우드 셋팅 참고)
• User Name : 클라우드 사용자 이름
• Public Key : 클라우드 연결시 사용 했던 키
• Passphrase : 클라우드 계정 비밀번호

3. Error

Access denied for user 'root@'@'localhost' 해결방법

초기 설정되어있는 mysql root 계정의 pw 타입이 문제가 될 수 있는데

select user, host, plugin from mysql.user;

1. auth_socket을 mysql_native_password로 변경해주면 가능하다. update user set plugin='mysql_native_password' where user='root';

2. 현재 사용중인 MySQL의 캐시를 지우고 새로운 설정을 적용 flush privaileges;

3. 정보 재확인 (변경 확인) select user, host, plugin from user;

리눅스 환경에서 apt 명령어로 mysql 설치하는 방법

2. 설치

1) apt 업데이트

sudo apt-get update

2) mysql 설치

sudo apt-get install mysql-server

3) mysql 버전 확인

mysql --version

# 결과 (버전 확인 되면 설치 성공)
mysql  Ver 8.0.31-0ubuntu0.20.04.1 for Linux on x86_64 ((Ubuntu))

3. 접속

1) root 유저로 접속

mysql.server start

sudo mysql -u root -p

[Enter password : 가 나오면 password 입력하면 된다. (생략도 가능, 생략 원할 시 Enter 입력)

2) 계정 확인 (User 목록 확인)

1. User 목록 확인 SELECT user, host, plugin FROM user;

2. 계정 추가 (% : 외부 접근 허용) CREATE USER '[계정명]'@'%' IDENTIFIED BY '[password]';

3. 권한 부여 GRANT ALL PRIVILEGES ON *.* TO 'ila'@'%' WITH GRANT OPTION;

3) databases 추가

1. 데이터베이스 생성 CREATE DATABASE [데이터베이스 이름]

2. 데이터베이스 보기 SHOW DATABASES;

3. 데이터베이스 사용 USE [데이터베이스 이름];

4. 클라우드 이용 (GCP) - 외부 ip 사용 시

1) Port 할당

https://velog.io/@hyeri_hello/Spring-%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8-GCP-Google-Cloud-Platform-%EC%84%9C%EB%B2%84-%EB%B0%B0%ED%8F%AC

위 url 내의 4번 목록 참고해서 3306 port 를 열어줘야 한다.

2) bind-address 변경

port open 후 주소 변경을 해줘야 한다.

1. 디렉토리 변경 cd /etc/mysql/mysql.conf.d

2. root 계정으로 mysqld.cnf 파일 열기 sudo vi mysqld.cnf

   
   

• i 를 누르면 insert 환경으로 바뀌고 ip 127.0.0.1 을 0.0.0.0 로 변경 후 esc 누르면 저장 전 readonly로 변경된다. 이후 :wq 저장 후 빠져나온다.

• 변경된 내용 재확인 하려면 cat mysqld.cnf로 열어서 확인한다.

• 이후 리스타트

sudo /etc/init.d/mysql restart

5. 관리도구 연결 (DBeaver)

https://velog.io/@hyeri_hello/DB-%EB%8D%B0%EC%9D%B4%ED%84%B0%EB%B2%A0%EC%9D%B4%EC%8A%A4-%EA%B4%80%EB%A6%AC%EB%8F%84%EA%B5%AC-DBeaver-%EC%97%B0%EA%B2%B0

Cloud Virtual Machine 을 사용하게 되면 기본적으로 쉘 접속은 클라우드에 로그인 한 후 브라우저에 연결된 쉘로 접속하게 된다. (AWS, GCP) 따라서 클라우드 로그인 없이 로컬 PC의 터미널을 활용해 접속하는 방법 정리했다.

ex) Google Cloud Platform 활용

1. SSH Key 생성

SSH 란 Secure Shell, 원격지 호스트 컴퓨터에 접속하기 위해 사용되는 보안 쉘 이다.

로컬 PC에서는 ssh-keygen 을 사용해서 키 를 생성 할 수 있다. ip_rsa.pub 디폴트 키로 적용해도 되나 나는 VM용으로 따로 만들었다. (계속 오류가 났음..🥲)

# 키 생성 명령어 

ssh-keygen -t rsa -f ~/.ssh/[키 파일 이름] -C [username = GCP계정]

1. ssh-keygen -t rsa -f ~/.ssh/gcp_key -C hyerihello@gmail.com
   

# 생성된 키 열어서 확인 명령어 

cat ~/.ssh/[키 파일 이름]

2. cat ~/.ssh/gcp_key.pub

✅ ** 여기서 잠깐! **

.ssh 폴더를 열어서 확인 하면 이름이 비슷한 2개의 파일을 볼 수 있는데 gcp_key.pub = public key (공개키) gcp_key = private key (비밀키) 이다.

# 숨겨져 있는 폴더 보는 명령어

cd ~/.[폴더명]

cd ~/.ssh ls -al

원격 연결을 위해서는 public key가 필요하기 때문에 gcp_key.pub 를 사용한다!

2. GCP 원격 서버에 Public Key 등록

로컬 PC에서 생성했던 ~/.ssh/gcp_key.pub 내용을 복사 후 GCP 서버의 ~/.ssh/authorized_keys 에 추가해야 한다.

GCP shell 에서

1. vi ~/.ssh/authorized_keys i 를 입력하면 insert 모드로 수정이 가능하며, 로컬 에서 복사했던 gcp_key.pub 내용을 붙여넣고 esc 를 누르면 읽기 모드로 다시 변환 된다. :wq 를 누르면 수정사항이 저장되고 빠져나온다. (참고, 저장하지 않고 빠져나오려면 :q 사용)

잘 저장되었는지 확인한다.

2. cat ~/.ssh/authorized_keys

3. GCP 인스턴스 SSH key 등록

클라우드 브라우저로 돌아가서 Key를 추가로 등록해줘야한다. Compute Engine > 메타데이터 > SSH키 > 수정 또는 항목추가 > gcp_key.pub 입력 > 저장

참고, 나는 등록한 키가 두 개여서 아래와 같이 나오지만 한 개만 등록 할 시 하나만 나온다.

https://console.cloud.google.com/compute/metadata?project=solar-semiotics-366106&tab=sshkeys

4. 원격접속

VM인스턴스로 돌아가서 외부 IP 확인한다.

로컬 PC로 돌아와 shell 에 접속 명령어를 입력한다.

ssh -i {로컬pc의 키파일 경로} {VM의 user계정이름}@{VM의 외부 ip} ssh -i /Users/ila/.ssh/gcp_key hyerihello@34.64.***.***

연결 성공 ~! 수고하셨습니다 👍

Spring boot project 를 클라우드로 배포하는 과정을 정리함

2. VM 인스턴스 생성

1) google cloud 가입

아래의 클라우드 사이트 계정 가입 한다. 처음 가입 시 $300 크레딧 제공

https://cloud.google.com/

2) 프로젝트 만들기 (VM 인스턴스 생성)

GCP는 프로젝트 단위로 리소스/서비스를 관리 함 즉, 프로젝트 생성 후에 프로젝트 내에서 VM 인스턴스를 생성/사용하는 방식이다.

(1) 이름

원하는 인스턴스 이름 사용

(2) 리전

서버의 물리적 위치, 한국 서비스라면 서울로 선택 하면 된다.

(3) 시리즈

머신 구성 선택, 나는 E2, e2-micro 또는 e2-small 정도 사용한다. 가격과 성능에 따라 선택 하면 된다. (추후 업그레이드 가능)

(4) 부팅 디스크

원하는 운영체제 선택, 나는 Ubuntu , 20.4 버전 선택 했다.

(5) ID 및 API 액세스

액세스 범위 - 모든 Cloud API 대한 전체 액세스 허용 선택 방화벽 - "HTTP", "HTTPS" 트래픽 모두 선택

(4) 만들기

하단의 만들기 선택 후 1분 안쪽으로 기다리면 인스턴스가 생성된다.

외부 IP : 외부 브라우저 등을 통해 접근 가능한 주소 SSH : 버튼을 클릭하면 해당 인스턴스의 웹 콘솔로 접근 할 수 있다.

3. 배포 작업

Spring boot project가 있다는 가정 하에 시작한다.

1) root 계정 비번 설정 및 이동

sudo passwd sudo su

2) Java 설치

모든 기존 패키지가 최신 상태인지 확인 sudo apt update

사용가능한 목록 찾기 sudo apt-cache search openjdk

OpenJDK17 - JRE, JDK 설치

sudo apt-get install openjdk-17-jre sudo apt-get install openjdk-17-jdk

자바 버전이 확인 되면 설치가 완료 된 것! java --version

root@instance-1:/home/abcd# java --version
openjdk 17.0.4 2022-07-19
OpenJDK Runtime Environment (build 17.0.4+8-Ubuntu-120.04)
OpenJDK 64-Bit Server VM (build 17.0.4+8-Ubuntu-120.04, mixed mode, sharing

3) Spring project .jar 파일 만들기

• JAR(Java Archive) JAVA 어플리케이션 동작 할 수 있도록 한 자바 프로젝트 압축 파일

• STS4 , Gradle 로 jar 파일 만들기

우측 상단에 돋보기 모양을 클릭한 후 Gradle Tasks를 클릭하면 콘솔창에 Gradle Tasks창이 오픈된다.

아래의 bootJar를 클릭하면 빌드가 완료 된다.

빌드된 빌드파일은 해당 프로젝트 폴더 내의 build > libs 에 있다.

4) 로컬 pc에서 원격 VM 에 이동 (.jar 파일)

" ssh key 생성 및 자세한 연결 내용" 아래 참고

https://velog.io/@hyeri_hello/Mac-OS-SSH-%EC%A0%91%EC%86%8D-%EB%B0%A9%EB%B2%95-%EB%A1%9C%EC%BB%AC-%EC%9B%90%EA%B2%A9-GCP-%ED%99%9C%EC%9A%A9

• VS Code 활용 가장 쉽게 접하는 VS Code IDE를 이용해 이동 시킬 수 있다.

1. Extensions 에서 Remote - SSH 설치 하면 하단에 Remote Explore 가 보여진다.

2. Remote Explorer 에서 SSH Targets을 선택 후 Add New 클릭

3. ssh 계정이름@외부ip(연결할 ip) 입력 및 톱니바퀴모양 클릭 후 config 파일 수정 Host : 원하는 이름 HostName : VM 외부 IP User : VM User nm IdentifyFile : 키 파일 경로

4. 연결시도 후 연결 성공 ~!

5. .jar 파일 이동

EXPLORER 이동 후 상단 바의 File > OpenFolder 클릭하면 아래와 같이 경로를 설정할 수 있다. 경로 설정 후 원하는 폴더에 .jar 파일을 이동 시킨다.

6. console 창을 열고 실행 명령어를 입력하면 배포가 완료된다.

   # 백그라운드 .jar 파일 배포
   

nohup java -jar [jar파일명].jar

``` nohup java -jar ilaapi-0.0.1-SNAPSHOT.jar

nohup.out 을 클릭해서 보면 서버가 올라간 것을 알 수 있다~!

5) 브라우저 실행

http://34.64.***.***:9090/swagger-ui/index.html

설정해 둔 스웨거를 열면 성공~!

4. url 연결 오류시 참고 사항 (외부 접속 포트 설정)

나는 스프링부트 프로젝트 서버를 9090을 사용하고 있었는데 (기존 작업하던 포트가 80 이어서 계속 죽이기 귀찮았음)

클라우드 VM 사용할때 무조건 Port를 열어줘야 사용이 가능하다.

https://console.cloud.google.com/networking/firewalls/list?project=solar-semiotics-366106

VPC 네트워크 > 방화벽 > 방화벽 규칙만들기 아래와 같이 설정 후 저장을 누른다!

끝! 수고했습니다~! 👻

Reference https://happy-jjang-a.tistory.com/164

Swagger UI 실행

1. dependencis 추가

• 아래 url 참고

https://mvnrepository.com/artifact/org.springdoc/springdoc-openapi-ui/1.6.11

// https://mvnrepository.com/artifact/org.springdoc/springdoc-openapi-ui
    implementation group: 'org.springdoc', name: 'springdoc-openapi-ui', version: '1.6.11'

2. Url 실행

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

개발한 REST API를 편리하게 문서화 해주고 이를 통해서 관리 및 제 3의 사용자가 편리하게 API를 호출해보고 테스트 할 수 있는 프로젝트

Spring boot에서는 간단하게 springfox-boot-starter를 gradle dependencis에 추가함으로 사용할 수 있다.

Swagger Annotation

Swagger 실행

1. dependencis 추가

1) 아래의 url에서 원하는 버전을 선택해 의존성을 추가 할 수 있다

https://mvnrepository.com/search?q=springfox

2) 3.0.0 버전 선택 시 (SpringFox Swagger2 + SpringFox Swagger UI)

• 기존엔 "SpringFox Swagger2 + SpringFox Swagger UI" 두 가지를 추가해서 사용해야 했으나 3.0.0 버전부터는 아래의 SpringFox Boot Starter를 통해 통합해서 이용 할 수 있다.

• Gradle 사용 : 아래의 코드를 복사해서 의존성 추가한다.

  // https://mvnrepository.com/artifact/io.springfox/springfox-boot-starter
  implementation group: 'io.springfox', name: 'springfox-boot-starter', version: '3.0.0'

• build.gradle 추가

  plugins {
    id 'org.springframework.boot' version '2.7.4'
    id 'io.spring.dependency-management' version '1.0.14.RELEASE'
    id 'java'
  }
  

group = 'com.example.swaggerapi' version = '0.0.1-SNAPSHOT' sourceCompatibility = '17'

configurations { compileOnly { extendsFrom annotationProcessor } }

repositories { mavenCentral() }

dependencies { implementation 'org.springframework.boot:spring-boot-starter-web' compileOnly 'org.projectlombok:lombok' annotationProcessor 'org.projectlombok:lombok' testImplementation 'org.springframework.boot:spring-boot-starter-test' // https://mvnrepository.com/artifact/io.springfox/springfox-boot-starter implementation group: 'io.springfox', name: 'springfox-boot-starter', version: '3.0.0' }

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

### 2. Controller 
아래와 같이 TestController를 만든 후 SwaggerUi가 연결 되었는지 확인한다.

package com.example.swaggerapi.controller;

import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController;

import io.swagger.v3.oas.annotations.tags.Tag;

@RestController @RequestMapping("/api") public class ApiController {

@GetMapping("/hello")
public String hello() {
    return "hello ila world";
}

}

### 3. 버전 오류 해결

실행 후 아래와 같이 오류가 난다면 버전 오류 일 수 있다. 

**" Spring boot 2.6버전 이후에 spring.mvc.pathmatch.matching-strategy 값이 
ant_apth_matcher에서 path_pattern_parser로 변경되면서 몇몇 라이브러리(swagger포함)에 오류가 발생한다고 한다."
**
> 출처: https://skmouse.tistory.com/entry/SpringBoot-Swagger-에러-Failed-to-start-bean-documentationPluginsBootstrapper-nested-exception-is-javalangNullPointerException [SK_MOUSE 개발일기:티스토리]

![](https://velog.velcdn.com/images/hyeri_hello/post/c0bc7481-bf49-4f36-9b91-26f127c33033/image.png)

버전 해결을 위해 application.properties에 아래 문장을 추가한다. 

spring.mvc.pathmatch.matching-strategy=ANT_PATH_MATCHER

![](https://velog.velcdn.com/images/hyeri_hello/post/3b8a552d-81a6-4c8b-b3a3-5d9a556a734c/image.png)


### 4. Swagger UI 접속 

http://localhost:9090/swagger-ui/

위 경로로 접속하면 컨트롤러로 자동 연결 된 것을 확인 할 수 있다. 

![](https://velog.velcdn.com/images/hyeri_hello/post/49c296b9-f0d4-4035-b56c-d3ca4daaf0ba/image.png)

Execute 해보면 실행 된 것도 확인 할 수 있다.

![](https://velog.velcdn.com/images/hyeri_hello/post/9c6e23e4-85a3-47ac-8adb-3e1ee9683181/image.png)