oracle.jbo.server

Class CodeSourceImpl

java.lang.Object

oracle.jbo.common.NamedObjectImpl

oracle.jbo.mom.DefinitionObject

oracle.jbo.mom.PersistableDefObject

oracle.jbo.server.CodeSourceImpl

All Implemented Interfaces:

DiffMergeable, DefPersistable, PersistentDefinition, ExprCodeSource

public class CodeSourceImpl
extends PersistableDefObject
implements ExprCodeSource

Since:

release specific (what release of product did this appear in)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	CodeSourceImpl.MethodSource

Nested classes/interfaces inherited from class oracle.jbo.mom.PersistableDefObject

PersistableDefObject.CustomizationType, PersistableDefObject.PersonalizationType

Nested classes/interfaces inherited from interface oracle.jbo.script.ExprCodeSource

ExprCodeSource.Type

Field Summary

Fields inherited from class oracle.jbo.mom.PersistableDefObject

mEditedProperties, mEditedPropertyExprs

Fields inherited from class oracle.jbo.mom.DefinitionObject

DEF_MDS_CLIENT_KEY, DEF_SCOPE_ALL, DEF_SCOPE_PERS, DEF_SCOPE_SESSION, DEF_SCOPE_SHARED, DEF_SCOPE_SITE, DEF_SCOPE_USER, mBaseDefObject, mExtendedDefObjects, mObjectResolved, PERSDEF_MDS_CLIENT_KEY, PROPERTY_EXPRMAP

Fields inherited from class oracle.jbo.common.NamedObjectImpl

mFullName, mObjName, mParent, mProperties, RES_ID_SUFFIX, RESID_SUFFIX

Fields inherited from interface oracle.jbo.script.ExprCodeSource

DEFAULT_CODE_SOURCE_NAME, DYNAMIC_CODE_SOURCE_NAME, mLogger, PERSONALIZED_CODE_SOURCE_NAME, TMP_CODE_SOURCE_NAME

Fields inherited from interface oracle.jbo.mom.xml.DefPersistable

XML_STATEMENT

Method Summary

Modifier and Type	Method and Description
boolean	addExpression(ExprDef exprDef)
void	applyDiffChildren(DifferDetails dif, DiffResolver resolver) Applies changes to children defs.
CodeSourceImpl.MethodSource	createMethodSource(java.lang.String name, java.util.List<java.lang.String> statements, int lineNumber, int lastLineNumber, int columnNumber, int lastColumnNumber)
DifferDetails	diffChildren(DiffMergeable docDef, DiffMergeable orgDef, DifferDetails difDetails) Performs diff of children defs.
java.lang.Object	getCacheKey() The key that should be used to cache the byte code that is generated for the code source.
java.lang.String	getClassName() The name of the class that will be generated by the compiler for the code source.
java.lang.String	getContentType()
java.lang.String	getDefXMLElementTag()
java.lang.String	getDefXMLNameSpace()
java.lang.String	getExpressionSource(ExprDef exprDef)
java.io.Reader	getScriptReader()
java.lang.String	getScriptText()
ExprCodeSource.Type	getType()
java.lang.String	getXMLElementTag() Returns a piece of static info for the type of object this is invoked upon.
boolean	hasExpression(ExprDef exprDef) Return true if the CodeSource defines an expression for the specified expresmion.
static CodeSourceImpl	loadFromXML(DefElement xmlElement)
void	loadXMLContents(DefElement xmlElement, java.lang.String fullName)
ExprDef	lookupExprDef(OwnerType type, java.lang.String path)
boolean	removeExpression(ExprDef exprDef)
void	setParent(NamedObjectImpl parent) Sets this object's parent.
void	writeChildren(DefWriter jos) Writes the Object's children to the Persistent storage
void	writeContents(DefWriter jos) Objects should write their persistence output in this method

Methods inherited from class oracle.jbo.mom.PersistableDefObject

