지식 줍줍 🐿️

REST & API

• REST : HTTP URL 로 서버의 자원(resource)을 명시하고, HTTP 메서드로 해당 자원에 대해 CRUD하는것
• API : 클라이언트가 서버의 자원을 요청할 수 있도록 서버에 제공하는 인터페이스 

PUT / PATCH 차이

• PUT: 기존 데이터를 전부 새 내용으로 변경. 만약 기존 데이터가 없다면 새로 생성! (requestBody 에 전체 요청값을!)
• PATCH: 기존 데이터 중 일부만 새 내용으로 변경 (requestBody 에 일부 요청값을!)

HTTP 상태

• 1XX : 요청이 수신돼 처리 중
• 2XX : 성공 (정상)
• 3XX : 요청이 완료되려면 추가 행동이 필요함 (리다이렉트..)
• 4XX : 클라이언트 요청이 잘못되 수행할 수 없음
• 5XX : 서버 내부에 에러가 발생!

RequestBody (요청 메세지)

• 요청라인: method type: POST, PATCH.., url..
• 헤더: content-type..host..
• 본문: json 

ResponseBody (응답 메세지)

• 상태라인: 200..201..
• 헤더: content-type...
• 본문: json

로깅 (logging)

시스템이 작동할 때 당시의 상태와 작동 정보를 기록 

로깅단계

JPA 및 로깅 관련 properties 설정 

-- 프로젝트 내 resources > application.properties (or yaml)

server.servlet.encoding.force = true
spring.h2.console.enable=true
spring.jpa.defer-datasource-initialization=true

# JPA 로깅 설정
logging.level.hibernate.SQL=DEBUG

# 쿼리 줄바꿈
spring.jpa.properties.hibernate.format_sql=true

# 매개변수 값 보여주기
logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE

# 유니크 URL 생성하지 않기
spring.datasource.generate-unique-name=false

# 고정 URL 설정
spring.datasource.url=jdbc:h2:mem:testdb

링크 (Link)

• 미리 정해 놓은 요청을 간편히 전송하는 기능 (페이지이동!)
• 클라이언트가 링크를 통해 어느 페이지로 이동하겠다고 요청하면, 서버는 결과 페이지를 응답!

리다이렉트 (Redirect)

• 클라이언트가 링크를 통해 어느 페이지로 이동하겠다고 요청하면,
서버는 결과 페이지를 응답 하지 않고 재요청하라는 회신을 보냄 (재요청)
리다이렉트(재요청)을 지시받은 클라이언트는 서버가 보내준 주소로 다시 요청을 보내고 서버는 이에대한 결과를 응답

클라이언트 링크 이동 요청 → 서버에서는 클라이언트에게 리다이렉트로 응답 → 클라이언트는 재요청 주소로 다시 요청  → 서버응답

롬복 (Lombok)

• 코드를 간소화해 주는 라이브러리 (@Data)
    → https://projectlombok.org/features/Data 

    → 꼭 필요한 어노테이션만 사용하는것이 좋다. (@Data 지양 구글 검색)

• 로딩 기능 지원 (@Slf4j)

리팩터링

• 코드의 기능에는 변함없이 구조 및 성능을 개선하는 작업

폼데이터 (form data)

• <form> 태그에 실려 전송되는 데이터. 전송된 데이터는 컨트롤러가 객체에 담아 받음(=DTO)
• DTO(Data Transfer Object) 을 지지고 볶아 DB 에 저장

Database & JPA

• 데이터베이스는 데이터를 관리하는 창고 (DB)
• DB는 자바언어를 모름! DB는 SQL(Structured Query Languate) 만 알고있음.
• 자바에서 DB에 데이터 기록을 하기위한 수단중에 하나로 JPA가 있음 
    → JPA(Java Persistence API) 을 통해 자바언어로 DB에 명령을 내림!
    → 객체지향적으로 관리를 할 수 있음
    → JPA 는 entity, repository 가 있음

실습관련

1. H2 DB에 웹 콘솔로 접근 허용하도록 함 (application.yaml)

spring.h2.console.enabled=true

2. h2 db 접속 관련
→ 인텔리제이 > debug 콘솔 > jdbc: 검색 후, jdbc url 정보 찾아 localhost:8080/h2-console 내의 JDBC URL 에 기입

뷰템플릿 (View Template)

• 화면을 담당하는 기술
• 웹페이지(View) 을 하나의 틀(Template) 으로 만들고 여기에 변수를 삽입해 서로 다른 페이지로 보여줌 ❓
    → 정보성의 데이터(변경 가능한 정보) 들을 유동적으로 변경하여 보여준다는 내용
• mustache
    → 뷰템플릿 만드는 도구 (템플릿 엔진)
    → src > main > resources > templates 에 위치
    → 컨트롤러 메소드 내에서 에서 mustache 파일명을 return 하면 서버에서는 알아서 mustache 파일을 찾아 웹브라우저로 전송함!

    → 플러그인 추가 필요 
• 그외에도 Thymeleaf..JSP 등이 있다.ㅎㅎㅎ

MVC 패턴 

• Model : 데이터를 관리!

• View : 화면에 보여줌!

• Controller : 요청과 응답을 받음!

실습관련

1. html 파일 내에서 한글이 깨지는 경우, application.properties 파일 내에 아래의 내용 추가 필요 

server.servlet.encoding.force=true

객체지향이 나오게 된 배경

• 1970년대 이전에는 설계없이 필요할때마다 개발하는 방식으로 진행
    → 시간이 지나면서 중복코드 증가, 유지보수의 어려움 발생으로 신뢰도 바닥 및 성능 저하 등의 이슈가 발생하게됨

• 1970년대 이후, 프로그램을 쪼개어 개발하는 구조적 개발 방법이 많이 사용 (분석 - 설계 - 개발 - 테스트)
    → 사용자 요구사항이 명확하고 변화가 많이 않은 환경에서는 효율적이나, 생명주기 각 단계별(ex. 물품구매..물품조회..물품삭제..)로 자연스럽게 서로 연결되지 않고, 프로그램 내부 기능들은 데이터와 복잡하여 얽혀있어 소프트웨어를 변경하는게 쉽지 않음
    → 유지보수 비용 증가
    → 객체지향이 나오게됨

• 객체지향은 현실세계에 존재하는 실체 및 개념들을 객체라는 독립된 단위로 구성 & 메세지로 상호작용 & 객체지향 시스템을 가시화하고 명세화하고 문서화한것이 UML

객체지향 요소

• 객체(Object) : 속성과 행동을 가지고 있는것
    → (자료(=속성(변수) + 값(변수값)=클래스에서 정의) 및 오퍼레이션(=클래스에 포함되어있는 메소드))

• 클래스(Class) : 객체를 생성할 수 있는 구조와 정보를 가지고 있는 틀 

• 메세지(Message) : 어떤 한 객체가 다른 객체에게 특정 작업을 요청하는 신호
    → 수신객체 이름 + 수행할 오퍼레이션 이름 + 전달되는 매개변수 

객체지향 특성

• 캡슐화(Encapsulation) : 해당 기능의 동작에 대한 흐름을 자세하게 알필요 없이, 외부에서 원하는 기능들을 수행하도록 지시하는것. 
    → 외부에서 객체 내 직접 접근 X
    → 외부에서 접근할 수 있는 오퍼레이션을 통해 관련 데이터에 접근 (이로써 단순하고 명확하게 표현가능)
    → 정보은닉이 가능 

• 상속(Inheritance) : 프로그램을 확장 가능하도록 해주는 수단
    → 재사용 및 확장성 
    → 일반화(Generalization) : 하위클래스의 공통적 특성을 추상화하여 상위 클래스로 정의하는것 (하위 -> 상위)
    → 특수화(Specialization) : 상위 클래스의 속성을 상속받아 하위 클래스에 실체화 (상위 -> 하위)

• 추상화(Abstraction) : 특정측면을 강조하여 나타낸것. 실세계상황을 간결하고 명확하게 모델링하여 이것을 프로그램으로 구현(=실체화)

• 다형성(Polymorphism) : 여러클래스에 같은 메소드명을 사용하나, 동작이 다른 케이스 (오버라이딩)

>>> 캡슐화와 추상화를 헤깔리면 안될듯!
캡슐화는 결과의 행동만 바라보는것이면(호출하는자의 입장에선 내부사정은 알필요 없다!), 추상화는 구체화를 하기 위한 수단의 시작으로 봐야할듯

스프링부트?

스프링 부트는 자바 웹개발을 빨리 하기위해 만들어진 도구 입니다. (프레임워크)

스프링과 스프링부트의 차이

1. 개발 환경설정 간소화 
    ‣ 스프링은 외부 라이브러리 직접 연동해야하나, 스프링부트는 미리 설정된 스타터 프로젝트로 외부 라이브러리 최적화해 사용자가 직접 연동 X

2. 웹서버 내장
    ‣ 스프링 부트는 톰캣이 내장되어 있음, 스프링은 톰캣이 내장되어 있지 않음

웹 서비스 동작 원리

1. 클라이언트
    ‣ 서비스를 사용하는 프로그램 or 컴퓨터

2. 서버
    ‣ 서비스를 제공하는 프로그램 or 컴퓨터

✓ 클라이언트 ←→ 서버 사이에는 요청(request) 와 응답(response) 가 존재한다.
    ‣ 전제조건은 서버가 실행중! 이여야 함 

localhost 와 스프링에서의 호출!

    ‣ 127.0.0.1 을 고유 지칭한것 (내 컴퓨터의 주소)
    ‣ 클라이언트가 localhost:8080/hello.html 을 호출 한다면 스프링부트가 응답으로 hello.html  을 보여줌
    ‣ hello.html은 서버에서 요청한 파일! (src > main > resources > static 을 기본적으로 찾음)

실습관련

1. JVM 설치 디렉터리로 이동

cd Library/Java/JavaVirtualMachines

2. JDK 삭제 명령

sudo rm -rf 설치된 JDK 버전

3. 인텔리제이 영어 메뉴 권장
    ‣ 인텔리제이 상단 메뉴바에서 Intellij IDEA > 설정 > 플러그인 > 설치탭 > Korean Language Pack 체크 해제 

4. 자바 버전 오류
    ‣ springboot3.x 부터는 JDK17 이상만 지원함! 만약 오류 발생시 build.gradle 설정 확인! (sourceCompatibility = '17') 
    ‣ 그래도 안되면 인텔리제이 java 설정 확인! (File → Settings 메뉴)

AOP 가 적용된 클래스에서(=포인트컷의 영향을 받은 클래스) 프록시가 적용안되는 상황이 있었음!

SampleService 클래스의 sample() 메소드 내에 sampleRecall1(), sampleRecall2() 는 모두 AOP 의 영향을 받을거라 생각했는데, 그렇지가 않았음!
이유는, AOP가 프록시 기반이였기 때문이였음!

프록시 개념을 사용하는 경우, 프록시 클래스(SampleServiceV2ProcxyImpl)가 핵심기능 클래스(SampleServiceV2)를 주입받아 프록시 클래스의 메소드(SampleServiceV2ProcxyImpl 의 sample())를 호출한 후, 핵심기능 클래스의 메소드(SampleServiceV2 의 sample())를 호출하게 됨  
= 핵심기능 클래스의 메소드(SampleServiceV2 의 sample()) 실행시점 기준으로 프록시(SampleServiceV2ProcxyImpl 의 sample())를 적용할수있다는걸 알수있음

따라서 핵심기능 클래스의 메소드(SampleServiceV2 sample()) 내의 다른 메소드들(SampleServiceV2 의 sampleRecall1(), sampleRecall2())은 프록시의 영향을 받지 않게 됨!

설명

서버에서 클라이언트로 데이터를 수신하는 방법 (단방향 통신)
WebSocket 의 경우, 서버 <-> 클라이언트 간 양방향 통신을 하지만, SSE 의 경우 단방향 통신을 함!
따라서 간단한 알림 전송 기능 개발등에 적합한 기술

구현 예제 

// server-side

// case1) SseEmitter 이용
// https://tecoble.techcourse.co.kr/post/2022-10-11-server-sent-events/ 참고 


// case2) WebFlux 이용 
// ...
@GetMapping(value = "/sse", produces = MediaType.TEXT_EVENT_STREAM_VALUE)
public Flux<String> sse() {
    return Flux.just("Server time: " + LocalDateTime.now())
            .doFinally(signalType -> {
                if (signalType == SignalType.CANCEL || signalType == SignalType.ON_COMPLETE) {
                    log.info("Closing SSE connection");
                }
            });

    ..
}

<!-- client-side --> 
<!-- server-side 의 case2) 방식 대응 --> 

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <title>SSE TEST</title>
</head>
<body>
<h1>SSE TEST</h1>
<div id="sse-data"></div>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script>

  const eventSource = new EventSource("{server-side주소}/sse");
  eventSource.onmessage = event => {
     $("#sse-data").append(event.data); // 이부분을 토스트 팝업 형태로 표현하면 됨!
  };

  eventSource.onerror = error => {
    console.error("SSE error:", error);
    eventSource.close();
  };
</script>
</body>
</html>