oracle.odi.domain.runtime.session

Class OdiSessionFolder

java.lang.Object

oracle.odi.domain.support.BusinessObject

oracle.odi.domain.support.AbstractRepositoryEntity

oracle.odi.domain.support.AbstractOdiEntity

oracle.odi.domain.runtime.session.OdiSessionFolder

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, IOdiEntity, IRepositoryEntity, IWorkRuntimeOdiEntity

public class OdiSessionFolder
extends oracle.odi.domain.support.AbstractOdiEntity
implements IWorkRuntimeOdiEntity

An OdiSessionFolder is used to group OdiSession using predefined Keywords. Contrary to other types of folder in ODI, an OdiSessionFolder doesn't contain objects (i.e. OdiSessions). It is made of a collection of keywords that can be used to filter sessions that have been started / created with some keywords matching all the OdiSessionFolder's keywords.

Therefore, it is the only entity inside OdiSessionFolder aggregate, thus is the root. It is identified by a unique session folder ID that can be obtained from getSessionFolderId() method call. equals / hashCode methods are implemented according this identity.

Life cycle of an OdiSessionFolder begins when it is created in runtime repository. Some keywords can then be assigned to the OdiSessionFolder. Life cycle ends when the OdiSessionFolder is removed from runtime repository.

Since:

11.1.1.3.0

See Also:

OdiSession, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	KEYWORDS_MAX_TOTAL_LENGTH Maximum total length of an OdiSessionFolder's keywords.
static int	NAME_MAX_LENGTH Maximum length of an OdiSessionFolder's name.

Fields inherited from class oracle.odi.domain.support.AbstractOdiEntity

STARTING_INTERNAL_VERSION

Constructor Summary

Constructors

Constructor and Description
OdiSessionFolder(java.lang.String pName) Constructs a new OdiSessionFolder, specified by name.

Method Summary

Methods

Modifier and Type	Method and Description
java.io.Serializable	getInternalId() Provides a common getter for the persistence layer to obtain an identity, irrespective of the actual type of identity used.
java.lang.String[]	getKeywords() Returns keywords elements that are defined for this OdiSessionFolder.
java.lang.String	getName() Returns the name of this OdiSessionFolder instance.
IRepositoryEntity	getSecurityContainer() Define a generic way to retrieve container for entities.
java.lang.Number	getSessionFolderId() Returns id of this OdiSessionFolder instance.
java.util.Collection	getSessions(IOdiSessionFinder pFinder) Obtains an unmodifiable collection of OdiSessions matching this OdiSessionFolder's keywords.
void	setKeywords(java.lang.String[] pKeywords) Sets keywords for this OdiSessionFolder.
void	setName(java.lang.String pName) Sets name of this OdiSessionFolder.

Methods inherited from class oracle.odi.domain.support.AbstractOdiEntity

equals, getFirstDate, getFirstUser, getInternalVersion, getLastDate, getLastUser, hashCode, isInstanceLevelSecurityNeeded, isNew, preCommit, toString

Methods inherited from class oracle.odi.domain.support.AbstractRepositoryEntity

getGlobalId, getNumericId, hasCustomizedPersistenceMethodFor, invokeCustomizedPersistenceMethodFor

Methods inherited from class oracle.odi.domain.support.BusinessObject

clone

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface oracle.odi.domain.IOdiEntity

getFirstDate, getFirstUser, getLastDate, getLastUser, isInstanceLevelSecurityNeeded

Methods inherited from interface oracle.odi.domain.IRepositoryEntity

getGlobalId

Field Detail

NAME_MAX_LENGTH

public static final int NAME_MAX_LENGTH

Maximum length of an OdiSessionFolder's name.

Since:

11.1.1.5.0

See Also:

Constant Field Values

KEYWORDS_MAX_TOTAL_LENGTH

public static final int KEYWORDS_MAX_TOTAL_LENGTH

Maximum total length of an OdiSessionFolder's keywords.

Since:

11.1.1.5.0

See Also:

Constant Field Values

Constructor Detail

OdiSessionFolder

public OdiSessionFolder(java.lang.String pName)

Constructs a new OdiSessionFolder, specified by name.

Parameters:

pName - - OdiSessionFolder's name

Throws:

DomainRuntimeException - if pName is null, empty or longer than 400

Since:

11.1.1.5.0

Method Detail

getSessionFolderId

public java.lang.Number getSessionFolderId()

Returns id of this OdiSessionFolder instance.

Returns:

id of this OdiSessionFolder instance.

getName

public java.lang.String getName()

Returns the name of this OdiSessionFolder instance.

Specified by:

getName in interface IOdiEntity

Overrides:

getName in class oracle.odi.domain.support.AbstractOdiEntity

Returns:

the name of this OdiSessionFolder instance.

getKeywords

public java.lang.String[] getKeywords()

Returns keywords elements that are defined for this OdiSessionFolder.

Returns:

keywords elements that are defined for this OdiSessionFolder.

getSessions

public java.util.Collection getSessions(IOdiSessionFinder pFinder)

Obtains an unmodifiable collection of OdiSessions matching this OdiSessionFolder's keywords.

Parameters:

pFinder - finder for OdiSession

Returns:

an unmodifiable collection of OdiSessions matching this OdiSessionFolder's keywords.

getInternalId

public java.io.Serializable getInternalId()

Description copied from interface: IRepositoryEntity

Provides a common getter for the persistence layer to obtain an identity, irrespective of the actual type of identity used.

Typically a subclass will delegate to a public SomePrimitiveWrapper getId() method. The necessity for the getInternalId() abstract method is solely because the persistence layer needs a way of obtaining the identity irrespective of the actual identity implementation choice.

Returning null from this method will indicate the object has never been saved. This will likely be relied on by some DAO implementations.

Specified by:

getInternalId in interface IRepositoryEntity

Returns:

the persistence identity of this instance

getSecurityContainer

public IRepositoryEntity getSecurityContainer()

Description copied from interface: IRepositoryEntity

Define a generic way to retrieve container for entities.

Specified by:

getSecurityContainer in interface IRepositoryEntity

Returns:

container entity

setName

public void setName(java.lang.String pName)

Sets name of this OdiSessionFolder.

Parameters:

pName - - name

Throws:

DomainRuntimeException - if pName is null, empty or longer than 400

Since:

11.1.1.5.0

setKeywords

public void setKeywords(java.lang.String[] pKeywords)

Sets keywords for this OdiSessionFolder.

Parameters:

pKeywords - array of string keywords

Throws:

DomainRuntimeException - if total length of keywords is greater than 250

Since:

11.1.1.5.0