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:
isPropReferenceTreeValid
in interfaceIGProp<GProp<?>[]>
- Overrides:
isPropReferenceTreeValid
in classGProp<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:
initialize
in interfaceIInitializePropMgr
- 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:
isPropRoot
in interfaceIGProp<GProp<?>[]>
- Overrides:
isPropRoot
in classGProp<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:
getPropRootPropMgr
in interfaceIGProp<GProp<?>[]>
- Overrides:
getPropRootPropMgr
in classGProp<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:
getRootName
in classGProp<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:
getEnvironment
in interfaceIGProp<GProp<?>[]>
- Overrides:
getEnvironment
in classGProp<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:
getRootFromName
in classGProp<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 "/".