Package oracle.rules.sdk2.dictionary

Class ChoiceList

java.lang.Object
oracle.rules.sdk2.dictionary.ChoiceList
public class ChoiceList extends Object
A ChoiceList provides a hierarchy to the flat array of Strings returned from the SDK2 getOptions methods.

We use String[] for 3 different purposes:

  1. pass the flat options from the SDK to the ChoiceList constructor
  2. return the options for each level in the hierarchy (return of getNextChoices)
  3. to represent a partial or complete selection from first level to N levels (previousSelections) (List<String&rt; is also provided for convenience)

  • Constructor Details

    • ChoiceList

      public ChoiceList(String[] optionList)

  • Method Details

    • getNextChoices

      public String[] getNextChoices(String flatSelection)
      Get the next level of choices given the previous selections, in order of first to last level. returns String[0], String[2], String[3], ..

    • getNextChoices

      public String[] getNextChoices(String... previousSelections)

    • getNextChoices

      public String[] getNextChoices(List<String> previousSelections)

    • flattenSelection

      public static String flattenSelection(String... previousSelections)
      get a Selection String suitable for SDK2 set value methods. For example, using a UI we have previously selected 2 levels "String" and "match" from TargetOptions.

      To set the Target: action.setTarget(ChoiceList.flattenSelection("String", "match"))

      Parameters:
      previousSelections -
      Returns:
      flattened selection

    • flattenSelection

      public static String flattenSelection(List<String> previousSelections)

    • parseSelection

      public static List<String> parseSelection(String selection)
      parse a Selection String into String[] with '.' a delimiter. For example, "String.match" becomes {"String", "match"}
      Parameters:
      selection -
      Returns:
      arrayized selection

    • getFirstChoices

      public String[] getFirstChoices()
      Just a convenient wrapper for getNextChoices(String[])
      Returns:
      first level of choices

    • isSelectionComplete

      public boolean isSelectionComplete(String... previousSelections)
      is the selection a complete selection? Note the selection can be complete and not be a leaf. This method could be used to render complete selections in bold face in the UI.
      Parameters:
      previousSelections -
      Returns:
      completeness or incompleteness of selections

    • isSelectionComplete

      public boolean isSelectionComplete(List<String> previousSelections)

    • getSelectionByIndex

      public String[] getSelectionByIndex(int index)
      Given an index of a selection from an SDK2 option list, get the parsed selection from this ChoiceList
      Parameters:
      index - of selection from SDK
      Returns:
      the selection