Package com.funnelback.plugin.gatherer
Interface PluginGatherContext
-
public interface PluginGatherContext
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description String
getCollectionName()
The name of the funnelback collection for which filtering is being performedMap<String,List<String>>
getConfigKeysMatchingPattern(String pattern)
Provides config settings which match the given key pattern.Set<String>
getConfigKeysWithPrefix(String prefix)
Provides a list of config setting keys which have some prefix.String
getConfigSetting(String key)
Provides access to config settings from the current funnelback installation and collection.File
getSearchHome()
The home of the Funnelback installation currently being used to perform filtering.Optional<String>
pluginConfigurationFile(String filename)
Reads a configuration file for the currently running plugin as a UTF-8 String.Optional<byte[]>
pluginConfigurationFileAsBytes(String filename)
Reads a configuration file for the currently running plugin.void
setConfigSetting(String key, String value)
Set the config settings for the current collection.
-
-
-
Method Detail
-
getSearchHome
File getSearchHome()
The home of the Funnelback installation currently being used to perform filtering.
-
getCollectionName
String getCollectionName()
The name of the funnelback collection for which filtering is being performed
-
getConfigSetting
String getConfigSetting(String key)
Provides access to config settings from the current funnelback installation and collection. Need to set a default value from a Groovy implementation? Consider http://www.groovy-lang.org/operators.html#_elvis_operator- Parameters:
key
- The name of the collection.cfg or global.cfg setting being requested- Returns:
- The value as set for the current install and collection context
-
setConfigSetting
void setConfigSetting(String key, String value)
Set the config settings for the current collection.- Parameters:
key
- The name of the collection.cfg or global.cfg parametervalue
- The value to be set for the collection.cfg or global.cfg parameter
-
getConfigKeysWithPrefix
Set<String> getConfigKeysWithPrefix(String prefix)
Provides a list of config setting keys which have some prefix. This is useful in cases where you need to process some set of config values (e.g. one setting per data source).
-
getConfigKeysMatchingPattern
Map<String,List<String>> getConfigKeysMatchingPattern(String pattern)
Provides config settings which match the given key pattern. The pattern is the same pattern used for configuration permissions. Some examples are: pattern 'a.*' matches 'a.foo' but does not match 'a.foo.bar' pattern 'a.*.*' matches 'a.foo.bar' but does not match 'a.foo' The key within the returned map is the full key and the value is a list of the parameters for the key. For example if config has: 'a.foo.bar' and 'a.b.c' and the pattern is 'a.*.*' the resulting map will contain: 'a.foo.bar': ["foo", "bar"] 'a.b.c': ["a", "b"] Note that if the config key contains '.' or '\' it will be escaped as it is in config. For example if config contains 'a.c:\\bar\.jpg' then for the pattern 'a.*' the resulting map would contain: 'a.c:\\bar\.jpg': ["c:\bar.jpg"] The key remains escaped however the paramaters in the list are left unescaped.- Parameters:
pattern
-- Returns:
- a map of all matching config keys where the key in the map is the config key and the value is a list of all parameters.
-
pluginConfigurationFileAsBytes
Optional<byte[]> pluginConfigurationFileAsBytes(String filename)
Reads a configuration file for the currently running plugin. The configuration file read is for the currently running plugin and either the data source or search package the plugin is currently running on. When a plugin is run during a search, this will be the results page (profile) the search is running on. Plugins can not read the configuration files for other plugins.- Parameters:
filename
- the name of the configuration file to read.- Returns:
- empty if the file doesn't exist, otherwise the contents of the file.
-
pluginConfigurationFile
Optional<String> pluginConfigurationFile(String filename)
Reads a configuration file for the currently running plugin as a UTF-8 String. See:pluginConfigurationFileAsBytes(String)
- Parameters:
filename
- the name of the configuration file to read.- Returns:
- empty if the file doesn't exist, otherwise the contents of the file.
-
-