पेश है अपाचे log4cxx लॉगिंग लाइब्रेरी

इससे पहले हमने Pantheios लॉगिंग लाइब्रेरी को देखा। अधिक प्रसिद्ध अपाचे log4cxx से परिचित होने के लिए बारी आई। पुस्तकालय C ++ में log4j (जावा लॉगिंग लाइब्रेरी) से सिद्धांतों और तंत्रों का कार्यान्वयन है। यह परियोजना "मृत" दिखती है, पिछले वर्ष में कम से कम कोई कठोर परिवर्तन नहीं देखा गया है, हालांकि इस पुस्तकालय को देखने (या शायद उपयोग नहीं) करने का कोई कारण नहीं है।

सामान्य टिप्पणी

मैं VisualStudio 2010 SP1 का उपयोग करके एक Windows प्लेटफ़ॉर्म पर लाइब्रेरी के साथ निर्माण और काम करने की प्रक्रिया पर विचार कर रहा हूं। लॉग्स, हमेशा की तरह, मैं कंसोल और फ़ाइल दोनों पर होना चाहता हूं। यह विशेष रूप से जोर देने के लायक है कि लॉग में राष्ट्रीय अक्षर (यूनिकोड पढ़ें) के सिमोल हो सकते हैं।

लेख शुरुआती के लिए अभिप्रेत है और इसमें एक त्वरित शुरुआत के लिए सामग्री है, न कि पुस्तकालय का गहन अध्ययन।

एक पुस्तकालय हो रही है

