यह एक बहुत ही सतही मार्गदर्शक है, जो केवल 'हैलो वर्ल्ड' एप्लिकेशन बनाने के उदाहरण का उपयोग करके प्ले फ्रेमवर्क की बुनियादी कार्यक्षमता को पेश करेगा।

(भाग 1)

रूप रचना

आइए एक फॉर्म बनाकर हमारा 'हैलो वर्ल्ड' एप्लीकेशन शुरू करें जहां आप एक नाम दर्ज कर सकते हैं।

इस तरह से helloworld / app / views / Application / index.html संपादित करें:

#{extends 'main.html' /} #{set title:'Home' /} <form action="@{Application.sayHello()}" method="GET"> <input type="text" name="myName" /> <input type="submit" value="Say hello!" /> </form>

हम यह सुनिश्चित करने के लिए @ {...} संकेतन का उपयोग करते हैं कि Play स्वचालित रूप से Application.sayHello पर एक URL बनाता है। अब, अपने ब्राउज़र होमपेज को रिफ्रेश करें।

क्षमा करें, आपको एक त्रुटि मिलेगी। ऐसा इसलिए है क्योंकि आप एक nonexistent Application.sayHello कार्रवाई का संदर्भ दे रहे हैं। आइए इसे helloworld / app / नियंत्रकों / Application.java में बनाएं:

 package controllers; import play.mvc.*; public class Application extends Controller { public static void index() { render(); } public static void sayHello(String myName) { render(myName); } }

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

अब, यदि आप अपना नाम दर्ज करने और फॉर्म जमा करने का प्रयास करते हैं, तो आपको एक और त्रुटि मिलेगी:

इस त्रुटि के कारण को समझना काफी सरल है। प्ले इस कार्रवाई के लिए डिफ़ॉल्ट टेम्पलेट को कॉल करने की कोशिश करता है, लेकिन यह मौजूद नहीं है। आइए इसे बनाएं helloworld / app / views / Application / sayHello.html:

 #{extends 'main.html' /} #{set title:'Home' /} <h1>Hello ${myName ?: 'guest'}!</h1> <a href="@{Application.index()}">Back to form</a>

अब पेज को रिफ्रेश करें।

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

सीएनसी सेटिंग

यदि आप बनाए गए पृष्ठ का URL देखते हैं, तो आपको कुछ ऐसा दिखाई देगा:

http: // localhost: 9000 / एप्लिकेशन / Sayhello? myName = guillaume

ऐसा इसलिए है क्योंकि Play सभी नियंत्रक क्रियाओं के लिए डिफ़ॉल्ट मार्ग का उपयोग करता है:

* /{controller}/{action} {controller}.{action}

हम कस्टम Application.sayHello क्रियाओं के लिए पथ निर्दिष्ट करके सर्वश्रेष्ठ URL सेट कर सकते हैं। पहली पंक्ति के बाद निम्नलिखित जोड़ने के लिए helloworld / conf / मार्गों को संशोधित करें:

GET /hello Application.sayHello

अब फॉर्म पर वापस जाएं और अपना नाम दर्ज करें ताकि यह सुनिश्चित हो सके कि सब कुछ काम करता है।

आउटपुट टेम्पलेट अनुकूलन

चूंकि टेम्पलेट main.html टेम्पलेट को इनहेरिट करते हैं, आप आसानी से सभी टेम्पलेट बदल सकते हैं। बदलिए helloworld / app / views / main.html:

 ... <body> The Hello world app. <hr/> #{doLayout /} </body> ...

लाइन "हैलो दुनिया एप्लिकेशन।" सभी पृष्ठों पर दिखाई दिया।

इनपुट सत्यापन

प्रपत्र में एक चेक जोड़ें। सबमिट करने से पहले फॉर्म को पूरा करना होगा। ऐसा करने के लिए, हम Play सत्यापन ढांचे का उपयोग कर सकते हैं।

परिवर्तनहेलो को हेलोवर्ल्ड / एप / कंट्रोलर / एप्लिकेशन.जाव नियंत्रक में निम्नानुसार बदलें:

 ... public static void sayHello(@Required String myName) { if(validation.hasErrors()) { flash.error("Oops, please enter your name!"); index(); } render(myName); } ...

Play.data.validation को आयात करना याद रखें। * @ असमान एनोटेशन का उपयोग करने के लिए। प्ले स्वचालित रूप से जाँच करेगा कि क्या myName फ़ील्ड भरा है या किसी त्रुटि वाली ऑब्जेक्ट को जोड़ें। फिर, यदि कोई त्रुटि है, तो हम एक संदेश जोड़ेंगे और इसे साइट के रूट पर पुनर्निर्देशित करेंगे।

