◆ SingleFileAspectEngineBuilderBase() [1/2]
| fiftyone.pipeline.engines.flowelements.SingleFileAspectEngineBuilderBase< TBuilder extends OnPremiseAspectEngineBuilderBase< TBuilder, TEngine, TEngine extends OnPremiseAspectEngine >.SingleFileAspectEngineBuilderBase | ( | ILoggerFactory | loggerFactory | ) |
Construct a new instance using the ILoggerFactory supplied.
- Parameters
-
- loggerFactory - the logger factory to use
◆ SingleFileAspectEngineBuilderBase() [2/2]
fiftyone.pipeline.engines.flowelements.SingleFileAspectEngineBuilderBase< TBuilder extends OnPremiseAspectEngineBuilderBase< TBuilder, TEngine, TEngine extends OnPremiseAspectEngine >.SingleFileAspectEngineBuilderBase ( ILoggerFactory loggerFactory, DataUpdateService dataUpdateService ) Construct a new instance using the ILoggerFactory and DataUpdateService supplied.
- Parameters
-
- loggerFactory - the logger factory to use
- dataUpdateService - the DataUpdateService to use when automatic updates happen on the data file
Member Function Documentation
◆ build() [1/3]
TEngine fiftyone.pipeline.engines.flowelements.SingleFileAspectEngineBuilderBase< TBuilder extends OnPremiseAspectEngineBuilderBase< TBuilder, TEngine, TEngine extends OnPremiseAspectEngine >.build ( @BuildArg("dataFile") String dataFile, @BuildArg("createTempDataCopy") boolean createTempDataCopy ) throws Exception Build an engine using the current options and the specified data file.
Also registers the data file with the data update service.
- Parameters
-
- dataFile - complete path to the data file to use when creating the engine
- createTempDataCopy - if true, the engine will create a copy of the data file in a temporary location rather than using the file provided directly. If not loading all data into memory, this is required for automatic data updates to occur
- Returns
- new AspectEngine instance
◆ build() [2/3]
TEngine fiftyone.pipeline.engines.flowelements.SingleFileAspectEngineBuilderBase< TBuilder extends OnPremiseAspectEngineBuilderBase< TBuilder, TEngine, TEngine extends OnPremiseAspectEngine >.build ( byte [] data ) throws Exception Build an engine using the current options and the specified byte array.
Also registers the data file with the data update service.
- Parameters
-
- data - a byte[] containing an in-memory representation of a data file
- Returns
- new AspectEngine instance
◆ build() [3/3]
TEngine fiftyone.pipeline.engines.flowelements.SingleFileAspectEngineBuilderBase< TBuilder extends OnPremiseAspectEngineBuilderBase< TBuilder, TEngine, TEngine extends OnPremiseAspectEngine >.build ( ) throws Exception protectedBuild an engine using the configured options.
Also registers the data file with the data update service.
- Returns
- new AspectEngine instance
◆ setAutoUpdate()
TBuilder fiftyone.pipeline.engines.flowelements.SingleFileAspectEngineBuilderBase< TBuilder extends OnPremiseAspectEngineBuilderBase< TBuilder, TEngine, TEngine extends OnPremiseAspectEngine >.setAutoUpdate ( boolean enabled ) Enable or disable automatic updates for this engine.
- Parameters
-
- enabled - if true, the engine will update it's data file with no manual intervention. If false, the engine will never update it's data file unless the manual update method is called on DataUpdateService
- Returns
- this builder
◆ setDataFileSystemWatcher()
TBuilder fiftyone.pipeline.engines.flowelements.SingleFileAspectEngineBuilderBase< TBuilder extends OnPremiseAspectEngineBuilderBase< TBuilder, TEngine, TEngine extends OnPremiseAspectEngine >.setDataFileSystemWatcher ( boolean enabled ) The DataUpdateService has the ability to watch a data file on disk and automatically refresh the engine as soon as the file is updated.
This setting enables/disables that feature.
The setAutoUpdate(boolean) feature must also be enabled in order for the file system watcher to work. If the engine is built from a byte[] then this setting does nothing.
- Parameters
-
- enabled - the cache configuration to use
- Returns
- this builder
◆ setDataUpdateDecompress()
TBuilder fiftyone.pipeline.engines.flowelements.SingleFileAspectEngineBuilderBase< TBuilder extends OnPremiseAspectEngineBuilderBase< TBuilder, TEngine, TEngine extends OnPremiseAspectEngine >.setDataUpdateDecompress ( boolean decompress ) Set a value indicating if the DataUpdateService should expect content from the configured data update URL to be compressed or not.
- Parameters
-
- decompress - true if the content from the data update URL needs to be decompressed. False otherwise
- Returns
- this builder
◆ setDataUpdateLicenseKey()
TBuilder fiftyone.pipeline.engines.flowelements.SingleFileAspectEngineBuilderBase< TBuilder extends OnPremiseAspectEngineBuilderBase< TBuilder, TEngine, TEngine extends OnPremiseAspectEngine >.setDataUpdateLicenseKey ( String key ) Set the license key to use when updating the Engine's data file.
- Parameters
-
- key - the license key to use when checking for updates to the data file. A license key can be obtained from the 51Degrees website. If you have no license key then this parameter can be set to null, but doing so will disable automatic updates.
- Returns
- this builder
◆ setDataUpdateLicenseKeys()
TBuilder fiftyone.pipeline.engines.flowelements.SingleFileAspectEngineBuilderBase< TBuilder extends OnPremiseAspectEngineBuilderBase< TBuilder, TEngine, TEngine extends OnPremiseAspectEngine >.setDataUpdateLicenseKeys ( String [] keys ) Set the license keys to use when updating the Engine's data file.
- Parameters
-
- keys - 51Degrees license keys
- Returns
- this builder
◆ setDataUpdateOnStartup()
TBuilder fiftyone.pipeline.engines.flowelements.SingleFileAspectEngineBuilderBase< TBuilder extends OnPremiseAspectEngineBuilderBase< TBuilder, TEngine, TEngine extends OnPremiseAspectEngine >.setDataUpdateOnStartup ( boolean enabled ) Configure the data file to update on startup or not.
- Parameters
-
- enabled - if true then when this file is registered with the data update service, it will immediately try to download the latest copy of the file. This action will block execution until the download is complete and the engine has loaded the new file.
- Returns
- this builder
◆ setDataUpdateUrl()
TBuilder fiftyone.pipeline.engines.flowelements.SingleFileAspectEngineBuilderBase< TBuilder extends OnPremiseAspectEngineBuilderBase< TBuilder, TEngine, TEngine extends OnPremiseAspectEngine >.setDataUpdateUrl ( String url ) Configure the engine to use the specified URL when looking for an updated data file.
- Parameters
-
- url - the URL to check for a new data file
- Returns
- this builder
◆ setDataUpdateUrlFormatter()