[스프링] 2025-07-02

📁 file.upload-dir=uploads/ 의미

이 설정은 파일 업로드를 위한 저장 경로를 지정하는 사용자 정의 프로퍼티이다.

 

🛠️  사용 예시

📍 application.properties

file.upload-dir=uploads/

• file.upload-dir은 Spring Boot에서 직접 제공하는 공식 키는 아니고, 개발자가 커스텀해서 사용하는 키이다.
• uploads/는 프로젝트 루트 또는 지정된 경로 기준으로 파일을 저장할 디렉토리 경로이다. (상대 경로)

 

📍 Java 코드 (예: @Value 사용)

@Value("${file.upload-dir}")
private String uploadDir;

• Java 코드에서 @Value로 주입받아 파일 저장 경로로 사용한다.

 

📍 파일 저장 로직

Path filePath = Paths.get(uploadDir + filename);
Files.copy(file.getInputStream(), filePath, StandardCopyOption.REPLACE_EXISTING);

 

이렇게 하면 uploads/ 폴더 아래에 업로드된 파일이 저장된다.

 

⚠️ 주의사항

• uploads/ 디렉토리가 서버 실행 전에 존재하지 않으면 에러가 발생할 수 있으므로, 서버 실행 시 자동 생성하거나, 수동으로 만들어야 한다.

Files.createDirectories(Paths.get(uploadDir));

 

• 상대 경로(uploads/)는 현재 실행되는 위치 기준이다. 예를 들어, Spring Boot를 build/libs 아래 JAR로 실행하면 uploads/도 거기에 만들어진다.

---

✅ @Controller란?

Spring에서 Controller는 클라이언트의 요청을 받아 처리하고, 응답을 반환하는 핵심 컴포넌트이다. 쉽게 말해, 브라우저 앱에서 보낸 요청을 가장 먼저 받아서 처리하는 역할을 한다.

@Controller
public class MyController {
    @GetMapping("/hello")
    public String hello() {
        return "hello.html";
    }
}

• @Controller는 Spring MVC의 컨트롤러임을 선언하는 어노테이션이다.
• 주로 뷰(View)를 반환할 때 사용된다.(HTML, JSP 등)
• return 값은 템플릿 파일명 (예 : hello.html)

 

✅ @RestController란?

@RestController
public class ApiController {
    @GetMapping("/api/greet")
    public String greet() {
        return "Hello, API!";
    }
}

• @RestController는 @Controller + @ResponseBody의 조합이다.
• 즉, 뷰를 반환하는 게 아니라 JSON/XML 같은 데이터를 직접 반환한다.
• 백엔드 API 서버에서는 거의 대부분 @RestController를 사용한다.

 

🔁 요청 매핑 어노테이션

어노테이션	설명
@GetMapping	GET  요청 처리 (예 : 조회)
@PostMapping	POST 요청 처리 (예 : 등록)
@PutMapping	PUT 요청 처리 (예 : 수정)
@DeleteMapping	DELETE 요청 처리 (예 : 삭제)
@RequestMapping	위 모든 요청을 처리할 수 있는 일반형 (GET/POST 등 지정 가능)

 

📥 파라미터 처리

@GetMapping("/user")
public String getUser(@RequestParam String name) {
    return name + "님 안녕하세요!";
}

• @RequestParam : 쿼리 스트링(?name = 이름)
• @PathVariable : URL 경로의 일부 (/user/{id}
• @RequestBody : JSON 요청 본문 파싱 (주로 POST/PUT)

📤 응답 반환 방식

방식	설명
문자열 반환 (String)	뷰 이름 (템플릿 파일) 혹은 메시지
ResponseEntity<T>	HTTP 상태 코드와 함께 응답
@ResponseBody	JSON 형식으로 바로 반환

---

Controller - Service - Repository 구조

이 패턴은 Spring에서 가장 많이 사용되는 레이어드 아키텍처(Layered Architecture)이다. 이 구조는 관심사 분리(Separation of Concerns) 원칙을 잘 지키게 해줘서 유지보수가 쉬워진다.

 

이렇게 나누는 이유는?

• Controller : 웹 요청 처리에만 집중
• Service : 복잡한 비즈니스 로직 분리
• Repository : 데이터 처리에만 집중

➡ 이렇게 하면 테스트가 쉬워지고, 변경에 유연하며, 협업 시 역할이 명확해진다.

 

📌 전체 구조 그림

 

1️⃣ Controller

역할

• HTTP 요청을 받고, 응답을 반환한다.
• 클라이언트와 가장 가까운 계층이다.
• 요청 데이터를 파싱하고, 서비스에 전달한다.

※ 파싱 (Parsing : 구문분석) 은 하나의 프로그램을 런타임환경 (예를 들면, 브라우저 내 자바스크립트 엔진)이 실제로 행할 수 있는 내부 포맷으로 분석하고 변환하는 것을 의미한다.

 

예시

@RestController
@RequestMapping("/api/users")
public class UserController {

    private final UserService userService;
    
    public UserController(UserService userService) {
        this.userService = userService;
    }

    @PostMapping
    public ResponseEntity<User> create(@RequestBody UserDto dto) {
        return ResponseEntity.ok(userService.createUser(dto));
    }
}

 

2️⃣ Service

역할

• 핵심 비즈니스 로직을 처리한다.
• 트랜잭션 처리, 여러 엔티티 간의 연산 등을 담당한다.
• Controller와 Repository의 중간다리 역할.

예시

@Service
public class UserService {

    private final UserRepository userRepository;

    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    public User createUser(UserDto dto) {
        User user = new User(dto.getName(), dto.getEmail());
        return userRepository.save(user);
    }
}

 

3️⃣ Repository

역할

• DB에 실제로 접근한다. (Insert, Select, Update, Delete)
• Spring Data JPA를 사용하는 경우 JpaRepository를 상속받아 사용한다.

예시

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    Optional<User> findByEmail(String email);
}