package com.minstudio.demo.controller;

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

@RestController  // 이 클래스가 API 요청을 처리하는 컨트롤러임을 선언
public class HelloController {

    // 브라우저가 GET /api/hello 주소로 요청할 때 실행되는 메서드
    @GetMapping("/api/hello")
    public String sayHello() {
        return "안녕하세요! 스프링 부트로 만든 첫 API입니다.";
    }
}

package com.minstudio.demo.controller;

import org.springframework.web.bind.annotation.*;

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

    // URL 예시: GET /api/users/123
    @GetMapping("/{id}")
    public String getUserById(@PathVariable("id") Long userId) {
        return "조회된 회원 아이디: " + userId;
    }

    // URL 예시: GET /api/users/search?keyword=스프링
    @GetMapping("/search")
    public String searchUsers(@RequestParam("keyword") String keyword) {
        return "검색된 키워드: " + keyword;
    }
}

// 1. 데이터를 받을 DTO 클래스 작성
package com.minstudio.demo.dto;

public class UserCreateDto {
    private String name;
    private int age;

    // Getter와 Setter (스프링이 JSON을 파싱할 때 필요합니다)
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    
    public int getAge() { return age; }
    public void setAge(int age) { this.age = age; }
}

// 2. 컨트롤러에서 처리
package com.minstudio.demo.controller;

import org.springframework.web.bind.annotation.*;
import com.minstudio.demo.dto.UserCreateDto;

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

    // POST /api/users
    @PostMapping
    public String createUser(@RequestBody UserCreateDto dto) {
        return "가입 완료! 이름: " + dto.getName() + ", 나이: " + dto.getAge();
    }
}

// 1. Entity: DB의 'member' 테이블과 매핑됨
package com.minstudio.demo.entity;

import jakarta.persistence.*;

@Entity
public class Member {
    
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;  // 기본키 (PK)
    
    @Column(nullable = false)
    private String name;

    // 생성자, Getter, Setter 생략 (실무에선 주로 Lombok @Getter 사용)
}

// 2. Repository: JpaRepository 상속만으로 CRUD 쿼리 자동 생성
package com.minstudio.demo.repository;

import org.springframework.data.jpa.repository.JpaRepository;
import com.minstudio.demo.entity.Member;

public interface MemberRepository extends JpaRepository {
    // 이제 findAll(), save(), findById() 등을 사용할 수 있습니다!
}

package com.minstudio.demo.service;

import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import lombok.RequiredArgsConstructor;

@Service // 스프링 빈으로 등록
@RequiredArgsConstructor // final 필드의 생성자를 자동으로 만들어 의존성 주입(DI) 완성
public class MemberService {

    // MemberRepository가 자동으로 주입됨
    private final MemberRepository memberRepository;

    @Transactional
    public Long createMember(String name) {
        // 비즈니스 로직: 이름 중복 검사 등...
        
        Member member = new Member();
        member.setName(name);
        
        Member savedMember = memberRepository.save(member);
        return savedMember.getId();
    }
}

package com.minstudio.demo.controller;

import org.springframework.web.bind.annotation.*;
import lombok.RequiredArgsConstructor;

@RestController
@RequestMapping("/api/members")
@RequiredArgsConstructor
public class MemberController {

    private final MemberService memberService;

    // Create
    @PostMapping
    public Long createMember(@RequestBody MemberCreateDto dto) {
        return memberService.createMember(dto.getName());
    }

    // Read
    @GetMapping("/{id}")
    public MemberResponseDto getMember(@PathVariable("id") Long id) {
        return memberService.findById(id); // Member 엔티티를 DTO로 변환하여 반환
    }

    // Update
    @PutMapping("/{id}")
    public void updateMember(@PathVariable("id") Long id, @RequestBody MemberUpdateDto dto) {
        memberService.updateMember(id, dto.getName());
    }

    // Delete
    @DeleteMapping("/{id}")
    public void deleteMember(@PathVariable("id") Long id) {
        memberService.deleteMember(id);
    }
}

