Package software.amazon.smithy.codegen.core

Class ReservedWordSymbolProvider.Builder

java.lang.Object
software.amazon.smithy.codegen.core.ReservedWordSymbolProvider.Builder
Enclosing class:
ReservedWordSymbolProvider
public static final class ReservedWordSymbolProvider.Builder extends Object
Builder to build a ReservedWordSymbolProvider.

  • Constructor Details

    • Builder

      public Builder()

  • Method Details

    • build

      public SymbolProvider build()
      Builds a SymbolProvider implementation that wraps another symbol provider and escapes its results.

      This might not always be the right solution. For example, symbol providers often need to recursively resolve symbols to create shapes like arrays and maps. In these cases, delegating would be awkward or impossible since the symbol provider being wrapped would also need access to the wrapper. In cases like this, use buildEscaper() and pass that into the SymbolProvider directly.

      Returns:
      Returns the built SymbolProvider that delegates to another.

    • buildEscaper

      public ReservedWordSymbolProvider.Escaper buildEscaper()
      Builds a SymbolProvider.Escaper that is used to manually escape Symbols and member names.
      Returns:
      Returns the built escaper.

    • symbolProvider

      public ReservedWordSymbolProvider.Builder symbolProvider(SymbolProvider delegate)
      Sets the delegate symbol provider.

      This is only required when calling build() to build a SymbolProvider that delegates to another provider.

      Parameters:
      delegate - Symbol provider to delegate to.
      Returns:
      Returns the builder

    • filenameReservedWords

      public ReservedWordSymbolProvider.Builder filenameReservedWords(ReservedWords filenameReservedWords)
      Sets the reserved word implementation for file names.

      If not provided, file names are not passed through a reserved words implementation after calling the delegate.

      Parameters:
      filenameReservedWords - Reserved word implementation for namespaces.
      Returns:
      Returns the builder.

    • namespaceReservedWords

      public ReservedWordSymbolProvider.Builder namespaceReservedWords(ReservedWords namespaceReservedWords)
      Sets the reserved word implementation for namespace names.

      If not provided, namespace names are not passed through a reserved words implementation after calling the delegate.

      Parameters:
      namespaceReservedWords - Reserved word implementation for namespaces.
      Returns:
      Returns the builder.

    • nameReservedWords

      public ReservedWordSymbolProvider.Builder nameReservedWords(ReservedWords nameReservedWords)
      Sets the reserved word implementation for names (structures names, class names, etc.).

      If not provided, names are not passed through a reserved words implementation after calling the delegate.

      Parameters:
      nameReservedWords - Reserved word implementation for containers.
      Returns:
      Returns the builder.

    • memberReservedWords

      public ReservedWordSymbolProvider.Builder memberReservedWords(ReservedWords memberReservedWords)
      Sets the reserved word implementation for members.

      If not provided, member names are not passed through a reserved words implementation after calling the delegate.

      Parameters:
      memberReservedWords - Reserved word implementation for members.
      Returns:
      Returns the builder.

    • escapePredicate

      public ReservedWordSymbolProvider.Builder escapePredicate(BiPredicate<Shape,Symbol> escapePredicate)
      Sets a predicate that is used to control when a shape + symbol combination should be checked if it's a reserved word.

      The predicate is invoked when toSymbol is called. It is used to disable/enable escaping reserved words based on the shape and symbol. The given predicate accepts the Shape and the Symbol that was created for the shape and returns true if reserved word checks should be made or false if reserved word checks should not be made. For example, some code generators only escape words that have namespaces to differentiate between language built-ins and user-defined types.

      By default, all symbols are checked for reserved words.

      Parameters:
      escapePredicate - Predicate that returns true if escaping should be checked.
      Returns:
      Returns the builder.