💫 Spring

✔️ Actuator

✅ 엑츄에이터란?
운영 환경에서 발생할 수 있는 장애에 대비해 스프링 부트가 제공하는 프로덕션 준비 기능들이다. 현재 애플리케이션이 살아있는지, 로그 정보가 정상 설정 되었는지, 커넥션 풀이 얼마나 사용되고 있는지 등을 확인할 수 있게 도와준다. 더 나아가 마이크로미어, 프로메테우스, 그라파나 같은 최근 유행 모니터링 시스템과 쉬운 연동을 제공한다.

✅ 준비
엑츄에이터를 사용하기 위해서는 build.gradle에 아래 라이브러리를 추가해야한다.

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

혹은 spring initializr에서 생성할 때 actuator를 추가해 준다.

✅ 확인

http://localhost:8080/actuator

엑츄에이터가 제대로 동작하는지 확인하기 위해서는 Main 클래스를 실행한뒤 http://localhost:8080/actuator 로 접속하여 확인할 수 있다.

✅ 액츄에이터의 기능들을 웹에 노출

• 엑츄에이터를 처음 확인해 보면 기능이 몇 개밖에 보이지 않는다. 다양한 기능들을 웹 환경에 노출하기 위해서는 application.yml 파일에 다음과 같이 추가해줘야 한다. (application.properties 파일을 application.yml로 바꾸고 그에 맞는 문법으로 작성해 주면 된다.)

management:  
	endpoints:    
    	web:      
        	exposure:        
            	include: "*"

• 특정 엔드포인트를 활성화 하려면 management.endpoint.{엔드포인트명}.enabled=true 를 적용하면 된다.
  (endpoints가 아닌 endpoint 임을 주의)

참고자료 : [Spring] 스프링부트 엑츄에이터(Actuator)란?

---

✔️ MVC

✅ MVC란?
MVC는 Model-View-Controller의 약어로, 애플리케이션을 세 부분으로 나누어 역할을 분리하는 디자인 패턴이다.

패턴	역할
Model	비즈니스 로직과 데이터, 애플리케이션의 상태를 자바 객체로 표현하고 조작하는 기능을 담당한다.
View	HTML, CSS, JavaScript 등을 사용해 사용자가 볼 수 있는 화면을 구성하며, Thymeleaf와 같은 템플릿 엔진을 통해 동적 화면을 생성한다.
Controllerㅤ	사용자의 요청을 받아 Model과 상호작용하고, 처리 결과를 View에 전달하는 중간 역할을 합니다.

---

✔️ Thymeleaf

✅ Thymeleaf 란
타임리프(Thymeleaf)는 Java 웹 애플리케이션 개발에 사용되는 서버사이드 템플릿 엔진입니다. HTML, XML, JavaScript, CSS 등 다양한 형식의 파일을 동적으로 처리하여 뷰를 생성하는 데 사용됩니다. 특히, 서버에서 데이터를 받아와 HTML에 동적으로 데이터를 주입하여 웹 페이지를 구성하는 데 유용합니다.

---

✅ service
비즈니스 로직을 담당한다. 컨트롤러에서 분리되어 재사용 및 유지보수에 용이하다.
복잡한 연산, 조건 분기, 외부 api 호출 등의 로직을 service 에 작성하면, 컨트롤러는 요청-응답처리에만 집중할 수 있어 코드가 더 깔끔하고 명확해진다.

ℹ️ 정리하면 Service 계층은 다음과 같은 역할을 합니다:

• 핵심 비즈니스 로직을 담당
• 컨트롤러와의 책임 분리
• 재사용성과 테스트 용이성 확보

✅ controller
사용자의 요청을 받아 필요한 데이터를 처리하고, 결과를 뷰에 전달하는 역할을 한다. 즉, 사용자 입력을 해석하고 적절한 서비스 로직을 호출하며, 그 결과를 Thymeleaf 뷰에 넘겨주는 중간 다리 역할을 수행한다.

ℹ️ 컨트롤러는 다음과 같은 책임을 가진다:

• HTTP 요청 수신 및 처리
• 입력값 검증 및 매핑
• 서비스 계층 호출
• 계산 결과 또는 에러 메시지를 모델에 담아 뷰에 전달

✅ Thymeleaf
사용자의 입력값을 폼을 통해 서버로 전송하고, 결과 또는 에러 메시지를 동적으로 화면에 출력한다. th:action을 통해 서버 경로를 지정하고, th:text, th:if 등을 사용해 조건부 렌더링을 구현한다.

---

✔️ 계산기 프로그램

✅ 파일구조

