Package org.apache.tapestry5.ioc.services

## Interface SymbolSource

- All Known Implementing Classes:
    `SymbolSourceImpl`

      @UsesOrderedConfiguration(SymbolProvider.class)
      public interface SymbolSource

  Used to manage symbols, configuration properties whose value is evaluated at runtime. Symbols use the Ant syntax: `${foo.bar.baz}` where `foo.bar.baz` is the name of the symbol. The symbol may appear inside some annotation, such as `Value`. The SymbolSource service configuration is an ordered list of `SymbolProvider`s. Two key SymbolProvider services are FactoryDefaults and ApplicationDefaults.

- - ### Method Summary

    All Methods Instance Methods Abstract Methods
    Modifier and Type | Method | Description
    --- | --- | ---
    `java.lang.String` | `expandSymbols​(java.lang.String input)` | Given an input string that may contain symbols, returns the string with any and all symbols fully expanded.
    `java.lang.String` | `valueForSymbol​(java.lang.String symbolName)` | Expands the value for a particular symbol.

- - ### Method Detail

    - #### valueForSymbol

          java.lang.String valueForSymbol​(java.lang.String symbolName)

      Expands the value for a particular symbol. This may involve recursive expansion, if the immediate value for the symbol itself contains symbols.
      Parameters:
        `symbolName` -
      Returns:
        the expanded string
      Throws:
        `java.lang.RuntimeException` - if the symbol name can not be expanded (no `SymbolProvider` can provide its value), or if an expansion is directly or indirectly recursive

    - #### expandSymbols

          java.lang.String expandSymbols​(java.lang.String input)

      Given an input string that may contain symbols, returns the string with any and all symbols fully expanded.
      Parameters:
        `input` -
      Returns:
        expanded input