🤶🏿 🚶🏼 👷🏼 REST के बजाय ग्राफकलाइन के साथ सरल सर्वर, जावा में कार्यान्वयन 🧑🏿‍🤝‍🧑🏾 👌🏽 🕵🏾

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

सैद्धांतिक भाग:
GraphQL - एपीआई पर एक नया रूप। भाग 1 व्लादिमीरजेट्स से
REST और ग्राफकैल की तुलनात्मक रूप से तुलना

मैं आपको तुरंत कोड दिखाऊंगा, क्योंकि ग्राफकॉल एक अमूर्त है। और यदि आप लंबे समय तक अमूर्तता पर चर्चा करते हैं, तो आप खो सकते हैं। मूल यहाँ है ।

मैंने कोड को थोड़ा बदल दिया है, क्योंकि नए संस्करणों में कुछ कक्षाएं नहीं हैं।

एक खाली मावेन प्रोजेक्ट बनाएं। पिकनिक में निर्भरता जोड़ें:

<dependency> <groupId>com.graphql-java</groupId> <artifactId>graphql-java</artifactId> <version>8.0</version> </dependency> <dependency> <groupId>com.graphql-java</groupId> <artifactId>graphql-java-tools</artifactId> <version>5.0.0</version> </dependency> <dependency> <groupId>com.graphql-java</groupId> <artifactId>graphql-java-servlet</artifactId> <version>5.0.0</version> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>3.0.1</version> <scope>provided</scope> </dependency>

सर्वर के बारे में न सोचने के लिए, जेट्टी लें:

  <plugin> <groupId>org.eclipse.jetty</groupId> <artifactId>jetty-maven-plugin</artifactId> <version>9.4.6.v20170531</version> </plugin>

ट्यूटोरियल से अंतर:

कंस्ट्रक्टर को एक कॉल के साथ SimpleGraphQLServlet से विरासत अब "पदावनत" है, आपको बिल्डर का उपयोग करना चाहिए, जो विरासत के साथ असंभव है, रचना का उपयोग करें।
सर्वलेट में, आप एक SimpleGraphQLServlet ऑब्जेक्ट बना सकते हैं।
GraphQLRootResolver - अब और नहीं, आप विशिष्ट का उपयोग कर सकते हैं: GraphQLMutationResolver और GraphQLRootResolver

नींव तैयार है। हम वसंत या JAX-RS के बिना, ट्यूटोरियल के अनुसार करेंगे। सामान्य तौर पर, एक नियमित सर्वलेट:

 @WebServlet(urlPatterns = "/graphql") public class GraphQLEndpoint extends HttpServlet { private SimpleGraphQLServlet graph; public GraphQLEndpoint() { graph = SimpleGraphQLServlet.builder(buildSchema()).build(); } private static GraphQLSchema buildSchema() { LinkRepository linkRepository = new LinkRepository(); return SchemaParser.newParser() .file("schema.graphqls") .resolvers(new Query(linkRepository), new Mutation(linkRepository)) .build() .makeExecutableSchema(); } @Override protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { graph.service(req, resp); } }

इसमें, सर्विस विधि डेटा को SimpleGraphQLServlet से पास करती है। इस पर हमारा व्यवसाय समाप्त हो जाता है।

