Package com.ultikits.ultitools.manager

Class RemoteFileOperations.WriteDenial

java.lang.Object

com.ultikits.ultitools.manager.RemoteFileOperations.WriteDenial

All Implemented Interfaces:

PosixAttributePreserver.ReplaceInPlaceListener

Enclosing class:

RemoteFileOperations

private static final class RemoteFileOperations.WriteDenial
extends Object
implements PosixAttributePreserver.ReplaceInPlaceListener

Collects why PosixAttributePreserver.replaceInPlace(java.io.File, byte[], com.ultikits.ultitools.utils.PosixAttributePreserver.ReplaceInPlaceListener) declined the replacement. A permission-copy failure is not a refusal — the shared operation still proceeds — so it leaves the reason unset.

Field Summary

Fields

Modifier and Type	Field	Description
private String	reason

Constructor Summary

Constructors

Modifier	Constructor	Description
private	WriteDenial()

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.
private String	reason()

Methods inherited from class java.lang.Object

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

Field Details

reason

private String reason

Constructor Details

WriteDenial

private WriteDenial()

Method Details

reason

private String reason()

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