org.entityfs.cap.symlink
Interface SymbolicLinkView

All Superinterfaces:

Comparable<EntityView>, Deletable, EntityAcceptingEntityView<SymbolicLinkView>, EntityHolder, EntityView, Lockable, Named, Observable, ReadLockable, ReadWriteLockable, ViewCapable<SymbolicLinkView>, WriteLockable

All Known Subinterfaces:

SymbolicLink, SymbolicLinkImplementation, SymbolicLinkViewImplementation

All Known Implementing Classes:

SymbolicLinkImpl, SymbolicLinkViewImpl

public interface SymbolicLinkView
extends EntityAcceptingEntityView<SymbolicLinkView>

A SymbolicLinkView is a view of a SymbolicLink that uses a Filter to determine which child entities that are visible.

The last modification time of a symbolic link is the last modification time of the entity that it points to.

A SymbolicLinkView is Observable for updates. It can send the following events:

• EntityDeletedEvent — the symbolic link was deleted.
• EntityRenamedEvent — the symbolic link was renamed and/or moved.
• NewEntityEvent — the symbolic link was created. This event can only be received from a file system observer since it is sent before a client can register an observer on the symbolic link. (Unless the event manager is paused; see the developer documentation for more on that.)

When registering an EntityObserver on a view rather on an entity, the view puts itself as the sender of the events. If the events contain child entities (is a ChildEntitiesEvent), all included child entities are filtered and views with the same filter rules as the observed view are created for view-capable child entities.

Read more about views in the EntityView documentation.

Since:

1.0

Author:

Karl Gustafsson

See Also:

SymbolicLinks, DCSymbolicLinkUtil, EntityView

In_jar:

entityfs-symlink

Method Summary

EntityLocation<?>

getTargetLocation() Get the target location.

Methods inherited from interface org.entityfs.EntityAcceptingEntityView

canBeDereferenced, dereferenceOrNull

Methods inherited from interface org.entityfs.EntityView

canRead, canWrite, copy, copy, copyAttributes, createLock, disconnect, getCapability, getFileSystem, getLastModified, getParent, getType, getViewed, getViewedEntity, isConnected, isRootDirectory, isValid, lock, rename, setLastModified, supportsCapability, touch

Methods inherited from interface java.lang.Comparable

compareTo

Methods inherited from interface org.entityfs.event.Observable

addObserver, countObservers, deleteObserver, deleteObservers

Methods inherited from interface org.entityfs.Named

getName

Methods inherited from interface org.entityfs.lock.ReadLockable

getReadLock, isReadLockedByCurrentThread, lockForReading

Methods inherited from interface org.entityfs.Deletable

delete, isDeleted

Methods inherited from interface org.entityfs.lock.WriteLockable

getWriteLock, isWriteLockedByCurrentThread, lockForWriting

Methods inherited from interface org.entityfs.ViewCapable

getFilter, hasFilters, newView

Methods inherited from interface org.entityfs.EntityHolder

containsEntity, containsEntity, getEntityOrNull

Method Detail

getTargetLocation

EntityLocation<?> getTargetLocation()

Get the target location. For an absolute symbolic link, this is an AbsoluteLocation. For a relative symbolic link, it is a RelativeLocation.

Returns:

The location of the target.

Locks_required:

A read lock on the symbolic link.

Permissions_required:

Execute access.