Class::MakeMethods::Standard::Universal - Generic Methods |
Class::MakeMethods::Standard::Universal - Generic Methods
package MyObject; use Class::MakeMethods::Standard::Universal ( no_op => 'this', abstract => 'that', delegate => { name=>'play_music', target=>'instrument', method=>'play' }, );
The Standard::Universal suclass of MakeMethods provides a [INCOMPLETE].
When you use
this package, the method names you provide
as arguments cause subroutines to be generated and installed in
your module.
See Calling Conventions in the Class::MakeMethods::Standard manpage for more information.
To declare methods, pass in pairs of a method-type name followed by one or more method names.
Valid method-type names for this package are listed in METHOD GENERATOR TYPES.
See Declaration Syntax in the Class::MakeMethods::Standard manpage and Parameter Syntax in the Class::MakeMethods::Standard manpage for more information.
For each method name passed, returns a subroutine with the following characteristics:
You might want to create and use such methods to provide hooks for subclass activity.
Sample declaration and usage:
package MyObject; use Class::MakeMethods::Standard::Universal ( no_op => 'whatever', ); ...
# Doesn't do anything MyObject->whatever();
For each method name passed, returns a subroutine with the following characteristics:
This is intended to support the use of abstract methods, that must be overidden in a useful subclass.
If each subclass is expected to provide an implementation of a given method, using this abstract method will replace the generic error message below with the clearer, more explicit error message that follows it:
Can't locate object method "foo" via package "My::Subclass" The "foo" method is abstract and can not be called on My::Subclass
However, note that the existence of this method will be detected by UNIVERSAL::can(), so it is not suitable for use in optional interfaces, for which you may wish to be able to detect whether the method is supported or not.
Sample declaration and usage:
package MyObject; use Class::MakeMethods::Standard::Universal ( abstract => 'whatever', ); ...
package MySubclass; sub whatever { ... }
# Failure MyObject->whatever();
# Success MySubclass->whatever();
For each method name passed, returns a subroutine with the following characteristics:
Sample declaration and usage:
package MyObject; use Class::MakeMethods::Standard::Universal ( call_methods => 'init', ); ...
my $object = MyObject->new() $object->init( foo => 'Foozle', bar => 'Barbados' );
# Equivalent to: $object->foo('Foozle'); $object->bar('Barbados');
For each method name passed, returns a subroutine with the following characteristics:
For each method name passed, returns a subroutine with the following characteristics:
You might create such a method to extend or adapt your class' interface.
Sample declaration and usage:
package MyObject; use Class::MakeMethods::Standard::Universal ( alias => { name=>'click_here', target=>'complex_machinery' } ); sub complex_machinery { ... } ...
$myobj->click_here(...); # calls $myobj->complex_machinery(...)
For each method name passed, returns a subroutine with the following characteristics:
You might want to create and use such methods to faciliate composition of objects from smaller objects.
Sample declaration and usage:
package MyObject; use Class::MakeMethods::Standard::Universal ( 'Standard::Hash:object' => { name=>'instrument' }, delegate => { name=>'play_music', target=>'instrument', method=>'play' } ); ...
my $object = MyObject->new(); $object->instrument( MyInstrument->new ); $object->play_music;
See the Class::MakeMethods manpage for general information about this distribution.
See the Class::MakeMethods::Standard manpage for more about this family of subclasses.
Class::MakeMethods::Standard::Universal - Generic Methods |