GlobalConfiguration
public class GlobalConfiguration
extends Object
implements IGlobalConfiguration
java.lang.Object | |
↳ | com.android.tradefed.config.GlobalConfiguration |
מימוש IGlobalConfiguration
המאחסן את אובייקטי התצורה הטעונים במפה
סיכום
שדות | |
---|---|
public static final String | CREDENTIAL_FACTORY_TYPE_NAME |
public static final String | DEVICE_MANAGER_TYPE_NAME |
public static final String | DEVICE_MONITOR_TYPE_NAME |
public static final String | DEVICE_REQUIREMENTS_TYPE_NAME |
public static final String | GLOBAL_CONFIG_SERVER |
public static final String | GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE |
public static final String | GLOBAL_CONFIG_VARIABLE |
public static final String | HOST_MONITOR_TYPE_NAME |
public static final String | HOST_OPTIONS_TYPE_NAME |
public static final String | HOST_RESOURCE_MANAGER_TYPE_NAME |
public static final String | KEY_STORE_TYPE_NAME |
public static final String | MULTI_DEVICE_RECOVERY_TYPE_NAME |
public static final String | RESOURCE_METRIC_COLLECTOR_TYPE_NAME |
public static final String | SANDBOX_FACTORY_TYPE_NAME |
public static final String | SCHEDULER_TYPE_NAME |
public static final String | SHARDING_STRATEGY_TYPE_NAME |
public static final String | TF_DEVICE_MANAGEMENT_SERVER_NAME |
public static final String | TF_FEATURE_SERVER_NAME |
public static final String | TF_INVOCATION_SERVER_NAME |
public static final String | WTF_HANDLER_TYPE_NAME
|
שיטות ציבוריות | |
---|---|
void | cleanup () ניקוי תקין בעת כיבוי מוזנת. |
File | cloneConfigWithFilter ( exclusionPatterns, String... allowlistConfigs) cloneConfigWithFilter ( exclusionPatterns, String... allowlistConfigs) סנן את ה-GlobalConfiguration על סמך רשימה לבנה ופלט לקובץ XML. |
File | cloneConfigWithFilter ( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs) cloneConfigWithFilter ( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs) סנן את ה-GlobalConfiguration על סמך רשימה לבנה תוך מתן מניפולציה של ערכי אופציות ופלט לקובץ XML. |
File | cloneConfigWithFilter (String... allowlistConfigs) סנן את ה-GlobalConfiguration על סמך רשימה מותרת ופלט לקובץ XML. |
static | createGlobalConfiguration (String[] args) מגדיר את יחידת |
ICommandScheduler | getCommandScheduler () מקבל את |
Object | getConfigurationObject (String typeName) מקבל את אובייקט התצורה המותאם אישית עם השם הפרטי. |
ICredentialFactory | getCredentialFactory () מקבל את |
String | getDescription () |
DeviceManagementGrpcServer | getDeviceManagementServer () מחזיר את |
IDeviceManager | getDeviceManager () מקבל את |
static IDeviceManager | getDeviceManagerInstance () מחזירה הפניה למופע Singleton |
getDeviceMonitors () מקבל את רשימת | |
IDeviceSelection | getDeviceRequirements () מקבל את ה- |
TradefedFeatureServer | getFeatureServer () מחזיר את |
IConfigurationServer | getGlobalConfigServer () מקבל שרת תצורה גלובלי. |
static | getHostMonitorInstances () |
getHostMonitors () מקבל את רשימת | |
IHostOptions | getHostOptions () מקבל את |
IHostResourceManager | getHostResourceManager () מקבל את |
static IGlobalConfiguration | getInstance () מחזירה הפניה למופע Singleton |
IKeyStoreFactory | getKeyStoreFactory () מקבל את |
getMultiDeviceRecoveryHandlers () מקבל את רשימת ה- | |
String | getName () |
getOptionValues (String optionName) קבל רשימה של ערכי האופציה. | |
getResourceMetricCollectors () מקבל את הרשימה של | |
ISandboxFactory | getSandboxFactory () קבל מפעל ארגז חול שניתן להשתמש בו כדי להפעיל הזמנה |
IShardHelper | getShardingStrategy () מחזיר את ה- |
TestInvocationManagementServer | getTestInvocationManagementSever () מחזיר את |
ITerribleFailureHandler | getWtfHandler () מקבל את |
void | injectOptionValue (String optionName, String optionValue) הזרקת ערך אופציה לתוך קבוצת אובייקטי התצורה. |
void | injectOptionValue (String optionName, String optionKey, String optionValue) הזרקת ערך אופציה לתוך קבוצת אובייקטי התצורה. |
void | printCommandUsage (boolean importantOnly, PrintStream out) מוציא טקסט עזרה של שורת פקודה עבור תצורה זו ל-printStream נתון. |
void | setCommandScheduler ( ICommandScheduler scheduler) הגדר את |
void | setConfigurationFactory ( IConfigurationFactory configFactory) הגדר את |
void | setConfigurationObject (String typeName, Object configObject) שיטה גנרית להגדיר את אובייקט התצורה עם השם הנתון, תוך החלפת כל ערך קיים. |
void | setConfigurationObjectList (String typeName, configList) setConfigurationObjectList (String typeName, configList) שיטה כללית להגדרת רשימת אובייקטי התצורה עבור השם הנתון, תוך החלפת כל ערך קיים. |
void | setDeviceManagementServer ( DeviceManagementGrpcServer server) מגדיר את |
void | setDeviceManager ( IDeviceManager manager) הגדר את |
void | setDeviceMonitor ( IDeviceMonitor monitor) הגדר את |
void | setDeviceRequirements ( IDeviceSelection devRequirements) הגדר את |
void | setHostMonitors ( hostMonitors) setHostMonitors ( hostMonitors) הגדר את רשימת |
void | setHostOptions ( IHostOptions hostOptions) הגדר את |
void | setHostResourceManager ( IHostResourceManager hostResourceManager) הגדר את |
void | setInvocationServer ( TestInvocationManagementServer server) מגדיר את |
void | setKeyStoreFactory ( IKeyStoreFactory factory) הגדר את |
setOptionsFromCommandLineArgs ( listArgs) setOptionsFromCommandLineArgs ( listArgs) הגדר את שדות ראה | |
void | setOriginalConfig (String config) מגדיר את התצורה המקורית ששימשה ליצירת התצורה הגלובלית. |
void | setResourceMetricCollector ( IResourceMetricCollector collector) מגדיר את |
void | setSandboxFactory ( ISandboxFactory factory) הגדר את |
void | setShardingStrategy ( IShardHelper sharding) מגדיר את |
void | setTradefedFeatureServer ( TradefedFeatureServer server) מגדיר את |
void | setWtfHandler ( ITerribleFailureHandler wtfHandler) הגדר את |
void | setup () הגדרה נכונה בתחילת ה- tradefed. |
void | validateOptions () אימות ערכי אופציות. |
שיטות מוגנות | |
---|---|
IConfigurationFactory | getConfigurationFactory () |
שדות
CREDENTIAL_FACTORY_TYPE_NAME
public static final String CREDENTIAL_FACTORY_TYPE_NAME
DEVICE_MANAGER_TYPE_NAME
public static final String DEVICE_MANAGER_TYPE_NAME
DEVICE_MONITOR_TYPE_NAME
public static final String DEVICE_MONITOR_TYPE_NAME
DEVICE_REQUIREMENTS_TYPE_NAME
public static final String DEVICE_REQUIREMENTS_TYPE_NAME
GLOBAL_CONFIG_SERVER
public static final String GLOBAL_CONFIG_SERVER
GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE
public static final String GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE
GLOBAL_CONFIG_VARIABLE
public static final String GLOBAL_CONFIG_VARIABLE
HOST_MONITOR_TYPE_NAME
public static final String HOST_MONITOR_TYPE_NAME
HOST_OPTIONS_TYPE_NAME
public static final String HOST_OPTIONS_TYPE_NAME
HOST_RESOURCE_MANAGER_TYPE_NAME
public static final String HOST_RESOURCE_MANAGER_TYPE_NAME
KEY_STORE_TYPE_NAME
public static final String KEY_STORE_TYPE_NAME
MULTI_DEVICE_RECOVERY_TYPE_NAME
public static final String MULTI_DEVICE_RECOVERY_TYPE_NAME
RESOURCE_METRIC_COLLECTOR_TYPE_NAME
public static final String RESOURCE_METRIC_COLLECTOR_TYPE_NAME
SANDBOX_FACTORY_TYPE_NAME
public static final String SANDBOX_FACTORY_TYPE_NAME
SCHEDULER_TYPE_NAME
public static final String SCHEDULER_TYPE_NAME
SHARDING_STRATEGY_TYPE_NAME
public static final String SHARDING_STRATEGY_TYPE_NAME
TF_DEVICE_MANAGEMENT_SERVER_NAME
public static final String TF_DEVICE_MANAGEMENT_SERVER_NAME
TF_FEATURE_SERVER_NAME
public static final String TF_FEATURE_SERVER_NAME
TF_INVOCATION_SERVER_NAME
public static final String TF_INVOCATION_SERVER_NAME
WTF_HANDLER_TYPE_NAME
public static final String WTF_HANDLER_TYPE_NAME
שיטות ציבוריות
לנקות
public void cleanup ()
ניקוי תקין בעת כיבוי מוזנת.
cloneConfigWithFilter
public File cloneConfigWithFilter (exclusionPatterns, String... allowlistConfigs)
סנן את ה-GlobalConfiguration על סמך רשימה לבנה ופלט לקובץ XML.
פרמטרים | |
---|---|
exclusionPatterns | |
allowlistConfigs | String : מערך ERROR(/String) של הגדרות שייכלל בקובץ ה-XML החדש. אם הוא מוגדר ל- null |
החזרות | |
---|---|
File | הקובץ המכיל את התצורה הגלובלית המסוננת החדשה. |
cloneConfigWithFilter
public File cloneConfigWithFilter (exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs)
סנן את ה-GlobalConfiguration על סמך רשימה לבנה תוך מתן מניפולציה של ערכי אופציות ופלט לקובץ XML.
פרמטרים | |
---|---|
exclusionPatterns | |
transformer | IConfigOptionValueTransformer |
deepCopy | boolean |
allowlistConfigs | String : מערך ERROR(/String) של הגדרות שייכלל בקובץ ה-XML החדש. אם הוא מוגדר ל- null |
החזרות | |
---|---|
File | הקובץ המכיל את התצורה הגלובלית המסוננת החדשה. |
cloneConfigWithFilter
public File cloneConfigWithFilter (String... allowlistConfigs)
סנן את ה-GlobalConfiguration על סמך רשימה מותרת ופלט לקובץ XML.
לדוגמה, עבור התצורה הבאה: <xml> <configuration> <device_monitor class="com.android.tradefed.device.DeviceMonitorMultiplexer" /> <wtf_handler class="com.android.tradefed.log.TerribleFailureEmailHandler" /> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>
כל התצורה למעט "key_store" יסוננה, וכתוצאה מכך קובץ תצורה עם התוכן הבא: <xml> <configuration> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>
פרמטרים | |
---|---|
allowlistConfigs | String : מערך ERROR(/String) של הגדרות שייכלל בקובץ ה-XML החדש. אם הוא מוגדר ל- null |
החזרות | |
---|---|
File | הקובץ המכיל את התצורה הגלובלית המסוננת החדשה. |
createGlobalConfiguration
public staticcreateGlobalConfiguration (String[] args)
מגדיר את יחידת GlobalConfiguration
עבור מופע TF זה. חייב להיקרא פעם אחת בלבד, לפני שמשהו ינסה לקרוא getInstance()
פרמטרים | |
---|---|
args | String |
החזרות | |
---|---|
זורק | |
---|---|
| אם מתקשרים יותר מפעם אחת |
ConfigurationException |
getCommandScheduler
public ICommandScheduler getCommandScheduler ()
מקבל את ICommandScheduler
לשימוש מהתצורה.
החזרות | |
---|---|
ICommandScheduler | ICommandScheduler . לעולם לא יחזור לריק. |
getConfigurationObject
public Object getConfigurationObject (String typeName)
מקבל את אובייקט התצורה המותאם אישית עם השם הפרטי.
פרמטרים | |
---|---|
typeName | String : הסוג הייחודי של אובייקט התצורה |
החזרות | |
---|---|
Object | האובייקט או null אם האובייקט בשם זה לא נמצא |
getCredentialFactory
public ICredentialFactory getCredentialFactory ()
מקבל את ICredentialFactory
ליצירת אישורים.
החזרות | |
---|---|
ICredentialFactory | ICredentialFactory או null אם לא צוין. |
getDeviceManagementServer
public DeviceManagementGrpcServer getDeviceManagementServer ()
מחזיר את DeviceManagementGrpcServer
או null אם לא מוגדר.
החזרות | |
---|---|
DeviceManagementGrpcServer |
getDeviceManager
public IDeviceManager getDeviceManager ()
מקבל את IDeviceManager
לשימוש מהתצורה. מנהל את קבוצת המכשירים הזמינים לבדיקה
החזרות | |
---|---|
IDeviceManager | ה- IDeviceManager שסופק בתצורה. |
getDeviceManagerInstance
public static IDeviceManager getDeviceManagerInstance ()
מחזירה הפניה למופע Singleton DeviceManager
עבור מופע TF זה.
החזרות | |
---|---|
IDeviceManager |
זורק | |
---|---|
| אם createGlobalConfiguration(String[]) לא נקרא כבר. |
getDeviceMonitors
publicgetDeviceMonitors ()
מקבל את רשימת IDeviceMonitor
מהתצורה הגלובלית.
החזרות | |
---|---|
הרשימה של IDeviceMonitor מהתצורה הגלובלית, או null אם לא צוין אף אחד. |
getDeviceRequirements
public IDeviceSelection getDeviceRequirements ()
מקבל את ה- IDeviceSelection
לשימוש מהתצורה. מייצג מסנן גלובלי שבו התקנים DeviceManager
יכול לראות.
החזרות | |
---|---|
IDeviceSelection | IDeviceSelection שסופק בתצורה. |
getFeatureServer
public TradefedFeatureServer getFeatureServer ()
מחזיר את TradefedFeatureServer
או null אם לא מוגדר.
החזרות | |
---|---|
TradefedFeatureServer |
getGlobalConfigServer
public IConfigurationServer getGlobalConfigServer ()
מקבל שרת תצורה גלובלי. שרת תצורה גלובלי משמש כדי לקבל תצורות מארח משרת במקום לקבל אותם מקבצים מקומיים.
החזרות | |
---|---|
IConfigurationServer |
getHostMonitorInstances
public staticgetHostMonitorInstances ()
החזרות | |
---|---|
getHostMonitors
publicgetHostMonitors ()
מקבל את רשימת IHostMonitor
מהתצורה הגלובלית.
החזרות | |
---|---|
הרשימה של IHostMonitor מהתצורה הגלובלית, או null אם לא צוין אף אחד. |
getHostOptions
public IHostOptions getHostOptions ()
מקבל את IHostOptions
לשימוש מהתצורה.
החזרות | |
---|---|
IHostOptions | ה- IDeviceManager שסופק בתצורה. |
getHostResourceManager
public IHostResourceManager getHostResourceManager ()
מקבל את IHostResourceManager
מהתצורה הגלובלית.
החזרות | |
---|---|
IHostResourceManager | ה- IHostResourceManager מהתצורה הגלובלית, או יישום ברירת המחדל LocalHostResourceManager אם אף אחד לא צוין בתצורת המארח. |
getInstance
public static IGlobalConfiguration getInstance ()
מחזירה הפניה למופע Singleton GlobalConfiguration
עבור מופע TF זה.
החזרות | |
---|---|
IGlobalConfiguration |
זורק | |
---|---|
| אם createGlobalConfiguration(String[]) לא נקרא כבר. |
getKeyStoreFactory
public IKeyStoreFactory getKeyStoreFactory ()
מקבל את IKeyStoreFactory
לשימוש מהתצורה.
החזרות | |
---|---|
IKeyStoreFactory | IKeyStoreFactory או null אם לא הוגדר מפעל של חנות מפתחות. |
getMultiDevice RecoveryHandlers
publicgetMultiDeviceRecoveryHandlers ()
מקבל את רשימת ה- IMultiDeviceRecovery
לשימוש מהתצורה.
החזרות | |
---|---|
הרשימה של IMultiDeviceRecovery , או null אם לא הוגדרה. |
getOptionValues
publicgetOptionValues (String optionName)
קבל רשימה של ערכי האופציה.
פרמטרים | |
---|---|
optionName | String : שם אפשרות המפה |
החזרות | |
---|---|
רשימה של ערכי האפשרות הנתונה. null אם שם האופציה אינו קיים. |
getResourceMetricCollectors
publicgetResourceMetricCollectors ()
מקבל את הרשימה של IResourceMetricCollector
מהתצורה הגלובלית.
החזרות | |
---|---|
הרשימה של IResourceMetricCollector מהתצורה הגלובלית או null אם לא צוין. |
getSandboxFactory
public ISandboxFactory getSandboxFactory ()
קבל מפעל ארגז חול שניתן להשתמש בו כדי להפעיל הזמנה
החזרות | |
---|---|
ISandboxFactory |
getShardingStrategy
public IShardHelper getShardingStrategy ()
מחזיר את ה- IShardHelper
שמגדיר את הדרך לריסוק תצורה.
החזרות | |
---|---|
IShardHelper |
getTestInvocationManagementSever
public TestInvocationManagementServer getTestInvocationManagementSever ()
מחזיר את TestInvocationManagementServer
או null אם לא מוגדר.
החזרות | |
---|---|
TestInvocationManagementServer |
getWtfHandler
public ITerribleFailureHandler getWtfHandler ()
מקבל את ITerribleFailureHandler
לשימוש מהתצורה. מטפל במה לעשות במקרה שמתרחש WTF (What a Terrible Failure).
החזרות | |
---|---|
ITerribleFailureHandler | ה- ITerribleFailureHandler שסופק בתצורה, או null אם לא הוגדר מטפל |
injectOptionValue
public void injectOptionValue (String optionName, String optionValue)
הזרקת ערך אופציה לתוך קבוצת אובייקטי התצורה.
שימושי כדי לספק ערכים עבור אפשרויות שנוצרות באופן דינמי.
פרמטרים | |
---|---|
optionName | String : שם האפשרות |
optionValue | String : ערכי האופציה |
זורק | |
---|---|
ConfigurationException |
injectOptionValue
public void injectOptionValue (String optionName, String optionKey, String optionValue)
הזרקת ערך אופציה לתוך קבוצת אובייקטי התצורה.
שימושי כדי לספק ערכים עבור אפשרויות שנוצרות באופן דינמי.
פרמטרים | |
---|---|
optionName | String : שם אפשרות המפה |
optionKey | String : מקש אפשרות המפה |
optionValue | String : ערך אפשרות המפה |
זורק | |
---|---|
ConfigurationException |
printCommandUsage
public void printCommandUsage (boolean importantOnly, PrintStream out)
מוציא טקסט עזרה של שורת פקודה עבור תצורה זו ל-printStream נתון.
פרמטרים | |
---|---|
importantOnly | boolean |
out | PrintStream : ה- ERROR(/PrintStream) לשימוש. |
זורק | |
---|---|
| com.android.tradefed.config.ConfigurationException |
ConfigurationException |
setCommandScheduler
public void setCommandScheduler (ICommandScheduler scheduler)
הגדר את ICommandScheduler
, והחלף את כל הערכים הקיימים.
setConfigurationFactory
public void setConfigurationFactory (IConfigurationFactory configFactory)
הגדר את IConfigurationFactory
עבור תצורה זו.
פרמטרים | |
---|---|
configFactory | IConfigurationFactory |
setConfigurationObject
public void setConfigurationObject (String typeName, Object configObject)
שיטה גנרית להגדיר את אובייקט התצורה עם השם הנתון, תוך החלפת כל ערך קיים.
פרמטרים | |
---|---|
typeName | String : השם הייחודי של סוג אובייקט התצורה. |
configObject | Object : אובייקט התצורה |
זורק | |
---|---|
ConfigurationException |
setConfigurationObjectList
public void setConfigurationObjectList (String typeName,configList)
שיטה כללית להגדרת רשימת אובייקטי התצורה עבור השם הנתון, תוך החלפת כל ערך קיים.
פרמטרים | |
---|---|
typeName | String : השם הייחודי של סוג אובייקט התצורה. |
configList |
זורק | |
---|---|
ConfigurationException |
setDeviceManagementServer
public void setDeviceManagementServer (DeviceManagementGrpcServer server)
מגדיר את DeviceManagementGrpcServer
.
פרמטרים | |
---|---|
server | DeviceManagementGrpcServer |
setDeviceManager
public void setDeviceManager (IDeviceManager manager)
הגדר את IDeviceManager
, החלפת כל הערכים הקיימים. זה מגדיר את המנהל עבור התקני הבדיקה
setDeviceMonitor
public void setDeviceMonitor (IDeviceMonitor monitor)
הגדר את IDeviceMonitor
.
פרמטרים | |
---|---|
monitor | IDeviceMonitor : הצג |
setDeviceRequirements
public void setDeviceRequirements (IDeviceSelection devRequirements)
הגדר את IDeviceSelection
, החלפת כל הערכים הקיימים. זה מגדיר מסנן התקנים גלובלי שבהם המכשירים שה- DeviceManager
יכול לראות.
setHostMonitors
public void setHostMonitors (hostMonitors)
הגדר את רשימת IHostMonitor
.
פרמטרים | |
---|---|
hostMonitors |
setHostOptions
public void setHostOptions (IHostOptions hostOptions)
הגדר את IHostOptions
והחלפת כל הערכים הקיימים.
setHostResourceManager
public void setHostResourceManager (IHostResourceManager hostResourceManager)
הגדר את IHostResourceManager
, תוך החלפת כל הערכים הקיימים.
setInvocationServer
public void setInvocationServer (TestInvocationManagementServer server)
מגדיר את TestInvocationManagementServer
.
פרמטרים | |
---|---|
server | TestInvocationManagementServer |
setKeyStoreFactory
public void setKeyStoreFactory (IKeyStoreFactory factory)
הגדר את IKeyStoreFactory
, החלפת כל הערכים הקיימים.
setOptionsFromCommandLineArgs
publicsetOptionsFromCommandLineArgs ( listArgs)
הגדר את שדות Option
הגלובלית עם קבוצה נתונה של ארגומנטים של שורת הפקודה
ראה ArgsOptionParser
לפורמט הצפוי
פרמטרים | |
---|---|
listArgs |
החזרות | |
---|---|
הוויכוחים הלא נצרכים |
זורק | |
---|---|
ConfigurationException |
setOriginalConfig
public void setOriginalConfig (String config)
מגדיר את התצורה המקורית ששימשה ליצירת התצורה הגלובלית.
פרמטרים | |
---|---|
config | String |
setResourceMetricCollector
public void setResourceMetricCollector (IResourceMetricCollector collector)
מגדיר את IResourceMetricCollector
.
פרמטרים | |
---|---|
collector | IResourceMetricCollector |
setSandboxFactory
public void setSandboxFactory (ISandboxFactory factory)
הגדר את ISandboxFactory
, והחלף את כל הערכים הקיימים.
setShardingStrategy
public void setShardingStrategy (IShardHelper sharding)
מגדיר את IShardHelper
לשימוש בעת פיצול תצורה.
פרמטרים | |
---|---|
sharding | IShardHelper |
setTradefedFeatureServer
public void setTradefedFeatureServer (TradefedFeatureServer server)
מגדיר את TradefedFeatureServer
.
פרמטרים | |
---|---|
server | TradefedFeatureServer |
setWtfHandler
public void setWtfHandler (ITerribleFailureHandler wtfHandler)
הגדר את ITerribleFailureHandler
.
פרמטרים | |
---|---|
wtfHandler | ITerribleFailureHandler : המטפל ב-WTF |
validateOptions
public void validateOptions ()
אימות ערכי אופציות.
כרגע זה רק יאמת שכל האפשרויות החובה הוגדרו
זורק | |
---|---|
ConfigurationException |
שיטות מוגנות
getConfigurationFactory
protected IConfigurationFactory getConfigurationFactory ()
החזרות | |
---|---|
IConfigurationFactory |