Class PreviewOptions.Builder

Enclosing class:
PreviewOptions

public static final class PreviewOptions.Builder extends UpdateOptions.Builder<PreviewOptions.Builder>
Builder for PreviewOptions.
  • Method Details

    • expectNoChanges

      public PreviewOptions.Builder expectNoChanges(boolean expectNoChanges)
      Return an error if any changes are proposed by this preview.
      Parameters:
      expectNoChanges - true if the preview should fail if any changes are proposed
      Returns:
      the builder
    • diff

      public PreviewOptions.Builder diff(boolean diff)
      Display the operation as a rich diff showing the overall change.
      Parameters:
      diff - true if a rich diff should be displayed
      Returns:
      the builder
    • replaces

      public PreviewOptions.Builder replaces(List<String> replaces)
      Resources to replace.
      Parameters:
      replaces - the list of resource URNs to replace
      Returns:
      the builder
    • excludeDependents

      public PreviewOptions.Builder excludeDependents(boolean excludeDependents)
      Allows exclusion of dependent targets discovered but not specified UpdateOptions.excludes()
      Parameters:
      excludeDependents - true if dependent targets should be excluded
      Returns:
      the builder
    • targetDependents

      public PreviewOptions.Builder targetDependents(boolean targetDependents)
      Allows updating of dependent targets discovered but not specified UpdateOptions.targets()
      Parameters:
      targetDependents - true if dependent targets should be updated
      Returns:
      the builder
    • program

      public PreviewOptions.Builder program(Consumer<Context> program)
      The program to execute as part of the update.
      Parameters:
      program - the program to execute
      Returns:
      the builder
    • plan

      public PreviewOptions.Builder plan(String plan)
      Save the operations proposed by the preview to a plan file at the given path.
      Parameters:
      plan - the path to the update plan
      Returns:
      the builder
    • logger

      public PreviewOptions.Builder logger(Logger logger)
      A custom logger instance that will be used for the action. Note that it will only be used if program is also provided.
      Parameters:
      logger - the logger
      Returns:
      the builder
    • build

      public PreviewOptions build()
      Builds the PreviewOptions.
      Returns:
      the preview options