일지

깔끔한 Service 코드 만들기(from, map, collect)

ubukki(@river20s) — Mon, 26 Jan 2026 20:32:09 +0900

스프링 부트로 비즈니스 로직을 구현할 때 엔티티를 DTO*로 변환하거나 리스트 데이터를 가공해야 하는 경우가 많다. 이때 자주 쓰게 되지만 헷갈리는 것이 from(), map(), collect()인데, 이 셋의 스펙과 활용법을 정리해보려 한다.

`from()` - 객체 간의 전환

보통 DTO 클래스 내부에 정적 메서드**로 구현하며, 어떤 객체로부터 이 DTO가 만들어지는가를 명확히 선언한다.

Entity → DTO
생성자 대신 from을 쓰는 이유****
- 읽기 훨씬 자연스러워서 의도가 명확하다. (예: new QuestionResponseDto(...)보다 QuestionResponseDto.from(question)이 읽기 자연스러움)
- 서비스 로직에서 일일이 Getter를 호출해 값을 세팅할 필요가 없다. 변환 로직이 DTO 내부에 있으므로 서비스 코드가 깔끔해진다.

from()

자바 표준 Stream 인터페이스에는 from()이라는 인스턴스 메서드가 없다. 대신 자바의 여러 클래스에서 정적 팩토리 메서드 관례로 사용된다.사례날짜, 시간 관련LocalDateTime.from(temporal)처럼 다른 시

ubukki.tistory.com

`map()` - 데이터 모양 바꾸기

데이터의 개수는 유지하면서 그 내부 형태만 바꿀 때 사용한다. 지금 작업에서 자주 쓰는 것은 두 종류의 map이다.

Java Stream의 map
List<Question>을 Stream***으로 만든 뒤 하나씩 꺼내 DTO로 변환할 때 사용
Spring Data Page의 map()
DB에서 페이징 처리된 Page<Question>을 Page<QuestionResponseDto>로 바꿀 때 사용

별도의 collect() 과정이 필요 없음. Page 객체가 가진 페이지 번호, 전체 개수 같은 메타데이터는 유지하면서 엔티티만 DTO로 바꿔준다.

map()

데이터의 변환map()은 주로 Stream이나 Optional 인터페이스에서 사용된다. 스트림 내부의 요소를 차례대로 다른 형태로 변환하는 역할을 한다. Stream map(Function mapper);입력타입 T를 받아서 결과타입 R

ubukki.tistory.com

`collect()` - 흩어진 데이터를 모으기

map으로 변환된 데이터들은 아직 스트림 상태다. 이를 실제 우리가 사용할 수 있는 리스트 형태로 바궈주는 것이 collect()다.

스트림의 요소들을 List, Set 등의 컬렉션으로 취합함

collect()

데이터의 취합collect()는 스트림의 요소들을 모아서 리스트, 셋, 맵과 같은 컬렉션이나 다른 형태의 결과물로 만드는 최종 연산이다. R collect(Collector collector);가변 축소(Mutable Reduction): 스트림의 요

ubukki.tistory.com

요약

    public List<QuestionResponseDto> getAllQuestions() {
        return questionRepository.findAll().stream()
                .map(QuestionResponseDto::from)
                .collect(Collectors.toList());
    }

단계	코드	상태
Source	repository.findAll()	List<Entity>
Stream	.stream()	Stream<Entity>
Map	.map(Dto::from)	Stream<Dto>
Collect	.collect(Collectors.toList())	List<Dto>

이 세 가지 메서드만 잘 활용해도 서비스 레이어의 가독성이 비약적으로 상승한다.

참고

* DTO: Data Transfer Object, 계층 간 데이터 전송을 위한 객체. DB 설계를 그대로 담은 Entity를 클라이언트에 직접 노출하지 않기 위해 사용한다. 필요한 데이터만 골라 담는다.

** 정적 팩토리 메서드(Static Factory Method): 객체 생성을 담당하는 클래스 내의 static 메서드이다. 이름을 가질 수 있어 생성 의도를 드러내기 좋고, 매번 새로운 객체를 생성하지 않아도 되는 등 유연한 설계가 가능하다. 예; from(), of()

*** 스트림 (Stream): Java 8부터 도입된 데이터의 흐름이다. 컬렉션(List, Set 등)에 저장된 요소들을 하나씩 참조하면서 선언적인 스타일(어떻게가 아닌 무엇을)로 가공하고 처리한다.

