org.objectweb.jorm.naming.api
Interface PNameManager

All Superinterfaces:
PNameCoder
All Known Subinterfaces:
FilteredPNamingContext, KeyFilteredNamingContext, PBinder, PNamingContext, PolymorphicPNamingContext

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

Field Summary
 
Fields inherited from interface org.objectweb.jorm.naming.api.PNameCoder
CTBIGDECIMAL, CTBIGINTEGER, 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.
 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).
 void unexport(java.lang.Object conn, PName pn, java.lang.Object hints)
          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, decodeBigDecimal, decodeBigInteger, decodeByte, decodeChar, decodeCharArray, decodeDate, decodeInt, decodeLong, decodeObyte, decodeOchar, decodeOint, decodeOlong, decodeOshort, decodeShort, decodeString, encode, encodeAbstract, encodeBigDecimal, encodeBigInteger, encodeByte, encodeChar, encodeCharArray, encodeDate, encodeInt, encodeLong, encodeObyte, encodeOchar, encodeOint, encodeOlong, encodeOshort, encodeShort, encodeString, getNull, getPType, setNullPName, setPType, 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.
PException

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.
PException

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
PException

unexport

public void unexport(java.lang.Object conn,
                     PName pn,
                     java.lang.Object hints)
              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.
hints - Any information relevant for name removing.
Throws:
PExceptionNaming - Raised in case of problem within the naming context.
PExceptionIO - Raised in case of problem during the access of the data store
PException