Package org.apache.tapestry5.ioc.services

Interface PipelineBuilder

  • All Known Implementing Classes:
    PipelineBuilderImpl
    public interface PipelineBuilder
    Creates a pipeline from a service interface and an ordered list of filters. Each filter is defined in terms of a filter interface: the filter interface is a variant of the service interface, where each method has an additional parameter that is an instance of the service interface. Typically, this service parameter (often named "delegate") is either the first or the last parameter of each method. The implementation of a filter method is expected to pass all of its parameters to the service instance passed into it. The interesting thing is that there may be multiple filters in the pipeline. A fabricated "bridge" object (that implements the service interface) is created to let each filter invoke methods on the next filter down the pipeline. This simplifies the model for creating pipelines, as each filter is coded as if it was directly "in front of" the terminator. In fact, it may be indirectly invoking methods on the next filter in the pipeline via a bridge instance. The builder is fairly smart about matching up service interface methods to filter interface methods, but keeping it simple is also a good idea. By convention, the final parameter of each filter method is the delegate object (the bridge or terminator).

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      <S,​F>
      S      		 build​(org.slf4j.Logger logger, java.lang.Class<S> serviceInterface, java.lang.Class<F> filterInterface, java.util.List<F> filters)
      Creates a pipeline from just the filters.
      <S,​F>
      S      		 build​(org.slf4j.Logger logger, java.lang.Class<S> serviceInterface, java.lang.Class<F> filterInterface, java.util.List<F> filters, S terminator)
      Creates a pipeline from the filters and a terminator.

    • Method Detail

      • build

        <S,​F> S build​(org.slf4j.Logger logger,
                    java.lang.Class<S> serviceInterface,
                    java.lang.Class<F> filterInterface,
                    java.util.List<F> filters,
                    S terminator)
        Creates a pipeline from the filters and a terminator.
        Type Parameters:
        S - service type
        F - filter type
        Parameters:
        logger - logs any warnings generated when constructing the pipeline
        serviceInterface - defines the interface for the pipeline
        filterInterface - the filter interface, contributed into the pipeline
        filters - sorted list of filters
        terminator - end of the pipeline
        Returns:
        an object that encapsulates the filters and the terminator

      • build

        <S,​F> S build​(org.slf4j.Logger logger,
                    java.lang.Class<S> serviceInterface,
                    java.lang.Class<F> filterInterface,
                    java.util.List<F> filters)
        Creates a pipeline from just the filters. A default implementation is created as the terminator.
        Type Parameters:
        S - service type
        F - filter type
        Parameters:
        logger - logs any warnings generated when constructing the pipeline
        serviceInterface - defines the interface for the pipeline
        filterInterface - the filter interface, contributed into the pipeline
        filters - sorted list of filters
        Returns:
        an object that encapsulates the filters and the default implementation