refactor(web)!: 쓰는 곳 없는 ApiHeaders.DEPRECATION·DATE 상수를 지운다

web ApiHeaders가 Deprecation·Date 헤더 이름 상수를 공개하지만 운영
코드와 시험 어디에서도 부르지 않는다. 헤더 registry는 지난 변경에서
쓰지 않는 Deprecation 행을 이미 지웠고, 상수만 남아 응답이 그 헤더를
보낸다고 읽힌다.

두 상수와 주석을 지우고 README의 ApiHeaders 절, 시험 도구 MainSources의
Javadoc 예시, docs/capability-status.md 제거 표를 맞춘다.

버린 안: @Deprecated로 한 판 남기기. 템플릿 안에 부르는 곳이 없고,
파생 서비스가 쓰고 있었다면 Spring HttpHeaders.DATE나 자기 상수로
바로 옮길 수 있다.

위험: 그 상수를 부르던 파생 서비스는 컴파일이 실패한다. upgrade
문서 5행이 옮기는 법을 적는다.

검증: desktop :adapter:inbound:web:check, scripts/verify.sh pr.

BREAKING CHANGE: ApiHeaders.DEPRECATION·ApiHeaders.DATE 상수가 없다.
Refs: round9 그룹 A 범위 밖 후속 3
This commit is contained in:
DongHyeonka
2026-11-13 19:30:12 +09:00
parent e69c321eca
commit c4a2023aaa
5 changed files with 9 additions and 13 deletions
+2 -2
View File
@@ -497,8 +497,8 @@ commit-aware response wrapper 계약을 구현한다. 또한 이 모듈은 HTML
- 템플릿 main 이 쓰는 상수: `Retry-After`, rate-limit 신호(`X-RateLimit-Limit`·`-Remaining` 은 숫자, `-Reset` 은
rfc3339 = fixed window 끝), `Cache-Control`·`Vary`, `ETag`·`Location`(CORS 노출 목록).
- 서비스 controller 가 읽으라고 둔 상수: `Idempotency-Key`(이름만. key shape/scope/replay 정책은 application-core 소유),
`If-Match`·`If-None-Match`(조건부 요청, 비교는 `conditional.ETags`), `Allow`. `Deprecation`·`Date` 상수는 있지만 아무
코드도 쓰지 않는다. `X-Api-Version` 은 없다.
`If-Match`·`If-None-Match`(조건부 요청, 비교는 `conditional.ETags`), `Allow`. `X-Api-Version`·`Deprecation`·`Date` 상수는
없다.
---
@@ -28,11 +28,5 @@ public final class ApiHeaders {
public static final String X_RATELIMIT_REMAINING = "X-RateLimit-Remaining";
public static final String X_RATELIMIT_RESET = "X-RateLimit-Reset";
// deep-offset deprecation marker
public static final String DEPRECATION = "Deprecation";
// always-emitted
public static final String DATE = "Date";
private ApiHeaders() {}
}
@@ -15,9 +15,9 @@ import java.util.stream.Stream;
* registry lists is really used by shipped code.
*
* <p>A registry row that points at a file holding its name only proves the name is declared. When
* the name sits in a constant ({@code DEPRECATION = "Deprecation"}), the row is backed only if
* something uses that constant: it appears again in its own file, or another main file names it as
* {@code DeclaringClass.CONSTANT}.
* the name sits in a constant ({@code NAME = "Some-Header"}), the row is backed only if something
* uses that constant: it appears again in its own file, or another main file names it as {@code
* DeclaringClass.CONSTANT}.
*/
public final class MainSources {