किसी पृष्ठ पर पुनर्निर्देशित करने पर फ़्लैश ऑब्जेक्ट आपको संदेशों को सहेजने की अनुमति देता है।

अब आपको बस एरर मैसेज दिखाना है, यदि कोई है तो। बदलिए helloworld / app / views / Application / index.html:

 #{extends 'main.html' /} #{set title:'Home' /} #{if flash.error} <p style="color:#c00"> ${flash.error} </p> #{/if} <form action="@{Application.sayHello()}" method="GET"> <input type="text" name="myName" /> <input type="submit" value="Say hello!" /> </form>

आइए देखें कि यह कैसे काम करता है:

स्वचालित परीक्षण

हम एप्लिकेशन के लिए एक परीक्षण लिखकर ट्यूटोरियल खत्म करते हैं। चूंकि सत्यापित करने के लिए जावा कोड में कोई तर्क नहीं है, इसलिए हमें वेब एप्लिकेशन को सत्यापित करना होगा। इसलिए, हम सेलेनियम के लिए एक परीक्षण लिखेंगे।

सबसे पहले एप्लिकेशन को टेस्ट मोड में चलाएं। एप्लिकेशन को रोकें और इसे कमांड से पुनरारंभ करें:

$ play test

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

अपने ब्राउज़र में निम्न पता खोलें http: // localhost: 9000 / @ परीक्षण देखने के लिए परीक्षण करें। सभी डिफ़ॉल्ट परीक्षणों का चयन करने और उन्हें चलाने की कोशिश करें, सब कुछ हरा होना चाहिए ... लेकिन ये मानक परीक्षण हैं, जो सामान्य रूप से कुछ भी परीक्षण नहीं करते हैं।

सेलेनियम के लिए टेस्ट आमतौर पर एक HTML फ़ाइल के रूप में लिखे जाते हैं। सेलेनियम के लिए परीक्षण लिखना थोड़ा थकाऊ है (HTML तालिका तत्वों का उपयोग करके प्रारूपण)। अच्छी खबर यह है कि प्ले आपको प्ले टेम्पलेट इंजन का उपयोग करके इसे उत्पन्न करने में मदद करेगा, जो सेलेनियम लिपियों के लिए सरलीकृत सिंटैक्स का समर्थन करता है।

एप्लिकेशन बनाते समय, सेलेनियम के परीक्षण सहित प्ले ने स्वचालित रूप से परीक्षण बनाए। ओपन हेलोवर्ल्ड / टेस्ट / Application.test.html:

 *{ You can use plain selenium command using the selenium tag }* #{selenium} // Open the home page, and check that no error occurred open('/') assertNotTitle('Application error') #{/selenium}

यह परीक्षण बिना किसी समस्या के काम करना चाहिए। वह बस मुख्य पृष्ठ खोलता है और यह सुनिश्चित करता है कि पृष्ठों में पाठ 'अनुप्रयोग त्रुटि' नहीं है।

हम अपने आवेदन के लिए एक परीक्षा लिखेंगे। परीक्षण की सामग्री बदलें:

 #{selenium} //     ,       open('/') assertNotTitle('Application error') //     assertTextPresent('The Hello world app.') //   clickAndWait('css=input[type=submit]') //     assertTextPresent('Oops, please enter your name!') //      type('css=input[type=text]', 'bob') clickAndWait('css=input[type=submit]') //   assertTextPresent('Hello bob!') assertTextPresent('The Hello world app.') //    clickAndWait('link=Back to form') //  ? assertTextNotPresent('Hello bob!') #{/selenium}

हमने आवेदनों का पूरी तरह से परीक्षण किया है। बस टेस्ट रनर में इस परीक्षा का चयन करें और "प्रारंभ" पर क्लिक करें। सब कुछ हरा होना चाहिए!

और चाहिए?

यह एक बहुत ही सरल पाठ था। यदि आप Play फ्रेमवर्क के बारे में अधिक जानना चाहते हैं, तो "ट्यूटोरियल - प्ले गाइड, एक वास्तविक दुनिया एप्लिकेशन चरण-दर-चरण" पढ़ें।

'हैलो वर्ल्ड' ट्यूटोरियल - आपका पहला प्ले फ्रेमवर्क एप्लिकेशन (भाग 2)