문제: 서버 쪽 상한이 찬 거절이 전송마다 다른 코드였다. web-advanced는 ADMISSION_REFUSED(503), fileserver는 instance·전송 pool 포화까지 TRANSFER_ADMISSION_REJECTED(429 RATE_LIMIT), gRPC는 RATE_LIMIT_EXCEEDED (RESOURCE_EXHAUSTED, "요청이 너무 잦습니다")였다. client는 자기 빈도 탓인지 서버 포화인지 가를 수 없었다. web은 상태만 아는 모든 503을 REQUEST_TIMEOUT으로 답했다 (§4는 비동기 시간 초과만). §4에 OPERATION_NOT_FOUND가 없었고, fileserver 오류 code 27개 중 23개가 계약 문서에 없었으며 예시가 "data": null을 실었다. fileserver는 Retry-After를 발생만 보고 붙여, 본문이 retryable=false로 좁힌 code에도 헤더가 나갔다. gRPC Javadoc과 graphql 스냅숏 머리말이 지운 이름(WORKLOG_NOT_FOUND, spi)을 적었다. 고른 방법(리뷰 README 6절 ②): - 공용 OperationalError.SERVER_BUSY(503, TRANSIENT_DEPENDENCY, retryable, Retry-After 1)를 더했다. registry 행, RetryAfterAdvisor, runbook server-busy.md를 같이 둔다. - web-advanced admission 거절, gRPC call admission(UNAVAILABLE), fileserver의 instance permit·직접 다운로드 permit·전송 pool 포화가 이 코드다. fileserver는 같은 이름의 FileserverErrorCode.SERVER_BUSY를 두고, 이름이 같은 code의 뜻이 같은지 FileserverExceptionTest가 이미 본다. 호출자 자기 scope의 동시 전송 초과만 TRANSFER_ADMISSION_REJECTED 429로 남는다. - 상태만 아는 503은 SERVER_BUSY, AsyncRequestTimeoutException만 REQUEST_TIMEOUT이다(HttpStatusErrorCodes.forException). - fileserver Retry-After는 본문과 같은 규칙(code와 발생이 모두 retryable)으로 붙인다. 재시도 불가 code인 ATOMIC_PUBLISH_UNSUPPORTED를 표에서 뺐다. - docs/fileserver/http-contract.md에 오류 code 표 전체를 두고 예시의 data:null을 지웠다. http-contract §4에 OPERATION_NOT_FOUND와 SERVER_BUSY를 적었다. - decisions 2.3에 결정 ①②③ 행을 더했다. - 포화 시험의 sleep(200)을 첫 거절 신호로 바꾸고, timeout 시험이 code까지 본다(같은 파일이라 RR9-03-20의 그 부분을 여기서 고친다). - web-advanced 파일의 spotless 정리(앞 커밋분)를 함께 싣는다. 버린 대안: JOB_EXECUTOR_REJECTED를 재사용 — 백그라운드 job 이름이라 요청 허가 거절을 읽는 client와 runbook을 잘못 이끈다. 위험·한계: 포화 거절로 분기하던 client와 재시도 정책, WebAdvancedError .ADMISSION_REFUSED를 참조하던 코드, 모든 503을 REQUEST_TIMEOUT으로 보던 client가 바뀐다(upgrade 안내 8·9·13). BREAKING CHANGE: 서버 포화 코드가 SERVER_BUSY 하나다(web-advanced ADMISSION_REFUSED 삭제, fileserver instance·pool 포화 429 → 503, gRPC RESOURCE_EXHAUSTED → UNAVAILABLE). 상태만 아는 503은 SERVER_BUSY다. 할 일은 docs/upgrade/2026-11-round9-contracts.md. Refs: RR9-03-06, RR9-03-07, RR9-03-11, RR9-03-12, RR9-03-15, RR9-03-16, RR9-03-20
170 lines
12 KiB
Plaintext
170 lines
12 KiB
Plaintext
# GraphQL leaf public API surface — every public top-level type in src/main/java.
|
|
# A public type in a single-jar leaf is reachable from every adopter's code, so
|
|
# additions are reviewed rather than discovered. `api` is the intended external
|
|
# surface; the rest are candidates to become internal when this leaf is split into
|
|
# capability artifacts.
|
|
# Update only after review with:
|
|
# ./gradlew :adapter:inbound:graphql:updateGraphQlApiSurface -PapproveGraphQlApiSurfaceChange
|
|
# types: 161
|
|
dev.caskeleton.adapter.inbound.graphql.HealthGraphqlController
|
|
dev.caskeleton.adapter.inbound.graphql.api.GraphQlClientProfile
|
|
dev.caskeleton.adapter.inbound.graphql.api.GraphQlOperationId
|
|
dev.caskeleton.adapter.inbound.graphql.api.GraphQlOperationName
|
|
dev.caskeleton.adapter.inbound.graphql.api.GraphQlSchemaCoordinate
|
|
dev.caskeleton.adapter.inbound.graphql.autoconfigure.GraphQlActivationEnvironmentPostProcessor
|
|
dev.caskeleton.adapter.inbound.graphql.autoconfigure.GraphQlDeploymentMode
|
|
dev.caskeleton.adapter.inbound.graphql.autoconfigure.GraphQlPlatformAutoConfiguration
|
|
dev.caskeleton.adapter.inbound.graphql.autoconfigure.GraphQlPlatformConfigurationException
|
|
dev.caskeleton.adapter.inbound.graphql.autoconfigure.GraphQlPlatformRuntime
|
|
dev.caskeleton.adapter.inbound.graphql.autoconfigure.GraphQlPlatformSettings
|
|
dev.caskeleton.adapter.inbound.graphql.autoconfigure.GraphQlPlatformStartupValidator
|
|
dev.caskeleton.adapter.inbound.graphql.autoconfigure.GraphQlRetiredSafetyAxis
|
|
dev.caskeleton.adapter.inbound.graphql.autoconfigure.GraphQlRootAutoConfiguration
|
|
dev.caskeleton.adapter.inbound.graphql.context.ActorRef
|
|
dev.caskeleton.adapter.inbound.graphql.context.GraphQlCommandAttribution
|
|
dev.caskeleton.adapter.inbound.graphql.context.GraphQlDeadline
|
|
dev.caskeleton.adapter.inbound.graphql.context.GraphQlIdentityFingerprinter
|
|
dev.caskeleton.adapter.inbound.graphql.context.GraphQlRequestContext
|
|
dev.caskeleton.adapter.inbound.graphql.context.TenantContext
|
|
dev.caskeleton.adapter.inbound.graphql.cost.GraphQlComplexityCalculator
|
|
dev.caskeleton.adapter.inbound.graphql.cost.GraphQlComplexityRejectedException
|
|
dev.caskeleton.adapter.inbound.graphql.cost.GraphQlComplexityResult
|
|
dev.caskeleton.adapter.inbound.graphql.cost.GraphQlCostCatalog
|
|
dev.caskeleton.adapter.inbound.graphql.cost.GraphQlDocumentComplexityScorer
|
|
dev.caskeleton.adapter.inbound.graphql.cost.GraphQlDocumentShape
|
|
dev.caskeleton.adapter.inbound.graphql.cost.GraphQlDocumentShapeAnalyzer
|
|
dev.caskeleton.adapter.inbound.graphql.cost.GraphQlFieldCostDescriptor
|
|
dev.caskeleton.adapter.inbound.graphql.cost.GraphQlResolverWeight
|
|
dev.caskeleton.adapter.inbound.graphql.cost.GraphQlStructuralLimitException
|
|
dev.caskeleton.adapter.inbound.graphql.cost.GraphQlStructuralLimitPolicy
|
|
dev.caskeleton.adapter.inbound.graphql.cost.GraphQlStructuralLimits
|
|
dev.caskeleton.adapter.inbound.graphql.dataloader.GraphQlBatchChunker
|
|
dev.caskeleton.adapter.inbound.graphql.dataloader.GraphQlBatchContext
|
|
dev.caskeleton.adapter.inbound.graphql.dataloader.GraphQlBatchErrorPolicy
|
|
dev.caskeleton.adapter.inbound.graphql.dataloader.GraphQlBatchExecutor
|
|
dev.caskeleton.adapter.inbound.graphql.dataloader.GraphQlBatchLoadException
|
|
dev.caskeleton.adapter.inbound.graphql.dataloader.GraphQlBatchObservation
|
|
dev.caskeleton.adapter.inbound.graphql.dataloader.GraphQlBatchPolicy
|
|
dev.caskeleton.adapter.inbound.graphql.dataloader.GraphQlBatchPolicyRegistry
|
|
dev.caskeleton.adapter.inbound.graphql.dataloader.GraphQlBatchResult
|
|
dev.caskeleton.adapter.inbound.graphql.dataloader.GraphQlBatchResultMapper
|
|
dev.caskeleton.adapter.inbound.graphql.dataloader.GraphQlBatchTimeoutException
|
|
dev.caskeleton.adapter.inbound.graphql.dataloader.GraphQlBatchValue
|
|
dev.caskeleton.adapter.inbound.graphql.dataloader.GraphQlDataLoaderFactory
|
|
dev.caskeleton.adapter.inbound.graphql.dataloader.GraphQlDataLoaderName
|
|
dev.caskeleton.adapter.inbound.graphql.dataloader.GraphQlMissingKeyException
|
|
dev.caskeleton.adapter.inbound.graphql.dataloader.GraphQlMissingKeyPolicy
|
|
dev.caskeleton.adapter.inbound.graphql.error.GraphQlErrorCategory
|
|
dev.caskeleton.adapter.inbound.graphql.error.GraphQlErrorCode
|
|
dev.caskeleton.adapter.inbound.graphql.error.GraphQlErrorContext
|
|
dev.caskeleton.adapter.inbound.graphql.error.GraphQlExceptionResolver
|
|
dev.caskeleton.adapter.inbound.graphql.error.GraphQlInternalErrorMasker
|
|
dev.caskeleton.adapter.inbound.graphql.error.GraphQlPlatformRejection
|
|
dev.caskeleton.adapter.inbound.graphql.error.GraphQlWireError
|
|
dev.caskeleton.adapter.inbound.graphql.error.GraphQlWireErrorMapper
|
|
dev.caskeleton.adapter.inbound.graphql.error.GraphQlWireErrors
|
|
dev.caskeleton.adapter.inbound.graphql.execution.BoundedPreparsedDocumentProvider
|
|
dev.caskeleton.adapter.inbound.graphql.execution.GraphQlAnonymousOperationException
|
|
dev.caskeleton.adapter.inbound.graphql.execution.GraphQlExecutionPipeline
|
|
dev.caskeleton.adapter.inbound.graphql.execution.GraphQlExecutionPipelineException
|
|
dev.caskeleton.adapter.inbound.graphql.execution.GraphQlExecutionPipelineValidator
|
|
dev.caskeleton.adapter.inbound.graphql.execution.GraphQlExecutionStage
|
|
dev.caskeleton.adapter.inbound.graphql.execution.GraphQlOperationSelection
|
|
dev.caskeleton.adapter.inbound.graphql.execution.GraphQlPreparsedCacheKey
|
|
dev.caskeleton.adapter.inbound.graphql.execution.GraphQlPreparsedCacheMetrics
|
|
dev.caskeleton.adapter.inbound.graphql.execution.GraphQlPreparsedCachePolicy
|
|
dev.caskeleton.adapter.inbound.graphql.execution.GraphQlRequestCancelledException
|
|
dev.caskeleton.adapter.inbound.graphql.fetch.GraphQlFetchProfile
|
|
dev.caskeleton.adapter.inbound.graphql.fetch.GraphQlFetchProfileClassifier
|
|
dev.caskeleton.adapter.inbound.graphql.fetch.GraphQlFetchProfileName
|
|
dev.caskeleton.adapter.inbound.graphql.fetch.GraphQlFetchProfileRegistry
|
|
dev.caskeleton.adapter.inbound.graphql.fetch.GraphQlFetchProfileRule
|
|
dev.caskeleton.adapter.inbound.graphql.fetch.GraphQlFetchProfileValidationException
|
|
dev.caskeleton.adapter.inbound.graphql.fetch.GraphQlSelectionCoordinate
|
|
dev.caskeleton.adapter.inbound.graphql.fetch.GraphQlSelectionSetView
|
|
dev.caskeleton.adapter.inbound.graphql.fetch.GraphQlSelectionSignature
|
|
dev.caskeleton.adapter.inbound.graphql.fetch.GraphQlUnmappedSelectionException
|
|
dev.caskeleton.adapter.inbound.graphql.http.GraphQlExtensionsPolicy
|
|
dev.caskeleton.adapter.inbound.graphql.http.GraphQlHttpContractException
|
|
dev.caskeleton.adapter.inbound.graphql.http.GraphQlHttpOutcome
|
|
dev.caskeleton.adapter.inbound.graphql.http.GraphQlJsonStructurePolicy
|
|
dev.caskeleton.adapter.inbound.graphql.http.GraphQlJsonValues
|
|
dev.caskeleton.adapter.inbound.graphql.http.GraphQlRequestFormatException
|
|
dev.caskeleton.adapter.inbound.graphql.http.GraphQlRequestSize
|
|
dev.caskeleton.adapter.inbound.graphql.http.GraphQlRequestTooLargeException
|
|
dev.caskeleton.adapter.inbound.graphql.mutation.GraphQlBatchMutationItemResult
|
|
dev.caskeleton.adapter.inbound.graphql.mutation.GraphQlBusinessResult
|
|
dev.caskeleton.adapter.inbound.graphql.mutation.GraphQlExpectedVersion
|
|
dev.caskeleton.adapter.inbound.graphql.mutation.GraphQlMutationContractException
|
|
dev.caskeleton.adapter.inbound.graphql.mutation.GraphQlMutationContractValidator
|
|
dev.caskeleton.adapter.inbound.graphql.mutation.GraphQlMutationCoordinate
|
|
dev.caskeleton.adapter.inbound.graphql.mutation.GraphQlMutationPayload
|
|
dev.caskeleton.adapter.inbound.graphql.mutation.GraphQlMutationResultMapper
|
|
dev.caskeleton.adapter.inbound.graphql.observation.GraphQlDataLoaderObservationConvention
|
|
dev.caskeleton.adapter.inbound.graphql.observation.GraphQlMetricCardinalityPolicy
|
|
dev.caskeleton.adapter.inbound.graphql.observation.GraphQlObservationContractException
|
|
dev.caskeleton.adapter.inbound.graphql.observation.GraphQlObservationNames
|
|
dev.caskeleton.adapter.inbound.graphql.observation.GraphQlOperationNameCardinality
|
|
dev.caskeleton.adapter.inbound.graphql.observation.GraphQlRequestObservationConvention
|
|
dev.caskeleton.adapter.inbound.graphql.observation.GraphQlResolverObservationConvention
|
|
dev.caskeleton.adapter.inbound.graphql.observation.GraphQlSensitiveAttributeFilter
|
|
dev.caskeleton.adapter.inbound.graphql.pagination.GraphQlConnection
|
|
dev.caskeleton.adapter.inbound.graphql.pagination.GraphQlConnectionAssembler
|
|
dev.caskeleton.adapter.inbound.graphql.pagination.GraphQlConnectionException
|
|
dev.caskeleton.adapter.inbound.graphql.pagination.GraphQlConnectionPolicy
|
|
dev.caskeleton.adapter.inbound.graphql.pagination.GraphQlConnectionRequest
|
|
dev.caskeleton.adapter.inbound.graphql.pagination.GraphQlCursorCodec
|
|
dev.caskeleton.adapter.inbound.graphql.pagination.GraphQlCursorException
|
|
dev.caskeleton.adapter.inbound.graphql.pagination.GraphQlCursorFraming
|
|
dev.caskeleton.adapter.inbound.graphql.pagination.GraphQlCursorKeyRing
|
|
dev.caskeleton.adapter.inbound.graphql.pagination.GraphQlCursorKeyset
|
|
dev.caskeleton.adapter.inbound.graphql.pagination.GraphQlCursorPayload
|
|
dev.caskeleton.adapter.inbound.graphql.pagination.GraphQlCursorScope
|
|
dev.caskeleton.adapter.inbound.graphql.pagination.GraphQlCursorVersion
|
|
dev.caskeleton.adapter.inbound.graphql.pagination.GraphQlEdge
|
|
dev.caskeleton.adapter.inbound.graphql.pagination.GraphQlKeysetWindow
|
|
dev.caskeleton.adapter.inbound.graphql.pagination.GraphQlPageInfo
|
|
dev.caskeleton.adapter.inbound.graphql.pagination.HmacGraphQlCursorCodec
|
|
dev.caskeleton.adapter.inbound.graphql.policy.GraphQlClientPolicy
|
|
dev.caskeleton.adapter.inbound.graphql.policy.GraphQlOperationType
|
|
dev.caskeleton.adapter.inbound.graphql.runtime.GraphQlBatchLoaderRegistrar
|
|
dev.caskeleton.adapter.inbound.graphql.runtime.GraphQlCostBudgetHandler
|
|
dev.caskeleton.adapter.inbound.graphql.runtime.GraphQlDataFetcherExceptionResolver
|
|
dev.caskeleton.adapter.inbound.graphql.runtime.GraphQlDeadlineInstrumentation
|
|
dev.caskeleton.adapter.inbound.graphql.runtime.GraphQlDocumentAuthorizationHandler
|
|
dev.caskeleton.adapter.inbound.graphql.runtime.GraphQlExecutionChain
|
|
dev.caskeleton.adapter.inbound.graphql.runtime.GraphQlExecutionContext
|
|
dev.caskeleton.adapter.inbound.graphql.runtime.GraphQlExecutionHandler
|
|
dev.caskeleton.adapter.inbound.graphql.runtime.GraphQlExecutionRequest
|
|
dev.caskeleton.adapter.inbound.graphql.runtime.GraphQlOperationSelectionHandler
|
|
dev.caskeleton.adapter.inbound.graphql.runtime.GraphQlPerParentFetchInstrumentation
|
|
dev.caskeleton.adapter.inbound.graphql.runtime.GraphQlPlatformInstrumentation
|
|
dev.caskeleton.adapter.inbound.graphql.runtime.GraphQlPlatformWebInterceptor
|
|
dev.caskeleton.adapter.inbound.graphql.runtime.GraphQlPreparsedDocumentAdapter
|
|
dev.caskeleton.adapter.inbound.graphql.runtime.GraphQlPrincipalResolver
|
|
dev.caskeleton.adapter.inbound.graphql.runtime.GraphQlRequestObservationConventionAdapter
|
|
dev.caskeleton.adapter.inbound.graphql.runtime.servlet.GraphQlRequestBodyLimitFilter
|
|
dev.caskeleton.adapter.inbound.graphql.scalar.BigDecimalScalar
|
|
dev.caskeleton.adapter.inbound.graphql.scalar.DateScalar
|
|
dev.caskeleton.adapter.inbound.graphql.scalar.GraphQlDecimalBounds
|
|
dev.caskeleton.adapter.inbound.graphql.scalar.GraphQlScalarWiringConfigurer
|
|
dev.caskeleton.adapter.inbound.graphql.scalar.InstantScalar
|
|
dev.caskeleton.adapter.inbound.graphql.scalar.LongScalar
|
|
dev.caskeleton.adapter.inbound.graphql.scalar.UuidScalar
|
|
dev.caskeleton.adapter.inbound.graphql.schema.GraphQlScalarDefinition
|
|
dev.caskeleton.adapter.inbound.graphql.schema.GraphQlScalarManifest
|
|
dev.caskeleton.adapter.inbound.graphql.schema.GraphQlScalarPolicy
|
|
dev.caskeleton.adapter.inbound.graphql.security.ApplicationObjectAuthorization
|
|
dev.caskeleton.adapter.inbound.graphql.security.GraphQlAuthenticatedPrincipal
|
|
dev.caskeleton.adapter.inbound.graphql.security.GraphQlAuthenticationContextFactory
|
|
dev.caskeleton.adapter.inbound.graphql.security.GraphQlAuthenticationException
|
|
dev.caskeleton.adapter.inbound.graphql.security.GraphQlAuthorizationDecision
|
|
dev.caskeleton.adapter.inbound.graphql.security.GraphQlAuthorizationDeniedException
|
|
dev.caskeleton.adapter.inbound.graphql.security.GraphQlAuthorizationInterceptor
|
|
dev.caskeleton.adapter.inbound.graphql.security.GraphQlAuthorizationPolicy
|
|
dev.caskeleton.adapter.inbound.graphql.security.GraphQlBatchContext
|
|
dev.caskeleton.adapter.inbound.graphql.security.GraphQlContextPropagator
|
|
dev.caskeleton.adapter.inbound.graphql.security.GraphQlObjectAuthorizationPort
|
|
dev.caskeleton.adapter.inbound.graphql.security.GraphQlTenantIsolationException
|
|
dev.caskeleton.adapter.inbound.graphql.security.GraphQlTenantIsolationPolicy
|