👌🏾 📍 💪 HELL का नाम JSMPP है 🕟 🙊 📃

जाहिर है, हर प्रोग्रामर के जीवन में, एक समय आता है जब उसके लिए यह आवश्यक हो जाता है कि वह एसएमएस संदेश कैसे भेजें। कल, ऐसे ही एक क्षण मेरे लिए आया। मुझे तुरंत कहना होगा कि यह ज़रूरत किसी भी तरह से विज्ञापन मेलिंग और अन्य स्पैम से जुड़ी नहीं है। उपकरण की निगरानी के दौरान पता चला घटनाओं की प्रतिक्रिया के भाग के रूप में एसएमएस-की को विशुद्ध रूप से शांतिपूर्ण उद्देश्यों के लिए भेजा जाना चाहिए।

इस तरह के समाचार पत्र के महत्व को कम करना मुश्किल है। वास्तव में, दुर्घटना की सूचना ईएमआईएल संपर्क व्यक्ति को भेजकर, हम तत्काल प्रतिक्रिया पर भरोसा नहीं कर सकते। यह ज्ञात नहीं है कि प्राप्तकर्ता कब अपना मेल पढ़ेगा। एसएमएस बहुत तेजी से दिया जाता है।

हमारी कंपनी ने एसएमपीपी सेवा के अपने स्वयं के कार्यान्वयन का लंबा और सफलतापूर्वक उपयोग किया है, और जावा में एक तैयार एसएमपीपी क्लाइंट का उपयोग करने का विचार मुझे तर्कसंगत लगा। हिम्मत से शब्द "जावा smpp क्लाइंट" को गूगल सर्च बार में चलाने के बाद, मुझे तुरंत वह लाइब्रेरी मिल गई जिसकी मुझे जरूरत थी। आगे क्या हुआ, इसके बारे में आज मेरी पोस्ट बताती है।

चूंकि मैं परियोजनाओं के निर्माण के लिए मावेन का उपयोग करता हूं, इसलिए सबसे पहले, मैंने साइट से लाइब्रेरी का नवीनतम संस्करण डाउनलोड किया, इसे निम्न आदेश के साथ स्थानीय रिपॉजिटरी में अपलोड किया:

mvn install:install-file -Dfile=jsmpp-2.1.0.jar -DgroupId=org.jsmpp -DartifactId=smpp -Dversion=2.1.0 -Dpackaging=jar

फिर एक पोम फाइल बनाई:

pom.xml

 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.acme.ae.tests.smpp</groupId> <artifactId>SMPPTest</artifactId> <version>1.0.0</version> <packaging>jar</packaging> <name>smppTest-${project.version}</name> <url>http://maven.apache.org</url> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <resource_dir>${project.basedir}/src/main/resources</resource_dir> </properties> <build> <finalName>${project.name}-${project.version}</finalName> <resources> <resource> <directory>${resource_dir}</directory> </resource> </resources> </build> <dependencies> <dependency> <groupId>org.jsmpp</groupId> <artifactId>smpp</artifactId> <version>2.1.0</version> </dependency> </dependencies> </project>

परीक्षण आवेदन की तैयारी काफी मानक लग रही थी:

Test.java

 package com.acme.ae.tests.smpp; public class Test { private void start() throws IOException { } private void stop() throws IOException { } private void test() { } public static void main(String[] args) { Test t = new Test(); try { try { t.start(); t.test(); } finally { t.stop(); } } catch (Exception e) { System.out.println(e.toString()); } } }

इसके बाद डेवलपर्स द्वारा उपलब्ध कराए गए उदाहरण का अध्ययन किया गया। एक अनुवाद विनिर्देश प्रेरणा के दूसरे स्रोत के रूप में इस्तेमाल किया गया था ।

सर्वर से कनेक्ट करने के लिए, ऊपर दिए गए उदाहरण के अनुसार, निम्नलिखित कोड का उपयोग किया गया था:

