NAME

Bread::Board::Traversable - role for traversing a container service tree

VERSION

version 0.37

SYNOPSIS

my $service = $container->fetch('/some/service/path');

my $root = $service->get_root_container;

DESCRIPTION

This role provides the basic functionality to traverse a container / service tree. Instances of classes consuming this role will get a parent-child relationship between them.

ATTRIBUTES

parent

Weak ref to another Bread::Board::Traversable object, read/write accessor (although you should probably not change this value directly in normal code).

METHODS

has_parent

Predicate for the "parent" attribute, true if a parent has been set.

detach_from_parent

Clearer for the "parent" attribute, you should probably not call this method in normal code.

get_root_container

Returns the farthest ancestor of the invocant, i.e. the top-most container this object is a part of.

fetch

my $service = $this->fetch('/absolute/path');
my $service = $this->fetch('relative/path');
my $service = $this->fetch('../relative/path');

Given a (relative or absolute) path to a service or container, this method walks the tree and returns the Bread::Board::Service or Bread::Board::Container instance for that path. Dies if no object can be found for the given path.

Aliases are resolved in this call, by calling aliased_from until we get an actual service.

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.