**** 보통 객체를 만들 때 new QuestionResponseDto(quesion) 처럼 생성자를 직접 부른다. 하지만 from이라는 정적 팩토리 메서드를 쓰면 다음과 같은 차이가 있다. 생성자는 한 클래스의 인스턴스를 만들지만, from은 특정 엔티티로부터 정보를 추출해서 응답용 객체 DTO를 만드는 의도적 작업을 수행한다. 즉 ㄱ객체 생성의 목적이 명확해지고, DTO 내부에서 엔티티의 어떤 필드를 사용할지 결정하므로 서비스 로직이 DTO 내부를 몰라도 되는 캡슐화적인 장점이 있다.

from()

ubukki(@river20s) — Mon, 26 Jan 2026 20:05:28 +0900

자바 표준 Stream 인터페이스에는 from()이라는 인스턴스 메서드가 없다. 대신 자바의 여러 클래스에서 정적 팩토리 메서드 관례로 사용된다.

사례

날짜, 시간 관련
LocalDateTime.from(temporal)처럼 다른 시간 객체를 기반으로 새로운 객체를 만들 때
EnumSet
EnumSet.from(Collection<E> c)
Project Reactor
다른 발행자를 리액티브 타입으로 변환할 때
DTO 변환
스프링 개발 시 Entity를 DTO로 변환할 때

Java 9 이상에서 컬렉션을 만들 때 사용하는 List.of()등과 유사한 성격의 객체 생성자 역할을 한다.

collect()

ubukki(@river20s) — Mon, 26 Jan 2026 20:01:56 +0900

데이터의 취합

collect()는 스트림의 요소들을 모아서 리스트, 셋, 맵과 같은 컬렉션이나 다른 형태의 결과물로 만드는 최종 연산이다.

<R, A> R collect(Collector<? super T, A, R> collector);

가변 축소(Mutable Reduction): 스트림의 요소들을 하나의 누적기(Container, 예: ArrayList)에 담아 최종 결과를 산출한다.
주로 Collectors 클래스에서 제공하는 정적 메서드(toList(), toSet(), joining() 등)와 함께 사용한다.
병렬 스트림 환경에서도 안전하게 데이터를 합칠 수 있도록 설계되어 있다.

map()

ubukki(@river20s) — Mon, 26 Jan 2026 19:58:05 +0900

데이터의 변환

map()은 주로 Stream이나 Optional 인터페이스에서 사용된다. 스트림 내부의 요소를 차례대로 다른 형태로 변환하는 역할을 한다.

<R> Stream<R> map(Function<? super T, ? extends R> mapper);

입력타입 T를 받아서 결과타입 R을 반환하는 Function 인터페이스를 인자로 받는다.
요소의 개수는 유지하되, 그 내용물(타입이나 값)이 바뀐다.
지연 연산, 중간 연산이므로 collect() 같은 최종 연산이 호출되기 전까지는 실제로 실행되지 않는다.

Map (Java Platform SE 8 )

If the specified key is not already associated with a value (or is mapped to null), attempts to compute its value using the given mapping function and enters it into this map unless null. If the function returns null no mapping is recorded. If the function

docs.oracle.com

Java의 < > 기호 - 제네릭(Generics)

ubukki(@river20s) — Mon, 26 Jan 2026 19:32:26 +0900

`< >` 기호의 의미

제네릭은 클래스 내부에서 사용할 데이터 타입을 외부에서 결정하는 것이다.

왜 필요한가?

제네릭을 사용하면 컴파일러에게 클래스에 들어갈 데이터 타입을 미리 알려줄 수 있다.

List list = new ArrayList();
List<String> list = new ArrayList<>();

제네릭을 사용하지 않은 위의 경우 꺼낼 때 형변환이 필요하다.
그 아래의 제네릭을 사용한 경우 문자열만 넣을 수 있으므로 꺼낼 때 안전하다.오늘 마주친 제네릭들
1. ResponseEntity<어쩌고Dto>
HTTP 응답을 보낼 때 응답 본문에 어쩌고Dto라는 객체를 담아서 보내겠다는 뜻.
데이터를 받는 쪽에서 '이 응답을 뜯어보면 어쩌고Dto가 들어있겠구나'하고 확신할 수 있음.2. Response<Void>
응답은 보내지만 본문에 담을 데이터는 없다는 뜻.
보통 deleteTag()처럼 데이터를 삭제하는 작업은 성공 여부만 중요하고 딱히 돌려줄 데이터 객체가 없어서 Void를 사용함.3. <List<Question>> 중첩 사용
응답 본문에 Question 객체들이 여러 개 담긴 리스트를 넣어서 보내겠다는 의미.4. Map<String, Integer>
Key는 String 타입, Value는 Integer 타입인 Map을 의미함제네릭을 쓰면 좋은 점

