स्प्रिंग प्लेटफॉर्म के साथ काम करते समय 10 सबसे आम त्रुटियां। भाग २

सैल्यूट, खाबरोवस्क। इसलिए विशेष रूप से पाठ्यक्रम के छात्रों के लिए तैयार किए गए एक लेख के दूसरे भाग का अनुवाद "डेवलपर ऑन द स्प्रिंग फ्रेमवर्क" समय पर पहुंचा। पहला भाग यहाँ पढ़ा जा सकता है ।

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

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

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

---

सामान्य गलती # 6: एनोटेशन-आधारित डेटा सत्यापन का उपयोग नहीं करना

आइए कल्पना करें कि पिछले उदाहरणों से हमारी TopTalent सेवा को नए TopTalent डेटा को जोड़ने के लिए एक समापन बिंदु की आवश्यकता है। इसके अलावा, मान लें कि वास्तव में महत्वपूर्ण कारण के लिए, आपके द्वारा जोड़ा गया प्रत्येक नाम ठीक 10 वर्ण लंबा होना चाहिए। यह लागू किया जा सकता है, उदाहरण के लिए, इस प्रकार है:

@RequestMapping("/put") public void addTopTalent(@RequestBody TopTalentData topTalentData) { boolean nameNonExistentOrHasInvalidLength = Optional.ofNullable(topTalentData) .map(TopTalentData::getName) .map(name -> name.length() == 10) .orElse(true); if (nameNonExistentOrInvalidLength) { //   } topTalentService.addTopTalent(topTalentData); } 

हालांकि, उपरोक्त कोड न केवल खराब संरचित है, बल्कि यह वास्तव में "स्वच्छ" समाधान नहीं है। हम कई प्रकार के डेटा सत्यापन करते हैं (अर्थात्, हम सत्यापित करते हैं कि TopTalentData ऑब्जेक्ट शून्य नहीं है, कि TopTalentData.name फ़ील्ड का मान शून्य नहीं है, और TopTalentData.name फ़ील्ड की लंबाई 10 वर्ण है), और डेटा गलत होने पर एक अपवाद भी फेंक दें।

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

 @RequestMapping("/put") public void addTopTalent(@Valid @NotNull @RequestBody TopTalentData topTalentData) { topTalentService.addTopTalent(topTalentData); } @ExceptionHandler @ResponseStatus(HttpStatus.BAD_REQUEST) public ErrorResponse handleInvalidTopTalentDataException(MethodArgumentNotValidException methodArgumentNotValidException) { //    } 

इसके अलावा, हमें यह इंगित करने की आवश्यकता है कि हम TopTalentData वर्ग में कौन सी संपत्ति सत्यापन करना चाहते हैं:

 public class TopTalentData { @Length(min = 10, max = 10) @NotNull private String name; } 

वसंत अब अनुरोध को रोक देगा और विधि को कॉल करने से पहले इसे सत्यापित करेगा, इसलिए कोई अतिरिक्त मैनुअल जांच की आवश्यकता नहीं होगी।

अपना लक्ष्य बनाकर भी इच्छित लक्ष्य प्राप्त किया जा सकता है। वास्तविक परिस्थितियों में, यह आमतौर पर आपके स्वयं के एनोटेशन का उपयोग करने के लिए समझ में आता है जब आपकी ज़रूरतें हाइबरनेट प्रतिबंधों के अंतर्निहित सेट से अधिक होती हैं , लेकिन इस उदाहरण के लिए, आइए कल्पना करें कि @Length एनोटेशन मौजूद नहीं हैं। आप एक डेटा सत्यापनकर्ता बना सकते हैं जो दो अतिरिक्त कक्षाएं बनाकर एक स्ट्रिंग की लंबाई की जांच करता है: एक सत्यापन के लिए और दूसरा एनोटेटिंग के लिए:

 @Target({ElementType.METHOD, ElementType.FIELD, ElementType.PARAMETER}) @Retention(RetentionPolicy.RUNTIME) @Documented @Constraint(validatedBy = { MyAnnotationValidator.class }) public @interface MyAnnotation { String message() default "String length does not match expected"; Class<?>[] groups() default {}; Class<? extends Payload>[] payload() default {}; int value(); } @Component public class MyAnnotationValidator implements ConstraintValidator<MyAnnotation, String> { private int expectedLength; @Override public void initialize(MyAnnotation myAnnotation) { this.expectedLength = myAnnotation.value(); } @Override public boolean isValid(String s, ConstraintValidatorContext constraintValidatorContext) { return s == null || s.length() == this.expectedLength; } } 

कृपया ध्यान दें कि इन मामलों में, जिम्मेदारी के पृथक्करण के सिद्धांत के सही अनुप्रयोग को संपत्ति को वैध के रूप में चिह्नित करने की आवश्यकता होती है यदि इसका मान शून्य है (s == null इस विधि में (s == null है), और फिर इस संपत्ति के लिए isValid एनोटेशन का उपयोग करें:

 public class TopTalentData { @MyAnnotation(value = 10) @NotNull private String name; } 

कॉमन मिस्टेक # 7: लिगेसी एक्सएमएल-आधारित कॉन्फ़िगरेशन का उपयोग करना

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

इस आलेख में (साथ ही साथ साथी GitHub रिपॉजिटरी सामग्री में), एनोटेशन का उपयोग स्प्रिंग को कॉन्फ़िगर करने के लिए किया जाता है, और स्प्रिंग को पता है कि JavaBean घटकों को बाध्य करने की आवश्यकता है क्योंकि रूट पैकेज को @Spring.ootApplication समग्र एनोटेशन का उपयोग करके एनोटेट किया गया है - इस तरह:

 @SpringBootApplication public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } 

यह समग्र एनोटेशन (इस पर अधिक जानकारी के लिए स्प्रिंग डॉक्यूमेंटेशन देखें) बस स्प्रिंग प्लेटफॉर्म को बताता है कि कौन से पैकेज जावाबीन घटकों को निकालने के लिए स्कैन करना है। हमारे विशेष मामले में, इसका मतलब है कि बाध्यकारी के लिए निम्नलिखित co.kukurin उप-पैकेज का उपयोग किया जाएगा:

• घटक (TopTententConverter, MyAnnotationValidator)
• @RestController (TopTalentController)
• रिपोजिटरी (TopTalentRepository)
• सेवा (TopTalentService) कक्षाएं

अगर हमारे पास @Configuration एनोटेशन वाली अतिरिक्त कक्षाएं हैं, तो उन्हें जावा कॉन्फ़िगरेशन के लिए भी चेक किया जाएगा।

सामान्य गलती # 8: कॉन्फ़िगरेशन प्रोफाइल का उपयोग नहीं करना

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

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

फ़ाइल आवेदन

 # set default profile to 'dev' spring.profiles.active: dev # production database details spring.datasource.url: 'jdbc:mysql://localhost:3306/toptal' spring.datasource.username: root spring.datasource.password: 

फ़ाइल आवेदन- DEV.YAML

 spring.datasource.url: 'jdbc:h2:mem:' spring.datasource.platform: h2 

यह माना जाना चाहिए कि कोड के साथ काम करते समय, आप ऑपरेटिंग वातावरण के लिए एक डेटाबेस के साथ कुछ यादृच्छिक क्रियाएं नहीं करना चाहेंगे, इसलिए यह विकास वातावरण (DEV) के लिए डिफ़ॉल्ट प्रोफ़ाइल के रूप में प्रोफ़ाइल का चयन करने के लिए समझ में आता है। इसके बाद, आप मैन्युअल रूप से JVM के लिए -Dspring.profiles.active=prod को निर्दिष्ट करके सर्वर पर कॉन्फ़िगरेशन प्रोफ़ाइल को ओवरराइड कर सकते हैं। इसके अलावा, डिफ़ॉल्ट कॉन्फ़िगरेशन प्रोफ़ाइल को ऑपरेटिंग सिस्टम वातावरण चर में निर्दिष्ट किया जा सकता है।

सामान्य गलती संख्या 9. निर्भरता इंजेक्शन तंत्र का उपयोग करने में विफलता

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

 public class TopTalentController { private final TopTalentService topTalentService; public TopTalentController() { this.topTalentService = new TopTalentService(); } } 

... हम वसंत मंच को बांधने की अनुमति देते हैं:

 public class TopTalentController { private final TopTalentService topTalentService; public TopTalentController(TopTalentService topTalentService) { this.topTalentService = topTalentService; } } 

Google टेक टॉक्स चैनल पर मिशको हेवरी के व्याख्यान में विस्तार से बताया गया है कि निर्भरता इंजेक्शन का उपयोग क्यों किया जाना चाहिए, और यहां हम देखेंगे कि यह तंत्र व्यवहार में कैसे उपयोग किया जाता है। जिम्मेदारी के विभाजन में ("सामान्य गलती # 3"), हमने सेवा और नियंत्रक कक्षाएं बनाईं। मान लीजिए कि हम एक नियंत्रक का परीक्षण करना चाहते हैं, यह मानते हुए कि TopTalentService वर्ग सही ढंग TopTalentService काम कर रहा है। हम वर्तमान कॉन्फ़िगरेशन के बजाय एक अलग कॉन्फ़िगरेशन क्लास बनाकर एक सिम्युलेटर ऑब्जेक्ट सम्मिलित कर सकते हैं:

 @Configuration public class SampleUnitTestConfig { @Bean public TopTalentService topTalentService() { TopTalentService topTalentService = Mockito.mock(TopTalentService.class); Mockito.when(topTalentService.getTopTalent()).thenReturn( Stream.of("Mary", "Joel").map(TopTalentData::new).collect(Collectors.toList())); return topTalentService; } } 

उसके बाद, हम स्प्रिंग प्लेटफॉर्म को SampleUnitTestConfig सिम्युलेटर ऑब्जेक्ट को लागू कर सकते हैं, जिसे हमें कॉन्फ़िगरेशन स्रोत के रूप में SampleUnitTestConfig का उपयोग करने की आवश्यकता है:
@ContextConfiguration(classes = { SampleUnitTestConfig.class })

इसके बाद, यह हमें इकाई परीक्षण में कस्टम जावाबीन घटक को एम्बेड करने के लिए प्रासंगिक कॉन्फ़िगरेशन का उपयोग करने की अनुमति देगा।

सामान्य गलती संख्या 10. परीक्षण या गलत परीक्षण का अभाव

इस तथ्य के बावजूद कि इकाई परीक्षण का विचार किसी भी तरह से नया नहीं है, ऐसा लगता है कि कई डेवलपर्स या तो इसके बारे में "भूल जाते हैं" (विशेषकर यदि यह अनिवार्य नहीं है ) या इसे बहुत देर से खर्च करते हैं। जाहिर है, यह गलत है, क्योंकि परीक्षण न केवल आपको कोड के सही संचालन की जांच करने की अनुमति देते हैं, बल्कि दस्तावेज के रूप में भी दिखाते हैं कि आवेदन विभिन्न स्थितियों में कैसे व्यवहार करना चाहिए।
वेब सेवाओं का परीक्षण करते समय, आप शायद ही कभी असाधारण रूप से "क्लीन" यूनिट परीक्षण चलाते हैं, क्योंकि HTTP प्रोटोकॉल का उपयोग करने वाले कनेक्शन के लिए आपको आमतौर पर स्प्रिंग DispatcherServlet सर्वलेट का उपयोग करने की आवश्यकता होती है और देखें कि क्या होता है जब आपको एक वास्तविक HttpServletRequest अनुरोध प्राप्त होता है (अर्थात, यह एकीकरण परीक्षण का उपयोग करता है सत्यापन, क्रमांकन, आदि)। एक सुरुचिपूर्ण और सिद्ध समाधान है, MESTMVC के साथ REST सेवाओं का आसानी से परीक्षण करने के लिए जावा लाइब्रेरी का उपयोग करना। निर्भरता इंजेक्शन के साथ निम्नलिखित कोड टुकड़ा पर विचार करें:

 @RunWith(SpringJUnit4ClassRunner.class) @ContextConfiguration(classes = { Application.class, SampleUnitTestConfig.class }) public class RestAssuredTestDemonstration { @Autowired private TopTalentController topTalentController; @Test public void shouldGetMaryAndJoel() throws Exception { // given MockMvcRequestSpecification givenRestAssuredSpecification = RestAssuredMockMvc.given() .standaloneSetup(topTalentController); // when MockMvcResponse response = givenRestAssuredSpecification.when().get("/toptal/get"); // then response.then().statusCode(200); response.then().body("name", hasItems("Mary", "Joel")); } } 

SampleUnitTestConfig TopTalentService वर्ग के सरोगेट कार्यान्वयन को TopTalentService के लिए TopTalentController , और अन्य सभी वर्ग अनुप्रयोग वर्ग के पैकेज के आधार पर स्कैनिंग संकुल द्वारा प्राप्त मानक कॉन्फ़िगरेशन का उपयोग करने के लिए बाध्य होते हैं। RestAssuredMockMvc उपयोग केवल हल्के वातावरण को सेट करने और /toptal/get GET अनुरोध भेजने के लिए किया जाता है।

व्यावसायिक रूप से स्प्रिंग का उपयोग करें

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

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

इस बिंदु पर, इस लेख का अनुवाद समाप्त हो गया।
पहला भाग पढ़ें