com.iizix.server.prop

Class ServerProps

java.lang.Object

com.iizix.prop.GProp<GProp<?>[]>

com.iizix.prop.PropCnr

com.iizix.server.prop.ServerProps

All Implemented Interfaces:

EventListener, IGProp<GProp<?>[]>, IPropCnr, Cloneable

Direct Known Subclasses:

EditorServerProps

public class ServerProps
extends PropCnr

This server property is a container that holds everything a client/server needs in order to establish communication with the other party, and information about themselves (such as environment).

The server properties has the following properties:

• $environment - EnvProps
• $settings - ServerSettings

Field Summary

Fields

Modifier and Type	Field and Description
protected EnvProps	envProps The environment properties.
protected ServerSettings	serverSettings The server settings properties.

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

Modifier	Constructor and Description
	ServerProps() Creates the client properties without a name.
protected	ServerProps(Atom atom, PropMgr propertyManager) Creates the client properties with an atom manager.

Method Summary

Modifier and Type	Method and Description
protected void	addPredefinedProps() Adds the predefined properties for this container.
ServerProps	clone() Creates a clone out of this property.
static ServerProps	createServerProps(PropMgr propertyManager) Creates a new instance of the Server properties.
protected ServerSettings	createServerSettings() Creates the ServerSettings property, overridden by the Designer version.
StringMapProp	getClientEnv() Gets the client environment properties.
EnvProps	getEnvironment() Gets the environment properties.
protected void	getPredefinedProps() Gets potential references to predefined properties for this container.
PropMgr	getPropRootPropMgr() Gets the Property Manager used for communication for the root container.
PropCnr	getRootFromName(GProp<?> requestor, String module) Gets the module root for a name.
String	getRootName(GProp<?> requestor) Gets and checks if this container is the root.
StringMapProp	getServerEnv() Gets the server environment properties.
ServerSettings	getServerSettings() Gets the container for server settings.
boolean	isPropRoot() Checks if this is a root property container.
ServerSettings	loadServerSettings(ServerShell shell, File file) Loads or reloads the server settings from the config file.
protected boolean	shouldSerializeToXML(int programType) The ServerProps are never written to XML.

Methods inherited from class com.iizix.prop.PropCnr

__transferChildProps, 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, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getPropBaseReference, getPropCnr, 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, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, 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, 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, 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, isPropReferenceTreeValid, 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, 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.IPropCnr

canRequestFocus, canRequestFocus, couldRequestFocusIfVirtualized, couldRequestFocusIfVirtualized

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, 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, isPropReferenceTreeValid, 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

Field Detail

envProps

protected EnvProps envProps

The environment properties.

serverSettings

protected ServerSettings serverSettings

The server settings properties.

Constructor Detail

ServerProps

public ServerProps()

Creates the client properties without a name. The name must be set in all cases using the setPropertyAtom call.

ServerProps

protected ServerProps(Atom atom,
                      PropMgr propertyManager)

Creates the client properties with an atom manager.

Parameters:

atom - The atom.

Method Detail

createServerProps

public static ServerProps createServerProps(PropMgr propertyManager)

Creates a new instance of the Server properties.

shouldSerializeToXML

protected boolean shouldSerializeToXML(int programType)

The ServerProps are never written to XML.

Method used to check for serialization to XML.

Overrides:

shouldSerializeToXML in class GProp<GProp<?>[]>

Parameters:

programType - From PropFactory.getProgramType(): 0=PropFactory.CLIENT, 1=PropFactory.SERVER or 2=PropFactory.EDITOR.

Returns:

true (default if not VOLATILE) to save to XML, false to avoid writing the property to XML.

getRootName

public String getRootName(GProp<?> requestor)

Gets and checks if this container is the root. The name returned is in the Editor "module:" and in "" (empty string) when running in the Server.

When running with assertions, this call throws an assertion error by default, showing that the call is directed to a non-root property container.

Overrides:

getRootName in class GProp<GProp<?>[]>

Parameters:

requestor - The requestor property.

Returns:

Name string if this is the root as "project:" for the Designer, and "" for the Server, null otherwise.

getRootFromName

public PropCnr getRootFromName(GProp<?> requestor,
                               String module)

Gets the module root for a name. In the Editor, the module is the project, and that root container is returned. In the Server, the module doesn't matter, so the real root returns itself.

When running with assertions, this call throws an assertion error by default, showing that the call is directed to a non-root property container.

Overrides:

getRootFromName in 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 this container is not the root, or if the module name is not found. The default implementation returns null.

isPropRoot

public boolean isPropRoot()

Checks if this is a root property container. It is overridden by the root property.

Specified by:

isPropRoot in interface IGProp<GProp<?>[]>

Overrides:

isPropRoot in class GProp<GProp<?>[]>

Returns:

true.

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 interface IGProp<GProp<?>[]>

Overrides:

getPropRootPropMgr in class GProp<GProp<?>[]>

Returns:

The Property Manager, or null when not attached to a root.

createServerSettings

protected ServerSettings createServerSettings()

Creates the ServerSettings property, overridden by the Designer version.

addPredefinedProps

protected void addPredefinedProps()
                           throws PropException

Adds the predefined properties for this container. This method is called once just after construction of the property container.

Overrides:

addPredefinedProps in class PropCnr

Throws:

PropException - for property exceptions.

getPredefinedProps

protected void getPredefinedProps()

Gets potential references to predefined properties for this container. This method is called once just after cloning of the property container.

The method should get reference to using the getProp(...) methods. This allows the subclass to be able to retrieve the new instances to the properties created during addPredefinedProps() if stored in instance variables.

Overrides:

getPredefinedProps in class PropCnr

clone

public ServerProps clone()

Creates a clone out of this property. The cloning is overridden by the subclasses in order to handle cloning of its class variables appropriately.

Cloning is used for "virtualization" of a property tree in the server. Client property classes will therefore throw CloneNotSupportedException.

Once a tree has been cloned, the change-flag is reset, and the create-flag is set. All listeners are also removed! The new cloned property is an orphan, i.e. has no parent set. All children properties are also (deep) cloned.

Note that the cloning process is done WITHOUT thread synchronization for performance reasons, thus no modifications should be done to the tree!

Overrides:

clone in class PropCnr

getEnvironment

public EnvProps getEnvironment()

Gets the environment properties. The default is to delegate the request to the parent container.

Specified by:

getEnvironment in interface IGProp<GProp<?>[]>

Overrides:

getEnvironment in class GProp<GProp<?>[]>

Returns:

The EnvProps for the client/server environment or null if not found.

getServerEnv

public StringMapProp getServerEnv()

Gets the server environment properties.

Returns:

StringMapProp for the server environment.

getClientEnv

public StringMapProp getClientEnv()

Gets the client environment properties.

Returns:

StringMapProp for the server environment.

getServerSettings

public ServerSettings getServerSettings()

Gets the container for server settings.

loadServerSettings

public ServerSettings loadServerSettings(ServerShell shell,
                                         File file)
                                  throws IOException,
                                         PropException

Loads or reloads the server settings from the config file.

Parameters:

shell - The Server shell.

file - The configuration file.

Throws:

IOException - For file errors.

PropException - For property errors.