Package com.ultikits.ultitools.config.document

Class StrictYamlPublication

java.lang.Object

com.ultikits.ultitools.config.document.StrictYamlPublication

final class StrictYamlPublication
extends Object

Complete publication only, selected solely by the opt-in YAML gate. Never opens the final target for writing. All uses are under WRITE_LOAD_LOCK. No scanning/recovery or inference of prior temporary ownership is performed.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static final class	StrictYamlPublication.Changed	A changed/deleted file or an existing creation target is not permission to write it.
private static final class	StrictYamlPublication.Metadata
private static final class	StrictYamlPublication.Opened	A close failure remains pre-commit; try-with-resources preserves an earlier failure as primary.
(package private) static interface	StrictYamlPublication.Operations
(package private) static final class	StrictYamlPublication.Refused	Policy refusal, distinguished from an I/O failure and reported once by the gate without values.
(package private) static final class	StrictYamlPublication.Target	The path/kind preflight; publication restrictions are checked only once a real edit needs staging.

Field Summary

Fields

Modifier and Type	Field	Description
private final StrictYamlPublication.Target	destination
private Object	fileKey
(package private) static final AtomicReference<StrictYamlPublication.Operations>	FILES	Filesystem seam, captured once per invocation; null selects real operations.
private static final Logger	LOGGER
private static final Set<PosixFilePermission>	NONE
private static final Set<PosixFilePermission>	PRIVATE
private static final StrictYamlPublication.Operations	REAL
private final Path	temporary
private static final Set<String>	WARNED_SYNC

Constructor Summary

Constructors

Modifier	Constructor	Description
private	StrictYamlPublication(StrictYamlPublication.Target destination, Path temporary)

Method Summary

Modifier and Type	Method	Description
private static void	checkKind(Path file, boolean creating, StrictYamlPublication.Operations files)
(package private) void	commit()	Successful atomic move is the replacement commit point; never retry with weaker semantics.
(package private) void	commitAsNewFile()	Native POSIX link's new-entry operation, not ATOMIC_MOVE used as create-if-absent.
(package private) boolean	discard(Throwable primary)	Cleanup requires current regular-file kind and the same non-null key recorded at exclusive creation.
(package private) boolean	matchesTarget()	The gate checks this before reading current bytes, immediately before publication.
(package private) static StrictYamlPublication.Target	prepare(Path file, boolean creating)	Anchors only the real parent, never lexically normalizing away a symlink followed by '..'.
private static PosixFileAttributes	requirePosix(Path path, StrictYamlPublication.Operations files)
private void	retained(String reason)
private static void	suppressCleanupFailure(Throwable primary, Throwable failure)	Throwable.addSuppressed rejects self-suppression by identity, not by an overridable equals implementation.
private void	syncDirectory()	Best effort only after commit: never imply that committed content was not published.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

FILES

static final AtomicReference<StrictYamlPublication.Operations> FILES

Filesystem seam, captured once per invocation; null selects real operations.

REAL

private static final StrictYamlPublication.Operations REAL

LOGGER

private static final Logger LOGGER

WARNED_SYNC

private static final Set<String> WARNED_SYNC

PRIVATE

private static final Set<PosixFilePermission> PRIVATE

NONE

private static final Set<PosixFilePermission> NONE

destination

private final StrictYamlPublication.Target destination

temporary

private final Path temporary

fileKey

private Object fileKey

Constructor Details

StrictYamlPublication

private StrictYamlPublication(StrictYamlPublication.Target destination,
 Path temporary)

Method Details

prepare

static StrictYamlPublication.Target prepare(Path file,
 boolean creating)
                                     throws IOException

Anchors only the real parent, never lexically normalizing away a symlink followed by '..'.

Throws:

IOException

checkKind

private static void checkKind(Path file,
 boolean creating,
 StrictYamlPublication.Operations files)
                       throws IOException

Throws:

IOException

requirePosix

private static PosixFileAttributes requirePosix(Path path,
 StrictYamlPublication.Operations files)
                                         throws IOException

Throws:

IOException

matchesTarget

boolean matchesTarget()
               throws IOException

The gate checks this before reading current bytes, immediately before publication.

Throws:

IOException

commit

void commit()
     throws IOException

Successful atomic move is the replacement commit point; never retry with weaker semantics.

Throws:

IOException

commitAsNewFile

void commitAsNewFile()
              throws IOException

Native POSIX link's new-entry operation, not ATOMIC_MOVE used as create-if-absent.

Throws:

IOException

syncDirectory

private void syncDirectory()

Best effort only after commit: never imply that committed content was not published.

discard

boolean discard(Throwable primary)

Cleanup requires current regular-file kind and the same non-null key recorded at exclusive creation.

suppressCleanupFailure

private static void suppressCleanupFailure(Throwable primary,
 Throwable failure)

Throwable.addSuppressed rejects self-suppression by identity, not by an overridable equals implementation.

retained

private void retained(String reason)