Package fr.dyade.aaa.agent

Class AgentIdStamp

java.lang.Object

fr.dyade.aaa.agent.AgentIdStamp

All Implemented Interfaces:

Serializable

final class AgentIdStamp
extends Object
implements Serializable

AgentIdStamp class defines static members, variable and functions, to manage the allocation of new identifiers. It locally maintains a pair of counters, one for local agent server, one for remote agent server, keeping track of the last allocated stamp for the given target domain. Stamps are allocated in growing order and are never reused once allocated, even after agents are deleted. Some initial stamps are reserved for statically identifying system and well known services as factory. They are defined in AgentId class.

Field Summary

Fields

Modifier and Type	Field	Description
private int	local	Stamp counter for local agent server.
private int	remote	Stamp counter for remote agent server.
private static long	serialVersionUID	Define serialVersionUID for interoperability.
(package private) static AgentIdStamp	stamp	Static reference to local AgentIdStamp object.

Constructor Summary

Constructors

Constructor	Description
AgentIdStamp()

Method Summary

Modifier and Type	Method	Description
(package private) static void	init()	Initializes AgentIdStamp class.
(package private) static AgentIdStamp	load()	Restores the object state from the persistent storage.
(package private) int	newStamp(short to)	Allocates a new stamp for the target agent server.
private void	readObject(ObjectInputStream in)	The readObject is responsible for reading from the stream and restoring the classes fields.
(package private) void	save()	Saves the object state on persistent storage.
private void	writeObject(ObjectOutputStream out)	The writeObject method is responsible for writing the state of the object for its particular class so that the corresponding readObject method can restore it.

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

Define serialVersionUID for interoperability.

See Also:

Constant Field Values

stamp

static AgentIdStamp stamp

Static reference to local AgentIdStamp object.

local

private int local

Stamp counter for local agent server.

remote

private int remote

Stamp counter for remote agent server.

Constructor Detail

AgentIdStamp

AgentIdStamp()

Method Detail

init

static void init()
          throws IOException,
                 ClassNotFoundException

Initializes AgentIdStamp class.

Throws:

IOException - IO problem during loading.

ClassNotFoundException - should never happened

save

void save()
   throws IOException

Saves the object state on persistent storage.

Throws:

IOException - an error occurs.

load

static AgentIdStamp load()
                  throws IOException,
                         ClassNotFoundException

Restores the object state from the persistent storage.

Returns:

the loaded AgentIdStamp object.

Throws:

IOException - an error occurs.

ClassNotFoundException - an error occurs.

writeObject

private void writeObject(ObjectOutputStream out)
                  throws IOException

The writeObject method is responsible for writing the state of the object for its particular class so that the corresponding readObject method can restore it.

Parameters:

out - the underlying output stream.

Throws:

IOException - an error occurs.

readObject

private void readObject(ObjectInputStream in)
                 throws IOException,
                        ClassNotFoundException

The readObject is responsible for reading from the stream and restoring the classes fields.

Parameters:

in - the underlying input stream.

Throws:

IOException - an error occurs.

ClassNotFoundException - an error occurs.

newStamp

int newStamp(short to)
      throws IOException

Allocates a new stamp for the target agent server.

Parameters:

to - The target agent server

Returns:

the new allocated stamp.

Throws:

IOException - an error occurs.