सर्वर कनेक्शन

  ... private SMPPSession session = null; private void start() throws IOException { session = new SMPPSession(); session.connectAndBind(SMPP_IP, SMPP_PORT, new BindParameter( BindType.BIND_TX, SMPP_LOGIN, SMPP_PASS, "cp", TypeOfNumber.UNKNOWN, NumberingPlanIndicator.UNKNOWN, null)); } private void stop() throws IOException { if (session != null) { session.unbindAndClose(); } } ...

यहां मापदंडों के एक हिस्से का उद्देश्य संदर्भ से काफी स्पष्ट है। शेष मापदंडों को नमूना कोड से अपरिवर्तित लिया गया था। चूँकि हम केवल संदेश भेजने वाले हैं, हम BindType.BIND_TX का उपयोग करते हैं।

उदाहरण से लिया गया संदेश अंतरण कोड (या एन्कोडिंग कार्य), संकलन करने से इनकार कर दिया:

 ... new GeneralDataCoding(Alphabet.ALPHA_DEFAULT, MessageClass.CLASS1, false) ...

GitHub के स्रोतों के साथ डाउनलोड की गई लाइब्रेरी (नवीनतम उपलब्ध संस्करण 2.1.0) के स्रोतों की तुलना करने के बाद, यह पता चला कि डेवलपर्स, किसी कारण से मुझे समझ में नहीं आया, डिजाइनर हस्ताक्षर को बदल दिया:

 - public GeneralDataCoding(boolean compressed, boolean containMessageClass, - MessageClass messageClass, Alphabet alphabet) { + public GeneralDataCoding(Alphabet alphabet, MessageClass messageClass, + boolean compressed) throws IllegalArgumentException { ... }

चूंकि मैंने पुराने संस्करण का उपयोग किया था, इसलिए मुझे कोड में समायोजन करना पड़ा (कोड में प्रेषक और रिसीवर के पते बदल दिए गए):

लघु संदेश स्थानांतरण

  ... private static TimeFormatter timeFormatter = new AbsoluteTimeFormatter(); private void test() throws PDUException, ResponseTimeoutException, InvalidResponseException, NegativeResponseException, IOException { String messageId = session.submitShortMessage( "CMT", TypeOfNumber.ALPHANUMERIC, NumberingPlanIndicator.UNKNOWN, "ACME", TypeOfNumber.INTERNATIONAL, NumberingPlanIndicator.ISDN, "7XXXXXXXXXX", new ESMClass(), (byte)0, (byte)1, timeFormatter.format(new Date()), null, new RegisteredDelivery(SMSCDeliveryReceipt.DEFAULT), (byte)0, new GeneralDataCoding( false, false, MessageClass.CLASS1, Alphabet.ALPHA_DEFAULT), (byte)0, "jSMPP simplify SMPP on Java platform".getBytes()); System.out.println("Message submitted, message_id is " + messageId); } ...

निष्पादन के लिए कोड चलाना असफल रहा। जब एक SMPPSession बनाने की कोशिश कर रहा है, एक अपवाद फेंक दिया गया था:

 Exception in thread "main" java.lang.NoClassDefFoundError: org/slf4j/LoggerFactory at org.jsmpp.session.AbstractSession.<clinit>(AbstractSession.java:51) at com.amfitel.m2000.ae.tests.smpp.Test.start(Test.java:56) at com.amfitel.m2000.ae.tests.smpp.Test.main(Test.java:179) Caused by: java.lang.ClassNotFoundException: org.slf4j.LoggerFactory at java.net.URLClassLoader$1.run(URLClassLoader.java:202) at java.security.AccessController.doPrivileged(Native Method) at java.net.URLClassLoader.findClass(URLClassLoader.java:190) at java.lang.ClassLoader.loadClass(ClassLoader.java:307) at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:301) at java.lang.ClassLoader.loadClass(ClassLoader.java:248) ... 3 more

दरअसल, गेटस्टार्टेड में SLF4J के उपयोग का एक मतलब था। मुझे pom.xml में एक निर्भरता जोड़ना था:

  ... <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>1.6.1</version> </dependency> ...

