Linux Certif

Toute la documentation sur la certification Linux LPI

NetSDS::Feature.3pm

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