org.melati.poem

Interface Initialiser

public interface Initialiser

A piece of code for initialising a newly created Persistent object in a POEM Table. Much like a Java constructor. You will probably want to define these as anonymous classes.

Author:

WilliamC At paneris.org

See Also:

Table.create(org.melati.poem.Initialiser)

Method Summary

Modifier and Type	Method and Description
void	init(Persistent object) Initialise a freshly generated POEM object.

Method Detail

init

void init(Persistent object)
   throws AccessPoemException,
          ValidationPoemException

Initialise a freshly generated POEM object.

Parameters:

object - A Persistent representing the new object, or, if the table was defined in the DSD under the name foo, an application-specialised subclass Foo of Persistent. You should call its setRaw and/or setCooked methods to get it into a state which is (a) legal, in that all its fields have valid values, and (b) writeable by you (the AccessToken of the calling thread).

Throws:

AccessPoemException - you will not provoke an AccessPoemException during initialisation (while this method is running) unless the application-specialised Persistent throws one explicitly, because POEM's standard checks are disabled; however, after this method returns, the object you have initialised will be checked to ensure that you have write access to it

ValidationPoemException

See Also:

PoemThread.accessToken(), Table.create(org.melati.poem.Initialiser)