net.java.truevfs.kernel.spec

Annotation Type FsAssertion

@Documented
 @Inherited
 @Retention(value=SOURCE)
 @Target(value={CONSTRUCTOR,METHOD})
public @interface FsAssertion

Asserts the properties of a virtual file system operation.

As of TrueVFS 0.10, application level transactions are not supported, that is, multiple file system operations cannot get composed into a single application level transaction - support for this feature may be added in a future version.

However, individual file system operations do come with assertions about their atomicity, consistency, isolation and durability - see FsController.

Since:

TrueVFS 0.10

Author:

Christian Schlichtherle

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
FsAssertion.Level	atomic Does the operation always either completely succeed or completely fail?
FsAssertion.Level	consistent If the VFS has been in a consistent state when the operation starts, then does it always leave the VFS in a consistent state, too?
FsAssertion.Level	durable If the operation has written any data, then is the change always persisted to the top-level file system?
FsAssertion.Level	isolated Is it always impossible for other threads to see the effects of any intermediate steps of the operation?

Element Detail

atomic

public abstract FsAssertion.Level atomic

Does the operation always either completely succeed or completely fail?

Default:

net.java.truevfs.kernel.spec.FsAssertion.Level.UNDEFINED

consistent

public abstract FsAssertion.Level consistent

If the VFS has been in a consistent state when the operation starts, then does it always leave the VFS in a consistent state, too?

Default:

net.java.truevfs.kernel.spec.FsAssertion.Level.UNDEFINED

durable

public abstract FsAssertion.Level durable

If the operation has written any data, then is the change always persisted to the top-level file system?

Default:

net.java.truevfs.kernel.spec.FsAssertion.Level.UNDEFINED

isolated

public abstract FsAssertion.Level isolated

Is it always impossible for other threads to see the effects of any intermediate steps of the operation?

Default:

net.java.truevfs.kernel.spec.FsAssertion.Level.UNDEFINED