/ 
DBIx-QuickORM-0.000020
⭐ Starred 0 / DBIx::QuickORM::Role::Linked

NAME

DBIx::QuickORM::Role::Linked - Role for sources that expose links.

DESCRIPTION

Provides link-resolution for sources that know about DBIx::QuickORM::Link objects. Given a link specification (a name, alias, table, column set, or an existing link object), resolve_link finds the matching link, building and caching a set of lookup indexes the first time it is needed.

SYNOPSIS

package My::Source;
use Role::Tiny::With;
with 'DBIx::QuickORM::Role::Linked';

sub links { ... }

my $link = $source->resolve_link('author');

REQUIRED METHODS

Consumers must provide links, returning the arrayref of DBIx::QuickORM::Link objects this source knows about.

PUBLIC METHODS

$source->connection
$source->from

Default no-op accessors; consumers override them when they have a connection or can resolve a sub-source by name.

Resolve a link from a specification. Accepts an existing DBIx::QuickORM::Link (returned as-is), a reference (a hashref/arrayref parsed into a link), or a name/alias/table/column lookup. Croaks when the specification cannot be resolved or is ambiguous.

A bare string spec is a fuzzy lookup: it is matched against aliases, then table names, then column keys, and the first hit wins. To force a particular dimension, pass it by keyword instead:

$source->resolve_link(alias => 'author');           # by link alias only
$source->resolve_link(table => 'users');            # by destination table only
$source->resolve_link(table => 'users', columns => ['user_id']);  # by table + columns

alias and table resolve standalone; columns (or a precomputed key) is scoped to a table, so pass it together with table.

PRIVATE METHODS

Look a link up in the cached indexes by table, alias, key, or columns, building the indexes on first use. Returns a single link, an arrayref of candidates, or undef.

SOURCE

The source code repository for DBIx::QuickORM can be found at https://github.com/exodist/DBIx-QuickORM.

MAINTAINERS

Chad Granum <exodist@cpan.org>

AUTHORS

Chad Granum <exodist@cpan.org>

COPYRIGHT

Copyright Chad Granum <exodist7@gmail.com>.

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

See https://dev.perl.org/licenses/