타입 안정성
잘못된 타입이 들어오면 컴파일 단계에서 에러를 잡아줌
불필요한 형변환 제거
데이터를 꺼낼 때마다 타입을 강제로 변환할 필요가 없어서 코드가 깔끔해짐메서드 앞에 붙는 <T>예를 들어
```
public <T> T genericMethod(T t)
```
처럼 메서드 앞에 < >가 붙는 경우도 있는데, 이는 이 메서드가 호출될 때 타입을 결정하는 제너릭 메서드라는 선언이다.왜 T를 쓰는가?< >안에는 아무거나 써도 되는데 보통 관례적으로 다음과 같이 쓴다.

기호	의미	설명
`<T>`	Type	가장 일반적으로 타입을 나타낼 때 사용
`<E>`	Element	리스트나 셋 같은 컬렉션 내부 요소
`<K>`	Key	Map의 키 타입
`<V>`	Value	Map의 값 타입
`<N>`	Number	숫자 타입을 강조

`<?>`

코드를 보다보면 <?>가 적힌 경우도 보이는데 이건 와일드 카드라고 한다.
예를 들어 List<?>는 어떤 타입이든 상관없이 다 받을 수 있는 리스트라는 뜻이다.
List<? extends Number>는 적어도 Number 클래스나 그 자식들이 들어올 수 있다고 상한선을 정하는 것이다.

제네릭 메서드

클래스 전체가 아니라 메서드 하나만 제네릭으로 만들고 싶을 때는 다음과 같이 쓴다.

public <T> void printArray(T[] array) {
    for (T element : array) {
        System.out.println(element);
    }
}

이 메서드는 호출할 때 String[]을 넣으면 T가 String이고, Integer[]를 넣으면 T가 Integer가 된다. 하나의 코드로 모든 타입을 대응할 수 있다.

요약

< >는 타입을 변수처럼 처리하겠다는 약속이다. 컴파일할 때 미리 타입을 체크해서 좋다. 코드 재사용성이 올라간다.

엔드 포인트(Endpoint)

ubukki(@river20s) — Mon, 26 Jan 2026 19:01:11 +0900

엔드포인트란

엔드포인트는 외부(클라이언트)에서 소프트웨어 서비스나 API에 접근할 수 있도록 공개된 통신의 종단점-끝점을 의미한다.

Spring에서의 엔드포인트

Spring MVC나 Spring Boot에서 만드는 Controller 안의 메서드 하나하나가 엔드포인트이다.

URL 경로(Path): 어디로 갈 것인가 (예: /api/users)
HTTP 메서드(Method): 어떤 행위를 할 것인가 (예: GET, POST)

예시

다음은 TagController.java 코드의 일부이다. 이 코드는 태그라는 리소스를 관리하기 위해 여러 엔드포인트를 갖고 있다.

package com.moyalist.backend.controller;

import com.moyalist.backend.dto.QuestionResponseDto;
import com.moyalist.backend.dto.TagRequestDto;
import com.moyalist.backend.dto.TagResponseDto;
import com.moyalist.backend.service.TagService;
import lombok.RequiredArgsConstructor;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

import java.util.List;
import java.util.Map;

@RestController
@RequestMapping("/api/tags")
@RequiredArgsConstructor
public class TagController {

    private final TagService tagService;

    @GetMapping
    public ResponseEntity<List<TagResponseDto>> getAllTags() {
        // 모든 태그 반환
        return ResponseEntity.ok(tagService.getAllTags());
    }

    @GetMapping("/{id}")
    public ResponseEntity<TagResponseDto> getTag(@PathVariable Long id) {
        // 특정 태그 반환
        return ResponseEntity.ok(tagService.getTag(id));
    }

    @PostMapping
    public ResponseEntity<TagResponseDto> createTag(@RequestBody Map<String, String> request) {
        Long userId = Long.parseLong(request.get("userId"));
        String name = request.get("name");
        return ResponseEntity.ok(tagService.createTag(userId, name));
    }

    @PutMapping("/{id}")
    public  ResponseEntity<TagResponseDto> updateTag(@RequestBody TagRequestDto request, @PathVariable Long id) {
        return ResponseEntity.ok(tagService.updateTag(id, request));
    }

