Java REST सेवा आसान है

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



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

तो, चलिए चलते हैं:

1. हम एक साधारण वर्ग का वर्णन करते हैं जो कुछ जानकारी तक पहुँच प्रदान करेगा। इसे कॉल काउंटर होने दें:

@Singleton
public static class Counter {
private final AtomicInteger counter = new AtomicInteger(0);
public int getNext() {
return counter.incrementAndGet();
}
}

* This source code was highlighted with Source Code Highlighter .

सिंगलटन एनोटेशन को जूस बताने के लिए आवश्यक है कि ऑब्जेक्ट एक सिंगलटन होना चाहिए :)

2. हम उस सेवा का वर्णन करते हैं जो हमें कुछ वापस लौटाएगी, साथ ही साथ काउंटर को खींचेगी:

@Path( "/hello" )
public static class Resource {

@Inject Counter counter;

@GET
public String get () {
return "Hello, User number " + counter.getNext();
}
}

* This source code was highlighted with Source Code Highlighter .

3. अब जर्सी और गुइसे से दोस्ती करें। मैंने तैयार एकीकरण का लाभ उठाया, इसे जर्सी-गाइस कहा जाता है। एकीकरण सेवा / फ़िल्टर GuiceContainer के माध्यम से किया जाता है, जिसका उपयोग करने के लिए आपको guice-servlet-मॉड्यूल एक्सटेंशन से ServletModule घोषित करने की आवश्यकता होती है और संकेत मिलता है कि हमें जिन अनुरोधों की आवश्यकता है, उन्हें GuiceContainer द्वारा संसाधित किया जाएगा, जो जर्सी को Guice के संदर्भ में संसाधनों की घोषणा करने की अनुमति देगा।

public static class Config extends GuiceServletContextListener {
@Override
protected Injector getInjector() {
return Guice.createInjector( new ServletModule(){
@Override
protected void configureServlets() {
bind(Resource. class );
bind(Counter. class );
serve( "*" ).with(GuiceContainer. class );
}
});
}
}

* This source code was highlighted with Source Code Highlighter .

उसी स्थान पर, हमने काउंटर और संसाधन को बाउंस किया।

4. सर्वलेट कंटेनर का उपयोग करके यह सारा सामान चलाना बाकी है। ऐसा करने के लिए, हमें युद्ध-कू को इकट्ठा करने और कुछ टॉमकैट पर तैनात करने की आवश्यकता नहीं है। आप एम्बेडेड कंटेनर का उपयोग कर सकते हैं। जेट्टी और ग्रिज़ली के दिमाग में आते हैं। मैंने आखिरी वाला चुना। यहाँ सर्वर को शुरू करने वाला कोड है:

public static void main( String [] args) throws Exception {
int port = Integer.valueOf(System.getProperty( "port" ));
GrizzlyWebServer server = new GrizzlyWebServer(port);
ServletAdapter adapter = new ServletAdapter( new DummySevlet());
adapter.addServletListener(Config. class .getName());
adapter.addFilter( new GuiceFilter(), "GuiceFilter" , null );
server.addGrizzlyAdapter(adapter, new String []{ "/" });
server.start();
}

* This source code was highlighted with Source Code Highlighter .

ध्यान दें कि आपको एक खाली सर्वलेट घोषित करना होगा:

@SuppressWarnings( "serial" )
public static class DummySevlet extends HttpServlet { }

* This source code was highlighted with Source Code Highlighter .

यह काम करने के लिए Guice फ़िल्टर के लिए आवश्यक है। यदि कोई सर्वलेट्स नहीं हैं, तो ग्रिज़ली किसी भी फ़िल्टर के लिए अनुरोध पारित नहीं करेगा।

शायद यही सब है। अगला, मैं पूरा कोड दूंगा:

public class App {

@Path( "/hello" )
public static class Resource {

@Inject Counter counter;

@GET
public String get () {
return "Hello, User number " + counter.getNext();
}
}

@Singleton
public static class Counter {
private final AtomicInteger counter = new AtomicInteger(0);
public int getNext() {
return counter.incrementAndGet();
}
}

public static class Config extends GuiceServletContextListener {
@Override
protected Injector getInjector() {
return Guice.createInjector( new ServletModule(){
@Override
protected void configureServlets() {
bind(Resource. class );
bind(Counter. class );
serve( "*" ).with(GuiceContainer. class );
}
});
}
}

@SuppressWarnings( "serial" )
public static class DummySevlet extends HttpServlet { }

public static void main( String [] args) throws Exception {
int port = Integer.valueOf(System.getProperty( "port" ));
GrizzlyWebServer server = new GrizzlyWebServer(port);
ServletAdapter adapter = new ServletAdapter( new DummySevlet());
adapter.addServletListener(Config. class .getName());
adapter.addFilter( new GuiceFilter(), "GuiceFilter" , null );
server.addGrizzlyAdapter(adapter, new String []{ "/" });
server.start();
}
}

* This source code was highlighted with Source Code Highlighter .

UPD: स्रोत