1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
|
package Moose::Meta::Method::Destructor;
use strict;
use warnings;
use Devel::GlobalDestruction ();
use Scalar::Util 'blessed', 'weaken';
use Try::Tiny ();
our $VERSION = '1.09';
$VERSION = eval $VERSION;
our $AUTHORITY = 'cpan:STEVAN';
use base 'Moose::Meta::Method',
'Class::MOP::Method::Inlined';
sub new {
my $class = shift;
my %options = @_;
(ref $options{options} eq 'HASH')
|| $class->throw_error("You must pass a hash of options", data => $options{options});
($options{package_name} && $options{name})
|| $class->throw_error("You must supply the package_name and name parameters $Class::MOP::Method::UPGRADE_ERROR_TEXT");
my $self = bless {
# from our superclass
'body' => undef,
'package_name' => $options{package_name},
'name' => $options{name},
# ...
'options' => $options{options},
'associated_metaclass' => $options{metaclass},
} => $class;
# we don't want this creating
# a cycle in the code, if not
# needed
weaken($self->{'associated_metaclass'});
$self->_initialize_body;
return $self;
}
## accessors
sub options { (shift)->{'options'} }
## method
sub is_needed {
my $self = shift;
my $metaclass = shift;
( blessed $metaclass && $metaclass->isa('Class::MOP::Class') )
|| $self->throw_error(
"The is_needed method expected a metaclass object as its arugment");
return $metaclass->find_method_by_name("DEMOLISHALL");
}
sub initialize_body {
Carp::cluck('The initialize_body method has been made private.'
. " The public version is deprecated and will be removed in a future release.\n");
shift->_initialize_body;
}
sub _initialize_body {
my $self = shift;
# TODO:
# the %options should also include a both
# a call 'initializer' and call 'SUPER::'
# options, which should cover approx 90%
# of the possible use cases (even if it
# requires some adaption on the part of
# the author, after all, nothing is free)
my @DEMOLISH_methods = $self->associated_metaclass->find_all_methods_by_name('DEMOLISH');
my $source;
$source = 'sub {' . "\n";
$source .= 'my $self = shift;' . "\n";
$source .= 'return $self->Moose::Object::DESTROY(@_)' . "\n";
$source .= ' if Scalar::Util::blessed($self) ne ';
$source .= "'" . $self->associated_metaclass->name . "'";
$source .= ';' . "\n";
if ( @DEMOLISH_methods ) {
$source .= 'local $?;' . "\n";
$source .= 'my $in_global_destruction = Devel::GlobalDestruction::in_global_destruction;' . "\n";
$source .= 'Try::Tiny::try {' . "\n";
$source .= '$self->' . $_->{class} . '::DEMOLISH($in_global_destruction);' . "\n"
for @DEMOLISH_methods;
$source .= '}';
$source .= q[ Try::Tiny::catch { no warnings 'misc'; die $_ };] . "\n";
$source .= 'return;' . "\n";
}
$source .= '}';
warn $source if $self->options->{debug};
my ( $code, $e ) = $self->_compile_code(
environment => {},
code => $source,
);
$self->throw_error(
"Could not eval the destructor :\n\n$source\n\nbecause :\n\n$e",
error => $e, data => $source )
if $e;
$self->{'body'} = $code;
}
1;
__END__
=pod
=head1 NAME
Moose::Meta::Method::Destructor - Method Meta Object for destructors
=head1 DESCRIPTION
This class is a subclass of L<Class::MOP::Class::Generated> that
provides Moose-specific functionality for inlining destructors.
To understand this class, you should read the the
L<Class::MOP::Class::Generated> documentation as well.
=head1 INHERITANCE
C<Moose::Meta::Method::Destructor> is a subclass of
L<Moose::Meta::Method> I<and> L<Class::MOP::Method::Generated>.
=head1 METHODS
=over 4
=item B<< Moose::Meta;:Method::Destructor->new(%options) >>
This constructs a new object. It accepts the following options:
=over 8
=item * package_name
The package for the class in which the destructor is being
inlined. This option is required.
=item * name
The name of the destructor method. This option is required.
=item * metaclass
The metaclass for the class this destructor belongs to. This is
optional, as it can be set later by calling C<<
$metamethod->attach_to_class >>.
=back
=item B<< Moose::Meta;:Method::Destructor->is_needed($metaclass) >>
Given a L<Moose::Meta::Class> object, this method returns a boolean
indicating whether the class needs a destructor. If the class or any
of its parents defines a C<DEMOLISH> method, it needs a destructor.
=back
=head1 BUGS
See L<Moose/BUGS> for details on reporting bugs.
=head1 AUTHORS
Stevan Little E<lt>stevan@iinteractive.comE<gt>
=head1 COPYRIGHT AND LICENSE
Copyright 2006-2010 by Infinity Interactive, Inc.
L<http://www.iinteractive.com>
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.
=cut
|
