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 AppPropCnrclone()Cloning is not supported.AppFactorygetAppFactory()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.EnvPropsgetEnvironment()Gets the environment properties.IJarFilegetJarFile()Gets the Jar file for the Module.IModuleProjectPropProvidergetModuleProjectPropProvider()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.PropMgrgetPropRootPropMgr()Gets the Property Manager used for communication for the root container.ModuleProjectPropCnrgetRootFromName(GProp<?> requestor, java.lang.String module)Gets the module root for a name.java.lang.StringgetRootName(GProp<?> requestor)Gets the name of the root container as in the Designer"module:".voidinitialize(PropMgr propMgr)Initializes the Property Manager instance for the property.voidinitialize(AppFactory factory, EnvProps serverEnvProps)Creates a PropCnr for the designer with the specified name with a null value.booleanisPropReferenceTreeValid()Verifies if the tree is valid for reference creation.booleanisPropRoot()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 interfaceIGProp<GProp<?>[]>- Overrides:
isPropReferenceTreeValidin 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:
initializein 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:
isPropRootin interfaceIGProp<GProp<?>[]>- Overrides:
isPropRootin 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:
getPropRootPropMgrin interfaceIGProp<GProp<?>[]>- Overrides:
getPropRootPropMgrin 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:
getRootNamein 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:
getEnvironmentin interfaceIGProp<GProp<?>[]>- Overrides:
getEnvironmentin 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:
getRootFromNamein 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 "/".