Package com.iizix.server.app.prop
Class AppPropCnr
- java.lang.Object
- com.iizix.prop.GProp<GProp<?>[]>
- com.iizix.prop.PropCnr
- com.iizix.server.app.prop.AppPropCnr
 
 
 
- All Implemented Interfaces:
- EventListener,- IGProp<GProp<?>[]>,- IInitializePropMgr,- IPropCnr,- java.lang.Cloneable
 - Direct Known Subclasses:
- EditorAppPropCnr
 - public class AppPropCnr extends PropCnr implements IInitializePropMgr The Application root property container that contains ModuleProjectPropCnr's for the Module Projects in the application.- Author:
- Christopher Mindus
 
- Field Summary- Fields inherited from class com.iizix.prop.PropCnr- EMPTY, EMPTY_CLASSES, EMPTY_CNRS, EXTENDS_FRAMEWORK_ERROR_ID
 - Fields inherited from class com.iizix.prop.GProp- GPDEBUG, PROP_ATTR_STRING_EDITOR_PROP, PROP_ATTR_STRING_ERRORED_NAME, PROP_ATTR_STRING_EXTENDS, PROP_ATTR_STRING_EXTENDS_FINAL, PROP_ATTR_STRING_EXTENDS_PRIVATE, PROP_ATTR_STRING_NULLABLE, PROP_ATTR_STRING_PRIVATE, PROP_ATTR_STRING_PRIVATE_CHANGE_EVENT, PROP_ATTR_STRING_READ_ONLY, PROP_USER_1, PROP_USER_2
 - Fields inherited from interface com.iizix.prop.IGProp- EQC_ERROR_IGNORE_ALL, EQC_ERROR_IGNORE_REFERENCES, EQC_IGNORE_ARRAY, EQC_IGNORE_VOLATILE_OR_EDITOR, EQC_PRIVATE, EQC_SAVE_FILE, EXT_CONTAINER_EXTENDS, EXT_CONTAINER_EXTENDS_VALID, EXT_EXTENDED, EXT_FINAL, EXT_OVERRIDES, EXT_OVERRIDES_FINAL_ERR, EXT_PRIVATE
 
 - Constructor Summary- Constructors - Constructor - Description - AppPropCnr()Constructs the instance without an AppID.- AppPropCnr(Atom appID)Constructs the instance with an application ID.
 - Method Summary- All Methods Instance Methods Concrete Methods - Modifier and Type - Method - Description - AppPropCnr- clone()Cloning is not supported.- AppFactory- getAppFactory()Gets the application factory.- java.lang.String[]- getClassPaths()Get the classpath entries for the modules inside the application when it is inside a Jar file.- EnvProps- getEnvironment()Gets the environment properties.- IJarFile- getJarFile()Gets the Jar file for the Module.- IModuleProjectPropProvider- getModuleProjectPropProvider()Gets the Module properties provider.- ModuleProjectPropCnr[]- getModuleProjects()Gets the Module model projects that are loaded for this application.- GProp<?>- getModulePropFromReference(GProp<?> requestor, java.lang.String reference)Gets a property from a reference name.- PropMgr- getPropRootPropMgr()Gets the Property Manager used for communication for the root container.- ModuleProjectPropCnr- getRootFromName(GProp<?> requestor, java.lang.String module)Gets the module root for a name.- java.lang.String- getRootName(GProp<?> requestor)Gets the name of the root container as in the Designer- "module:".- void- initialize(PropMgr propMgr)Initializes the Property Manager instance for the property.- void- initialize(AppFactory factory, EnvProps serverEnvProps)Creates a PropCnr for the designer with the specified name with a null value.- boolean- isPropReferenceTreeValid()Verifies if the tree is valid for reference creation.- boolean- isPropRoot()Checks if this is a root property container.- Methods inherited from class com.iizix.prop.PropCnr- __transferChildProps, addPredefinedProps, addProp, addProp, addProp2, addProp2, appendPropValue, canRequestFocus, completeVirtualize, containsProp, containsProp, convertLoadedProp, couldRequestFocusIfVirtualized, createCopyOfAtom, createUniqueAtom, createUniqueAtom, createUniqueAtom, createVSReference, doPropEqualsArrayValues, doVirtualizePropCnr, enablePropCommunication, enablePropHashMap, equalsTree, equalsTree, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getBool, getBool, getBool, getBool, getChildPropError, getChildPropError, getChildPropErrorSeverity, getChildPropErrorSeverity, getErrorsProp, getExtendsContainer, getExtendsError, getExtendsName, getExtendsOverride, getExtendsPossibleClasses, getFirstProp, getFirstProp, getFocusEngine, getInt, getInt, getInt, getInt, getLong, getLong, getLong, getLong, getNumber, getNumber, getNumber, getNumber, getPossibleChildren, getPredefinedProps, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getPropBaseReference, getPropCnr, getPropCount, getPropCount, getPropIndex, getPropIndex, getPropIndexes, getProps, getProps, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue0, getReferences, getRetargetedVerifyContainer, getString, getString, getString, getString, getValueClasses, getVSReference, hasFocus, hasSendData, initializeElement, initializeExtendsFramework, initializeProp, initializeValue, initPropCnr, insertProp, insertProp2, isChild, isExtendsOverriden, isExtendsPropertyValid, isExtendsRoot, isPropAddRemoveAllowed, isPropCommunicating, isPropExtended, isSibling, list, list, logPropNotFound, maybeAddProp, onInsertProp, onPropDispose, onPropRemoved, onPropTreeInitialized, onReferenceEvent, paramString, prepare, removeAllProps, removeAllProps2, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, reorderProps, replaceProps, requestFocus, requestFocus, requestFocusEx, requestFocusEx, resolveReferences, resolveRuntimeReferences, setBool, setBool, setBool, setBool, setCreateRequiredProp, setExtendsName, setExtendsOverride, setInt, setInt, setInt, setLong, setLong, setLong, setLong, setNumber, setNumber, setNumber, setNumber, setProp, setProp, setProp, setProp2, setProp2, setPropValue, setPropValue, setPropValue, setPropValue, setPropValue, setPropValue, setString, setString, setString, setString, shouldCreateProps, shouldSerializeToXML, toElementString, toNativeValue0, usePropHashMap, usesPropIndex, validateChildPropInValue, validateClassInstances, validatePropType, validatePropValue, verify, verifyInternalUseOnly, verifyTree, virtualize
 - Methods inherited from class com.iizix.prop.GProp- addPropError, addPropListener, convertPropError, dispose, equals, equals, equalsErrors, equalsObj, equalsPropValue, equalValues, extendsClone, finalize, fine, fine, finer, finer, finest, finest, fromElementString, getAliasName, getAppSessionGyro, getAppWorker, getAtomPath, getAttribute, getChildReferencePropName, getClientSessionGyro, getClientWorker, getConstraints, getErroredPropItems, getErroredProps, getErrorsProp, getExtendsRootContainer, getFullPropName, getFullPropName, getFullPropNameDebug, getFullPropNameDebug, getListeners, getModuleFolder, getModuleFolder, getParent, getParent, getProjectName, getPropAtom, getPropError, getPropError, getPropErroredName, getPropErrorSeverity, getPropExtendsFlags, getPropFromPath, getPropFromPath, getPropFromReference, getPropFromReference, getPropIndex, getPropName, getPropPath, getPropPath, getPropReferenceTarget, getPropTreeErrorSeverity, getPropValue, getPropValue, getPropValueObject, getReferencePropName, getRelativePropName, getRootParent, getRootParent, getTreeLock, hasChanged, hasPrivateChangeEventProp, hasPropError, hasPropTreeError, info, info, initializeGElement, initializeGProp, isDisposed, isPropChildOf, isPropClientCreated, isPropCreateRequired, isPropExtended, isPropExtendsFinal, isPropExtendsPrivate, isPropExtendsPrivateInRoot, isPropExtendsPrivateInRoot, isPropFile, isPropFolder, isPropForEditor, isPropNullable, isPropPrivate, isPropPrivateAtCreation, isPropReadOnly, isPropUSER, isPropValueTreeLockNeeded, isPropVirtualized, isPropVirtualizing, isPropVolatile, isPropVolatileOrEditorOnly, isProxied, list, list, list, mapAliasToReference, mapAliasToReference, mapReferenceToAlias, mapReferenceToAlias, mapReferenceToProjectRelative, modifyPropValue, moveProp, moveProp, moveProp, onEvent, onEventSelf, onPrepare, onPropInvalidateCache, onPropParentChanged, onPropValueSet, onRemoteEvent, onVirtualizationCompleted, onVirtualized, paramValue, post, post, removePropError, removePropListener, removePropUSER, renameProp, renameProp2, resetChangedTree, setChanged, setConstraints, setConstraints, setParent, setPrivateChangeEventProp, setPrivateCreateRequiredProp, setPropError, setPropErroredName, setPropExtended, setPropExtendsFinal, setPropExtendsPrivate, setPropForEditor, setPropNullable, setPropPrivate, setPropReadOnly, setPropUSER, setPropValue, setPropValue, setPropValue, setPropValueIncognito, setPropVolatile, severe, severe, severe, shouldSerializeToXML, throwIfReadOnly, toNativeValue, toString, toString, triggerRemoteEvent, triggerRemoteEvent, validateProp, verifyHasPropertyItem, warning, warning, warning
 - Methods inherited from class java.lang.Object- getClass, hashCode, notify, notifyAll, wait, wait, wait
 - Methods inherited from interface com.iizix.prop.IGProp- addPropError, addPropListener, dispose, equals, fine, fine, finer, finer, finest, finest, fromElementString, getAppSessionGyro, getAtomPath, getClientSessionGyro, getConstraints, getErroredPropItems, getErroredProps, getErrorsProp, getExtendsRootContainer, getFullPropName, getFullPropNameDebug, getModuleFolder, getModuleFolder, getParent, getParent, getPropAtom, getPropError, getPropError, getPropErrorSeverity, getPropExtendsFlags, getPropFromPath, getPropFromReference, getPropIndex, getPropName, getPropPath, getPropPath, getPropTreeErrorSeverity, getPropValue, getPropValue, getReferencePropName, getRelativePropName, getRootParent, getTreeLock, hasChanged, hasPrivateChangeEventProp, hasPropError, hasPropTreeError, info, info, initializeGElement, initializeGProp, isDisposed, isPropChildOf, isPropClientCreated, isPropCreateRequired, isPropExtended, isPropExtendsFinal, isPropExtendsPrivate, isPropExtendsPrivateInRoot, isPropExtendsPrivateInRoot, isPropFile, isPropFolder, isPropNullable, isPropPrivate, isPropReadOnly, isPropVirtualized, list, list, list, mapAliasToReference, mapReferenceToAlias, mapReferenceToProjectRelative, moveProp, moveProp, moveProp, onEvent, onEventSelf, onRemoteEvent, removePropError, removePropListener, renameProp, setChanged, setConstraints, setConstraints, setParent, setPrivateChangeEventProp, setPropError, setPropExtendsFinal, setPropExtendsPrivate, setPropNullable, setPropPrivate, setPropReadOnly, setPropValue, setPropValue, severe, severe, severe, toNativeValue, triggerRemoteEvent, triggerRemoteEvent, validateProp, verifyHasPropertyItem, warning, warning, warning
 - Methods inherited from interface com.iizix.prop.IPropCnr- canRequestFocus, canRequestFocus, couldRequestFocusIfVirtualized, couldRequestFocusIfVirtualized
 
 
- Constructor Detail- AppPropCnr- public AppPropCnr() Constructs the instance without an AppID. This constructor is used for the Designer and the property system.
 - AppPropCnr- public AppPropCnr(Atom appID) Constructs the instance with an application ID. This constructor is made for loading an entire iiziApp from a Jar file.- Parameters:
- appID- The application ID.
 
 
 - Method Detail- isPropReferenceTreeValid- public boolean isPropReferenceTreeValid() Verifies if the tree is valid for reference creation. This method is typically overridden in a root property that has a Property Manager owner that in turn is checked for a particular configuration (e.g. Client-related references such as LabelForReference that does not create references when communicating).- Specified by:
- isPropReferenceTreeValidin interface- IGProp<GProp<?>[]>
- Overrides:
- isPropReferenceTreeValidin class- GProp<GProp<?>[]>
- Returns:
- true if the root property manager is found, false otherwise.
 
 - getModuleProjectPropProvider- public IModuleProjectPropProvider getModuleProjectPropProvider() Gets the Module properties provider.
 - initialize- public void initialize(PropMgr propMgr) Initializes the Property Manager instance for the property.- Specified by:
- initializein interface- IInitializePropMgr
- Parameters:
- propMgr- The Property Manager.
 
 - initialize- public void initialize(AppFactory factory, EnvProps serverEnvProps) Creates a PropCnr for the designer with the specified name with a null value.- Parameters:
- factory- The factory.
- serverEnvProps- The server environment.
- Throws:
- java.lang.IllegalStateException- If this is called twice.
 
 - getJarFile- public IJarFile getJarFile() Gets the Jar file for the Module. This Jar file can be a Jar-in-Jar file, or null if running in development mode.- Returns:
- The Jar file or null when running in development mode.
- Throws:
- java.lang.NullPointerException- If called when not in the Server.
 
 - getAppFactory- public AppFactory getAppFactory() Gets the application factory.- Returns:
- The AppFactory.
 
 - clone- public AppPropCnr clone() throws java.lang.CloneNotSupportedException Cloning is not supported.
 - isPropRoot- public boolean isPropRoot() Checks if this is a root property container.- Specified by:
- isPropRootin interface- IGProp<GProp<?>[]>
- Overrides:
- isPropRootin class- GProp<GProp<?>[]>
- Returns:
- true, always.
 
 - getPropRootPropMgr- public PropMgr getPropRootPropMgr() Gets the Property Manager used for communication for the root container. If this is not the root container, the parent function is called upwards in tree.- Specified by:
- getPropRootPropMgrin interface- IGProp<GProp<?>[]>
- Overrides:
- getPropRootPropMgrin class- GProp<GProp<?>[]>
- Returns:
- The Server Property Manager. If the server instance fails to be retrieved, the super.getPropRootPropMgr()is called.
 
 - getRootName- public java.lang.String getRootName(GProp<?> requestor) Gets the name of the root container as in the Designer- "module:".- Overrides:
- getRootNamein class- GProp<GProp<?>[]>
- Parameters:
- requestor- The requestor property.
- Returns:
- The application root returns "{APP_ROOT}:", because each Module project property container is a root itself, and this name is illegal for Atoms and paths.
 
 - getEnvironment- public EnvProps getEnvironment() Gets the environment properties.- Specified by:
- getEnvironmentin interface- IGProp<GProp<?>[]>
- Overrides:
- getEnvironmentin class- GProp<GProp<?>[]>
- Returns:
- The EnvProps for the client session, client application or server environment in respective priority order depending on what can be retrieved at the moment of calling this method.
 
 - getRootFromName- public ModuleProjectPropCnr getRootFromName(GProp<?> requestor, java.lang.String module) Gets the module root for a name. As this is the Designer, the module is the project.- Overrides:
- getRootFromNamein class- GProp<GProp<?>[]>
- Parameters:
- requestor- The requestor property.
- module- The module name (without colon), i.e. the project name in the Designer.
- Returns:
- The root property container, or null if the module name is not found.
 
 - getModulePropFromReference- public GProp<?> getModulePropFromReference(GProp<?> requestor, java.lang.String reference) Gets a property from a reference name. The property is looked up by attempting a virtualized instance first, then if not found, the "static" non-virtualized properties.- Parameters:
- requestor- The requestor property.
- reference- The reference string.
- Returns:
- The property with the reference in question, or null if not found.
 
 - getModuleProjects- public ModuleProjectPropCnr[] getModuleProjects() Gets the Module model projects that are loaded for this application.
 - getClassPaths- public java.lang.String[] getClassPaths() Get the classpath entries for the modules inside the application when it is inside a Jar file.- Returns:
- The classpath entries, directory list, where each entry ends with "/".