स्प्रिंग डेटा मोंगो के साथ स्प्रिंग बूट का परिचय

सभी को नमस्कार। हम छात्रों को उनके पेशेवर अवकाश पर बधाई देने और यह सूचित करने के लिए कि फरवरी में हम "डेवलपर ऑन द स्प्रिंग फ्रेमवर्क" शुरू करेंगे। यह आज के प्रकाशन का विषय होगा।

जस्टिस लीग खतरे में है, और केवल अल्फ्रेड सभी को बचा सकता है - स्प्रिंग बूट, स्प्रिंग डेटा और मोंगोबीडी के साथ नई प्रबंधन प्रणाली के साथ।

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



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

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

डाउनलोड किए गए संग्रह को अनपैक करने के बाद, शुरुआत के लिए, प्रोफ़ाइल में निम्नलिखित मापदंडों को कॉन्फ़िगर करें:

SPRING_BOOT_HOME=<extracted path>/spring-1.3.0.M1 PATH=$SPRING_BOOT_HOME/bin:$PATH 

फिर bashrc फ़ाइल में निम्न जोड़ें:

 <extracted-path>/spring-1.3.0.M1/shell-completion/bash/spring 

स्प्रिंग बूट एप्लिकेशन बनाने के लिए स्प्रिंग-क्लि के साथ काम करने पर यह कमांड लाइन में ऑटो-पूरा जोड़ देगा। याद रखें कि प्रोफ़ाइल और "bashrc" फ़ाइलों के लिए आपको "स्रोत" में होने वाले परिवर्तनों की पुष्टि करनी होगी।

यह लेख निम्नलिखित प्रौद्योगिकी स्टैक का उपयोग करता है:

• वसंत ऋतु
• स्प्रिंग डेटा
• MongoDB।

हम निम्न कमांड चलाकर एक एप्लिकेशन प्रोजेक्ट टेम्पलेट बनाकर शुरू करते हैं। कृपया ध्यान दें कि मेरे GitHub भंडार से एक नमूना परियोजना डाउनलोड की जा सकती है ।

 spring init -dweb,data-mongodb,flapdoodle-mongo --groupId com.justiceleague --artifactId justiceleaguemodule --build maven justiceleaguesystem 

यह एकीकृत मोंगबीडी के साथ स्प्रिंग एमवीसी और स्प्रिंग डेटा के साथ एक मावेन परियोजना उत्पन्न करेगा।
डिफ़ॉल्ट रूप से, स्प्रिंग-क्लि "डेमो" नामक एक प्रोजेक्ट बनाता है। इसलिए, हमें संबंधित जेनरेट किए गए एप्लिकेशन वर्ग का नाम बदलना होगा। यदि आपने ऊपर वर्णित मेरे GitHub रिपॉजिटरी के स्रोतों का उपयोग किया है, तो आप इस चरण को छोड़ सकते हैं।
स्प्रिंग बूट का उपयोग करना, एप्लिकेशन को चलाना प्रोजेक्ट द्वारा बनाई गई JAR फ़ाइल को चलाने के समान सरल है। जो बस वसंत लोड करने के लिए @SpringBootApplication द्वारा एनोटेट किए गए एप्लिकेशन वर्ग को कॉल करता है। आइए देखें कि यह कैसा दिखता है:

 package com.justiceleague.justiceleaguemodule; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; /** *   spring boot,   -    *   * * @author dinuka * */ @SpringBootApplication public class JusticeLeagueManagementApplication { public static void main(String[] args) { SpringApplication.run(JusticeLeagueManagementApplication.class, args); } } 

