org.agilewiki.jid

Class Jid

java.lang.Object

org.agilewiki.jactor.lpc.JLPCActor

org.agilewiki.jid.Jid

All Implemented Interfaces:

org.agilewiki.jactor.Actor, org.agilewiki.jactor.apc.APCRequestSource, org.agilewiki.jactor.apc.RequestProcessor, org.agilewiki.jactor.lpc.RequestSource, org.agilewiki.jactor.lpc.TargetActor, _Jid

Direct Known Subclasses:

AppJid, CollectionJid, ScalarJid

public class Jid
extends org.agilewiki.jactor.lpc.JLPCActor
implements _Jid

Base class for Incremental Deserialization Actors.

Nested Class Summary

Nested classes/interfaces inherited from class org.agilewiki.jactor.lpc.JLPCActor

org.agilewiki.jactor.lpc.JLPCActor.SMBuilder

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	serializedBytes Holds the serialized data.
protected int	serializedOffset The start of the serialized data.

Constructor Summary

Constructors

Constructor and Description
Jid()

Method Summary

Methods

Modifier and Type	Method and Description
void	change(int lengthChange) Process a change in the persistent data.
protected void	changed(int lengthChange) Notification that the persistent data has changed.
org.agilewiki.jactor.Actor	copyJID(org.agilewiki.jactor.Mailbox m) Returns a copy of the actor.
Jid	createSubordinate(org.agilewiki.jactor.factory.ActorFactory factory)
Jid	createSubordinate(org.agilewiki.jactor.factory.ActorFactory factory, org.agilewiki.jactor.Actor parent)
Jid	createSubordinate(org.agilewiki.jactor.factory.ActorFactory factory, org.agilewiki.jactor.Actor parent, byte[] bytes)
Jid	createSubordinate(org.agilewiki.jactor.factory.ActorFactory factory, org.agilewiki.jactor.Actor parent, ReadableBytes readableBytes)
Jid	createSubordinate(org.agilewiki.jactor.factory.ActorFactory factory, byte[] bytes)
Jid	createSubordinate(org.agilewiki.jactor.factory.ActorFactory factory, ReadableBytes readableBytes)
Jid	createSubordinate(String actorType)
Jid	createSubordinate(String actorType, org.agilewiki.jactor.Actor parent)
Jid	createSubordinate(String actorType, org.agilewiki.jactor.Actor parent, byte[] bytes)
Jid	createSubordinate(String actorType, org.agilewiki.jactor.Actor parent, ReadableBytes readableBytes)
Jid	createSubordinate(String actorType, byte[] bytes)
Jid	createSubordinate(String actorType, ReadableBytes readableBytes)
byte[]	getSerializedBytes() Returns a byte array holding the serialized persistent data.
int	getSerializedLength() Returns the number of bytes needed to serialize the persistent data.
void	isJidEqual(org.agilewiki.jactor.Actor actor, org.agilewiki.jactor.RP rp)
protected boolean	isSerialized() Returns true when the persistent data is already serialized.
void	load(ReadableBytes readableBytes) Load the serialized data into the JID.
protected ReadableBytes	readable() Returns a readable form of the serialized data.
_Jid	resolvePathname(String pathname) Resolves a JID pathname, returning a JID actor or null.
void	save(AppendableBytes appendableBytes) Saves the persistent data in a byte array.
protected void	serialize(AppendableBytes appendableBytes) Serialize the persistent data.
void	setContainerJid(_Jid containerJid) Assign the container.

Methods inherited from class org.agilewiki.jactor.lpc.JLPCActor

acceptEvent, acceptRequest, getActorType, getAncestor, getExceptionHandler, getFactory, getMailbox, getMailboxFactory, getMatch, getParent, hasDataItem, haveEvents, initialize, initialize, initialize, initialize, initialize, requirements, responseFrom, send, send, sendEvent, setExceptionHandler, setInitialBufferCapacity

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.agilewiki.jactor.lpc.TargetActor

setExceptionHandler

Methods inherited from interface org.agilewiki.jactor.Actor

acceptEvent, acceptRequest, getActorType, getAncestor, getFactory, getMailbox, getMatch, getParent, hasDataItem, setInitialBufferCapacity

Field Detail

serializedBytes

protected byte[] serializedBytes

Holds the serialized data.

serializedOffset

protected int serializedOffset

The start of the serialized data.

Constructor Detail

Jid

public Jid()

Method Detail

createSubordinate

public final Jid createSubordinate(org.agilewiki.jactor.factory.ActorFactory factory)
                            throws Exception

Throws:

Exception

createSubordinate

public final Jid createSubordinate(String actorType)
                            throws Exception

Throws:

Exception

createSubordinate

public final Jid createSubordinate(org.agilewiki.jactor.factory.ActorFactory factory,
                    org.agilewiki.jactor.Actor parent)
                            throws Exception

Throws:

Exception

createSubordinate

public final Jid createSubordinate(String actorType,
                    org.agilewiki.jactor.Actor parent)
                            throws Exception

Throws:

Exception

createSubordinate

public final Jid createSubordinate(org.agilewiki.jactor.factory.ActorFactory factory,
                    byte[] bytes)
                            throws Exception

Throws:

Exception

createSubordinate

public final Jid createSubordinate(String actorType,
                    byte[] bytes)
                            throws Exception

Throws:

Exception

createSubordinate

public final Jid createSubordinate(org.agilewiki.jactor.factory.ActorFactory factory,
                    org.agilewiki.jactor.Actor parent,
                    byte[] bytes)
                            throws Exception

Throws:

Exception

createSubordinate

public final Jid createSubordinate(String actorType,
                    org.agilewiki.jactor.Actor parent,
                    byte[] bytes)
                            throws Exception

Throws:

Exception

createSubordinate

public final Jid createSubordinate(org.agilewiki.jactor.factory.ActorFactory factory,
                    ReadableBytes readableBytes)
                            throws Exception

Throws:

Exception

createSubordinate

public final Jid createSubordinate(String actorType,
                    ReadableBytes readableBytes)
                            throws Exception

Throws:

Exception

createSubordinate

public final Jid createSubordinate(org.agilewiki.jactor.factory.ActorFactory factory,
                    org.agilewiki.jactor.Actor parent,
                    ReadableBytes readableBytes)
                            throws Exception

Throws:

Exception

createSubordinate

public final Jid createSubordinate(String actorType,
                    org.agilewiki.jactor.Actor parent,
                    ReadableBytes readableBytes)
                            throws Exception

Throws:

Exception

readable

protected final ReadableBytes readable()

Returns a readable form of the serialized data.

Returns:

A ReadableBytes wrapper of the serialized data.

changed

protected void changed(int lengthChange)
                throws Exception

Notification that the persistent data has changed.

Parameters:

lengthChange - The change in the size of the serialized data.

Throws:

Exception - Any uncaught exception which occurred while processing the notification.

change

public void change(int lengthChange)
            throws Exception

Process a change in the persistent data.

Specified by:

change in interface _Jid

Parameters:

lengthChange - The change in the size of the serialized data.

Throws:

Exception - Any uncaught exception which occurred while processing the change.

setContainerJid

public void setContainerJid(_Jid containerJid)

Assign the container.

Specified by:

setContainerJid in interface _Jid

Parameters:

containerJid - The container, or null.

getSerializedLength

public int getSerializedLength()
                        throws Exception

Returns the number of bytes needed to serialize the persistent data.

Specified by:

getSerializedLength in interface _Jid

Returns:

The minimum size of the byte array needed to serialize the persistent data.

Throws:

Exception

isSerialized

protected final boolean isSerialized()

Returns true when the persistent data is already serialized.

Returns:

True when the persistent data is already serialized.

serialize

protected void serialize(AppendableBytes appendableBytes)
                  throws Exception

Serialize the persistent data.

Parameters:

appendableBytes - The wrapped byte array into which the persistent data is to be serialized.

Throws:

Exception

save

public void save(AppendableBytes appendableBytes)
          throws Exception

Saves the persistent data in a byte array.

Specified by:

save in interface _Jid

Parameters:

appendableBytes - Holds the byte array and offset.

Throws:

Exception

getSerializedBytes

public final byte[] getSerializedBytes()
                                throws Exception

Returns a byte array holding the serialized persistent data.

Returns:

The byte array holding the serialized persistent data.

Throws:

Exception

load

public void load(ReadableBytes readableBytes)
          throws Exception

Load the serialized data into the JID.

Specified by:

load in interface _Jid

Parameters:

readableBytes - Holds the serialized data.

Throws:

Exception

resolvePathname

public _Jid resolvePathname(String pathname)
                     throws Exception

Resolves a JID pathname, returning a JID actor or null.

Specified by:

resolvePathname in interface _Jid

Parameters:

pathname - A JID pathname.

Returns:

A JID actor or null.

Throws:

Exception - Any uncaught exception which occurred while processing the request.

copyJID

public final org.agilewiki.jactor.Actor copyJID(org.agilewiki.jactor.Mailbox m)
                                         throws Exception

Returns a copy of the actor.

Parameters:

m - The mailbox.

Returns:

a copy of the actor.

Throws:

Exception

isJidEqual

public final void isJidEqual(org.agilewiki.jactor.Actor actor,
              org.agilewiki.jactor.RP rp)
                      throws Exception

Throws:

Exception