include डायरेक्टिव का उपयोग ट्रांसलेशन चरण के दौरान फ़ाइल को शामिल करने के लिए किया जाता है। यह डायरेक्टिव कंटेनर को वर्तमान JSP के साथ अन्य बाहरी फ़ाइलों की सामग्री को ट्रांसलेशन चरण के दौरान मर्ज करने के लिए कहता है। आप अपने JSP पेज में कहीं भी include डायरेक्टिव कोड कर सकते हैं।
इस डायरेक्टिव का सामान्य उपयोग रूप निम्नानुसार है -
<%@ include file = "relative url" %>
include डायरेक्टिव में फ़ाइलनाम वास्तव में एक सापेक्ष URL है। यदि आप बिना संबद्ध पथ के केवल फ़ाइलनाम निर्दिष्ट करते हैं, तो JSP कंपाइलर मान लेता है कि फ़ाइल आपके JSP के समान डायरेक्टरी में है।
आप उपरोक्त सिंटैक्स के XML समतुल्य को निम्नानुसार लिख सकते हैं -
<jsp:directive.include file = "relative url" />
उदाहरण
include डायरेक्टिव का एक अच्छा उदाहरण कई कंटेंट पेजेस के साथ एक सामान्य हेडर और फुटर शामिल करना है।
आइए निम्न तीन फ़ाइलों (a) header.jsp, (b) footer.jsp, और (c) main.jsp को परिभाषित करें -
निम्न header.jsp की सामग्री है -
<%! int pageCount = 0; void addCount() { pageCount++; } %> <% addCount(); %> <html> <head> <title>The include Directive Example</title> </head> <body> <center> <h2>The include Directive Example</h2> <p>This site has been visited <%= pageCount %> times.</p> </center> <br/><br/>
निम्न footer.jsp की सामग्री है -
<br/><br/> <center> <p>Copyright © 2010</p> </center> </body> </html>
अंत में main.jsp की सामग्री यहां है -
<%@ include file = "header.jsp" %> <center> <p>Thanks for visiting my page.</p> </center> <%@ include file = "footer.jsp" %>
आइए अब इन सभी फ़ाइलों को रूट डायरेक्टरी में रखें और main.jsp को एक्सेस करने का प्रयास करें। आपको निम्न आउटपुट प्राप्त होगा -
The include Directive Example This site has been visited 1 times. Thanks for visiting my page. Copyright © 2010
main.jsp को रिफ्रेश करें और आप पाएंगे कि पेज हिट काउंटर बढ़ता रहता है।
आप अपने रचनात्मक अंतर्ज्ञान के आधार पर अपने वेबपेज डिज़ाइन कर सकते हैं; यह अनुशंसा की जाती है कि आप अपनी वेबसाइट के डायनामिक भागों को अलग फ़ाइलों में रखें और फिर उन्हें मुख्य फ़ाइल में शामिल करें। इससे जब आपको अपने वेबपेज के किसी भाग को बदलने की आवश्यकता होती है तो यह आसान हो जाता है।