addDefImport, addExtendedDefObject, addSavedDocName, adjustPropertyMapForWrite, allocatePropertyMap, allocatePropertyMapForEdits, applyDiffContents, beginDiffObjects, checkEditable, checkStructWithOld, close, createFromXML, deregisterDefObject, deregisterSessionObject, diffContents, diffObjects, ensureDifferDetails, findDefImport, finishedLoading, getBaseDir, getBasePackage, getDefImports, getDefManager, getDefTypeName, getDefWriter, getEditedPropertiesMap, getEditedPropertyExpressionsMap, getEditedPropertyMap, getEditObject, getEditVersionsAsString, getExtendedDefObjectsInternal, getFileName, getFullDirName, getFullFileName, getMajorVersion, getMergeableFullName, getMergeableName, getMinorVersion, getOrigObject, getPropertyMap, getSavedDocNames, getSessionSyncLock, getSubstitutedNames, getSyncLock, guaranteePath, hasExtendedDefObjects, includeCustomizationLayerInfo, isCustomizationEnabled, isCustomizationEnabled, isDirty, isEditable, isFromTip, isLoadBase, isMajorVersionChanged, isMinorVersionChanged, isNew, isPersonalizationEnabled, isPersonalizationEnabled, isPropertyExpression, loadDefImports, loadDefObject, loadXMLContentsNoResolve, lockDefinitionContext, mergeChanges, mergePropertyMap, objectRemoved, reapplyChanges, registerClass, registerDefObject, registerSessionDefObject, registerSiteDefObject, remove, removeAndDelete, removeDefImport, removeExtendedDefObject, removeProperty, saveXMLContents, setCustomizationEnabled, setCustomizationEnabled, setDefaultBaseDir, setDefMgr, setDirty, setEditable, setEditableFlag, setEditableObject, setFullName, setFullNameInternal, setLoadBase, setMajorVersionChanged, setNew, setOrigObject, setPersonalizationEnabled, setPersonalizationEnabled, setProperty, setPropertyExpression, setPropertyMap, setupDefWriterFromMO, staticUpdateChildrenList, unlockDefinitionContext, updateChildrenList, updateMdsKeyFromTip, verifyVersion, verifyVersionNullCheck, writeHeaderForNew, writeObject, writeVersion, writeXMLContents

Methods inherited from class oracle.jbo.mom.DefinitionObject

addPropertySetName, enableUpdateCheck, getAllExtendedDefObjects, getBaseDefObject, getContainerDef, getContainerName, getDefinitionState, getDefScope, getExtendedDefObjects, getMdsKey, getMdsReference, getPropertySetName, getPropertySetNames, getRootBaseDefObject, isBaseDefFor, isComponentDefinition, isDeprecated, isDynamicDefinitionObject, isObjectResolved, isSubtypeOf, isSuppressUpdateCheck, loadCustomProperties, loadProperties, loadPropertiesInMap, loadPropertySetNames, loadSchemaProperties, resolveReferences, setBaseDefObject, setBaseDefObject, setDefScope, setMdsKey, setMdsReference, setName, setObjectResolved, setPropertySetName, staticLoadCustomProperties, staticLoadSchemaProperties, suppressUpdateCheck

Methods inherited from class oracle.jbo.common.NamedObjectImpl

getAllProperties, getFullName, getName, getParent, getProperties, getPropertiesAsStrings, getPropertiesMap, getProperty, getProperty, getPropertyExpressionDef, getPropertyExpressionsMap, getPropertyNamesSet, getRawPropertyValue, getResourcesFromBundle, getStringFromMessageBundle, refreshProperty, removeProperty, requiresNamePrefixedResId, resolveObjectProperty, resolvePropertyRaw, setPropertiesMap, setPropertiesMap2, setProperty

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface oracle.jbo.script.ExprCodeSource

getName, getScriptText

Methods inherited from interface oracle.jbo.mom.xml.DefPersistable

getFullName

Method Detail

setParent

public void setParent(NamedObjectImpl parent)

Description copied from class: DefinitionObject

Sets this object's parent.

Overrides:

setParent in class DefinitionObject

Parameters:

parent - the named object that is to be the parent of this object.

getClassName

public java.lang.String getClassName()

Description copied from interface: ExprCodeSource

The name of the class that will be generated by the compiler for the code source.

Specified by:

getClassName in interface ExprCodeSource

getCacheKey

public java.lang.Object getCacheKey()

Description copied from interface: ExprCodeSource

The key that should be used to cache the byte code that is generated for the code source. A null key indicates that a cache should not be used.

Specified by:

getCacheKey in interface ExprCodeSource

lookupExprDef

public ExprDef lookupExprDef(OwnerType type,
                             java.lang.String path)

Specified by:

lookupExprDef in interface ExprCodeSource

getExpressionSource

public java.lang.String getExpressionSource(ExprDef exprDef)

Specified by:

getExpressionSource in interface ExprCodeSource

removeExpression

public boolean removeExpression(ExprDef exprDef)

Specified by:

removeExpression in interface ExprCodeSource

addExpression

public boolean addExpression(ExprDef exprDef)

Specified by:

addExpression in interface ExprCodeSource

hasExpression

public boolean hasExpression(ExprDef exprDef)

Description copied from interface: ExprCodeSource

Return true if the CodeSource defines an expression for the specified expresmion.

Specified by:

hasExpression in interface ExprCodeSource

Parameters:

exprDef - an expression def. If null this will return true if the CodeSource defines any expression.

getScriptReader

public java.io.Reader getScriptReader()

Specified by:

getScriptReader in interface ExprCodeSource

getScriptText

public java.lang.String getScriptText()

Specified by:

getScriptText in interface ExprCodeSource

getDefXMLElementTag

@Concealed
public java.lang.String getDefXMLElementTag()

Specified by:

getDefXMLElementTag in interface PersistentDefinition

Overrides:

getDefXMLElementTag in class PersistableDefObject

For internal use only. Application developers should not use this

getXMLElementTag

@Concealed
public java.lang.String getXMLElementTag()

