Class DynamicPromptHelper


  • public class DynamicPromptHelper
    extends java.lang.Object
    Utility class to help with dynamic prompting scenarios. Provides common patterns and helper methods for conditional prompting.
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static boolean allResultsExist​(java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>> results, java.lang.String... resultNames)
      Checks if all specified results exist.
      static boolean anyResultExists​(java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>> results, java.lang.String... resultNames)
      Checks if any of the specified results exist.
      static java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> chain​(java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>>... providers)
      Creates a prompt provider that chains multiple conditional providers.
      static java.lang.String getResultValue​(java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>> results, java.lang.String resultName)
      Gets the result value for a specific prompt, or null if not found.
      static boolean hasValue​(java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>> results, java.lang.String resultName)
      Checks if a result exists and has a non-empty value.
      static boolean resultEqualsAny​(java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>> results, java.lang.String resultName, java.lang.String... values)
      Checks if a result equals any of the given values.
      static java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> when​(java.util.function.Predicate<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>> condition, java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> promptProvider)
      Creates a conditional prompt provider that only shows prompts when a condition is met.
      static java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> whenResultEquals​(java.lang.String resultName, java.lang.String expectedValue, java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> promptProvider)
      Creates a prompt provider that only executes if a specific result has a specific value.
      static java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> whenResultExists​(java.lang.String resultName, java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> promptProvider)
      Creates a prompt provider that only executes if a specific result exists.
      static java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> whenResultMissing​(java.lang.String resultName, java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> promptProvider)
      Creates a prompt provider that only executes if a specific result does NOT exist.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Method Detail

      • when

        public static java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> when​(java.util.function.Predicate<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>> condition,
                                                                                                                                                                              java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> promptProvider)
        Creates a conditional prompt provider that only shows prompts when a condition is met.
        Parameters:
        condition - the condition to check against previous results
        promptProvider - the provider to call when condition is true
        Returns:
        a conditional prompt provider
      • whenResultExists

        public static java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> whenResultExists​(java.lang.String resultName,
                                                                                                                                                                                          java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> promptProvider)
        Creates a prompt provider that only executes if a specific result exists.
        Parameters:
        resultName - the name of the result that must exist
        promptProvider - the provider to call when the result exists
        Returns:
        a conditional prompt provider
      • whenResultEquals

        public static java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> whenResultEquals​(java.lang.String resultName,
                                                                                                                                                                                          java.lang.String expectedValue,
                                                                                                                                                                                          java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> promptProvider)
        Creates a prompt provider that only executes if a specific result has a specific value.
        Parameters:
        resultName - the name of the result to check
        expectedValue - the expected value
        promptProvider - the provider to call when the condition is met
        Returns:
        a conditional prompt provider
      • whenResultMissing

        public static java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> whenResultMissing​(java.lang.String resultName,
                                                                                                                                                                                           java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> promptProvider)
        Creates a prompt provider that only executes if a specific result does NOT exist.
        Parameters:
        resultName - the name of the result that must not exist
        promptProvider - the provider to call when the result doesn't exist
        Returns:
        a conditional prompt provider
      • chain

        @SafeVarargs
        public static java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>> chain​(java.util.function.Function<java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>>,​java.util.List<? extends Prompt>>... providers)
        Creates a prompt provider that chains multiple conditional providers. Each provider is tried in order until one returns a non-null result.
        Parameters:
        providers - the providers to chain
        Returns:
        a chained prompt provider
      • getResultValue

        public static java.lang.String getResultValue​(java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>> results,
                                                      java.lang.String resultName)
        Gets the result value for a specific prompt, or null if not found.
        Parameters:
        results - the results map
        resultName - the name of the result
        Returns:
        the result value or null
      • hasValue

        public static boolean hasValue​(java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>> results,
                                       java.lang.String resultName)
        Checks if a result exists and has a non-empty value.
        Parameters:
        results - the results map
        resultName - the name of the result
        Returns:
        true if the result exists and has a non-empty value
      • resultEqualsAny

        public static boolean resultEqualsAny​(java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>> results,
                                              java.lang.String resultName,
                                              java.lang.String... values)
        Checks if a result equals any of the given values.
        Parameters:
        results - the results map
        resultName - the name of the result
        values - the values to check against
        Returns:
        true if the result equals any of the values
      • allResultsExist

        public static boolean allResultsExist​(java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>> results,
                                              java.lang.String... resultNames)
        Checks if all specified results exist.
        Parameters:
        results - the results map
        resultNames - the names of the results to check
        Returns:
        true if all results exist
      • anyResultExists

        public static boolean anyResultExists​(java.util.Map<java.lang.String,​? extends PromptResult<? extends Prompt>> results,
                                              java.lang.String... resultNames)
        Checks if any of the specified results exist.
        Parameters:
        results - the results map
        resultNames - the names of the results to check
        Returns:
        true if any result exists