फिर हम डोमेन कक्षाओं में जाते हैं, जहां डेटा के स्तर को निर्धारित करने के लिए MongoDB के साथ स्प्रिंग डेटा का उपयोग किया जाता है। डोमेन वर्ग इस प्रकार है:

 package com.justiceleague.justiceleaguemodule.domain; import org.bson.types.ObjectId; import org.springframework.data.annotation.Id; import org.springframework.data.mongodb.core.index.Indexed; import org.springframework.data.mongodb.core.mapping.Document; /** *         ,  *    MongoDB * * @author dinuka * */ @Document(collection = "justiceLeagueMembers") public class JusticeLeagueMemberDetail { @Id private ObjectId id; @Indexed private String name; private String superPower; private String location; public JusticeLeagueMemberDetail(String name, String superPower, String location) { this.name = name; this.superPower = superPower; this.location = location; } public String getId() { return id.toString(); } public void setId(String id) { this.id = new ObjectId(id); } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getSuperPower() { return superPower; } public void setSuperPower(String superPower) { this.superPower = superPower; } public String getLocation() { return location; } public void setLocation(String location) { this.location = location; } } 

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

 @Document 

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

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

 package com.justiceleague.justiceleaguemodule.dao; import org.springframework.data.mongodb.repository.MongoRepository; import org.springframework.data.mongodb.repository.Query; import com.justiceleague.justiceleaguemodule.domain.JusticeLeagueMemberDetail; public interface JusticeLeagueRepository extends MongoRepository < JusticeLeagueMemberDetail, String > { /** *        ,   . *  . * * @param superHeroName *        . * @return   {@link JusticeLeagueMemberDetail}   *  . */ @Query("{ 'name' : {$regex: ?0, $options: 'i' }}") JusticeLeagueMemberDetail findBySuperHeroName(final String superHeroName); } 

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

जैसा कि आप देख सकते हैं, केवल एक विधि परिभाषित है। @Query एनोटेशन के साथ @Query हम नियमित अभिव्यक्तियों का उपयोग करते हुए एक सुपर हीरो की तलाश कर रहे हैं। MongoDB में मैच खोजने की कोशिश करने पर "i" विकल्प का मतलब मामले की अनदेखी करना है।

फिर, हम सेवा स्तर के माध्यम से न्याय लीग के नए सदस्यों के भंडारण के तर्क को लागू करते हैं।

 package com.justiceleague.justiceleaguemodule.service.impl; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import com.justiceleague.justiceleaguemodule.constants.MessageConstants.ErrorMessages; import com.justiceleague.justiceleaguemodule.dao.JusticeLeagueRepository; import com.justiceleague.justiceleaguemodule.domain.JusticeLeagueMemberDetail; import com.justiceleague.justiceleaguemodule.exception.JusticeLeagueManagementException; import com.justiceleague.justiceleaguemodule.service.JusticeLeagueMemberService; import com.justiceleague.justiceleaguemodule.web.dto.JusticeLeagueMemberDTO; import com.justiceleague.justiceleaguemodule.web.transformer.DTOToDomainTransformer; /** *     {@link JusticeLeagueMemberService}   * ,     * * @author dinuka * */ @Service public class JusticeLeagueMemberServiceImpl implements JusticeLeagueMemberService { @Autowired private JusticeLeagueRepository justiceLeagueRepo; /** * {@inheritDoc} */ public void addMember(JusticeLeagueMemberDTO justiceLeagueMember) { JusticeLeagueMemberDetail dbMember = justiceLeagueRepo.findBySuperHeroName(justiceLeagueMember.getName()); if (dbMember != null) { throw new JusticeLeagueManagementException(ErrorMessages.MEMBER_ALREDY_EXISTS); } JusticeLeagueMemberDetail memberToPersist = DTOToDomainTransformer.transform(justiceLeagueMember); justiceLeagueRepo.insert(memberToPersist); } } 

फिर, यह काफी सरल है - यदि प्रतिभागी पहले से मौजूद है, तो हमें एक त्रुटि मिलती है। अन्यथा, प्रतिभागी को जोड़ें। ध्यान दें कि यह सम्मिलित रिपॉजिटरी के पहले से लागू स्प्रिंग डेटा विधि का उपयोग करता है, जिसे हमने पहले परिभाषित किया था।

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

 package com.justiceleague.justiceleaguemodule.web.rest.controller; import javax.validation.Valid; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.http.HttpStatus; import org.springframework.http.MediaType; import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.ResponseBody; import org.springframework.web.bind.annotation.ResponseStatus; import org.springframework.web.bind.annotation.RestController; import com.justiceleague.justiceleaguemodule.constants.MessageConstants; import com.justiceleague.justiceleaguemodule.service.JusticeLeagueMemberService; import com.justiceleague.justiceleaguemodule.web.dto.JusticeLeagueMemberDTO; import com.justiceleague.justiceleaguemodule.web.dto.ResponseDTO; /** *    REST API . * * @author dinuka * */ @RestController @RequestMapping("/justiceleague") public class JusticeLeagueManagementController { @Autowired private JusticeLeagueMemberService memberService; /** *             * * @param justiceLeagueMember *    . * @return an instance of {@link ResponseDTO}     *   . */ @ResponseBody @ResponseStatus(value = HttpStatus.CREATED) @RequestMapping(method = RequestMethod.POST, path = "/addMember", produces = { MediaType.APPLICATION_JSON_VALUE }, consumes = { MediaType.APPLICATION_JSON_VALUE }) public ResponseDTO addJusticeLeagueMember(@Valid @RequestBody JusticeLeagueMemberDTO justiceLeagueMember) { ResponseDTO responseDTO = new ResponseDTO(ResponseDTO.Status.SUCCESS, MessageConstants.MEMBER_ADDED_SUCCESSFULLY); try { memberService.addMember(justiceLeagueMember); } catch (Exception e) { responseDTO.setStatus(ResponseDTO.Status.FAIL); responseDTO.setMessage(e.getMessage()); } return responseDTO; } } 

