---
kind: CONCEPT
slug: messaging-schema-json-c04
title: 디코딩은 등록 클래스와 정확히 같은지를 본다
topic: schema-and-wire-models
project: clean-architecture-backend-template
status: 게시 전
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
rootTreeNode: concept:messaging-schema-json-c04
evidenceCapturedOn: 2026-09-01
assets:
  - key: messaging-schema-json-c04
    file: ../../../final/evidence/rendered/messaging-schema-json-c04.svg
evidence:
  - ../../../final/evidence/raw/messaging-schema-json-c04.txt
source:
  - 원본 분석 절은 final/document.md#a19-messaging-schema-json#L238 이다.
module: messaging-schema-json
---

# 디코딩은 등록 클래스와 정확히 같은지를 본다

encode: requireRegistered(type, version) → payload가 등록 타입의 인스턴스인지 → BoundedByteSink 생성 → mapper.writeValue(sink, payload) → 실패 시 unwrapTooLarge → EncodedMessage(bytes, JSON, SchemaReference) decode: requireRegistered(type, version) → 요청 클래스가 등록 클래스와 정확히 같은지 → encoded.length 상한 → mapper.readValue → JacksonException이면 JSON_DECODE_FAILED

## 관계

- **실패 코드는 운영자의 다음 행동이 갈리는 지점마다 나눈다**
  같은 분석 리프에서 끌어낸 규칙이다.

## 본문

<!-- body:start -->

**encode:** `requireRegistered(type, version)` → payload가 등록 타입의 인스턴스인지 → `BoundedByteSink` 생성 → `mapper.writeValue(sink, payload)` → 실패 시 `unwrapTooLarge` → `EncodedMessage(bytes, JSON, SchemaReference)`

**decode:** `requireRegistered(type, version)` → 요청 클래스가 등록 클래스와 정확히 같은지 → `encoded.length` 상한 → `mapper.readValue` → `JacksonException`이면 `JSON_DECODE_FAILED`

## BoundedByteSink 참조 위치

:::evidence key="messaging-schema-json-c04" alt="코드베이스에서 BoundedByteSink 를 검색한 출력 15줄. 이 기록이 세는 참조가 그 출력에 그대로 보인다." caption="BoundedByteSink 코드베이스 검색 — 15줄 · exit 0" zoom="true"
:::

<!-- body:end -->