स्टैकट्रेस फ़िल्टरिंग, साइलेंट स्ट्रिंग पार्सिंग और संस्करण तुलना के साथ ओपन सोर्स जावा लाइब्रेरी

विभिन्न नौकरियों में कुछ समय के बाद, मुझे कई उपयोगिताओं की आवश्यकता हुई जो मुझे उस समय उपलब्ध नहीं मिली। और मैंने देखा कि मुझे बार-बार उनकी जरूरत थी। इसलिए मैंने अपनी छोटी सी लाइब्रेरी लिखी जो मुझे बहुत उपयोगी लगी। इसलिए मैंने इसे एक ओपन-सोर्स जावा लाइब्रेरी के रूप में प्रकाशित किया।

यहाँ Github लिंक दिया गया है

जावदोक ऑनलाइन यहाँ उपलब्ध है

इसके अलावा, यह पुस्तकालय मावेन सेंट्रल पर उपलब्ध है। यहां मावेन कलाकृतियां हैं (संस्करण 1.5.0.8 इस लेख के लेखन के समय नवीनतम है, लेकिन भविष्य में हो सकता है। http: //search.moden पर विरूपण साक्ष्य "MgntUtils" के नवीनतम संस्करण की खोज करने के लिए । org / ):

<dependency> <groupId>com.github.michaelgantman</groupId> <artifactId>MgntUtils</artifactId> <version>1.5.0.8</version> </dependency> <dependency> <groupId>com.github.michaelgantman</groupId> <artifactId>MgntUtils</artifactId> <version>1.5.0.8</version> <classifier>javadoc</classifier> </dependency> <dependency> <groupId>com.github.michaelgantman</groupId> <artifactId>MgntUtils</artifactId> <version>1.5.0.8</version> <classifier>sources</classifier> </dependency> 

नीचे बस एक संक्षिप्त विवरण है कि क्या है। पुस्तकालय एक विस्तृत विवरण के साथ अच्छी तरह से लिखा (मुझे आशा है) जावाडॉक के साथ आता है। तो यहाँ सुविधाओं की सूची है:

स्टैकट्रेस शोर फ़िल्टर

मेरे अनुभव में, यह सुविधा मेरे लिए सबसे सामान्य और उपयोगी थी। Stacktrace डिबगिंग के दौरान एक जीवनरक्षक है या यह पता लगाने की कोशिश कर रहा है कि आपके आवेदन में क्या गलत हुआ है। हालाँकि, सर्वर साइड पर लॉग्स के साथ काम करने पर आप भारी स्टैक्ट्रेस के पार आ सकते हैं, जिसमें विभिन्न फ्रेमवर्क और एप्लिकेशन सर्वर संबंधित पैकेजों की सबसे लंबी बेकार पूंछ होती है। और कहीं इस ढेर में, एक प्रासंगिक ट्रेस की कई लाइनें हैं और वे बेकार जानकारी द्वारा अलग-अलग खंडों में हो सकते हैं। एक प्रासंगिक सामान की खोज करना एक बुरा सपना बन जाता है। यहां एक लिंक दिया गया है जो वास्तविक जीवन के उदाहरणों (बेहोश करने वाले के लिए नहीं) https://dzone.com/articles/filtering-stack-trace-hell के साथ इसी समस्या का वर्णन करता है। इसलिए मेरी लाइब्रेरी में, TextUtils नामक एक क्लास है और इसमें कई ओवरलोड हस्ताक्षर के साथ विधि getStacktrace () है । यह एक फेंकने योग्य उदाहरण लेता है और संकुल के उपसर्ग को सेट करने की अनुमति देता है जो प्रासंगिक हैं।

इसके अलावा, एक ही उपयोगिता (संस्करण 1.5.0.3 से शुरू) में विधि getStacktrace () है जो थर्सटेबल के बजाय CharSequence इंटरफ़ेस लेती है और इस प्रकार थ्रैटेबल से निकाले गए स्टैकट के रूप में स्टायर के रूप में संग्रहित स्टैकट्रेस को फ़िल्टर और छोटा करने की अनुमति देती है। इसलिए, मूल रूप से स्टैकट्रैक को रन टाइम पर या बाद में लॉग के रूप में किसी भी पाठ स्रोत से "मक्खी पर" फ़िल्टर किया जा सकता है। (बस स्पष्ट करने के लिए - उपयोगिता संपूर्ण लॉग फ़ाइल को पार्स करने और संशोधित करने का समर्थन नहीं करती है। यह केवल स्टैकट्रेस को फ़िल्टर करने का समर्थन करती है जिसे स्ट्रिंग के रूप में पारित किया गया है। इसलिए यदि कोई लॉग फ़ाइल में अपवादों को फ़िल्टर करना चाहता है, तो उसे लॉग फ़ाइल को पार्स करना होगा। और स्टैकट्रेस (एस) को अलग-अलग तारों के रूप में निकालें और फिर इस उपयोगिता का उपयोग प्रत्येक व्यक्तिगत स्टैकट्रेस को फ़िल्टर करने के लिए कर सकते हैं)।

यहाँ एक उपयोग उदाहरण है। मान लें कि आपका कंपनी कोड हमेशा उन पैकेजों में रहता है जो "com.plain। *" से शुरू होते हैं, इसलिए आप ऐसा उपसर्ग सेट करते हैं और ऐसा करते हैं

 logger.info(TextUtils.getStacktrace(e,true,"com.plain.")); 

यह बहुत ही चालाकी से ट्रेस्रेस के बेकार हिस्सों को बहुत ही चालाकी से छोड़ेगा। इसके अलावा, मैंने उपसर्ग को पूर्व-सेट करने के लिए बहुत सुविधाजनक पाया और फिर सुविधा पद्धति का उपयोग किया

 TextUtils.getStacktrace(e); 

यह ऐसा ही करेगा। उपसर्ग पूर्व निर्धारित करने के लिए सिर्फ विधि का उपयोग करें

 setRelevantPackage("com.plain."); 

यदि आप कॉन्फ़िगरेशन द्वारा इस मान को पूर्व-निर्धारित करना चाहते हैं, तो लाइब्रेरी संस्करण 1.1.0.1 से शुरू करके आप " com.plain। " और संपत्ति का मान करने के लिए "परिवर्तनीय" MGNT_RELEVANT_PACKAGE या सिस्टम प्रॉपर्टी " mgnt.relevant.package " सेट कर सकते हैं। आपके द्वारा पाठ को लागू किए बिना उस मान पर सेट किया जाएगा TextUtils.setRelevantPackage ("com.plain।"); स्पष्ट रूप से आपके कोड में। ध्यान दें कि यदि दोनों सेट किए गए थे, तो सिस्टम प्रॉपर्टी वैल्यू पर्यावरण चर पर पूर्वता ले लेगी। बस याद दिलाएं कि सिस्टम प्रॉपर्टी के साथ-साथ आप इसे अपने कमांड लाइन में जोड़ सकते हैं -D झंडा:

"-Dmgnt.relevant.package = com.plain।"

इसके अलावा, यदि आप पहले किसी संस्करण का उपयोग करते हैं तो इस लाइब्रेरी का 1.1.0.1 या ऊपर उल्लिखित पर्यावरण चर या सिस्टम प्रॉपर्टी का उपयोग नहीं करना चाहते हैं और आप स्प्रिंग परिवेश का उपयोग कर रहे हैं, तो आप अपने स्प्रिंग कॉन्फ़िगरेशन में निम्न खंड जोड़कर उपसर्ग पूर्व निर्धारित कर सकते हैं:

 <bean class="org.springframework.beans.factory.config.MethodInvokingFactoryBean"> <property name="targetClass" value="com.mgnt.utils.TextUtils"/> <property name="targetMethod" value="setRelevantPackage"/> <property name="arguments" value="com.plain."/> </bean> 

जवादोक सब कुछ विस्तार से बताता है। लेकिन यहाँ एक छोटा सा टीज़र है: आपको निम्नलिखित स्टैकट्रेस मिलेगा:

 at com.plain.BookService.listBooks() at com.plain.BookService$$FastClassByCGLIB$$e7645040.invoke() at net.sf.cglib.proxy.MethodProxy.invoke() ... at com.plain.LoggingAspect.logging() at sun.reflect.NativeMethodAccessorImpl.invoke0() ... at com.plain.BookService$$EnhancerByCGLIB$$7cb147e4.listBooks() at com.plain.web.BookController.listBooks() 

के बजाय

 at com.plain.BookService.listBooks() at com.plain.BookService$$FastClassByCGLIB$$e7645040.invoke() at net.sf.cglib.proxy.MethodProxy.invoke() at org.springframework.aop.framework.Cglib2AopProxy$CglibMethodInvocation.invokeJoinpoint() at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed() at org.springframework.aop.aspectj.MethodInvocationProceedingJoinPoint.proceed() at com.plain.LoggingAspect.logging() at sun.reflect.NativeMethodAccessorImpl.invoke0() at sun.reflect.NativeMethodAccessorImpl.invoke() at sun.reflect.DelegatingMethodAccessorImpl.invoke() at java.lang.reflect.Method.invoke() at org.springframework.aop.aspectj.AbstractAspectJAdvice.invokeAdviceMethodWithGivenArgs() at org.springframework.aop.aspectj.AbstractAspectJAdvice.invokeAdviceMethod() at org.springframework.aop.aspectj.AspectJAroundAdvice.invoke() at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed() at org.springframework.aop.interceptor.AbstractTraceInterceptor.invoke() at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed() at org.springframework.transaction.interceptor.TransactionInterceptor.invoke() at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed() at org.springframework.aop.interceptor.ExposeInvocationInterceptor.invoke() at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed() at org.springframework.aop.framework.Cglib2AopProxy$DynamicAdvisedInterceptor.intercept() at com.plain.BookService$$EnhancerByCGLIB$$7cb147e4.listBooks() at com.plain.web.BookController.listBooks() 

इंटीजर, लॉन्ग आदि में साइलेंट स्ट्रिंग पार्सिंग

एक ही क्लास टेक्स्टयूटिल्स स्ट्रिंग को चुपचाप पार्स करने के तरीके प्रदान करता है (बिना किसी अपवाद के) डबल, लॉन्ग, इंटेगर, शॉर्ट और बाइट के प्रकारों में। विधियों को parseStringToLong () parseStringToInteger () आदि कहा जाता है। वे सभी 4 तर्क लेते हैं:

1. एक स्ट्रिंग को पार्स किया जाना है
2. यदि कोई पार्सिंग समस्या हुई है, तो डिफ़ॉल्ट मान के रूप में सेवा करने के लिए संख्या (डबल, लंबी, पूर्णांक, लघु या बाइट) का कार्यान्वयन
3. लॉग में त्रुटि संदेश के रूप में एक स्ट्रिंग मुद्रित किया जाता है यदि पहला तर्क शून्य है (शून्य हो सकता है, और फिर कोई त्रुटि नहीं छपी है)
4. एक त्रुटि संदेश के रूप में मुद्रित करने के लिए स्ट्रिंग यदि NumberFormatException हुई (शून्य हो सकती है, और तब कोई त्रुटि मुद्रित नहीं होती है)

समय अंतराल के लिए स्ट्रिंग स्ट्रिंग

एक ही वर्ग के TextUtils में , एक विधि है parseStringToTimeInterval (स्ट्रिंग मान) । यह विधि कुछ समय अंतराल मान रखने के लिए एक स्ट्रिंग को पार्स करती है - वैकल्पिक समय इकाई प्रत्यय के साथ एक संख्यात्मक मान। उदाहरण के लिए, स्ट्रिंग "38" को 38 सेकंड, "24 मीटर" - 24 मिनट "4h" - 4 घंटे, "3 डी" - 3 दिन और "45" 45 मिलीसेकंड के रूप में पार्स किया जाएगा। समर्थित प्रत्यय सेकंड के लिए " एस ", मिनट के लिए " एम ", घंटों के लिए " एच " और दिनों के लिए " डी " हैं। प्रत्यय के बिना स्ट्रिंग को मिलीसेकंड में मान रखने के लिए माना जाता है। प्रत्यय मामले असंवेदनशील हैं। यदि प्रदान की गई स्ट्रिंग में एक असमर्थित प्रत्यय है या ऋणात्मक संख्यात्मक मान या शून्य रखता है या गैर-संख्यात्मक मान रखता है - तो IllegalArgumentException को फेंक दिया जाता है। यह विधि TimeInterval वर्ग को लौटाती है - इस पुस्तकालय में परिभाषित एक वर्ग भी। अनिवार्य रूप से, यह प्रासंगिक गेटर्स और सेटर्स के साथ दो गुण रखता है: लंबा "मान" और java.util.concurrent.TimeUnit। लेकिन गेटर्स और सेटर्स के अलावा इस क्लास में मेमिलिस () , टूसेकंड्स () , टूमिनुट्स () , टूहोर्स () टुडे () के तरीके हैं । वे विधियाँ निर्दिष्ट समय पैमाने में लंबे समय तक लौटती हैं (कक्षा java.util.concurrent.TimeUn.nn के समान तरीके)

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

 long milliseconds = TextUtils.parsingStringToTimeInterval("5d").toMillis(); 

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

संस्करणों की तुलना करें

यह उपयोगिता स्ट्रिंग को संस्करण और विसे-वर्सा में बदलने और संस्करणों और संस्करण श्रेणियों की ठीक से तुलना करने की अनुमति देती है। अक्सर अगर आपको संस्करणों की तुलना करने की आवश्यकता होती है तो आप स्ट्रिंग्स की तुलना करते हैं। तो चलो कहते हैं कि संस्करण "1.5.3" संस्करण "1.3.1" से अधिक होगा। हालांकि, अगर आप स्ट्रिंग्स "1.4.2" और "1.12.3" की तुलना करेंगे तो स्ट्रिंग "1.4.2" गलती से अधिक हो जाएगा। तो यह उपयोगिता इस तरह की समस्या का ख्याल रखती है और इसके अलावा, वर्जनरेंज क्लास का परिचय देती है और वर्जन रेंज पर परिचालन की अनुमति देती है। (कक्षा TextUtils और वर्ग VersionRange में तुलना के तरीके देखें)

स्ट्रिंग यूनिकोड कनवर्टर

क्लास StringUnicodeEncoderDecoder में ऐसी विधियाँ हैं जो एक स्ट्रिंग (किसी भी भाषा में) को यूनिकोड वर्णों और अनुक्रम-वर्सा के अनुक्रम में परिवर्तित कर सकती हैं। उदाहरण के लिए, एक स्ट्रिंग "हैलो वर्ल्ड" में परिवर्तित हो जाएगा

"u0048 \ u0065 \ u006c \ u006c \ u006f \ u0020 \ u0057 \ u006f \ u0072 \ u006c \ u0064"

और वापस बहाल किया जा सकता है।

जीवनचक्र प्रबंधन (स्व-इंस्टेंटिंग कारखाने)

यह सुविधा एक पैकेज है जिसमें कुछ छोटे बुनियादी ढाँचे होते हैं जो फैक्टरियों के साथ काम करने को सरल और स्वचालित करते हैं जो एक इंटरफ़ेस का ठोस कार्यान्वयन प्रदान करते हैं। पैकेज में सिर्फ 2 वर्ग शामिल हैं: BaseEntityFactory और BaseEntity । संक्षेप में, यह जो बुनियादी ढाँचा है वह यह है कि यदि आप एक ऐसी फैक्ट्री बनाते हैं जो बेसइन्तेयफैक्टरी का विस्तार करती है और कुछ इंटरफ़ेस इसके सभी ठोस कार्यान्वयनों के साथ है जो बेसइन्टिटी का विस्तार करता है, तो आपके प्रत्येक कंक्रीट कार्यान्वयन क्लास श्रेणी के उदाहरण स्वचालित रूप से आपके कारखाने में डाले जाएंगे। आपको अपने कारखाने को कैसे और कब आबाद करना है, इसके बारे में चिंता करने की ज़रूरत नहीं है। बुनियादी ढांचा आपके लिए यह तब करेगा जब आपके कंक्रीट कार्यान्वयन वर्ग के निर्माता को लागू किया जाएगा। तो आपको बस इतना करना है कि किसी भी संख्या में ठोस कार्यान्वयन कक्षाएं बनाना है और यह सुनिश्चित करना है कि प्रत्येक के लिए एक निर्माता को लगाया जाए। उसके बाद, आप अपने कारखाने का उपयोग अपने कोड में कहीं भी अपने किसी भी ठोस कार्यान्वयन वर्ग को प्राप्त करने के लिए कर सकते हैं। यह एक संक्षिप्त विवरण है। कुछ और विवरण हैं, लेकिन बहुत से नहीं हैं। इस पैकेज के विस्तृत विवरण के लिए कृपया पैकेज com.mgnt.lifecycle.management विवरण के Javadoc API देखें। साथ ही, स्रोत कोड में पैकेज com.mgnt.lifecycle.management.example शामिल है जो इस सुविधा का उपयोग करने के तरीके पर अच्छी तरह से टिप्पणी और विस्तृत कोड उदाहरण रखता है।

व्यावहारिक उपयोग के लिए, मैंने इसे स्प्रिंग फ्रेमवर्क के लिए बहुत उपयोगी पाया। याद रखें कि वसंत इसकी शुरुआत के दौरान सभी सेम को परिभाषित करता है। इसलिए वसंत के संदर्भ में, यदि हम बस अपने ठोस कार्यान्वयन को स्प्रिंग बीन्स के रूप में घोषित करते हैं, तो स्प्रिंग उन्हें हमारे लिए तुरंत शुरू कर देगा, इस प्रकार यह हमारे कारखाने को स्वचालित रूप से आरंभ कर देगा। यह बहुत सुविधाजनक हो सकता है। कल्पना करें कि आपके पास कुछ बीन है जिसमें उपयोगकर्ता-परिभाषित इंटरफ़ेस के प्रकार की संपत्ति है जिसमें कई कार्यान्वयन हैं, लेकिन वास्तविक कार्यान्वयन की आवश्यकता होगी जो रनटाइम पर निर्धारित की जाती है। तो उस समय, आप आवश्यक कार्यान्वयन तक पहुँचने के लिए अपने कारखाने के तरीके getInstance (java.lang.String) का उपयोग कर सकते हैं। यह आपको अपनी सभी ठोस तात्कालिकताओं को अपने बीन में इंजेक्ट करने की अनुमति नहीं देगा और वसंत परिभाषित बीन का उपयोग करने के लिए आपको स्प्रिंग बीन फैक्ट्री का उपयोग नहीं करना पड़ेगा क्योंकि यह गैर-घुसपैठ की स्प्रिंग का उल्लंघन करेगा (जिसका अर्थ है कि आप उन घटकों को लिख सकते हैं जिनकी कोई निर्भरता नहीं है स्प्रिंग)। इसके अलावा, अगर बाद के किसी चरण में आपको अधिक ठोस कार्यान्वयन जोड़ने की आवश्यकता होगी, तो आपको बस इतना करना होगा कि अपने कार्यान्वयन वर्गों को अपने कोड में जोड़ना होगा और उन्हें स्प्रिंग बीन्स घोषित करना होगा। शेष स्प्रिंग और इस बुनियादी ढांचे द्वारा किया जाएगा!

फ़ाइल के बर्तन

यह उपयोगिता किसी फ़ाइल को स्ट्रिंग के रूप में या वर्ण सेट को निर्दिष्ट किए बिना या बस एक बाइट सरणी के रूप में पढ़ने की अनुमति देती है। यह उपयोगिता तेजी से प्रदर्शन के लिए nio पैकेज और बफ़र्स का उपयोग करती है। इस उपयोगिता के लिए अधिकतम फ़ाइल आकार 2G है।

समय का सदुपयोग

यह केवल एक एकल सुविधा विधि है जो थ्रेड.स्लीप () के समान कार्यक्षमता प्रदान करती है, लेकिन यह मौन है। यानी यह "IterruptedException" निगल जाता है। इसके अलावा, यह 2 तर्क लेता है: नींद और माप इकाई के लिए समय। इसलिए इसके बजाय

 try { Thread.sleep(2000); } catch (InterruptedException ie) { } 

आप बस लिख सकते हैं:

 TimeUtils.sleepFor(2, TimeUnit.SECONDS); 

मुझे लगा कि यह प्यारा है

तो यह बात है। इस पुस्तकालय को डाउनलोड करने के लिए स्वतंत्र महसूस करें। यह एमआईटी लाइसेंस के साथ आता है - मेरे द्वारा ज्ञात सबसे अधिक अनुज्ञेय लाइसेंसों में से एक। स्रोत कोड, Javadoc और बाइनरी संस्करण उपरोक्त लिंक पर उपलब्ध है। कोड को JDK 8 द्वारा संकलित किया गया था लेकिन इसमें संस्करण 8 की कोई विशेषता नहीं है। यह जावा 7 के साथ सबसे निश्चित रूप से काम करना चाहिए, मुझे संदेह है कि यह जावा 6 और 5 के साथ भी काम करेगा, लेकिन उन संस्करणों के साथ इसका परीक्षण नहीं किया है। जैसा कि आप फिट देखते हैं, इसका उपयोग करने के लिए स्वतंत्र महसूस करें, यदि आप इसे पसंद करते हैं, तो इसके बारे में दूसरों को बताएं और यदि आपके पास कोई प्रतिक्रिया है तो मुझे michael_gantman@yahoo.com पर एक नोट छोड़ने के लिए स्वतंत्र महसूस करें।