स्प्रिंग बूट का परिचय: जावा में एक साधारण रीस्ट एपीआई बनाना

बोझिल निर्भरता कॉन्फ़िगरेशन के कारण, एंटरप्राइज़ अनुप्रयोगों के लिए स्प्रिंग को कॉन्फ़िगर करना एक बहुत थकाऊ और त्रुटि-रहित कार्य बन गया है। यह उन अनुप्रयोगों के लिए विशेष रूप से सच है जो कई तृतीय-पक्ष पुस्तकालयों का उपयोग करते हैं।

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

• बनाया जा रहा है (स्प्रिंग MVC, स्प्रिंग JDBC, स्प्रिंग ORM, आदि) के प्रकार के आधार पर, आवश्यक स्प्रिंग आदि आयात करें
• वेब कंटेनर लाइब्रेरी आयात करें (वेब ​​अनुप्रयोगों के लिए)
• आवश्यक तृतीय-पक्ष लाइब्रेरीज़ आयात करें (उदाहरण के लिए, हाइबरनेट, जैक्सन), जबकि आपको स्प्रिंग के निर्दिष्ट संस्करण के साथ संगत संस्करणों की तलाश करनी चाहिए
• DAO घटकों को कॉन्फ़िगर करें, जैसे: डेटा स्रोत, लेनदेन प्रबंधन, आदि।
• वेब परत घटकों को कॉन्फ़िगर करें, जैसे: संसाधन प्रबंधक, रिज़ॉल्वर देखें
• एक वर्ग परिभाषित करें जो सभी आवश्यक कॉन्फ़िगरेशन को लोड करेगा।

1. स्प्रिंग बूट का परिचय

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

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

2. स्प्रिंग बूट की विशेषताएं

स्प्रिंग बूट की महान कार्यक्षमता है, लेकिन इसकी सबसे महत्वपूर्ण विशेषताएं हैं: निर्भरता प्रबंधन, स्वचालित कॉन्फ़िगरेशन और अंतर्निहित सर्वलेट कंटेनर

2.1। आसान निर्भरता प्रबंधन

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

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

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

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

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

इसलिए, स्प्रिंग बूट का उपयोग करते समय, pom.xml फ़ाइल में स्प्रिंग एप्लिकेशन का उपयोग करते समय की तुलना में बहुत कम लाइनें होती हैं

सभी स्प्रिंग बूट स्टार्टर पैकेज के लिए प्रलेखन देखें ।

2.2। स्वचालित कॉन्फ़िगरेशन

दूसरा उत्कृष्ट स्प्रिंग बूट सुविधा स्वचालित अनुप्रयोग कॉन्फ़िगरेशन है

उपयुक्त स्टार्टर पैकेज चुनने के बाद, स्प्रिंग बूट आपके द्वारा जोड़े गए जार निर्भरता के आधार पर स्प्रिंग एप्लिकेशन को स्वचालित रूप से कॉन्फ़िगर करने का प्रयास करेगा

उदाहरण के लिए, यदि आप स्प्रिंग-बूट-स्टार्टर-वेब जोड़ते हैं, तो स्प्रिंग बूट स्वचालित रूप से पंजीकृत बीन्स जैसे डिस्पैचर सेर्वलेट , रिसोर्सहैंडलर , मैसेजसोर्स को कॉन्फ़िगर कर देगा

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

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

उपयोगकर्ता सेटिंग्स के साथ किसी भी समय ऑटो कॉन्फ़िगरेशन को पूरी तरह से परिभाषित किया जा सकता है

2.3। अनुप्रयोग सर्वर के लिए मूल समर्थन - सर्वलेट कंटेनर

प्रत्येक स्प्रिंग बूट वेब एप्लिकेशन में एक एम्बेडेड वेब सर्वर शामिल होता है। बॉक्स से बाहर समर्थित सर्वलेट कंटेनरों की सूची देखें ।

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

यदि आपको एक अलग HTTP सर्वर का उपयोग करने की आवश्यकता है, तो इसके लिए केवल डिफ़ॉल्ट निर्भरता को बाहर करें। स्प्रिंग बूट विभिन्न HTTP सर्वर के लिए अलग स्टार्टर पैकेज प्रदान करता है

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

3. वसंत बूट स्थापना आवश्यकताएँ

स्प्रिंग बूट एप्लिकेशन को कॉन्फ़िगर और चलाने के लिए, निम्नलिखित आवश्यक है:

• जावा 8+
• अपाचे मावेन 3.x

4. स्प्रिंग बूट एप्लिकेशन बनाना

अब चलिए स्प्रिंग बूट की क्षमताओं का उपयोग करके भुगतान स्वीकार करने के लिए एक बहुत ही सरल REST API का अभ्यास और कार्यान्वयन करें

4.1। मावेन का उपयोग करके एक वेब प्रोजेक्ट बनाना

जिस IDE का आप उपयोग कर रहे हैं, उसे स्प्रिंगबूटरेस्ट सर्विस कहते हुए मावेन प्रोजेक्ट बनाएं

जावा 8+ संस्करण का उपयोग करना सुनिश्चित करें क्योंकि स्प्रिंग बूट पहले के संस्करणों के साथ काम नहीं करता है

4.2। Pom.xml कॉन्फ़िगरेशन

दूसरा चरण स्प्रिंग बूट को pom.xml फ़ाइल में कॉन्फ़िगर करना है

सभी स्प्रिंग बूट एप्लिकेशन स्प्रिंग-बूट-स्टार्टर-पैरेंट से कॉन्फ़िगर किए गए हैं, इसलिए निर्भरता को और अधिक परिभाषित करने से पहले, स्टार्टर-पैरेंट को निम्नानुसार जोड़ें:

<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.1.1.RELEASE</version> </parent> 

क्योंकि चूंकि हम एक REST API बना रहे हैं, इसलिए एक निर्भरता के रूप में स्प्रिंग-बूट-स्टार्टर-वेब का उपयोग करना आवश्यक है, जो कि अन्य सभी निर्भरता को परिभाषित करता है, जैसे कि स्प्रिंग-कोर , स्प्रिंग-वेब , स्प्रिंग-वेबमिक्स , सर्वलेट जी , और जैकसन-डेटाबाइंड लाइब्रेरी, इसलिए बस pom.xml को निम्नलिखित जोड़ें:

 <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> 

अब निम्नलिखित जार पुस्तकालयों को स्वचालित रूप से आपकी परियोजना में आयात किया जाता है:

अगला कदम स्प्रिंग बूट प्लगइन जोड़ना है:

 <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> 

अंतिम चरण विधानसभा के दौरान मावेन को एक निष्पादन योग्य जार फ़ाइल बनाने के लिए है:

 <packaging>jar</packaging> 

नीचे पूर्ण pom.xml फ़ाइल है:

 <?xml version="1.0" encoding="UTF-8"?> <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>springboot.topjava.ru</groupId> <artifactId>SpringBootRestService</artifactId> <version>1.0</version> <packaging>jar</packaging> <properties> <maven.compiler.source>1.8</maven.compiler.source> <maven.compiler.target>1.8</maven.compiler.target> </properties> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.1.1.RELEASE</version> </parent> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project> 

जैसा कि आप देख सकते हैं, एक निर्भरता का उपयोग करके, हम पूरी तरह कार्यात्मक वेब एप्लिकेशन बना सकते हैं

4.3। REST संसाधन बनाना

अब हम अनुरोधों और प्रतिक्रियाओं के लिए पीओजेओ कक्षाओं के साथ एक भुगतान नियंत्रक बनाने जा रहे हैं

भुगतान के अनुरोध की कक्षा लिखें:

 package springboot.topjava.ru; public class PaymentRequest { private int userId; private String itemId; private double discount; public String getItemId() { return itemId; } public void setItemId(String itemId) { this.itemId = itemId; } public double getDiscount() { return discount; } public void setDiscount(double discount) { this.discount = discount; } public int getUserId() { return userId; } public void setUserId(int userId) { this.userId = userId; } } 

और एक ऐसा वर्ग जो हमारी सेवा द्वारा लौटी मूल प्रतिक्रिया की प्रक्रिया करता है:

 package springboot.topjava.ru; public class BaseResponse { private final String status; private final Integer code; public BaseResponse(String status, Integer code) { this.status = status; this.code = code; } public String getStatus() { return status; } public Integer getCode() { return code; } } 

अब एक नियंत्रक बनाएँ:

 package springboot.topjava.ru; import org.springframework.web.bind.annotation.*; @RestController @RequestMapping("/payment") public class PaymentController { private final String sharedKey = "SHARED_KEY"; private static final String SUCCESS_STATUS = "success"; private static final String ERROR_STATUS = "error"; private static final int CODE_SUCCESS = 100; private static final int AUTH_FAILURE = 102; @GetMapping public BaseResponse showStatus() { return new BaseResponse(SUCCESS_STATUS, 1); } @PostMapping("/pay") public BaseResponse pay(@RequestParam(value = "key") String key, @RequestBody PaymentRequest request) { final BaseResponse response; if (sharedKey.equalsIgnoreCase(key)) { int userId = request.getUserId(); String itemId = request.getItemId(); double discount = request.getDiscount(); // Process the request // .... // Return success response to the client. response = new BaseResponse(SUCCESS_STATUS, CODE_SUCCESS); } else { response = new BaseResponse(ERROR_STATUS, AUTH_FAILURE); } return response; } } 

4.4। मुख्य अनुप्रयोग वर्ग बनाना

यह अंतिम चरण कॉन्फ़िगरेशन क्लास बनाना और एप्लिकेशन लॉन्च करना है। स्प्रिंग बूट नए @SpringBootApplication एनोटेशन का समर्थन करता है, जो अपने डिफ़ॉल्ट विशेषताओं के साथ @Configuration , @EnableAutoConfiguration और @ComponentScan का उपयोग करने के बराबर है।

इस प्रकार, आपको बस @SpringBootApplication के साथ एनोटेट एक वर्ग बनाने की आवश्यकता है, और स्प्रिंग बूट स्वचालित कॉन्फ़िगरेशन को सक्षम करेगा और वर्तमान पैकेज में आपके संसाधनों को स्कैन करेगा:

 package springboot.topjava.ru; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } 

5. स्प्रिंग बूट एप्लिकेशन की तैनाती

अब स्प्रिंग बूट की तीसरी महान विशेषता का लाभ उठाते हैं - यह एक एम्बेडेड सर्वर है। हम सभी को मावेन का उपयोग करके एक निष्पादन योग्य जार फ़ाइल बनाने की आवश्यकता है और इसे सामान्य स्टैंडअलोन एप्लिकेशन की तरह चलाएं:

• कमांड लाइन मोड (cmd कमांड) दर्ज करें, pom.xml के साथ फ़ोल्डर में जाएं और mvan क्लीन पैकेज कमांड दर्ज करें
• मावेन स्प्रिंगबूटरेस्ट सर्विस-1.0. jar नामक एक निष्पादन योग्य जार फ़ाइल उत्पन्न करेगा
• सीडी लक्ष्य फ़ोल्डर पर जाएं
• फिर जार फ़ाइल चलाएँ: java -jar SpringBootRestService-1.0.jar
• Http: // localhost: 8080 / भुगतान पर ब्राउज़र पर जाएं

हमारा REST API चल रहा है और पोर्ट 8080 के माध्यम से अनुरोधों को पूरा करने के लिए तैयार है (डिफ़ॉल्ट रूप से)

इस लेख में, हमने स्प्रिंग बूट की क्षमताओं को देखा और अंतर्निहित सर्वर का उपयोग करके पूरी तरह से काम करने का उदाहरण बनाया।

स्रोत:
https://dzone.com/articles/introducing-spring-boot

अनुवाद में, जानकारी अपडेट की गई थी:

• स्प्रिंग-बूट-स्टार्टर-माता-पिता ने संस्करण को 1.5.8 से बदल दिया। कृपया इसे 2.1.1 पर छोड़ दें। कृपया और तदनुसार उन पुस्तकालयों की सूची, जिन्हें मावेन खींचता है, अपडेट किया गया था
• हटाए गए स्प्रिंग रिपॉजिटरी घोषणाओं को, केंद्रीय भंडार से निर्भरताएं खींच ली जाती हैं
• BaseResponse वर्ग में, खेतों को अंतिम रूप दिया, एक निर्माणकर्ता को जोड़ा, और बसने वालों को हटा दिया
• PaymentController में, हमने ब्राउज़र में एप्लिकेशन का परीक्षण करने के लिए @GetMapping के साथ showStatus () विधि की शुरुआत की
• @ GetMapping / @ PostMapping के तरीकों में @RequestMapping बदला गया
• कमांड लाइन से आवेदन को तैनात करने के लिए परिवर्तन भी किए गए थे

अद्यतन:

जैसा कि Lure_of_Chaos ने उल्लेख किया है, अब सब कुछ स्वचालित रूप से SPITING INITIALIZR के माध्यम से किया जा सकता है। और अपने पसंदीदा JetBrains IntelliJ IDEA को छोड़े बिना ।