John Napiorkowski > Catalyst-Runtime-5.90051 > Catalyst::Component::ContextClosure

Download:
Catalyst-Runtime-5.90051.tar.gz

Dependencies

Annotate this POD

Website

CPAN RT

New  23
Open  15
Stalled  1
View/Report Bugs
Source   Latest Release: Catalyst-Runtime-5.90079_003

NAME ^

Catalyst::Component::ContextClosure - Moose Role for components which need to close over the $ctx, without leaking

SYNOPSIS ^

    package MyApp::Controller::Foo;
    use Moose;
    use namespace::clean -except => 'meta';
    BEGIN {
        extends 'Catalyst::Controller';
        with 'Catalyst::Component::ContextClosure';
    }

    sub some_action : Local {
        my ($self, $ctx) = @_;
        $ctx->stash(a_closure => $self->make_context_closure(sub {
            my ($ctx) = @_;
            $ctx->response->body('body set from closure');
        }, $ctx));
    }

DESCRIPTION ^

A common problem with stashing a closure, that closes over the Catalyst context (often called $ctx or $c), is the circular reference it creates, as the closure holds onto a reference to context, and the context holds a reference to the closure in its stash. This creates a memory leak, unless you always carefully weaken the closures context reference.

This role provides a convenience method to create closures, that closes over $ctx.

METHODS ^

make_context_closure ($closure, $ctx)

Returns a code reference, that will invoke $closure with a weakened reference to $ctx. All other parameters to the returned code reference will be passed along to $closure.

SEE ALSO ^

Catalyst::Component

Catalyst::Controller

CatalystX::LeakChecker

COPYRIGHT ^

This library is free software. You can redistribute it and/or modify it under the same terms as Perl itself.

syntax highlighting: