Interface ContributionDef

All Known Subinterfaces:
ContributionDef2, ContributionDef3
All Known Implementing Classes:
AbstractContributionDef, ContributionDefImpl, SyntheticSymbolSourceContributionDef

public interface ContributionDef
Contribution to a service configuration. The toString() method of the ContributionDef will be used for some exception reporting and should clearly identify where the contribution comes from; the normal behavior is to identify the class and method of the contribution method.
  • Method Details

    • getServiceId

      Identifies the service contributed to.
    • contribute

      void contribute(ModuleBuilderSource moduleSource, ServiceResources resources, Configuration configuration)
      Performs the work needed to contribute into the standard, unordered configuration.
      Parameters:
      moduleSource - the source, if needed, of the module instance associated with the contribution
      resources - allows access to services visible to the module
      configuration - the unordered configuration into which values should be loaded. This instance will encapsulate all related error checks (such as passing of nulls or inappropriate classes).
    • contribute

      void contribute(ModuleBuilderSource moduleSource, ServiceResources resources, OrderedConfiguration configuration)
      Performs the work needed to contribute into the ordered configuration.
      Parameters:
      moduleSource - the source, if needed, of the module instance associated with the contribution
      resources - allows access to services visible to the module
      configuration - the ordered configuration into which values should be loaded. This instance will encapsulate all related error checks (such as passing of nulls or inappropriate classes).
    • contribute

      void contribute(ModuleBuilderSource moduleSource, ServiceResources resources, MappedConfiguration configuration)
      Performs the work needed to contribute into the mapped configuration.
      Parameters:
      moduleSource - the source, if needed, of the module instance associated with the contribution
      resources - allows access to services visible to the module
      configuration - the mapped configuration into which values should be loaded. This instance will encapsulate all related error checks (such as passing of null keys or values or inappropriate classes, or duplicate keys).