• पुस्तकालय की वेबसाइट: http://log.apache.org/log4cxx/index.html
• लाइसेंस: अपाचे लाइसेंस, संस्करण 2.0
• निर्भर करता है: अपाचे पोर्टेबल रनटाइम (APR) ( http://apr.apache.org/ )
• विधानसभा की आवश्यकता: sed (GNU यूटिल्स से)

सभा

सबसे पहले, हमें निर्भरता और पुस्तकालय को स्वयं डाउनलोड करने की आवश्यकता है। अच्छे के लिए, आपको इसे एसवीएन परियोजना से डाउनलोड करना चाहिए, जैसे कमिट्स को देखते हुए, बग्स को ठीक किया गया था, लेकिन किसी कारण से मैंने जोखिम नहीं लेने और स्थिर संस्करण 0.10.0 के साथ अपनी किस्मत आजमाने का फैसला किया।

तो चलिए!
डाउनलोड कर रहा है:
: www.apache.org/dyn/closer.cgi/logging/log4cxx/0.10.0/apache-log4cxx-0.10.0.tar.gz
APR: apr.apache.org/download.cgi ( APR 1.4.2, APR-util 1.3.10 , APR iconv 1.2.1)
Sed: sourceforge.net/projects/gnuwin32/files//sed/4.2.1/sed-4.2.1-bin.zip/download

Sed:
sourceforge.net/projects/gnuwin32/files/libintl/0.14.4/libintl-0.14.4-bin.zip/download
sourceforge.net/projects/gnuwin32/files/libiconv/1.9.2-1/libiconv-1.9.2-1-bin.zip/download
sourceforge.net/projects/gnuwin32/files/regex/2.7/regex-2.7-bin.zip/download

Fuf, सबसे मुश्किल हिस्सा पीछे है ...

निकालें:

• C: \ temp \ log4cxx_test \ apache-log4cxx-0.10.0 \
• C में APR: \ temp \ log4cxx_test \ apr \ (संग्रह फ़ोल्डर का नाम बदलना मत भूलना)
• APR Util C: \ temp \ log4cxx_test \ apr-use \ (संग्रह फ़ोल्डर का नाम बदलना मत भूलना)
• C में APR: \ temp \ log4cxx_test \ apr-use \ (संग्रह का नाम बदलना न भूलें)

मुझे मशीन पर इस तरह से sed की आवश्यकता नहीं है, लेकिन मुझे इसे एक कॉन्फ़िगरेशन स्क्रिप्ट की आवश्यकता है, मुझे इसे यहां छोड़ना होगा: C: \ temp \ log4cxx \ Apache-log4cxx-0.10.0 \ और सभी dll फाइलें डालें, जिस पर यह निर्भर करता है। यदि भविष्य में उन्हें sed की आवश्यकता हो, तो Aesthetes, sed और dll दोनों को% SystemRoot% \ System32 \ में फेंक सकते हैं।

अगला: कमांड लाइन VS2010 चलाएं और निर्देशिका C: \ temp \ log4cxx \ Apache-log4cxx-0.10.0 \ पर जाएं और इसे अनुक्रम में करें:
>configure
>configure-aprutil


कोई त्रुटि नहीं होनी चाहिए।

यह विधानसभा की बारी थी। यहाँ यह स्टूडियो (devenv) शुरू करने और c: \ temp \ log4cxx \ Apache-log4cxx-0.10.0 \ परियोजनाओं \ log4cxx.dsw को खोलने के लायक है। स्टूडियो आपको उन परियोजनाओं को बदलने के लिए कहेगा, जो हमें चाहिए।

हम बिल्ड दबाते हैं, लेकिन हम चाय पीने नहीं जाते हैं। असेंबली प्रक्रिया ~ 300 मील की त्रुटियों के साथ जल्दी समाप्त हो जाएगी। यह LOG4CXX_LIST_DEF मैक्रो पर शपथ लेगा। ऐसे सभी मैक्रो को कक्षा के सामने प्रस्तुत किया जाना चाहिए (वे कक्षा के अंदर घोषित किए जाते हैं)।

इन त्रुटियों को दूर करने के बाद, अज्ञात std :: insert_iterator से संबंधित त्रुटियाँ होंगी - बस फ़ाइल की शुरुआत में #include <iterator> जोड़ें।

इसके बाद, KeySet अनिश्चितता के बारे में त्रुटियाँ दिखाई देंगी - ऐसी सभी त्रुटियों को बदलना होगा (उदाहरण):
LoggingEvent::KeySet set;

KeySet set;

(चूंकि हमने एक मैक्रो को हटा दिया है जो कक्षाओं के बाहर इन समान कीसेट्स बनाता है)।

इस "shamanism" के बाद विधानसभा सफल होगी, लेकिन कुछ कार्यों की अनिश्चितता के बारे में संदेशों के साथ लिंक "विफल" होगा। बस यह कि रूपांतरण करते समय, स्टूडियो परियोजना में आवश्यक फाइलों के लिंक बनाना भूल गया।
उन्हें बस log4cxx प्रोजेक्ट के गुणों में जोड़ा जाना चाहिए (मैं पूर्ण सरलता के लिए पथों को हार्डकोड करता हूं, क्योंकि मुझे केवल एक बार के निर्माण की अवधि के लिए इसकी आवश्यकता है):



जिसके बाद लिंक काम करेगा।

संक्षेप में वास्तुकला के बारे में

log4cxx एपेंडर्स, लेआउट्स और टारगेट की अवधारणाओं के साथ काम करता है।

परिशिष्ट - प्राप्तकर्ता (लक्ष्य) संदेश प्रवाह (सार में लाइनों का लॉग) के लिए मापदंडों के एक सेट को परिभाषित करता है, जिसमें लेआउट का एक लिंक होता है, जो बदले में संदेश को प्रारूपित करने के नियमों को निर्धारित करता है।

प्रोजेक्ट वेबसाइट पर वास्तुकला के बारे में और पढ़ें।

परीक्षण कार्य

मैं पर्यावरण कार्यक्रमों के माध्यम से अपने कार्यक्रमों में इसी तरह की मौलिक पुस्तकालयों को खींचना पसंद करता हूं (लेकिन जब से मैं पुस्तकालयों के विभिन्न संस्करणों के साथ काम करता हूं तो मैं उन्हें उपयोगकर्ता के लिए पर्यावरण चर के रूप में परिभाषित नहीं करने की कोशिश करता हूं)। इसलिए, कमांड लाइन VS2010 हम निम्नलिखित में चला रहे हैं:
>SET LOG4CXX=C:\temp\log4cxx\apache-log4cxx-0.10.0\src\main\include\
>SET LOG4CXXLIB=C:\temp\log4cxx\apache-log4cxx-0.10.0\projects\Debug\
>devnenv

(मैंने डिबग मोड में एकत्र किया, रिलीज के लिए, ज़ाहिर है, रास्ते थोड़े अलग हैं)।

अगला, एक साधारण C ++ कंसोल एप्लिकेशन प्रोजेक्ट बनाएं - यह हमारी परीक्षा परियोजना होगी।
इसमें, हम अपने वातावरण चर के अनुसार प्रोजेक्ट सेटअप में सामान्य रूप से शामिल फ़ाइलों और पुस्तकालयों को शामिल करते हैं:

और जोड़ने के लिए:




इसमें हमें शामिल करने की बारी है:

 //apache log4cxx #pragma warning(push) #pragma warning(disable: 4231 4250) //warning C4231: nonstandard extension used : 'extern' before template explicit instantiation c:\libs\apache\apache-log4cxx-0.10.0\src\main\include\log4cxx\rolling\timebasedrollingpolicy.h 221 p2jbTestApp //warning C4250: 'log4cxx::rolling::TimeBasedRollingPolicy' : inherits 'log4cxx::rolling::RollingPolicyBase::log4cxx::rolling::RollingPolicyBase::setOption' via dominance #include <log4cxx/rolling/rollingfileappender.h> #include <log4cxx/logger.h> #include <log4cxx/consoleappender.h> #include <log4cxx/logmanager.h> #include <log4cxx/patternlayout.h> #include <log4cxx/rolling/timebasedrollingpolicy.h> #include <log4cxx/helpers/simpledateformat.h> #include <log4cxx/helpers/stringhelper.h> #include <log4cxx/xml/domconfigurator.h> #pragma warning(pop) 

अब आपको एक कॉन्फ़िगरेशन फ़ाइल बनाने की आवश्यकता है। मैंने इसे इस तरह बनाया है:

 <?xml version="1.0" encoding="UTF-8" ?> <!-- debug="true" --> <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/" > <appender name="ConsoleAppender" class="org.apache.log4j.ConsoleAppender"> <param name="Target" value="System.out"/> <layout class="org.apache.log4j.PatternLayout"> <param name="ConversionPattern" value="%d{ABSOLUTE} [%t] %level %c{2}#%M %F:%L - %m%n"/> </layout> </appender> <appender name="DailyRollingFileAppender" class="org.apache.log4j.rolling.DailyRollingFileAppender"> <layout class="org.apache.log4j.PatternLayout"> <param name="ConversionPattern" value="%d{ABSOLUTE} [%t] %level %c{2}#%M %F:%L - %m%n"/> </layout> <param name="Encoding" value="UTF-16" /> <param name="file" value="logfile.log"/> <param name="DatePattern" value="'.'yyyy-MM-dd" /> <param name="append" value="true"/> </appender> <root> <priority value="all" /> <appender-ref ref="DailyRollingFileAppender"/> <appender-ref ref="ConsoleAppender"/> </root> </log4j:configuration> 

आप log4j के लिए प्रलेखन में अधिक पढ़ सकते हैं, क्योंकि फ़ाइल प्रारूप "लगभग मैच।"

अच्छी तरह से और नीचे परीक्षण कार्यक्रम:

 void foo(void*) { log4cxx::LoggerPtr logger = log4cxx::Logger::getRootLogger(); for(int i=0;i<10;++i){ LOG4CXX_DEBUG((logger), L"debug" << L"other debug message"); LOG4CXX_TRACE((logger), L"trace"); LOG4CXX_INFO((logger), L", !"); LOG4CXX_WARN((logger), L"WARN"); LOG4CXX_ERROR((logger), L"error"); LOG4CXX_FATAL((logger), L"FATAL"); } } int _tmain(int argc, _TCHAR* argv[]) { setlocale(LC_ALL, "Russian_Russia.OCP"); //      TCHAR selfName[MAX_PATH]; HMODULE hModule = GetModuleHandle(NULL); GetModuleFileName(hModule, selfName, _countof(selfName)); std::wstring configFile(selfName); configFile.append(L".logconfig"); log4cxx::xml::DOMConfigurator::configure(configFile); for(int i=0;i<10;++i){ _beginthread(foo,0,NULL); } std::cin.get(); return 0; } 

मैं उपयोग की "चाल" पर ध्यान देता हूं:

 LOG4CXX_DEBUG((logger), L"debug" << L"other debug message"); 

"यह कैसे काम करता है" चक्र से। तथ्य यह है कि मैक्रो का दूसरा तर्क स्ट्रीम इनपुट को पास किया गया है, और यही कारण है कि आप ऑपरेटर का उपयोग करके यहां कई संदेश (केवल पाठ नहीं) लिख सकते हैं।

निष्कर्ष

हमने साधारण उदाहरण का उपयोग करके log4cxx के असेंबली और बेसिक सेटअप को देखा।
लाइब्रेरी के फायदों के बीच, यह कॉन्फ़िगरेशन फ़ाइल के माध्यम से कस्टमिज़ेबिलिटी को उजागर करने के लायक है, बॉक्स के बाहर यूनिकोड समर्थन (आउटपुट फ़ाइलों के विभिन्न एन्कोडिंग सहित)।

मंत्रियों में से, यह विधानसभा की सापेक्ष जटिलता पर ध्यान देने योग्य है, वे यह भी कहते हैं कि पुस्तकालय बह रहा है और इतनी तेजी से नहीं।

इस विषय के बाहर रहता है: उन्नत कॉन्फ़िगरेशन, अन्य लकड़हारा की तुलना में, "लीक के मिथक" का सत्यापन।

एक अच्छा प्रवेश करें!