संस्करण संख्या (1.6.1, 1.4.3 नहीं, जैसा कि गेटस्टार्टेड में उल्लेख किया गया है) गिटहब पर पोम फ़ाइल से लिया गया था। अब लॉग में एक अप्रिय त्रुटि लिखी जाने लगी, लेकिन सर्वर के साथ कम से कम संबंध स्थापित हो गया:

 SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder". SLF4J: Defaulting to no-operation (NOP) logger implementation SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

टिप्पणी

GitHub के स्रोतों से ली गई एक और निर्भरता को जोड़कर समस्या का हल किया गया:

  ... <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.6.1</version> </dependency> ...

इसे जोड़ने के बाद, log4j.properties में निर्दिष्ट सेटिंग्स के अनुसार, एक सामान्य लॉग बनना शुरू हुआ। टिप के लिए Googolplex का धन्यवाद।

एक संदेश भेजना भी सफल रहा, लेकिन "चौराहे" पत्र के बजाय फोन पर आए। वायरशर्क बचाव में आए:

हमारे एसएमपीपी सर्वर डेवलपर ने तर्क दिया कि लैटिन में सामान्य संदेश भेजने के लिए, डेटा कोडिंग को 0. भेजना चाहिए। मुझे यह कहना चाहिए कि जेएसएमपीपी एपीआई का उपयोग करते समय विनिर्देश द्वारा निर्धारित विभिन्न संख्यात्मक कोड बनाने की प्रक्रिया स्पष्ट नहीं है। स्रोत कोड पर एक छोटे से ध्यान के बाद, समस्या हल हो गई थी:

  ... new GeneralDataCoding( false, false, - MessageClass.CLASS1, + MessageClass.CLASS0, Alphabet.ALPHA_DEFAULT) ...

अब यह सीखना जारी रहा कि सिरिलिक वर्णमाला का उपयोग करके लंबे संदेश और संदेश कैसे भेजें। लंबे संदेश भेजने के लिए, मैं डेवलपर्स से उदाहरण में प्रस्तावित दृष्टिकोण का उपयोग करके MESSAGE_PAYLOAD के साथ बुद्धिमान नहीं हुआ।

सिरिलिक वर्णमाला को प्रसारित करने के लिए, एन्कोडिंग को बदलना और संदेश को UCS-2 में अनुवाद करना आवश्यक था। व्यावहारिक दृष्टिकोण से, बाद में UTF-16 एन्कोडिंग में बाइट्स के अनुक्रम के रूप में एक पाठ प्रतिनिधित्व हुआ (आप यहां UCS-2 और UTF-16 के बीच अंतर के बारे में पढ़ सकते हैं)। परिणामस्वरूप, संदेश भेजने वाला कोड इस तरह दिखाई देता है:

एक लंबे सिरिलिक संदेश का प्रसारण

 GeneralDataCoding coding = new GeneralDataCoding( false, false, MessageClass.CLASS0, Alphabet.ALPHA_UCS2); final int totalSegments = 3; Random random = new Random(); OptionalParameter sarMsgRefNum = OptionalParameters.newSarMsgRefNum((short)random.nextInt()); OptionalParameter sarTotalSegments = OptionalParameters.newSarTotalSegments(totalSegments); for (int i = 0; i < totalSegments; i++) { final int seqNum = i + 1; String message = " " + seqNum + " of " + totalSegments + " "; OptionalParameter sarSegmentSeqnum = OptionalParameters.newSarSegmentSeqnum(seqNum); String messageId = session.submitShortMessage( "CMT", TypeOfNumber.ALPHANUMERIC, NumberingPlanIndicator.UNKNOWN, "ACME", TypeOfNumber.INTERNATIONAL, NumberingPlanIndicator.ISDN, "7XXXXXXXXXX", new ESMClass(), SMPP_PROTOCOL_ID, // (byte)0 SMPP_PRIORITY_FLAG, // (byte)1 null, null, new RegisteredDelivery(SMSCDeliveryReceipt.DEFAULT), SMPP_REP_IF_P_FLAG, // (byte)0 coding, (byte)0, message.getBytes(Charset.forName("UTF-16")), sarMsgRefNum, sarSegmentSeqnum, sarTotalSegments); System.out.println("Message submitted, message_id is " + messageId); }

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

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

HELL का नाम JSMPP है

More articles: