NAME

Bread::Board::LifeCycle::Singleton - service role for singleton lifecycle

VERSION

version 0.35

DESCRIPTION

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

ATTRIBUTES

`instance`

The object build by the last call to get to actually do any work, and returned by any subsequent call to get.

METHODS

`get`

The first time this is called (or the first time after calling "flush_instance"), the actual get method will be invoked, and its return value cached in the "instance" attribute. The value of that attribute will always be returned, so you can call get as many time as you need, and always receive the same instance.

`has_instance`

Predicate for the "instance" attribute.

`flush_instance`

Clearer for the "instance" attribute. Clearing the attribute will cause the next call to get to instantiate a new object.

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 is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.