Package com.ultikits.ultitools.abstracts

Class AbstractConfigEntity.PanelWrite

java.lang.Object

com.ultikits.ultitools.abstracts.AbstractConfigEntity.PanelWrite

Enclosing class:

AbstractConfigEntity

@Internal
public final class AbstractConfigEntity.PanelWrite
extends Object

Narrow manager coordination for one staged entity; not a module transaction API.

Field Summary

Fields

Modifier and Type	Field	Description
private final AbstractConfigEntity.PanelCheckpoint	before
private final Map<Field,Object>	bound
private final List<AbstractConfigEntity.ModuleChange>	changes
private OperatorFileWriter.Result	committed
private final OperatorFileWriter.Staged	staged
private final Path	target

Constructor Summary

Constructors

Modifier	Constructor	Description
private	PanelWrite(AbstractConfigEntity.PanelCheckpoint before, List<AbstractConfigEntity.ModuleChange> changes, Path target, OperatorFileWriter.Staged staged, Map<Field,Object> bound)

Method Summary

Modifier and Type	Method	Description
void	acknowledge()	Acknowledges only after every manager-owned replacement succeeds.
void	commit()	Publishes this file through the configuration write gate only while it still holds exactly the bytes the write was verified against; a file the operator saved after staging is kept and refused.
void	discard()	Releases a staged file that has not been committed.
void	rollback()	Restores a target this write replaced to exactly the bytes it was verified against - through the gate's last-moment check, so a file the operator saved after this write replaced it is kept and named once (OperatorFileWriter.Staged.restore(), 17-65 review round 1 R65-I3) - and all entity state; always discards its staged file.

Methods inherited from class java.lang.Object

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

Field Details

before

private final AbstractConfigEntity.PanelCheckpoint before

changes

private final List<AbstractConfigEntity.ModuleChange> changes

target

private final Path target

staged

private final OperatorFileWriter.Staged staged

committed

private OperatorFileWriter.Result committed

bound

private final Map<Field,Object> bound

Constructor Details

PanelWrite

private PanelWrite(AbstractConfigEntity.PanelCheckpoint before,
 List<AbstractConfigEntity.ModuleChange> changes,
 Path target,
 OperatorFileWriter.Staged staged,
 Map<Field,Object> bound)

Method Details

commit

public void commit()
            throws IOException

Publishes this file through the configuration write gate only while it still holds exactly the bytes the write was verified against; a file the operator saved after staging is kept and refused.

Throws:

IOException - if the replacement fails, or ConfigWriteRefusedException when the file changed since it was staged (nothing was moved)

acknowledge

public void acknowledge()

Acknowledges only after every manager-owned replacement succeeds.

rollback

public void rollback()
              throws IOException

Restores a target this write replaced to exactly the bytes it was verified against - through the gate's last-moment check, so a file the operator saved after this write replaced it is kept and named once (OperatorFileWriter.Staged.restore(), 17-65 review round 1 R65-I3) - and all entity state; always discards its staged file.

Throws:

IOException - if physical recovery fails

discard

public void discard()

Releases a staged file that has not been committed.