NAME

       Bread::Board::Container::Parameterized - A parameterized container

VERSION

       version 0.37

DESCRIPTION

       This class implements a sort of container factory for Bread::Board: a parameterized
       container is a, in practice, a function from a set of parameters (which must be
       containers) to an actual container. See Bread::Board::Manual::Example::FormSensible for an
       example.

ATTRIBUTES

   "name"
       Read/write string, required. Every container needs a name, by which it can be referenced
       when fetching it.

   "allowed_parameter_names"
       Read-only arrayref of strings, required. These are the names of the containers that must
       be passed to "create" to get an actual container out of this parameterized object.

   "container"
       This attribute holds the "prototype" container. Services inside it can depend on service
       paths that include the container names given in "allowed_parameter_names".

METHODS

   "add_service"
   "get_service"
   "has_service"
   "get_service_list"
   "has_services"
   "add_sub_container"
   "get_sub_container"
   "has_sub_container"
   "get_sub_container_list"
   "has_sub_containers"
       All these methods are delegated to the "prototype" "container", so that this object can be
       defined as if it were a normal container.

   "create"
         my $container = $parameterized_container->create(%params);

       After checking that the keys of %params are exactly the same strings that are present in
       "allowed_parameter_names", this method clones the prototype "container", adds the %params
       to the clone as sub-containers, and returns the clone.

       If this was not a top-level container, the parent is also cloned, and the container clone
       is added to the parent clone.

       Please note that the container returned by this method does not have the same name as the
       parameterized container, and that calling this method with different parameter values will
       return different containers, but all with the same name. It's probably a bad idea to
       instantiate a non-top-level parameterized container more than once.

   "fetch"
   "resolve"
       These two methods die, since services in a parameterized container won't usually resolve,
       and attempting to do so is almost always a mistake.

AUTHOR

       Stevan Little <stevan@iinteractive.com>

BUGS

       Please report any bugs or feature requests on the bugtracker website
       https://github.com/stevan/BreadBoard/issues

       When submitting a bug or request, please include a test-file or a patch to an existing
       test-file that illustrates the bug or desired feature.

COPYRIGHT AND LICENSE

       This software is copyright (c) 2019, 2017, 2016, 2015, 2014, 2013, 2011, 2009 by Infinity
       Interactive.

       This is free software; you can redistribute it and/or modify it under the same terms as
       the Perl 5 programming language system itself.