नियमित कोड (लिंक और लिंकप्रोसेरीटरी)

 public class Link { private final String url; private final String description; public Link(String url, String description) { this.url = url; this.description = description; } public String getUrl() { return url; } public String getDescription() { return description; } }

 public class LinkRepository { private final List<Link> links; public LinkRepository() { links = new ArrayList<>(); //add some links to start off with links.add(new Link("http://howtographql.com", "Your favorite GraphQL page")); links.add(new Link("http://graphql.org/learn/", "The official docks")); } public List<Link> getAllLinks() { return links; } public void saveLink(Link link) { links.add(link); } }

अब अनुरोध कोड (REST में अनुरोध प्राप्त करें) और म्यूटेशन (परिवर्तन के लिए अनुरोध)

 import com.coxautodev.graphql.tools.GraphQLQueryResolver; public class Query implements GraphQLQueryResolver { private final LinkRepository linkRepository; public Query(LinkRepository linkRepository) { this.linkRepository = linkRepository; } public List<Link> allLinks() { return linkRepository.getAllLinks(); } }

 import com.coxautodev.graphql.tools.GraphQLMutationResolver; public class Mutation implements GraphQLMutationResolver { private final LinkRepository linkRepository; public Mutation(LinkRepository linkRepository) { this.linkRepository = linkRepository; } public Link createLink(String url, String description) { Link newLink = new Link(url, description); linkRepository.saveLink(newLink); return newLink; } }

हम जेट्टी के माध्यम से शुरू करते हैं: भागो और हम अनुरोध को फेंक देते हैं:

 http://localhost:8080/graphql?query={allLinks{url}}

हमें जवाब मिलता है:

 {"data": {"allLinks": [ {"url":"http://howtographql.com"}, {"url":"http://graphql.org/learn/"} ] } }

और यहां पहला मुख्य बिंदु है: हमारे पास 2 फ़ील्ड हैं, url और विवरण, और हमें प्रतिक्रिया में केवल url प्राप्त हुआ। और ठीक ही है, क्योंकि हम केवल आग्रह करते हैं और अनुरोध में {allLinks {url}} मांगते हैं। यदि आप अनुरोध को इसमें बदलते हैं:

 http://localhost:8080/graphql?query={allLinks{url,description}}

इसका उत्तर है:

 {"data": {"allLinks": [ { "url":"http://howtographql.com", "description":"Your favorite GraphQL page" }, { "url":"http://graphql.org/learn/", "description":"The official docks" } ] } }

अब हमें यूआरएल और विवरण मिल गया है। और सभी क्योंकि हमने उनसे पूछा।

डेटा परिवर्तन के लिए अनुरोध।

यह यूआई उपयोगिता का उपयोग करने के लिए थोड़ा अधिक जटिल और बहुत आसान है।

1. हम पते पर जाते हैं
2. पूरे index.html फ़ाइल की प्रतिलिपि बनाएँ
3. 2 लाइनों को बदलें:

ये हैं:

 <link rel="stylesheet" href="./node_modules/graphiql/graphiql.css" /> <script src="./node_modules/graphiql/graphiql.js"></script>

इन पर:

 <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/graphiql@0.11.2/graphiql.css" /> <script src="//cdn.jsdelivr.net/npm/graphiql@0.11.2/graphiql.js"></script>

4. इस index.html को प्रोजेक्ट में बदलें ... \ src \ main \ webapp \ index.html जिसमें अभी लिखा है।

हम प्रोजेक्ट को फिर से शुरू करते हैं, लोकलहोस्ट पर जाएं: 8080 और इस तरह के पेज पर जाएं

पहला बोनस: बाईं ओर डॉक्स बटन है, जो आपके प्रोजेक्ट के लिए तैयार प्रलेखन को छुपाता है। ज्यादा नहीं, ऐसे क्षेत्र जिन्हें अनुरोध किया जा सकता है और वे विधियां जिन्हें कहा जा सकता है और उनमें क्या होना चाहिए।

यह आपके पसंदीदा कार सेट भी देता है।

अब इसके साथ, हम एक म्यूटेशन अनुरोध भेजेंगे। हमारे पास एक उत्परिवर्तन है, "एक लिंक जोड़ें"।

क्वेरी पाठ:

 mutation createLink{ createLink(url:"http://test.com", description:"test mutation"){ url description } }

थोड़े समय बाद मुझे पता चला कि शब्द उत्परिवर्तन पर्याप्त है (इसे लिखने के बाद ज़रूर लिखें)

 mutation { createLink(url:"http://test.com", description:"test mutation"){ url description } }

यानी हम सिर्फ इसके नाम से विधि को कहते हैं और इसके मापदंडों को पास करते हैं। आप यह भी धोखा दे सकते हैं कि हम कौन सी जानकारी वापस पाना चाहते हैं।

म्यूटेशन अनुरोध कैसे देखें

1. F12 डेवलपर टैब खोलें और नेटवर्क खोलें, हम अनुरोध भेजते हैं।

2. प्रस्तुत अनुरोध पर, आरएमबी -> प्रतिलिपि -> प्रतिलिपि के रूप में cURL (बैश)

2.1। जो लोग कर्ल का उपयोग करते हैं, उनके लिए यह पर्याप्त है, जो पोस्टमैन को आगे देखना चाहते हैं

3. पोस्टमैन खोलें और शीर्ष बाईं ओर आयात पर क्लिक करें।

4. खुलने वाली विंडो में, पेस्ट रॉ टेक्स्ट का चयन करें और वहां कॉपी किए गए कर्ल अनुरोध को पेस्ट करें

और हम अनुरोध निकाय देख सकते हैं:

 {"query":"mutation createLink{\n createLink(url:\"http://test.com\", description:\"test mutation\"){\n\t\turl\n description\n }\n}","variables":null,"operationName":"createLink"}    “\n”.

इस स्तर पर, पहले से ही एक साधारण सर्वर है, वहां भंडारण है, और हम अनुरोधों के लिए यूआरएल सेट करते हैं।

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

Github नमूना कोड
2 शाखाएँ:

मास्टर - सरकारी ट्यूटोरियल में कैसे किया जाता है

update_version निर्भरता के नए संस्करणों के साथ एक अद्यतन संस्करण है।

संदर्भ:

1. डॉक्स
2. आधिकारिक ट्यूटोरियल (विभिन्न भाषाओं के लिए)
3. वह वीडियो जिसने पहली समझ दी

REST के बजाय ग्राफकलाइन के साथ सरल सर्वर, जावा में कार्यान्वयन

More articles: