Interface SuggestionService

  • All Known Implementing Classes:
    SuggestionServiceImpl

    public interface SuggestionService
    Pluggable service to generate user action suggestions based on text input and contextual data.

    This services aims to build more natural user interfaces for search and navigation by trying to interpret and make explicit possible user intents.

    Possible usages of this service:

    • make the top right JSF search box more useful with ajax auto-completion that leads to typed suggestions
    • custom auto-complete field in layouts
    • smart mobile application using a Content Automation operation for suggesting next operations / chains
    Since:
    5.5
    Author:
    ogrisel
    • Method Detail

      • suggest

        List<Suggestion> suggest​(String userInput,
                                 SuggestionContext context)
                          throws SuggestionException
        Call the suggesters registered for the given suggestion point mentioned in the context and aggregate the results.
        Parameters:
        userInput - text typed by the user
        context - user context (with suggestPoint name and more)
        Returns:
        generated suggestion for the given input and context
        Throws:
        SuggestionException
      • suggest

        List<Suggestion> suggest​(String userInput,
                                 SuggestionContext suggestionContext,
                                 String suggester)
                          throws SuggestionException
        Call a single suggester registered under the provided name.
        Parameters:
        userInput - text typed by the user
        suggestionContext - user context (with suggestPoint name and more)
        suggester - the registration name of the suggester to use
        Returns:
        generated suggestion for the given input and context
        Throws:
        SuggestionException