बैटमैन पर्याप्त नहीं है, इसलिए हम JSON पेलोड के रूप में कार्यक्षमता प्रदान करते हैं, हालांकि अल्फ्रेड पुराने जमाने का होगा और XML को पसंद करेगा।

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

 package com.justiceleague.justiceleaguemodule.test.util; import java.io.IOException; import java.net.UnknownHostException; import org.junit.After; import org.junit.AfterClass; import org.junit.Before; import org.junit.BeforeClass; import org.junit.runner.RunWith; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc; import org.springframework.boot.test.context.SpringBootTest; import org.springframework.data.mongodb.core.MongoTemplate; import org.springframework.test.context.junit4.SpringRunner; import org.springframework.test.web.servlet.MockMvc; import com.fasterxml.jackson.databind.ObjectMapper; import com.justiceleague.justiceleaguemodule.domain.JusticeLeagueMemberDetail; import de.flapdoodle.embed.mongo.MongodExecutable; import de.flapdoodle.embed.mongo.MongodStarter; import de.flapdoodle.embed.mongo.config.IMongodConfig; import de.flapdoodle.embed.mongo.config.MongodConfigBuilder; import de.flapdoodle.embed.mongo.config.Net; import de.flapdoodle.embed.mongo.distribution.Version; /** *     ,     , *            . * * @author dinuka * */ @RunWith(SpringRunner.class) @SpringBootTest @AutoConfigureMockMvc public abstract class BaseIntegrationTest { @Autowired protected MockMvc mockMvc; protected ObjectMapper mapper; private static MongodExecutable mongodExecutable; @Autowired protected MongoTemplate mongoTemplate; @Before public void setUp() { mapper = new ObjectMapper(); } @After public void after() { mongoTemplate.dropCollection(JusticeLeagueMemberDetail.class); } /** *      mongodb     *  . * * @throws UnknownHostException * @throws IOException */ @BeforeClass public static void beforeClass() throws UnknownHostException, IOException { MongodStarter starter = MongodStarter.getDefaultInstance(); IMongodConfig mongoConfig = new MongodConfigBuilder().version(Version.Main.PRODUCTION) .net(new Net(27017, false)).build(); mongodExecutable = starter.prepare(mongoConfig); try { mongodExecutable.start(); } catch (Exception e) { closeMongoExecutable(); } } @AfterClass public static void afterClass() { closeMongoExecutable(); } private static void closeMongoExecutable() { if (mongodExecutable != null) { mongodExecutable.stop(); } } } 

 package com.justiceleague.justiceleaguemodule.web.rest.controller; import org.hamcrest.beans.SamePropertyValuesAs; import org.junit.Assert; import org.junit.Test; import org.springframework.http.MediaType; import org.springframework.test.web.servlet.request.MockMvcRequestBuilders; import org.springframework.test.web.servlet.result.MockMvcResultMatchers; import com.justiceleague.justiceleaguemodule.constants.MessageConstants; import com.justiceleague.justiceleaguemodule.constants.MessageConstants.ErrorMessages; import com.justiceleague.justiceleaguemodule.domain.JusticeLeagueMemberDetail; import com.justiceleague.justiceleaguemodule.test.util.BaseIntegrationTest; import com.justiceleague.justiceleaguemodule.web.dto.JusticeLeagueMemberDTO; import com.justiceleague.justiceleaguemodule.web.dto.ResponseDTO; import com.justiceleague.justiceleaguemodule.web.dto.ResponseDTO.Status; /** *      REST-,  * {@link JusticeLeagueManagementController} * * @author dinuka * */ public class JusticeLeagueManagementControllerTest extends BaseIntegrationTest { /** *          *   . * * @throws Exception */ @Test public void testAddJusticeLeagueMember() throws Exception { JusticeLeagueMemberDTO flash = new JusticeLeagueMemberDTO("Barry Allen", "super speed", "Central City"); String jsonContent = mapper.writeValueAsString(flash); String response = mockMvc .perform(MockMvcRequestBuilders.post("/justiceleague/addMember") .accept(MediaType.APPLICATION_JSON) .contentType(MediaType.APPLICATION_JSON).content(jsonContent)) .andExpect(MockMvcResultMatchers.status().isCreated()).andReturn().getResponse().getContentAsString(); ResponseDTO expected = new ResponseDTO(Status.SUCCESS, MessageConstants.MEMBER_ADDED_SUCCESSFULLY); ResponseDTO receivedResponse = mapper.readValue(response, ResponseDTO.class); Assert.assertThat(receivedResponse, SamePropertyValuesAs.samePropertyValuesAs(expected)); } /** *   ,       *    ,     . * * @throws Exception */ @Test public void testAddJusticeLeagueMemberWhenMemberAlreadyExists() throws Exception { JusticeLeagueMemberDetail flashDetail = new JusticeLeagueMemberDetail("Barry Allen", "super speed","Central City"); mongoTemplate.save(flashDetail); JusticeLeagueMemberDTO flash = new JusticeLeagueMemberDTO("Barry Allen", "super speed", "Central City"); String jsonContent = mapper.writeValueAsString(flash); String response = mockMvc .perform(MockMvcRequestBuilders.post("/justiceleague/addMember"). accept(MediaType.APPLICATION_JSON) .contentType(MediaType.APPLICATION_JSON).content(jsonContent)) .andExpect(MockMvcResultMatchers.status().isCreated()).andReturn().getResponse() .getContentAsString(); ResponseDTO expected = new ResponseDTO(Status.FAIL, ErrorMessages.MEMBER_ALREDY_EXISTS); ResponseDTO receivedResponse = mapper.readValue(response, ResponseDTO.class); Assert.assertThat(receivedResponse, SamePropertyValuesAs.samePropertyValuesAs(expected)); } /** *   ,      , *          JSON . *    -  . * * @throws Exception */ @Test public void testAddJusticeLeagueMemberWhenNameNotPassedIn() throws Exception { //     ,   //     . JusticeLeagueMemberDTO flash = new JusticeLeagueMemberDTO (null, "super speed", "Central City"); String jsonContent = mapper.writeValueAsString(flash); mockMvc.perform(MockMvcRequestBuilders.post("/justiceleague/addMember") .accept(MediaType.APPLICATION_JSON) .contentType(MediaType.APPLICATION_JSON).content(jsonContent)) .andExpect(MockMvcResultMatchers.status().is4xxClientError()); } } 

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

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