org.objectweb.jorm.naming.api
Interface PNameManager

All Superinterfaces:

PNameCoder

All Known Subinterfaces:

PBinder, PNamingContext

public interface PNameManager

extends PNameCoder

The PNameManager interface provides a means to create, remove and manage PName. It ensures that each of the names it manages unambiguously designates a particular information item (another persistent name or a binding for instance).

Author:

R. Basset, P. D?chamboux

Fields inherited from interface org.objectweb.jorm.naming.api.PNameCoder

CTBYTE, CTBYTEARRAY, CTCHAR, CTCHARARRAY, CTCOMPOSITE, CTDATE, CTINT, CTLONG, CTOBYTE, CTOCHAR, CTOINT, CTOLONG, CTOSHORT, CTSHORT, CTSTRING, CTSYSTEM

Method Summary

PName	export(java.lang.Object conn, java.lang.Object infoitem) It associates a PName to an information item within a naming context.
PName	export(java.lang.Object conn, java.lang.Object infoitem, java.lang.Object hints) It associates a PName to an information item within a naming context.
PType	getPType() Retrieves the PType associated to the JORM class which is the type of the name managed by this naming context.
void	setPType(PType pt) Assigns the PType associated to the JORM class which is the type of the name managed by this naming context.
void	unexport(java.lang.Object conn, PName pn) It removes the PName and all the associated information within a naming context (i.e., the association between the PName and its information item).

Methods inherited from interface org.objectweb.jorm.naming.api.PNameCoder

codingSupported, decode, decodeAbstract, decodeByte, decodeChar, decodeDate, decodeInt, decodeLong, decodeObyte, decodeOchar, decodeOint, decodeOlong, decodeOshort, decodeShort, decodeString, encode, encodeAbstract, encodeByte, encodeChar, encodeDate, encodeInt, encodeLong, encodeObyte, encodeOchar, encodeOint, encodeOlong, encodeOshort, encodeShort, encodeString, getNull, supportCompositeField, supportDynamicComposite, supportStaticComposite

Method Detail

export

public PName export(java.lang.Object conn,
                    java.lang.Object infoitem)
             throws PException

It associates a PName to an information item within a naming context.

Parameters:

conn - The connection that can be used to access the data store.

infoitem - The information item that must be accessible through a PName within a naming context.

Returns:

The PName associated to the given information item.

Throws:

PExceptionNaming - Raised in case of problem within the naming context.

PExceptionIO - Raised in case of problem during the access of the data store.

export

public PName export(java.lang.Object conn,
                    java.lang.Object infoitem,
                    java.lang.Object hints)
             throws PException

It associates a PName to an information item within a naming context.

Parameters:

conn - The connection that can be used to access the data store.

infoitem - The information item that must be accessible through a PName within a naming context.

hints - Any information relevant for name creation.

Returns:

The PName associated to the given information item.

Throws:

PExceptionNaming - Raised in case of problem within the naming context.

PExceptionIO - Raised in case of problem during the access of the data store.

getPType

public PType getPType()

Retrieves the PType associated to the JORM class which is the type of the name managed by this naming context.

Returns:

The related PType.

setPType

public void setPType(PType pt)

Assigns the PType associated to the JORM class which is the type of the name managed by this naming context.

Parameters:

pt - The PType of the JORM class reference managed by this naming context.

unexport

public void unexport(java.lang.Object conn,
                     PName pn)
              throws PException

It removes the PName and all the associated information within a naming context (i.e., the association between the PName and its information item).

Parameters:

conn - The connection that can be used to access the data store.

pn - A PName valid in this naming context. In case of a PBinder, export is done on a PBinding.

Throws:

PExceptionNaming - Raised in case of problem within the naming context.

PExceptionIO - Raised in case of problem during the access of the data store