oracle.odi.domain.topology

Class OdiContext

java.lang.Object

oracle.odi.domain.support.BusinessObject

oracle.odi.domain.support.AbstractRepositoryEntity

oracle.odi.domain.support.AbstractOdiEntity

oracle.odi.domain.topology.OdiContext

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, oracle.odi.core.audit.support.IAuditableFirstClassObject, IFlexFieldUser, IModelObject, IModelObjectBase, IContext, IMasterOdiEntity, oracle.odi.domain.impexp.IExportable, IOdiEntity, IRepositoryEntity, oracle.odi.impexp.smartie.ISmartExportable

public class OdiContext
extends oracle.odi.domain.support.AbstractOdiEntity
implements IContext, IFlexFieldUser, IMasterOdiEntity, oracle.odi.domain.impexp.IExportable, oracle.odi.impexp.smartie.ISmartExportable, oracle.odi.core.audit.support.IAuditableFirstClassObject

An ODI Context.

This class doesn't provides any method to manage mapping between physical schema and logical schema. It only permit to define a context in the ODI topology. Such OdiContext can then be used to map schemas using the class OdiContextualSchemaMapping.

Since:

11.1.1.3.0

See Also:

OdiPhysicalSchema, OdiLogicalSchema, OdiContextualSchemaMapping, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	CODE_MAX_LENGTH Max length of context code.
static int	NAME_MAX_LENGTH Max length of context name.

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

STARTING_INTERNAL_VERSION

Constructor Summary

Constructors

Constructor and Description
OdiContext(java.lang.String pCode) Create a new OdiContext with given code.
OdiContext(java.lang.String pName, java.lang.String pCode) Create a new OdiContext with given name and code.

Method Summary

Modifier and Type	Method and Description
void	changePassword(char[] pOldPassword, char[] pNewPassword, OdiInstance pOdiInstance) Method verifies if pOldPassword equals current password set for this context or if it wasn't previously set and updates the context's password to pNewPassword if checks passed.
java.lang.String	getCode() Returns this OdiContext's code.
java.lang.Number	getContextId() Returns the Internal Context ID.
java.util.Collection	getFlexFieldsValues() Obtains flex fields values related to this IFlexFieldUser.
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	getName() Returns the Context Name.
void	initFlexFields(IOdiFlexFieldFinder pOdiFlexFieldFinder) Initialize flex fields related to this IFlexFieldUser.
boolean	isDefaultContext() Returns whether this OdiContext has been defined as default OdiContext, or not.
boolean	isInstanceLevelSecurityNeeded() Internal: this method is for internal purpose and must not be considered as part of the public API.
void	setName(java.lang.String pName) Sets the Context Name.
boolean	verifyPassword(char[] pPassword, OdiInstance pOdiInstance) Verifies if password provided matches context's current password.

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

getFirstDate, getFirstUser, getInternalVersion, getLastDate, getLastUser, isNew, preCommit, toString

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

equals, getBigNumericId, getGlobalId, getNumericId, getParent, hashCode

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.adapter.IModelObjectBase

getBigNumericId, getGlobalId, getNumericId

Methods inherited from interface oracle.odi.domain.IOdiEntity

getFirstDate, getFirstUser, getLastDate, getLastUser

Methods inherited from interface oracle.odi.domain.IRepositoryEntity

getGlobalId, getParent

Field Detail

CODE_MAX_LENGTH

public static final int CODE_MAX_LENGTH

Max length of context code.

See Also:

Constant Field Values

NAME_MAX_LENGTH

public static final int NAME_MAX_LENGTH

Max length of context name.

See Also:

Constant Field Values

Constructor Detail

OdiContext

public OdiContext(java.lang.String pCode)

Create a new OdiContext with given code.

This constructor also defines the context's name with that code value as a default name value for this OdiContext.

Parameters:

pCode - the context's code

OdiContext

public OdiContext(java.lang.String pName,
                  java.lang.String pCode)

Create a new OdiContext with given name and code.

Parameters:

pName - context's name

pCode - context's code

Method Detail

getContextId

public java.lang.Number getContextId()

Returns the Internal Context ID.

Returns:

context id

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

isInstanceLevelSecurityNeeded

public boolean isInstanceLevelSecurityNeeded()

Description copied from interface: IOdiEntity

Internal: this method is for internal purpose and must not be considered as part of the public API.

Defines a method to capture the info on which object needs instance level privilege.

Specified by:

isInstanceLevelSecurityNeeded in interface IOdiEntity

Overrides:

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

Returns:

true if instance level security needed, false otherwise

getCode

public java.lang.String getCode()

Returns this OdiContext's code.

Specified by:

getCode in interface IContext

Returns:

context code

isDefaultContext

public boolean isDefaultContext()

Returns whether this OdiContext has been defined as default OdiContext, or not.

Returns:

true if this is the default context, false otherwise

getName

public java.lang.String getName()

Returns the Context Name.

Specified by:

getName in interface IFlexFieldUser

Specified by:

getName in interface IModelObject

Specified by:

getName in interface IContext

Specified by:

getName in interface IOdiEntity

Overrides:

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

Returns:

this context name

See Also:

setName(String)

setName

public void setName(java.lang.String pName)

Sets the Context Name.

Parameters:

pName - context name

Throws:

DomainRuntimeException - if name is null, empty or longer than 35

See Also:

getName()

getFlexFieldsValues

public java.util.Collection getFlexFieldsValues()

Description copied from interface: IFlexFieldUser

Obtains flex fields values related to this IFlexFieldUser. In most implementations method IFlexFieldUser.initFlexFields(IOdiFlexFieldFinder) should be called before calling this method.

Specified by:

getFlexFieldsValues in interface IFlexFieldUser

Returns:

an unmodifiable Collection of flex field values

initFlexFields

public void initFlexFields(IOdiFlexFieldFinder pOdiFlexFieldFinder)

Description copied from interface: IFlexFieldUser

Initialize flex fields related to this IFlexFieldUser.

Specified by:

initFlexFields in interface IFlexFieldUser

Parameters:

pOdiFlexFieldFinder - OdiFlexField finder to be used to query flex fields

changePassword

public void changePassword(char[] pOldPassword,
                           char[] pNewPassword,
                           OdiInstance pOdiInstance)

Method verifies if pOldPassword equals current password set for this context or if it wasn't previously set and updates the context's password to pNewPassword if checks passed.

Parameters:

pOldPassword - unencrypted password set for this context, null or empty array in case the context wasn't password protected

pNewPassword - new password to set, null or empty array to remove password

pOdiInstance - the password encryption in 12.1.3 is AES which is dependent on odi instance

verifyPassword

public boolean verifyPassword(char[] pPassword,
                              OdiInstance pOdiInstance)

Verifies if password provided matches context's current password.

Parameters:

pPassword - password to compare current one with.

pOdiInstance - needed for password encryption and decryption since in 12.1.3 encryption and decryption is OdiInstnace dependent.

Returns:

true if passwords match, false otherwise.