package com.minstudio.demo.exception;

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

@RestControllerAdvice
public class GlobalExceptionHandler {

    // 아이디를 찾을 수 없는 등의 기본 예외 처리
    @ExceptionHandler(IllegalArgumentException.class)
    public ResponseEntity handleIllegalArgument(IllegalArgumentException ex) {
        ErrorResponse response = new ErrorResponse("400", ex.getMessage());
        return ResponseEntity.badRequest().body(response);
    }
}

// DTO에 어노테이션 추가
public class SignupRequestDto {
    @NotBlank(message = "이름은 필수 입력 값입니다.")
    private String name;

    @Email(message = "이메일 형식이 올바르지 않습니다.")
    private String email;
}

// Controller에서 @Valid 적용
@PostMapping("/signup")
public String signup(@Valid @RequestBody SignupRequestDto dto) {
    // 유효성 검사가 통과한 데이터만 이곳에 도달합니다!
    return "가입 성공: " + dto.getName();
}

// 1. 회원은 여러 게시글을 쓴다 (1:N)
@Entity
public class Member {
    @Id @GeneratedValue
    private Long id;

    // 주인이 아니므로 mappedBy = "member" (Post 클래스의 member 변수명)
    // 회원을 조회할 때 게시글 목록을 읽기만 할 수 있습니다.
    @OneToMany(mappedBy = "member") 
    private List posts = new ArrayList<>();
}

// 2. 게시글은 특정 회원에게 속한다 (N:1)
@Entity
public class Post {
    @Id @GeneratedValue
    private Long id;

    // 데이터베이스 테이블에 실제 FK(member_id)가 생성됨. 주인이 됨!
    // 게시글을 저장할 때 member_id 외래 키도 함께 업데이트 됩니다.
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "member_id")
    private Member member;
}

@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        http
            .csrf(csrf -> csrf.disable()) // REST API에서는 CSRF 비활성화
            .sessionManagement(session -> session.sessionCreationPolicy(SessionCreationPolicy.STATELESS)) // JWT 사용 시 세션 끔
            .authorizeHttpRequests(auth -> auth
                .requestMatchers("/api/public/**", "/login", "/signup").permitAll() // 누구나 접근 가능
                .anyRequest().authenticated() // 그 외 API는 토큰(인증) 필수
            );
            
        return http.build();
    }
}

@PostMapping("/upload")
public String uploadFile(@RequestParam("file") MultipartFile file) throws IOException {
    if (file.isEmpty()) {
        return "빈 파일입니다.";
    }
    // 파일을 저장할 디렉토리 경로
    String fullPath = "/Users/workspace/upload/" + file.getOriginalFilename();
    
    // 로컬 하드디스크에 파일 저장
    file.transferTo(new File(fullPath));
    return "업로드 성공: " + fullPath;
}

@RestController
@Tag(name = "회원 관리 API", description = "회원 가입, 조회, 탈퇴 기능을 제공합니다.")
public class UserController {

    @Operation(summary = "회원 단건 조회", description = "ID를 통해 특정 회원의 상세 정보를 조회합니다.")
    @GetMapping("/users/{id}")
    public UserDto getUser(
            @Parameter(description = "조회할 회원의 고유 ID", example = "1") 
            @PathVariable Long id) {
        return userService.findById(id);
    }
}

import org.junit.jupiter.api.Test;
import static org.assertj.core.api.Assertions.*;

@SpringBootTest
class MemberServiceTest {

    @Autowired MemberService memberService;
    @Autowired MemberRepository memberRepository;

    @Test
    @DisplayName("회원가입이 정상적으로 이루어져야 한다")
    void 회원가입_성공_테스트() {
        // given (준비)
        Member member = new Member("테스터");

        // when (실행)
        Long savedId = memberService.join(member);

        // then (검증)
        Member findMember = memberRepository.findById(savedId).get();
        assertThat(member.getName()).isEqualTo(findMember.getName());
    }
}