Interface OAuthAuthorizationServerStore
Application-owned authoritative issuer persistence. Implementations must be safe across callers and nodes.
Reads are linearizable; commits atomically check every condition before applying all mutations and return
a contextual COMMITTED receipt only after durability under the application's deployment contract. CONFLICT has zero effects;
a lost connection with uncertain outcome returns UNKNOWN, never a guessed conflict or success.
Condition-only commits are required atomic read-set barriers. TIMED commits validate fresh authority time
after all waits and exact predicates, lower/upper bounds before capacity or mutation. FENCE_ONLY is
restricted to the transaction type's two existing permanent-fence epoch transitions. Reads and failed
writes perform no cleanup. Missing established roots cannot be recreated as a fresh namespace.
All time and admission facts are backend-owned; no worker clock fallback is permitted. No callback executes inside a transaction.
Providers honor the remaining budget and preserve permanent fences and retained replay tombstones:
capacity pressure rejects work rather than evicting active records. Revetsec cannot forcibly preempt
blocked application code. This interface supplies no database, durability or rollback detection by itself.
- Since:
- 1.0.0
- Author:
- Mark Allen
-
Method Summary
Modifier and TypeMethodDescriptioncommit(@NonNull OAuthStoreTransaction transaction, @NonNull Duration remainingBudget) Atomically checks the complete predicate set and applies the complete mutation set.read(@NonNull OAuthStoreKey key, @NonNull Duration remainingBudget) Reads an authoritative entry or confirmed absence with coherent admitted time, preserving every transport field exactly.
-
Method Details
-
read
Reads an authoritative entry or confirmed absence with coherent admitted time, preserving every transport field exactly. Infrastructure failure is unavailable, never translated into absence. Do not include record data in diagnostics.- Parameters:
key- the exact addressremainingBudget- the remaining positive operation budget- Returns:
- the coherent available, fenced or unavailable observation
- Since:
- 1.0.0
-
commit
@NonNull OAuthStoreCommitReceipt commit(@NonNull OAuthStoreTransaction transaction, @NonNull Duration remainingBudget) Atomically checks the complete predicate set and applies the complete mutation set. Zero mutations still checks all predicates at one linearization point. Never partially apply writes.- Parameters:
transaction- the immutable engine-created transactionremainingBudget- the remaining positive operation budget- Returns:
- the actual durable, conflict or uncertain outcome
- Since:
- 1.0.0
-