    @DeleteMapping("/{id}")
    public ResponseEntity<Void> deleteTag(@PathVariable Long id) {
        tagService.deleteTag(id);
        return ResponseEntity.noContent().build();
    }

    @GetMapping("/{id}/questions")
    public ResponseEntity<List<QuestionResponseDto>>
    getQuestionByTagId(@PathVariable Long id) {
        return ResponseEntity.ok(tagService.getQuestionsByTagId(id));
    }
}

TagController.java

Tag 엔드포인트

클래스 상단에 @RequestMapping("/api/tags")가 선언되어 있으므로, 모든 엔드포인트의 기본 주소는 /api/tags로 시작한다.

HTTP 메서드	엔드포인트 경로(Path)	역할
GET	`/api/tags`	저장된 모든 태그 목록을 가져옴
GET	`/api/tags/{id}`	특정 ID를 가진 태그 하나를 조회함
POST	`/api/tags`	새로운 태그를 생성함
PUT	`/api/tags{id}`	기존 태그 정보를 수정함
DELETE	`/api/tags/{id}`	특정 태그를 삭제함
GET	`/api/tags/{id}/questions`	특정 태그가 달린 궁금증 목록을 가져옴

경로 변수

@GetMapping("/{id}")나 @DeleteMapping("/{id}")에서 보이는 {id}는 고정된 주소가 아니라 변하는 값이다.
사용자가 /api/tags/10으로 요청을 보내면, Spring은 {id} 자리에 10을 넣어서 getTag(10L) 메서드를 실행한다.
이를 동적 엔드포인트라고 부르기도 한다.

같은 경로, 다른 목적

/api/tags/{id}라는 똑같은 주소를 사용하는 엔드포인트가 3개나 있다(GET, PUT, DELETE).
- GET으로 보내면 조회를 하고
- PUT으로 보내면 수정을 하며
- DELETE로 보내면 삭제를 한다.
이렇게 같은 URL이라도 HTTP 메서드에 따라 행위를 달리하는 것이 RESTful API 설계의 핵심이다.

Request Body

createTag 메서드를 보면 @RequestBody Map<String, String> request가 있다.
엔드포인트는 단순 주소만 있는 게 아니라, 사용자가 보내는 JSON 데이터가 서버로 들어오는 통로 역할도 한다.

소개 About

ubukki(@river20s) — Mon, 26 Jan 2026 18:38:02 +0900

→e-mail (river20s@naver.com)

→Developer

→GitHub (@river20s)

→Currently creating a Moya List ...

TypeError: list indices must be integer or slices, not tuple

ubukki(@river20s) — Sat, 10 May 2025 21:55:43 +0900

예외가 발생했습니다. TypeError
list indices must be integers or slices, not tuple
  File "C:\Users\eunbe\leetcode\leetcode-study\longest-increasing-subsequence\river20s.py", line 11, in lengthOfLIS_bruteforce
    for idx_j in nums[idx_i, n-1]:
                 ~~~~^^^^^^^^^^^^
  File "C:\Users\eunbe\leetcode\leetcode-study\longest-increasing-subsequence\river20s.py", line 23, in <module>
    result = solver.lengthOfLIS_bruteforce(test_nums)
TypeError: list indices must be integers or slices, not tuple

range() 함수는 특정 범위의 연속된 정수들을 만들어내는 객체(이터레이터)를 반환한다. 이 정수들은 주로 for 루프에서 인덱스로 사용된다.

파이썬에서 리스트의 요소를 여러 개 선택하거나 범위를 지정할 때는 슬라이싱(slicing) 을 사용하며, 콜론:으로 구분한다.

일지

깔끔한 Service 코드 만들기(from, map, collect)

from() - 객체 간의 전환

map() - 데이터 모양 바꾸기

collect() - 흩어진 데이터를 모으기

요약

참고

from()

사례

collect()

데이터의 취합

map()

데이터의 변환

Java의 < > 기호 - 제네릭(Generics)

< > 기호의 의미

왜 필요한가?

<?>

제네릭 메서드

요약

엔드 포인트(Endpoint)

엔드포인트란

Spring에서의 엔드포인트

예시

Tag 엔드포인트

경로 변수

같은 경로, 다른 목적

Request Body

소개 About

→e-mail (river20s@naver.com)

→Developer

→GitHub (@river20s)

→Currently creating a Moya List ...

TypeError: list indices must be integer or slices, not tuple

`from()` - 객체 간의 전환

`map()` - 데이터 모양 바꾸기

`collect()` - 흩어진 데이터를 모으기

`< >` 기호의 의미

`<?>`