Package com.funnelback.plugin.gatherer

Interface PluginGatherContext

  • public interface PluginGatherContext

    • 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 parameter
        value - 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.