JavaMap(3p)    User Contributed Perl Documentation    JavaMap(3p)


NAME
       Log::Log4perl::JavaMap - maps java log4j appenders to Log::Dispatch
       classes

SYNOPSIS
            ###############################
            log4j.appender.FileAppndr1        = org.apache.log4j.FileAppender
            log4j.appender.FileAppndr1.File   = /var/log/onetime.log
            log4j.appender.FileAppndr1.Append = false

            log4j.appender.FileAppndr1.layout = org.apache.log4j.PatternLayout
            log4j.appender.FileAppndr1.layout.ConversionPattern=%d %4r [%t] %-5p %c %x - %m%n
            ###############################

DESCRIPTION
       If somebody wants to create an appender called
       "org.apache.log4j.ConsoleAppender", we want to translate it to
       Log::Dispatch::Screen, and then translate the log4j options into
       Log::Dispatch parameters..

   What's Implemented
       (Note that you can always use the Log::Dispatch::* module.  By
       'implemented' I mean having a translation class that translates log4j
       options into the Log::Dispatch options so you can use log4j rather than
       log4perl syntax in your config file.)

       Here's the list of appenders I see on the current (6/2002) log4j site.

       These are implemented

           ConsoleAppender     - Log::Dispatch::Screen
           FileAppender        - Log::Dispatch::File
           RollingFileAppender - Log::Dispatch::FileRotate (by Mark Pfeiffer)
           JDBCAppender        - Log::Log4perl::Appender::DBI
           SyslogAppender      - Log::Dispatch::Syslog
           NTEventLogAppender  - Log::Dispatch::Win32EventLog

       These should/will/might be implemented

           DailyRollingFileAppender -
           SMTPAppender     - Log::Dispatch::Email::MailSender

       These might be implemented but they don't have corresponding classes in
       Log::Dispatch (yet):

           NullAppender
           TelnetAppender

       These might be simulated

           LF5Appender - use Tk?
           ExternallyRolledFileAppender - catch a HUP instead?

       These will probably not be implemented



perl v5.12.2                2009-05-02                          1





JavaMap(3p)    User Contributed Perl Documentation    JavaMap(3p)


           AsyncAppender
           JMSAppender
           SocketAppender - (ships a serialized LoggingEvent to the server side)
           SocketHubAppender

ROLL YOUR OWN
       Let's say you've in a mixed Java/Perl enviroment and you've come up
       with some custom Java appender with behavior you want to use in both
       worlds, "myorg.customAppender".  You write a Perl appender with the
       same behavior "Myorg::CustomAppender". You want to use one config file
       accross both applications, so the config file will have to say
       'myorg.customAppender'.  But the mapping from "myorg.customAppender" to
       "Myorg::CustomAppender" isn't in this JavaMap class, so what do you do?

       In  your Perl code, before you call Log::Log4perl::init(), do this:

           $Log::Log4perl::JavaMap::user_defined{'myorg.customAppender'} =
               'Myorg::CustomAppender';

       and you can use 'myorg.customAppender' in your config file with
       impunity.

AUTHORS
           Kevin Goess, <cpanATgoess.org>
           Mike Schilli, <mATperlmeister.com>

           June, 2002

SEE ALSO
       http://jakarta.apache.org/log4j/docs/



























perl v5.12.2                2009-05-02                          2