📦src
 ┣ 📂main
 ┃ ┣ 📂java
 ┃ ┃ ┗ 📂com
 ┃ ┃ ┃ ┗ 📂j797
 ┃ ┃ ┃ ┃ ┗ 💫calculator
 ┃ ┃ ┃ ┃ ┃ ┣ ✅controller
 ┃ ┃ ┃ ┃ ┃ ┃ ┗ 📜CalculatorController.java
 ┃ ┃ ┃ ┃ ┃ ┣ ✅service
 ┃ ┃ ┃ ┃ ┃ ┃ ┗ 📜CalculatorService.java
 ┃ ┃ ┃ ┃ ┃ ┗ 📜CalculatorApplication.java
 ┃ ┗ 📂resources
 ┃ ┃ ┣ 📂static
 ┃ ┃ ┣ 📂templates
 ┃ ┃ ┃ ┗ ✅calculator.html
 ┃ ┃ ┗ 📜application.properties
 ┗ 📂test
 ┃ ┗ 📂java
 ┃ ┃ ┗ 📂com
 ┃ ┃ ┃ ┗ 📂j797
 ┃ ┃ ┃ ┃ ┗ 📂calculator
 ┃ ┃ ┃ ┃ ┃ ┗ 📜CalculatorApplicationTests.java

✅ service
계산기 앱과 같은 구조에서는 연산 로직을 컨트롤러가 아닌 Service에 위임함으로써, 테스트 코드 작성이 쉬워지고 로직 변경 시 영향 범위를 줄일 수 있다.

• CalculatorService 클래스에 calculate 메소드를 구현한다. 이 메소드는 두 개의 double 값을 받아 사칙연산을 수행하고, 연산자가 유효하지 않거나 0으로 나누는 경우에는 IllegalArgumentException 예외를 발생시킨다.

@Service
public class CalculatorService {
    public double calculate(double num1, double num2, String operation) {
        switch (operation) {
            case "add":
                return num1 + num2;
            case "subtract":
                return num1 - num2;
            case "multiply":
                return num1 * num2;
            case "divide":
                if (num2 == 0) {
                    throw new IllegalArgumentException("0으로 나눌 수 없습니다.");
                } else {
                    return num1 / num2;
                }
            default:
                throw new IllegalArgumentException("허용되지 않은 연산자입니다." + operation);
        }
    }
}

✅ controller
사용자가 입력한 숫자와 연산자는 @RequestParam을 통해 컨트롤러로 전달되며, 컨트롤러는 이를 기반으로 CalculatorService의 calculate 메서드를 호출한다. 결과값이나 예외 메시지는 Model 객체에 담아 템플릿에 전달하여 사용자에게 피드백을 제공한다.

• @PostMapping("/calculate") 메서드는 사용자로부터 입력받은 숫자와 연산자 값을 @RequestParam으로 받아 CalculatorService의 calculate 메서드를 호출한다. 결과값은 Model 객체에 넘겨 뷰로 전달된다.

@Controller
public class CalculatorController{
    private final CalculatorService calculatorService;

    <@Autowired
    public CalculatorController(CalculatorService calculatorService) {
        this.calculatorService = calculatorService;
    }

    @GetMapping("/")
    public String showCalculator() {
        return "calculator"; // 타임리프 html 반환
    }

    @PostMapping("/calculate")
    public String calculate(
        @RequestParam("num1") double num1,
        @RequestParam("num2") double num2,
        @RequestParam("operation") String operation,
        Model model
    ) {
        try {
            double result = calculatorService.calculate(num1, num2, operation);
            System.out.println("clicked!" + result);
            model.addAttribute("result", result);
        } catch(IllegalArgumentException e) {
            model.addAttribute("errorMessage", e.getMessage());
        }
        return "calculator";
    }
}

✅ Thymeleaf

계산기 앱의 뷰는 Thymeleaf 템플릿으로 구성되며, 사용자의 입력값을 폼을 통해 서버로 전송하고, 결과 또는 에러 메시지를 동적으로 화면에 출력한다. th:action을 통해 서버 경로를 지정하고, th:text, th:if 등을 사용해 조건부 렌더링을 구현한다.

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
  <meta charset="UTF-8">
  <title>Simple Calculator</title>
</head>
<body>
<h1>Simple Calculator</h1>
<form th:action="@{/calculate}" method="post">
  <!--id는 label과 매칭, name은 controller/@RequestParam과 매칭-->
  <label for="num1">Number 1:</label>
  <input type="number" step="any" name="num1" id="num1" required />

  <label for="num2">Number 2:</label>
  <input type="number" step="any" name="num2" id="num2" required />

  <label for="operation">Operation:</label>
  <select name="operation" id="operation">
    <!--value를 반환-->
    <option value="add">Add (+)</option>
    <option value="subtract">Subtract (-)</option>
    <option value="multiply">Multiply (×)</option>
    <option value="divide">Divide (÷)</option>
  </select>

  <button type="submit">Calculate</button>
</form>

<!--Model에 값이 있으면 꺼내온다-->
<div th:if="${errorMessage}" class="error">
  <p th:text="${errorMessage}"></p>
</div>

<div th:if="${result}" class="result">
  <h2>Result: <span th:text="${result}"></span></h2>
</div>
</body>
</html>

전체코드