|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.apache.jackrabbit.core.state.ItemState
ItemState
represents the state of an Item
.
Field Summary | |
protected ItemId |
id
|
protected ItemState |
overlayedState
|
protected String |
parentUUID
the uuid of the (primary) parent node or null if this is the root node |
protected int |
status
the internal status of this item state |
static int |
STATUS_EXISTING
'existing', i.e. |
static int |
STATUS_EXISTING_MODIFIED
'existing', i.e. |
static int |
STATUS_EXISTING_REMOVED
'existing', i.e. |
static int |
STATUS_NEW
'new' state |
static int |
STATUS_STALE_DESTROYED
'existing', i.e. |
static int |
STATUS_STALE_MODIFIED
'existing', i.e. |
static int |
STATUS_UNDEFINED
flags defining the current status of this ItemState instance |
Constructor Summary | |
protected |
ItemState(int initialStatus,
boolean isTransient)
Protected constructor |
protected |
ItemState(String parentUUID,
ItemId id,
int initialStatus,
boolean isTransient)
Protected constructor |
Method Summary | |
void |
addListener(ItemStateListener listener)
Add an ItemStateListener |
protected void |
connect(ItemState overlayedState)
Connect this state to some underlying overlayed state. |
protected void |
copy(ItemState state)
Copy state information from a state into this state |
void |
discard()
Discards this instance, i.e. |
protected void |
disconnect()
Disconnect this state from the underlying overlayed state. |
ItemId |
getId()
Returns the identifier of this item state. |
ItemState |
getOverlayedState()
Returns the persistent state backing this transient state or null if there is no persistent state (i.e.. |
String |
getParentUUID()
Returns the UUID of the parent NodeState or null
if either this item state represents the root node or this item state is
'free floating', i.e. |
int |
getStatus()
Returns the status of this item. |
boolean |
hasOverlayedState()
Determines if this item state is overlying persistent state. |
abstract boolean |
isNode()
Determines if this item state represents a node. |
boolean |
isStale()
Determines whether this item state has become stale. |
boolean |
isTransient()
Returns true if this item state represents new or modified
state (i.e. |
protected void |
notifyStateCreated()
Notify the listeners that the persistent state this object is representing has been created. |
protected void |
notifyStateDestroyed()
Notify the listeners that the persistent state this object is representing has been destroyed. |
protected void |
notifyStateDiscarded()
Notify the listeners that the persistent state this object is representing has been discarded. |
void |
notifyStateUpdated()
Notify the listeners that the persistent state this object is representing has been updated. |
protected void |
reconnect()
Reconnect this state to the overlayed state that it has been disconnected from earlier. |
void |
removeListener(ItemStateListener listener)
Remove an ItemStateListener |
void |
setParentUUID(String parentUUID)
Sets the UUID of the parent NodeState . |
void |
setStatus(int newStatus)
Sets the new status of this item. |
void |
stateCreated(ItemState created)
Called when an ItemState has successfully
been created (i.e. its underlying persistent state was created). |
void |
stateDestroyed(ItemState destroyed)
Called when an ItemState has successfully been
removed (i.e. its underlying persistent state has been destroyed). |
void |
stateDiscarded(ItemState discarded)
Called when an ItemState has been discarded (i.e. it has
been rendered 'invalid'). |
void |
stateModified(ItemState modified)
Called when an ItemState has successfully
been modified (i.e. its underlying persistent state has changed). |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final int STATUS_UNDEFINED
ItemState
instance
public static final int STATUS_EXISTING
public static final int STATUS_EXISTING_MODIFIED
public static final int STATUS_EXISTING_REMOVED
public static final int STATUS_NEW
public static final int STATUS_STALE_MODIFIED
public static final int STATUS_STALE_DESTROYED
protected int status
protected String parentUUID
null
if this is the root node
protected ItemId id
protected transient ItemState overlayedState
Constructor Detail |
protected ItemState(String parentUUID, ItemId id, int initialStatus, boolean isTransient)
parentUUID
- the UUID of the (primary) parent node or null
id
- the id of the item state objectinitialStatus
- the initial status of the item state objectisTransient
- flag indicating whether this state is transient or notprotected ItemState(int initialStatus, boolean isTransient)
initialStatus
- the initial status of the new ItemState
instanceisTransient
- flag indicating whether this state is transient or notMethod Detail |
protected void copy(ItemState state)
state
- source state informationprotected void connect(ItemState overlayedState)
protected void reconnect()
protected void disconnect()
protected void notifyStateDiscarded()
protected void notifyStateCreated()
public void notifyStateUpdated()
protected void notifyStateDestroyed()
public abstract boolean isNode()
public ItemId getId()
public boolean isTransient()
true
if this item state represents new or modified
state (i.e. the result of copy-on-write) or false
if it
represents existing, unmodified state.
true
if this item state is modified or new,
otherwise false
public boolean isStale()
public String getParentUUID()
NodeState
or null
if either this item state represents the root node or this item state is
'free floating', i.e. not attached to the repository's hierarchy.
NodeState
's UUIDpublic void setParentUUID(String parentUUID)
NodeState
.
parentUUID
- the parent NodeState
's UUID or null
if either this item state should represent the root node or this item state
should be 'free floating', i.e. detached from the repository's hierarchy.public int getStatus()
public void setStatus(int newStatus)
newStatus
- the new statuspublic void discard()
public boolean hasOverlayedState()
true
if this item state is overlying persistent
state, otherwise false
.public ItemState getOverlayedState()
null
if there is no persistent state (i.e.. this
state is purely transient).
null
if there is
no persistent state.public void addListener(ItemStateListener listener)
ItemStateListener
listener
- the new listener to be informed on modificationspublic void removeListener(ItemStateListener listener)
ItemStateListener
listener
- an existing listenerpublic void stateCreated(ItemState created)
ItemState
has successfully
been created (i.e. its underlying persistent state was created).
stateCreated
in interface ItemStateListener
created
- the ItemState
that has been 'created'public void stateDestroyed(ItemState destroyed)
ItemState
has successfully been
removed (i.e. its underlying persistent state has been destroyed).
stateDestroyed
in interface ItemStateListener
destroyed
- the ItemState
that has been 'destroyed'public void stateModified(ItemState modified)
ItemState
has successfully
been modified (i.e. its underlying persistent state has changed).
stateModified
in interface ItemStateListener
modified
- the ItemState
that has been 'modified'public void stateDiscarded(ItemState discarded)
ItemState
has been discarded (i.e. it has
been rendered 'invalid').
stateDiscarded
in interface ItemStateListener
discarded
- the ItemState
that has been discardeddiscard()
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |