NAME¶
NetSDS::Feature - abstract application feature
SYNOPSIS¶
package NetSDS::Feature::DBI;
use DBI;
use base 'NetSDS::Feature';
sub init {
my ($self) = @_;
my $dsn = $self->conf->{dsn};
my $user = $self->conf->{user};
my $passwd = $self->conf->{passwd};
$self->{dbconn} = DBI->connect($dsn, $user, $passwd);
}
# Sample method - DBI::do proxy
sub do {
my $self = shift @_;
return $self->{dbconn}->do(@_);
}
1;
DESCRIPTION¶
Application "features" are Perl5 packages with unified API for easy
integration of some functionality into NetSDS applications infrastructure.
"NetSDS::Feature" module contains superclass for application features
providing the following common feature functionality:
* class construction
* initialization stub
* logging
CLASS METHODS¶
- create($app, $conf) - feature constructor
- init() - feature initialization
- This method should be rewritten with feature functionality implementation.
It's possibly to use application and configuration handlers at this time.
Example:
sub init {
my ($self) = @_;
$self->{answer} = $self->conf->{answer} || '42';
my $pid = $self->app->pid();
if ($self->app->daemon()) {
$self->log("info", "Seems we are in a daemon mode");
}
}
OBJECT METHODS¶
- app() - application object
- This method allows to use application methods and properties.
print "Feature included from app: " . $self->app->name;
- conf() - feature configuration
- This method provides access to feature configuration.
- log($level, $message) - implements logging
- Example:
# Write log message
$self->log("info", "Application does something interesting.");
See NetSDS::Logger documentation for details.
EXAMPLES¶
See "samples/app_features.pl" script.
SEE ALSO¶
- •
- NetSDS::App
AUTHOR¶
Michael Bochkaryov <misha@rattler.kiev.ua>
LICENSE¶
Copyright (C) 2008-2009 Net Style Ltd.
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA