Interface IRuntimeReferenceLookup
- All Known Implementing Classes:
- AppFactory,- AppSessionGyro,- RuntimeApp
 - public interface IRuntimeReferenceLookupInterface used to gets a reference for runtime use to get the reference of an item. The reference must be fully qualified such as "*ALIAS:/type/path" or "MODULE:/type/path" and cannot be relative.look-up a reference from a virtualized container in an application.- Note: The reference can be to the static or virtualized properties, but if a property type is virtualized and the property is not found, a fall-back to search the application for the static non-virtualized property IS NOT PERFORMED. - Author:
- Christopher Mindus
 
- Method Summary- All Methods Instance Methods Abstract Methods Default Methods - Modifier and Type - Method - Description - AppFactory- getAppFactory()Gets the application factory.- EnvProps- getEnvironment()Gets the environment properties to use.- PropCnr- getRootFromName(GProp<?> requestor, java.lang.String module)Gets the module root for a name.- default GProp<?>- getRuntimePropFromReference(java.lang.String reference)Gets a reference for runtime use to get the reference of an item.- GProp<?>- getRuntimePropFromReference(java.lang.String reference, boolean fallBackToNonVirtualized)Gets a reference for runtime use to get the reference of an item.
 
- Method Detail- getRuntimePropFromReference- default GProp<?> getRuntimePropFromReference(java.lang.String reference) Gets a reference for runtime use to get the reference of an item. The reference must be fully qualified such as "*ALIAS:/type/path" or "MODULE:/type/path" and cannot be relative.- Note: The reference can be to the static or virtualized properties, but if a property type is virtualized and the property is not found, a fall-back to search the application for the static non-virtualized property IS NOT PERFORMED. - Calling this method is the same as calling - getRuntimePropFromReference(reference, false)}.- Parameters:
- reference- The reference to look-up.
- Returns:
- The property found, or null for reference not found.
 
 - getRuntimePropFromReference- GProp<?> getRuntimePropFromReference(java.lang.String reference, boolean fallBackToNonVirtualized) Gets a reference for runtime use to get the reference of an item. The reference must be fully qualified such as "*ALIAS:/type/path" or "MODULE:/type/path" and cannot be relative.- If the flag - fallBackToNonVirtualizedis false, the search will not fallback to searching for the non-virtualized property in the runtime app. The result will only returned virtualized properties, i.e. for a reference as e.g. "module:/vs/someVS", and depending on where this method is called (the client session), also includes other virtualized properties such as panels as e.g. "module:/panel/somePanel".- To always fallback to also searching the runtime app, specify - fallBackToNonVirtualizedto true.- Parameters:
- reference- The reference to look-up.
- fallBackToNonVirtualized- Flag indicating a fallback to non-virtualized properties.
- Returns:
- The property found, or null for reference not found.
 
 - getRootFromName- PropCnr getRootFromName(GProp<?> requestor, java.lang.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. - 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.
 
 - getEnvironment- EnvProps getEnvironment() Gets the environment properties to use.- Returns:
- The environment for the client session, original session or server in that priority order.
 
 - getAppFactory- AppFactory getAppFactory() Gets the application factory.- Returns:
- The AppFactory.