---
name: "Bread::Board::LifeCycle::Singleton::WithParameters"
section: "3pm"
platform: "linux"
package: "libbread-board-perl"
version: "0.37-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Bread::Board::LifeCycle::Singleton::WithParameters"
---

# Bread::Board::LifeCycle::Singleton::WithParameters(3pm)

singleton lifecycle role for a parameterized service

## NAME

Bread::Board::LifeCycle::Singleton::WithParameters - singleton lifecycle role for a parameterized service

## VERSION

version 0.37

## DESCRIPTION

Sub-role of Bread::Board::LifeCycle, this role defines the "singleton" lifecycle for a parameterized service. The `"get"` method will only do its work the first time it is invoked for each set of parameters; subsequent invocations with the same parameters will return the same object.

## ATTRIBUTES

### "instances"

Hashref mapping keys to objects, used to cache the results of "get"

## METHODS

### "get"

Generates a key using "generate\_instance\_key" (passing it all the arguments); if the "instances" attribute does not hold an object for that key, it will build it (by calling the underlying `"get"` method) and store it in "instances". The object (either retrieved from "instances" or freshly built) will be returned.

### "generate\_instance\_key"

Generates a (hopefully) unique key from the given arguments (usually, whatever was passed to "get"). The current implementation stringifies all arguments, so different references to identical values will be considered different.

## 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.