Description copied from interface: PersistentDefinition

Returns a piece of static info for the type of object this is invoked upon. Examples are PreparedStatements for insert, update, delete, and String containing a base the select statement for retrieving instances of this type through the SQLInputStream

Specified by:

getXMLElementTag in interface PersistentDefinition

Overrides:

getXMLElementTag in class PersistableDefObject

Returns:

returns the Statement required to store in Persitent Storage. Incase of XML, it just returns the String. In the case of SQL a JDBC PreparedStatement is returned.

For internal use only. Application developers should not use this

getDefXMLNameSpace

@Concealed
public java.lang.String getDefXMLNameSpace()

Specified by:

getDefXMLNameSpace in interface PersistentDefinition

Overrides:

getDefXMLNameSpace in class PersistableDefObject

For internal use only. Application developers should not use this

writeContents

public void writeContents(DefWriter jos)

Description copied from interface: PersistentDefinition

Objects should write their persistence output in this method

Specified by:

writeContents in interface PersistentDefinition

Overrides:

writeContents in class PersistableDefObject

Parameters:

jos - the Output storage for persistence

writeChildren

public void writeChildren(DefWriter jos)

Description copied from interface: PersistentDefinition

Writes the Object's children to the Persistent storage

Specified by:

writeChildren in interface PersistentDefinition

Overrides:

writeChildren in class PersistableDefObject

Parameters:

jos - the Output storage for persistence

loadXMLContents

public void loadXMLContents(DefElement xmlElement,
                            java.lang.String fullName)

Overrides:

loadXMLContents in class PersistableDefObject

loadFromXML

@Concealed
public static CodeSourceImpl loadFromXML(DefElement xmlElement)

For internal use only. Application developers should not use this

diffChildren

public DifferDetails diffChildren(DiffMergeable docDef,
                                  DiffMergeable orgDef,
                                  DifferDetails difDetails)

Description copied from interface: DiffMergeable

Performs diff of children defs. This def should enumerate through all its children and diff them and accumulate details of diff into difDetails and return it at the end.

For example, if this def has Child1 and Child2, its implementation should look something like:

    public DifferDetails diffChildren(DiffMergeable docDef, DiffMergeable orgDef, DifferDetails difDetails)
    {
       difDetails = diffChildrenChild1(docDef, orgDef, difDetails);
       difDetails = diffChildrenChild1(docDef, orgDef, difDetails);

       return difDetails;
    }
 

where diffChildrenChild1() uses DifferChildren's helper method diffChildrenList to diff the child defs.

Specified by:

diffChildren in interface DiffMergeable

Overrides:

diffChildren in class PersistableDefObject

Parameters:

docDef - the document-level definition

orgDef - the original definition. It could be null if the definition did not exist originally

difDetails - the DifferDetails that accumulate the details of diff from the document-level (top-level) def

Returns:

the DifferDetails that has all the details of diff

applyDiffChildren

public void applyDiffChildren(DifferDetails dif,
                              DiffResolver resolver)

Description copied from interface: DiffMergeable

Applies changes to children defs. dif contains the changes to be applied to the children. For each child def, this method should first retrieve the diff details for the child, which is of type DifferChildren. Then, it should call DifferChildren.applyDiffChanges(oracle.jbo.mom.DiffChildrenMerge, oracle.jbo.mom.DiffResolver) to perform the change operation.

applyChanges() requires a DiffChildrenMerge object, which has the insert, update, and remove methods. 'this' def object must provide implmementation of these operations.

Here is a sample:

    public void applyDiffChildren(DifferDetails dif, DiffResolver resolver)
    {
       DifferChangeMap detailMap = dif.getDetailMap();

       if (detailMap != null)
       {
          DifferChildren difChild1 = (DifferChildren) detailMap.getValue();

          if (difVCs != null)
          {
             DiffChildrenMerge dm = new DiffChildrenMerge()
             {
                public void insertChild(Object id, Object value)
                {
                   .. perform insert op for Child1 ..
                }

                public void updateChild(Object id, Object value, Object oldValue)
                {
                   .. perform update op for Child1 ..
                }

                public void removeChild(Object id)
                {
                   .. perform remove op for Child1 ..
                }
             };

             difChild1.applyDiffChanges(dm, resolver);
          }

          // Similarly for Child2
       }
    }
 

Specified by:

applyDiffChildren in interface DiffMergeable

Overrides:

applyDiffChildren in class PersistableDefObject

getType

public ExprCodeSource.Type getType()

Specified by:

getType in interface ExprCodeSource

getContentType

public java.lang.String getContentType()

Specified by:

getContentType in interface ExprCodeSource

createMethodSource

@Concealed
public CodeSourceImpl.MethodSource createMethodSource(java.lang.String name,
                                                                 java.util.List<java.lang.String> statements,
                                                                 int lineNumber,
                                                                 int lastLineNumber,
                                                                 int columnNumber,
                                                                 int lastColumnNumber)

For internal use only. Application developers should not use this