Package com.ultikits.ultitools.utils

Class OfficialLanguageFiles.LoggingListener

java.lang.Object

com.ultikits.ultitools.utils.OfficialLanguageFiles.LoggingListener

All Implemented Interfaces:

PosixAttributePreserver.ReplaceInPlaceListener

Enclosing class:

OfficialLanguageFiles

private static final class OfficialLanguageFiles.LoggingListener
extends Object
implements PosixAttributePreserver.ReplaceInPlaceListener

Logs why a framework language file was not replaced; the file stays as it was in every case but one.

Field Summary

Fields

Modifier and Type	Field	Description
private final File	file
private final Logger	logger

Constructor Summary

Constructors

Constructor	Description
LoggingListener(File file, Logger logger)

Method Summary

Modifier and Type	Method	Description
void	onOperatorPinnedReadOnly()	target exists and none of its POSIX write-permission bits (owner, group, or other) are set for the current process -- treated as a deliberate operator hardening signal, exactly like a symlinked target.
void	onOwnershipCopyFailure(String ownerName, String groupName)	target's owner/group could not be replicated onto the staging file; the replacement is abandoned.
void	onPermissionCopyFailure()	target's permission bits were read successfully but could not be applied to the staging file; best-effort only, the replacement still proceeds.
void	onSourceAttributesUnreadable()	A POSIX view exists for target but reading its current attributes failed -- see PosixAttributePreserver.copyIfSupported(java.io.File, java.io.File, java.lang.Runnable, java.lang.Runnable, java.util.function.BiConsumer<java.lang.String, java.lang.String>)'s own javadoc for why this is distinct from "no POSIX view at all" and must also abandon the replacement.
void	onSymbolicLink()	target is a symbolic link.
void	onWriteFailure(IOException cause)	The atomic write or move itself failed (e.g.

Methods inherited from class java.lang.Object

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

Field Details

file

private final File file

logger

private final Logger logger

Constructor Details

LoggingListener

LoggingListener(File file,
 Logger logger)

Method Details

onOperatorPinnedReadOnly

public void onOperatorPinnedReadOnly()

Description copied from interface: PosixAttributePreserver.ReplaceInPlaceListener

target exists and none of its POSIX write-permission bits (owner, group, or other) are set for the current process -- treated as a deliberate operator hardening signal, exactly like a symlinked target. The replacement is refused; target is left completely untouched.

Specified by:

onOperatorPinnedReadOnly in interface PosixAttributePreserver.ReplaceInPlaceListener

onSymbolicLink

public void onSymbolicLink()

Description copied from interface: PosixAttributePreserver.ReplaceInPlaceListener

target is a symbolic link. writeBytes's pre-existing contract (see PosixAttributePreserver.replaceInPlace(java.io.File, byte[], com.ultikits.ultitools.utils.PosixAttributePreserver.ReplaceInPlaceListener)'s own javadoc) is REFUSE, not write-through-to-target: the replacement is declined entirely, exactly like an operator-pinned read-only file, rather than either replacing the link itself (which would silently break an operator-managed shared layout) or resolving and writing through to the link's target (which this shared operation does not attempt, for the same relative-vs-absolute-link and shared-target reasons writeBytes's own javadoc already gives).

Specified by:

onSymbolicLink in interface PosixAttributePreserver.ReplaceInPlaceListener

onSourceAttributesUnreadable

public void onSourceAttributesUnreadable()

Description copied from interface: PosixAttributePreserver.ReplaceInPlaceListener

A POSIX view exists for target but reading its current attributes failed -- see PosixAttributePreserver.copyIfSupported(java.io.File, java.io.File, java.lang.Runnable, java.lang.Runnable, java.util.function.BiConsumer<java.lang.String, java.lang.String>)'s own javadoc for why this is distinct from "no POSIX view at all" and must also abandon the replacement.

Specified by:

onSourceAttributesUnreadable in interface PosixAttributePreserver.ReplaceInPlaceListener

onPermissionCopyFailure

public void onPermissionCopyFailure()

Description copied from interface: PosixAttributePreserver.ReplaceInPlaceListener

target's permission bits were read successfully but could not be applied to the staging file; best-effort only, the replacement still proceeds.

Specified by:

onPermissionCopyFailure in interface PosixAttributePreserver.ReplaceInPlaceListener

onOwnershipCopyFailure

public void onOwnershipCopyFailure(String ownerName,
 String groupName)

Description copied from interface: PosixAttributePreserver.ReplaceInPlaceListener

target's owner/group could not be replicated onto the staging file; the replacement is abandoned.

Specified by:

onOwnershipCopyFailure in interface PosixAttributePreserver.ReplaceInPlaceListener

Parameters:

ownerName - the owner name target is owned by

groupName - the group name target is owned by

onWriteFailure

public void onWriteFailure(IOException cause)

Description copied from interface: PosixAttributePreserver.ReplaceInPlaceListener

The atomic write or move itself failed (e.g. the filesystem filled up mid-write, or a transient I/O error during the rename). target is guaranteed untouched -- the staging file is written and moved only after every guard above has already passed, and a failure here never truncates or partially overwrites target itself.

Specified by:

onWriteFailure in interface PosixAttributePreserver.ReplaceInPlaceListener

Parameters:

cause - the underlying IOException