Net::DRI::Logging::Null(3pm) User Contributed Perl Documentation Net::DRI::Logging::Null(3pm)NAME
Net::DRI::Logging::Null - Null Logging Operations for Net::DRI
VERSION
This documentation refers to Net::DRI::Logging::Null version 1.01
SYNOPSIS
See Net::DRI::Logging
DESCRIPTION
This is the default logging class used by Net::DRI if nothing else is specified,
It discards everything (no logging at all).
EXAMPLES
$dri->new({..., logging => 'null' ,...});
If not provided during "new()", this is the default behaviour.
SUBROUTINES /METHODS
All mandated by superclass Net::DRI::Logging.
DIAGNOSTICS
None.
CONFIGURATION AND ENVIRONMENT
None.
DEPENDENCIES
This module has to be used inside the Net::DRI framework and needs the following components:
Net::DRI::Logging
INCOMPATIBILITIES
None
BUGS AND LIMITATIONS
No known bugs. Please report problems to author (see below) or use CPAN RT system. Patches are welcome.
SUPPORT
For now, support questions should be sent to:
<netdri@dotandco.com>
Please also see the SUPPORT file in the distribution.
SEE ALSO
<http://www.dotandco.com/services/software/Net-DRI/>
AUTHOR
Patrick Mevzek, <netdri@dotandco.com>
LICENSE AND COPYRIGHT
Copyright (c) 2009 Patrick Mevzek <netdri@dotandco.com>. All rights reserved.
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.
See the LICENSE file that comes with this distribution for more details.
perl v5.10.1 2010-03-25 Net::DRI::Logging::Null(3pm)
Check Out this Related Man Page
Net::DRI::Logging(3pm) User Contributed Perl Documentation Net::DRI::Logging(3pm)NAME
Net::DRI::Logging - Logging Operations for Net::DRI
VERSION
This documentation refers to Net::DRI::Logging version 1.02
SYNOPSIS
This module is never used directly, only its subclasses are used. See the subclasses documentation: Net::DRI::Logging::Files,
Net::DRI::Logging::Null and Net::DRI::Logging::Stderr. See also Net::DRI documentation and its "logging()" method.
DESCRIPTION
This is the superclass of all logging modules (under the Net::DRI::Logging::* namespace).
EXAMPLES
See Net::DRI documentation.
SUBROUTINES /METHODS
This is mostly a pure virtual superclass. All subclasses should have the following methods:
new()
a ref hash is passed with some keys ; besides keys specifically related to the logging class used, some keys are (or should be)
understood by all clases.
They are:
level
current level of logging (no messages below this level would be dumped), between: debug info notice warning error critical alert
emergency ; default: warning
It can be changed anytime later by using the level() method
xml_indent
0 or 1 depending if you want your XML strings to be dumped as a long line(0) or indented for humans(1) ; default: 0
encoding
if needed, name of encoding to use to convert data stream ; default: UTF-8
name()
returns the name as string of the logging modules
setup_channel(SOURCE,TYPE,DATA)
prepare for a new channel of data comming from SOURCE (package name), of TYPE ; DATA is a ref hash of additional parameter, such as
filenames, etc.
output(LEVEL,TYPE,DATA1,DATA2,...)
add data to channel type TYPE at level LEVEL ('debug', 'info', 'notice', etc.) ; DATA is a ref hash with all data to log or a simple
string (the message) ; the logging module should know what to do with it and how to format it (which may depend on the TYPE attribute,
which itself is tied to the SOURCE attribute of "setup_channel()").
DIAGNOSTICS
None.
CONFIGURATION AND ENVIRONMENT
See the "new()" method.
DEPENDENCIES
This module has to be used inside the Net::DRI framework and needs the following components:
Net::DRI::BaseClass
Net::DRI::Util
Net::DRI::Exception
INCOMPATIBILITIES
None.
BUGS AND LIMITATIONS
No known bugs. Please report problems to author (see below) or use CPAN RT system. Patches are welcome.
The interface could be later changed to suit Log::Log4Perl or other Perl standard logging modules, if needed.
Other subclasses should be created to cater for other logging destinations (such as a RDBMS).
Net::DRI expects these logging modules to be non-blocking and returning immediately.
This logging framework is currently only used by Net::DRI::Transport::Socket, it should get applied to other transports and other internal
parts of Net::DRI.
When LocalStorage do appear inside Net::DRI, logging should probably use it (TODO).
SUPPORT
For now, support questions should be sent to:
<netdri@dotandco.com>
Please also see the SUPPORT file in the distribution.
SEE ALSO
<http://www.dotandco.com/services/software/Net-DRI/>
AUTHOR
Patrick Mevzek, <netdri@dotandco.com>
LICENSE AND COPYRIGHT
Copyright (c) 2009,2010 Patrick Mevzek <netdri@dotandco.com>. All rights reserved.
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.
See the LICENSE file that comes with this distribution for more details.
perl v5.10.1 2010-03-25 Net::DRI::Logging(3pm)