lease를 넘겨받는 저장소 다섯 곳이 앞 실행의 쓰기를 막지 못한다. durable operation은 owner만 보고 써서 같은 worker id가 다시 claim하면 앞 실행의 결과가 남는다. 알림 lease 회복은 상태를 다시 읽은 뒤 조건 없이 되돌려 끝난 delivery를 다시 보낸다. 만료 sweep·전체 읽음은 기다린 행의 상태를 다시 보지 않는다. 멱등성 reaper는 앱 시계로 비교하고 한 번에 다 지우며, 같은 키 요청이 되살린 기록까지 지운다. fileserver recovery enqueue는 동시 삽입에서 25P02로 실패하고, cleanup은 claim lease가 끝난 뒤에도 항목을 시작한다. 저장소가 행에서 만드는 claim·lease record는 잘못된 값을 IllegalArgumentException으로 거절해 web이 400으로 바꾼다. 고른 방법: 모든 쓰기를 owner·fence(·상태·만료) 조건을 단 한 문장으로 바꾼다. durable operation은 V23 lease_fence를 더하고 DurableOperationClaim 을 돌려준다. 알림 회복은 requeueAbandoned 한 문장이다. 만료 sweep은 subquery가 SKIP LOCKED로 쥔 행을 건너뛰고 바깥 UPDATE가 상태·만료를 다시 본다. 전체 읽음은 바깥 UPDATE가 상태를 다시 본다. reaper는 DB now()로 1000행씩, 트랜잭션마다 30초(SpringTransaction.DEFAULT_TIMEOUT_SECONDS)이고 바깥 DELETE에도 만료를 둔다. recovery는 INSERT … ON CONFLICT, cleanup은 lease 마지막 2분에 시작하지 않고 시도를 세지 않는 release로 돌려준다. 알림 provider timeout은 lease보다 짧아야 기동한다(호출이 lease를 넘으면 lease 복구가 아직 도는 호출을 맞추기로 넘긴다). 저장소가 만드는 record 일곱은 IllegalStateException으로 거절한다. 버린 대안: 읽고 비교한 뒤 쓰기(경합이 그대로 남음), 앱 쪽 락(인스턴스 사이에서 무의미). 위험·한계: 포트 시그니처가 바뀐다(DurableOperationStorePort, RecipientLeaseStorePort.expiredDispatching, RecipientDeliveryStorePort .requeueAbandoned, CleanupQueuePort.release). owner가 없거나 fence가 0인 V4 전 DISPATCHING 행은 회복이 고르지 않는다(안내 4행에 고치는 SQL). provider timeout 검사는 필요조건일 뿐이고, 호출 전체를 묶는 것은 SES다. 검증: desktop RED(고치기 전 트리 + 새 시험, pr1-red3) 새 시험 13건 실패. GREEN은 PR 본문의 verify.sh pr·PostgreSQL lane 결과. Refs: RR9-01-02, RR9-01-04, RR9-01-06, RR9-01-12, RR9-01-13, RR9-01-23, RR9-01-24, RR9-01-29, R1 넘김 DurableOperationStoreContractTest BREAKING CHANGE: DurableOperationStorePort의 heartbeat·reportProgress·succeed·fail이 DurableOperationClaim을 받고 claimNext가 그것을 돌려준다. RecipientLeaseStorePort.expiredDispatching이 List<RecipientLease>를 돌려주고 RecipientDeliveryStorePort.requeueAbandoned, CleanupQueuePort.release가 새로 생긴다. IdempotencyReaper 생성자에서 Clock이 빠진다. 알림 provider timeout이 lease 이상이면 기동이 실패한다. 저장소가 만드는 claim·lease record가 IllegalStateException을 던진다. docs/upgrade/2026-11-round9-claim-fence.md
175 lines
13 KiB
Plaintext
175 lines
13 KiB
Plaintext
# JPA persistence 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 is implementation that has not been moved under an internal
|
|
# root yet.
|
|
# Update only after review with:
|
|
# ./gradlew :adapter:outbound:persistence-jpa:updateJpaApiSurface -PapproveJpaApiSurfaceChange
|
|
# types: 166
|
|
dev.caskeleton.adapter.outbound.persistence.api.PersistenceOperationName
|
|
dev.caskeleton.adapter.outbound.persistence.api.capability.CapabilitySupport
|
|
dev.caskeleton.adapter.outbound.persistence.api.capability.JpaCapability
|
|
dev.caskeleton.adapter.outbound.persistence.api.capability.SupportLevel
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.CheckConstraintViolationException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.ConnectionUnavailableException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.ConstraintCode
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.ConstraintViolationDetails
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.DataCorruptionException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.DeadlockDetectedException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.FailureCategory
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.ForeignKeyViolationException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.JpaEntityNotFoundException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.JpaFailureContext
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.JpaPersistenceException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.NotNullConstraintViolationException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.OptimisticConflictException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.PessimisticLockTimeoutException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.QueryTimeoutException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.SchemaMismatchException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.SerializationFailureException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.SqlExceptionSqlStateResolver
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.TransactionCompletionUnknownException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.TransactionTimeoutException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.UniqueConstraintViolationException
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.CursorPayloadCodec
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.KeysetPageRequest
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.KeysetSlice
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.NoopQueryObservation
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.QueryName
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.QueryObservation
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.QueryScope
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.SignedJsonCursorCodec
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.SortDirection
|
|
dev.caskeleton.adapter.outbound.persistence.api.transaction.TransactionCompletionEvidence
|
|
dev.caskeleton.adapter.outbound.persistence.audit.AuditContextPort
|
|
dev.caskeleton.adapter.outbound.persistence.audit.AuditableEntity
|
|
dev.caskeleton.adapter.outbound.persistence.audit.DomainContextAuditContext
|
|
dev.caskeleton.adapter.outbound.persistence.cache.CacheConcurrencyStrategy
|
|
dev.caskeleton.adapter.outbound.persistence.cache.CacheRegionCatalog
|
|
dev.caskeleton.adapter.outbound.persistence.cache.HibernateCacheGuard
|
|
dev.caskeleton.adapter.outbound.persistence.cache.HibernateCachePolicy
|
|
dev.caskeleton.adapter.outbound.persistence.cache.HibernateCacheSettings
|
|
dev.caskeleton.adapter.outbound.persistence.config.PersistenceJpaConfig
|
|
dev.caskeleton.adapter.outbound.persistence.config.PersistenceVendorSettings
|
|
dev.caskeleton.adapter.outbound.persistence.envers.EntityRevision
|
|
dev.caskeleton.adapter.outbound.persistence.envers.EnversConfigurationGuard
|
|
dev.caskeleton.adapter.outbound.persistence.envers.EnversHistoryPolicy
|
|
dev.caskeleton.adapter.outbound.persistence.envers.EnversRevisionMetadata
|
|
dev.caskeleton.adapter.outbound.persistence.envers.HibernateEnversHistoryReader
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.database.TenantDataSourceLifecycle
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.database.TenantDataSourceRegistry
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.database.TenantPoolBudget
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.replica.ConsistencyAwareDataSourceRouter
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.replica.ConsistencyToken
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.replica.ReadConsistency
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.replica.ReplicaLagMonitor
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.replica.ReplicaRoutingDecision
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.replica.ReplicaTarget
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.replica.TransactionContext
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.rls.RlsPolicyVerifier
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.rls.RlsTenantSessionBinder
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.schema.SchemaMultiTenantConnectionProvider
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.schema.SchemaTenantMigrationOrchestrator
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.schema.SchemaTenantRegistry
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.schema.TenantMigrationStatus
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.tenant.TenantAwareRepositoryGuard
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.tenant.TenantContext
|
|
dev.caskeleton.adapter.outbound.persistence.failure.PersistenceExceptionTranslator
|
|
dev.caskeleton.adapter.outbound.persistence.failure.SqlStateErrorMapping
|
|
dev.caskeleton.adapter.outbound.persistence.failure.StandardSqlStateErrorMapping
|
|
dev.caskeleton.adapter.outbound.persistence.h2.H2PersistenceConfig
|
|
dev.caskeleton.adapter.outbound.persistence.h2.H2SqlStateErrorMapping
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.HibernateProviderPolicy
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.HibernateStatisticsCollector
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.HibernateStatisticsSnapshot
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.JdbcBatchCounter
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.NamedStatementInspector
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.QueryNameContext
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.batch.BatchExecutionResult
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.batch.HibernateBatchConfigurationGuard
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.batch.HibernateJpaBatchExecutor
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.batch.JpaBatchProfile
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.bulk.AffectedRowsExpectation
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.bulk.BulkDmlResult
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.bulk.BulkOperationName
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.bulk.HibernateBulkDmlExecutor
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.stateless.HibernateStatelessSessionRunner
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.stateless.StatelessRowCapExceededException
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.stateless.StatelessWorkName
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.stateless.StatelessWorkResult
|
|
dev.caskeleton.adapter.outbound.persistence.idempotency.jpa.IdempotencyReaper
|
|
dev.caskeleton.adapter.outbound.persistence.idempotency.jpa.IdempotencyRecordJpaRepository
|
|
dev.caskeleton.adapter.outbound.persistence.idempotency.jpa.entity.IdempotencyRecordEntity
|
|
dev.caskeleton.adapter.outbound.persistence.idempotency.postgresql.IdempotencySchemaStream
|
|
dev.caskeleton.adapter.outbound.persistence.idempotency.postgresql.PostgreSqlIdempotencyStore
|
|
dev.caskeleton.adapter.outbound.persistence.liveevent.JpaLiveEventReplay
|
|
dev.caskeleton.adapter.outbound.persistence.liveevent.LiveEventJpaRepository
|
|
dev.caskeleton.adapter.outbound.persistence.liveevent.entity.LiveEventEntity
|
|
dev.caskeleton.adapter.outbound.persistence.lock.DistributedLockPersistenceConfig
|
|
dev.caskeleton.adapter.outbound.persistence.lock.LockRegistryDistributedLock
|
|
dev.caskeleton.adapter.outbound.persistence.lock.LockSettings
|
|
dev.caskeleton.adapter.outbound.persistence.migration.FlywaySchemaPolicy
|
|
dev.caskeleton.adapter.outbound.persistence.migration.SchemaManagementMode
|
|
dev.caskeleton.adapter.outbound.persistence.observation.JpaMetricTags
|
|
dev.caskeleton.adapter.outbound.persistence.observation.LowCardinality
|
|
dev.caskeleton.adapter.outbound.persistence.observation.MicrometerQueryObservation
|
|
dev.caskeleton.adapter.outbound.persistence.observation.SqlDiagnosticRedactor
|
|
dev.caskeleton.adapter.outbound.persistence.operation.DurableOperationJpaRepository
|
|
dev.caskeleton.adapter.outbound.persistence.operation.JpaDurableOperationStore
|
|
dev.caskeleton.adapter.outbound.persistence.operation.entity.DurableOperationEntity
|
|
dev.caskeleton.adapter.outbound.persistence.outbox.h2.H2OutboxClaimRepository
|
|
dev.caskeleton.adapter.outbound.persistence.outbox.jpa.JpaOutboxStore
|
|
dev.caskeleton.adapter.outbound.persistence.outbox.jpa.OutboxClaimRepository
|
|
dev.caskeleton.adapter.outbound.persistence.outbox.jpa.OutboxEventJpaRepository
|
|
dev.caskeleton.adapter.outbound.persistence.outbox.jpa.OutboxReaper
|
|
dev.caskeleton.adapter.outbound.persistence.outbox.jpa.entity.OutboxEventEntity
|
|
dev.caskeleton.adapter.outbound.persistence.outbox.postgresql.PostgreSqlOutboxClaimRepository
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.PostgreSqlPersistenceConfig
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.PostgreSqlSqlStateErrorMapping
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.array.PostgreSqlArraySupport
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.constraint.PostgreSqlConstraintCatalog
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.constraint.PostgreSqlConstraintViolationTranslator
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.copy.BoundedCopyInputStream
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.copy.CopyAdminCapability
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.copy.CopyFormat
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.copy.CopyLimits
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.copy.CopyOperationName
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.copy.CopyResult
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.copy.RegisteredCopyStatement
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.copy.RegisteredPostgreSqlCopyLoader
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.error.PostgreSqlExceptionTranslator
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.error.PostgreSqlFailureClassifier
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.error.PostgreSqlServerErrorFields
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.error.PostgreSqlState
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.json.JsonDocument
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.json.JsonDocumentCodec
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.json.JsonPathName
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.json.PostgreSqlJsonQuerySupport
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.lock.PostgreSqlLockExceptionTranslator
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.lock.PostgreSqlLockOptions
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.range.PgRange
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.range.PgRangeCodec
|
|
dev.caskeleton.adapter.outbound.persistence.querydsl.PredicatePolicy
|
|
dev.caskeleton.adapter.outbound.persistence.querydsl.QueryPage
|
|
dev.caskeleton.adapter.outbound.persistence.security.DatabasePrivilegeReport
|
|
dev.caskeleton.adapter.outbound.persistence.security.DatabaseRolePolicy
|
|
dev.caskeleton.adapter.outbound.persistence.security.PostgreSqlRuntimeRoleVerifier
|
|
dev.caskeleton.adapter.outbound.persistence.security.SearchPathPolicy
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.EntityGraphCatalog
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.FetchPlanApplier
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.FetchPlanName
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.JpaKeysetQuerySupport
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.JpaRepositoryFragmentSupport
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.JpaStreamExecutor
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.KeysetPredicateBuilder
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.KeysetSliceAssembler
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.KeysetTerm
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.RegisteredQuery
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.SafeSortField
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.SafeSortMapper
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.SafeSortRegistry
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.ScrollPolicy
|
|
dev.caskeleton.adapter.outbound.persistence.transaction.BatchedDeletes
|
|
dev.caskeleton.adapter.outbound.persistence.transaction.CallerTransaction
|
|
dev.caskeleton.adapter.outbound.persistence.transaction.SpringTransaction
|