2013-06-27 18 views
27

वहाँ कई जावा सर्वर चेहरे web.xml में <context-param> हैं: facelets.REFRESH_PERIOD, facelets.DEVELOPMENT, facelets.SKIP_COMMENTS आदि कहाँ मैं उन सभी पैरामीटर की एक पूरी सूची मिल सकती है?अवलोकन और महत्व देता

+0

एक असली त्वरित Google खोज https://facelets.java.net/nonav/docs/dev/docbook.html#config-webapp-init –

+0

पहले लाती है, मुझे उस सूची में javax.faces.PROJECT_STAGE दिखाई नहीं देता है।दूसरा - ऐसा लगता है कि जैस 1.1 और 1.2 के बारे में पेज नहीं है? – Cherry

+1

आपके उदाहरण फेसलेट पैरा के लिए हैं, न कि चेहरे का सामना करते हैं। 2.0 के लिए, चेहरे चेहरे का हिस्सा बन गए और पैरा का नाम बदल दिया गया। 2.0 के लिए एक सूची के लिए यहां देखें: http://docs.jboss.org/jbossas/6/JSF_Guide/en-US/html/jsf.reference.html –

उत्तर

69

सबसे पहले, facelets. से शुरू होने वाले लोग जेएसएफ संदर्भ पैरामीटर नहीं हैं, लेकिन Facelets 1.x संदर्भ पैरामीटर हैं। पहले, जेएसएफ 1.x युग के दौरान, फेसलेट को जेएसएफ के हिस्से के रूप में एकीकृत नहीं किया गया था। हालांकि, जेएसएफ 2.0 के बाद, फेसलेट जेएसएफ के हिस्से के रूप में एकीकृत है, लीगेसी जेएसपी को डिफॉल्ट व्यू टेक्नोलॉजी के रूप में बदल रहा है, और अधिकांश फेसलेट्स 1.x संदर्भ पैरामीटर जेएसएफ 2.x संदर्भ पैरामीटर में रीमेप किए गए थे।

असली जेएसएफ संदर्भ पैरामीटर नाम javax.faces. से शुरू होते हैं। वे JSF specification के अध्याय 11.1.3 में सूचीबद्ध हैं।

11.1.3 ऐप्लिकेशन कॉन्फ़िगरेशन पैरामीटर

सर्वलेट कंटेनर का समर्थन आवेदन कॉन्फ़िगरेशन पैरामीटर वेब अनुप्रयोग तैनाती डिस्क्रिप्टर में <context-param> तत्वों सहित द्वारा अनुकूलित किया जा सकता है कि: यहाँ JSF 2.0 विनिर्देश से प्रासंगिकता के एक उद्धरण है। सभी JSF कार्यान्वयन निम्न अनुप्रयोग विन्यास पैरामीटर नाम का समर्थन करने के लिए आवश्यक हैं:

  • javax.faces.CONFIG_FILES - अल्पविराम सीमांकित संदर्भ रिश्तेदार संसाधन पथ जिसके तहत JSF कार्यान्वयन आवेदन कॉन्फ़िगरेशन संसाधन (धारा 11.4 देखने के लिए दिखेगा की सूची। 4 "अनुप्रयोग विन्यास संसाधन प्रारूप"), "/WEB-INF/faces-config.xml" नामक विन्यास संसाधन लोड करने से पहले (यदि ऐसा संसाधन मौजूद है)। यदि सूची में "/WEB-INF/faces-config.xml" मौजूद है, तो इसे अनदेखा किया जाना चाहिए।

  • javax.faces.DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SYSTEM_TIMEZONE - इस परम सेट है, तो और अपने मूल्य रिटर्न true के String प्रतिनिधित्व पर toLowerCase().equals("true") बुला, Application.createConverter() गारंटी करना होगा कि सभी javax.faces.convert.DateTimeConverter उदाहरणों में से समय क्षेत्र के लिए डिफ़ॉल्ट होना चाहिए बराबर TimeZone.getDefault() बजाय "GMT" का।

  • javax.faces.DEFAULT_SUFFIX - जेएसपी पृष्ठों के लिए जेएसएफ सामग्री युक्त वैकल्पिक प्रत्यय को परिभाषित करने के लिए वेब एप्लिकेशन को अनुमति दें। पूर्ण विनिर्देश के लिए प्रतीकात्मक निरंतर ViewHandler.DEFAULT_SUFFIX_PARAM_NAME के लिए javadocs देखें।

  • javax.faces.DISABLE_FACELET_JSF_VIEWHANDLER - इस परम सेट कर दिया जाता है, और बुला toLowerCase().equals("true") अपने मूल्य के String प्रतिनिधित्व पर रिटर्न true, तो डिफ़ॉल्ट ViewHandler इस विनिर्देशन का नवीनतम 1.2 संस्करण में निर्दिष्ट के रूप में व्यवहार करना चाहिए। अनुभाग 7.5 "व्यूहैंडलर" में निर्दिष्ट कोई भी व्यवहार डिफ़ॉल्ट ViewHandler में कार्यान्वित किया गया है जो के लिए अनुरोधों को संभालने से संबंधित है, जो जावासेवर फेस दृश्य घोषणा भाषा में लिखे गए पृष्ठों को रनटाइम द्वारा निष्पादित नहीं किया जाना चाहिए।

  • javax.faces.FACELETS_LIBRARIES - इस परम सेट है, तो क्रम अर्धविराम के रूप में यह व्याख्या करना होगा (;) रास्तों में से अलग की गई सूची, के साथ शुरू "/" (उद्धरण के बिना)।रनटाइम को वेब अनुप्रयोग रूट के सापेक्ष पथ के रूप में सूची में प्रत्येक प्रविष्टि की व्याख्या करनी चाहिए और उस पथ पर मिली फ़ाइल को फेसलेट टैग लाइब्रेरी के रूप में समझना चाहिए, के अनुसार धारा 1.1 में घोषित स्कीमा "अनुप्रयोग विन्यास संसाधन के लिए XML स्कीमा परिभाषा फ़ाइल "और धारा 10.3.2" फेसलेट टैग लाइब्रेरी तंत्र "के अनुसार टैग को बेनकाब करें। रनटाइम को facelets.LIBRARIES परम नाम को मौजूदा फेसलेट टैग लाइब्रेरीज़ के साथ पिछड़ा संगतता के लिए इस परम नाम के उपनाम के रूप में भी विचार करना चाहिए।

  • javax.faces.FACELETS_BUFFER_SIZE - जब ResponseWriter उत्पन्न होता है बफर आकार प्रतिक्रिया पर स्थापित करने के लिए। डिफ़ॉल्ट रूप से मान -1 है, जो प्रतिक्रिया पर बफर आकार निर्दिष्ट नहीं करेगा। यदि आप उत्पन्न होने पर प्रतिक्रिया को आंशिक रूप से प्रस्तुत नहीं किया जाता है, तो यह बढ़ाया जाना चाहिए। रनटाइम को facelets.BUFFER_SIZE परम नाम को इस पैरा नाम के उपनाम के रूप में भी मौजूदा फेसलेट टैग लाइब्रेरीज़ के साथ पिछड़ा संगतता के लिए विचार करना चाहिए।

  • javax.faces.DECORATORS - एक अर्धविराम (;) प्रकार javax.faces.view.facelets.TagDecorator के वर्ग नामों की सूची delimitted, नो-तर्क निर्माता के साथ। ये सज्जाकार लोड होगा जब एक Facelets VDL देखने के लिए पहले अनुरोध पेज compilation.The क्रम के लिए ViewHandler हिट भी मौजूदा facelets टैग पुस्तकालयों के साथ पीछे की ओर संगतता के लिए इस परम नाम को उपनाम के रूप में facelets.DECORATORS परम नाम पर विचार करना चाहिए।

  • javax.faces.FACELETS_REFRESH_PERIOD - जब एक पृष्ठ का अनुरोध किया जाता है, सेकंड में क्या अंतराल में परिवर्तन के लिए संकलक जांच होनी चाहिए। यदि आप पृष्ठ संकलित होने के बाद संकलक को परिवर्तनों की जांच नहीं करना चाहते हैं, तो का मान -1 का मान लें। कम रिफ्रेश अवधि निर्धारित करना विकास के दौरान चलने वाले एप्लिकेशन में पृष्ठों को संपादित करने में सक्षम होने के दौरान सहायता करता है। रनटाइम को facelets.REFRESH_PERIOD परम नाम को पर मौजूदा उपनाम टैग लाइब्रेरीज़ के साथ पिछड़ा संगतता के लिए पैरा नाम पर भी उपनाम के रूप में विचार करना चाहिए।

  • javax.faces.FACELETS_RESOURCE_RESOLVER - इस परम सेट है, तो क्रम एक एक जावा वर्ग कि javax.faces.view.facelets.ResourceResolver प्रदान करता है और एक शून्य तर्क सार्वजनिक निर्माता या एक एक तर्क सार्वजनिक निर्माता जहां प्रकार है की पूरी तरह से योग्य classname के रूप में अपने मूल्य की व्याख्या करना चाहिए तर्क का ResourceResolver है। यदि यह पैरा सेट किया गया है और इसका मान उन आवश्यकताओं के अनुरूप नहीं है, तो रनटाइम संदेश लॉग और जारी रखना चाहिए। यदि यह इन आवश्यकताओं के अनुरूप है और इसमें एक-तर्क कन्स्ट्रक्टर है, तो डिफ़ॉल्ट ResourceResolver कन्स्ट्रक्टर को पास किया जाना चाहिए। यदि इसमें शून्य तर्क कन्स्ट्रक्टर है तो इसे सीधे बुलाया जाता है। किसी भी मामले में, नया ResourceResolver पुराने को बदल देता है। रनटाइम को facelets.RESOURCE_RESOLVER परम नाम को मौजूदा फेसलेट टैग लाइब्रेरीज़ के साथ पिछड़ा संगतता के लिए इस पैरा नाम के उपनाम के रूप में भी मानना ​​चाहिए।

  • javax.faces.FACELETS_SKIP_COMMENTS - इस परम सेट किया गया है, और इसके मूल्य रिटर्न true के String प्रतिनिधित्व पर toLowerCase().equals("true") बुला रहे हैं, तो क्रम सुनिश्चित करना चाहिए कि Facelets स्रोत पेज में किसी भी एक्सएमएल टिप्पणियाँ ग्राहक को नहीं दिया जाता है।रनटाइम को भी facelets.SKIP_COMMENTS परम नाम को मौजूदा फेसलेट टैग लाइब्रेरीज़ के साथ पीछे की संगतता के लिए इस परम नाम के उपनाम के रूप में मानना ​​चाहिए।

  • javax.faces.FACELETS_SUFFIX - वेब एप्लिकेशन को फेसलेट आधारित जेएसएफ सामग्री वाले एक्सएचटीएमएल पृष्ठों के लिए वैकल्पिक प्रत्यय को परिभाषित करने दें। पूर्ण विनिर्देश के लिए प्रतीकात्मक स्थिर ViewHandler.FACELETS_SUFFIX_PARAM_NAME के लिए javadocs देखें।

  • javax.faces.FACELETS_VIEW_MAPPINGS - इस परम सेट है, तो क्रम अर्धविराम के रूप में यह व्याख्या करना होगा (;) अलग तार कि रूप Facelets का उपयोग कर व्याख्या की जानी चाहिए जबरन आवेदन में है कि कुछ पन्नों घोषित करने के लिए प्रयोग किया जाता है की सूची, उनके विस्तार के बावजूद। रनटाइम को facelets.VIEW_MAPPINGS परम पैरामीटर अनुप्रयोगों के साथ पिछड़ा संगतता के लिए इस परम नाम के उपनाम के रूप में परम नाम पर भी विचार करना चाहिए। पूर्ण विनिर्देश के लिए प्रतीकात्मक स्थिर ViewHandler.FACELETS_VIEW_MAPPINGS_PARAM_NAME के लिए javadocs देखें।

  • javax.faces.FULL_STATE_SAVING_VIEW_IDS - क्रम दृश्य आईडी की एक अल्पविराम पृथक सूची, जिनमें से प्रत्येक अपने राज्य होना आवश्यक है के रूप में इस पैरामीटर का मान की व्याख्या करना होगा राज्य बचत तंत्र JSF 1.2 में निर्दिष्ट का उपयोग कर बचा लिया।

  • javax.faces.INTERPRET_EMPTY_STRING_SUBMITTED_VALUES_AS_NULL - इस परम सेट है, तो और अपने मूल्य के String प्रतिनिधित्व पर toLowerCase().equals("true") बुला रिटर्न true, UIInput.validate() के किसी भी कार्यान्वयन निम्नलिखित अतिरिक्त कार्रवाई करनी चाहिए। तो javax.faces.INTERPRET_EMPTY_STRING_SUBMITTED_VALUES_AS_NULL संदर्भ पैरामीटर मान true (अनदेखी मामले), और UIInput.getSubmittedValue() रिटर्न एक शून्य लंबाई String कॉल UIInput.setSubmittedValue(null) और

  • javax.faces.LIFECYCLE_ID वर्तमान प्रस्तुत मूल्य के रूप में अशक्त का उपयोग कर प्रसंस्करण जारी रखने के लिए - Lifecycle उदाहरण के जीवनचक्र पहचानकर्ता इस वेब एप्लिकेशन के लिए जेएसएफ अनुरोध करते समय प्रयुक्त होने के लिए। यदि निर्दिष्ट नहीं है, तो जेएसएफ डिफ़ॉल्ट उदाहरण, LifecycleFactory.DEFAULT_LIFECYCLE द्वारा पहचाना गया, इसका उपयोग किया जाना चाहिए।

  • javax.faces.PARTIAL_STATE_SAVING --The ServletContext init पैरामीटर के क्रम द्वारा परामर्श का निर्धारण करता है, तो आंशिक राज्य बचत तंत्र इस्तेमाल किया जाना चाहिए। यदि अपरिभाषित है, तो रनटाइम को एप्लिकेशन के संस्करण स्तर को निर्धारित करना होगा।

    • 1.2 और उसके बाद के संस्करणों के संस्करण के लिए, रनटाइम आंशिक राज्य बचत तंत्र का उपयोग नहीं करना चाहिए।
    • 2.0 और बाद वाले संस्करणों के संस्करणों के लिए, रनटाइम आंशिक राज्य बचत तंत्र का उपयोग करना चाहिए।

    इस पैरामीटर परिभाषित किया गया है, और आवेदन 1.2 पर और के तहत संस्करणीकृत है, तो क्रम आंशिक राज्य बचत तंत्र का उपयोग नहीं करना चाहिए। अन्यथा, यदि यह पैरा परिभाषित किया गया है, और toLowerCase().equals("true") को String पर अपने मूल्य रिटर्न का प्रतिनिधित्व true का प्रतिनिधित्व करता है, तो रनटाइम आंशिक स्थिति तंत्र का उपयोग करना चाहिए। अन्यथा आंशिक स्थिति बचत तंत्र का उपयोग नहीं किया जाना चाहिए।

  • javax.faces.PROJECT_STAGE - एक मानव पठनीय स्ट्रिंग का वर्णन करता है कि यह विशेष जेएसएफ एप्लिकेशन सॉफ़्टवेयर विकास जीवन चक्र में कहां है। वैध मान "Development", "UnitTest", "SystemTest", या "Production" वर्ग javax.faces.application.ProjectStage के enum स्थिरांक के अनुरूप हैं। जेएनडीआई के माध्यम से इस मूल्य को सेट करना भी संभव है। Application.getProjectStage() के लिए javadocs देखें।

  • javax.faces.STATE_SAVING_METHOD - वह स्थान जहां राज्य की जानकारी सहेजी जाती है। मान्य मान "server" (आमतौर पर HttpSession में सहेजे गए) और "client" (आमतौर पर बाद के फॉर्म सबमिट में एक छिपे हुए फ़ील्ड के रूप में सहेजे गए)। यदि निर्दिष्ट नहीं है, तो डिफ़ॉल्ट मान "server" का उपयोग किया जाना चाहिए।

  • javax.faces.VALIDATE_EMPTY_FIELDS - इस परम सेट किया गया है, और इसके मूल्य रिटर्न true, सभी प्रस्तुत क्षेत्रों सत्यापित किया जाएगा, के एक String प्रतिनिधित्व पर toLowerCase().equals("true") बुला हैं। मॉडल सत्यापनकर्ता को यह तय करना आवश्यक है कि वर्तमान अनुप्रयोग में स्वीकार्य या खाली मान स्वीकार्य हैं या नहीं। यदि मान false है, तो मान्य या खाली मान मान्यताओं को पास नहीं किए जाएंगे। यदि मान स्ट्रिंग "auto" है, तो रनटाइम को यह जांचना चाहिए कि क्या वर्तमान वातावरण में JSR-303 बीन्स प्रमाणीकरण मौजूद है या नहीं। यदि ऐसा है, तो रनटाइम आगे बढ़ना चाहिए जैसे कि मान "true" निर्दिष्ट किया गया था। यदि जेएसआर -303 बीन्स प्रमाणीकरण वर्तमान वातावरण में मौजूद नहीं है, तो रनटाइम सबसे अधिक आगे बढ़ता है जैसे कि मान "false" निर्दिष्ट किया गया था। यदि परम सेट नहीं है, तो सिस्टम को व्यवहार करना चाहिए जैसे कि param "auto" मान के साथ सेट किया गया था।

  • javax.faces.validator.DISABLE_DEFAULT_BEAN_VALIDATOR - इस परम सेट कर दिया जाता है, और बुला toLowerCase().equals("true") अपने मूल्य के String प्रतिनिधित्व पर रिटर्न true हैं, क्रम नहीं स्वचालित रूप से सत्यापनकर्ता-आईडी के साथ सत्यापनकर्ता प्रतीकात्मक निरंतर के मूल्य के बराबर जोड़ना होगा डिफ़ॉल्ट सत्यापनकर्ताओं की सूची में javax.faces.validator.VALIDATOR_ID। इस पैरामीटर को सत्य पर सेट करना में प्रत्येक दृश्य में प्रत्येक इनपुट घटक के लिए बीन सत्यापन की स्वचालित स्थापना को अक्षम करने का प्रभाव है, हालांकि मैन्युअल स्थापना अभी भी संभव है।

JSF कार्यान्वयन करने के लिए अतिरिक्त कॉन्फ़िगरेशन पैरामीटर, साथ ही अतिरिक्त तंत्र का समर्थन करने के JSF कार्यान्वयन कस्टमाइज़ चुन सकते हैं; हालांकि, इन सुविधाओं पर निर्भर अनुप्रयोग अन्य जेएसएफ कार्यान्वयन के लिए पोर्टेबल नहीं होंगे।

जैसा कि आप अंतिम पैराग्राफ में पढ़ सकते हैं, जेएसएफ कार्यान्वयन में संदर्भ पैरामीटर का अपना सेट भी हो सकता है। Mojarra के लिए जो com.sun.faces. से शुरू हो रहे हैं जो इस ब्लॉग पर सूचीबद्ध हैं: What Mojarra context parameters are available? माइफेस के लिए जो org.apache.myfaces. से शुरू होते हैं जो अपनी साइट पर भी सूचीबद्ध हैं: MyFaces documentation - Web Context Parameters

+0

मोजाररा लिंक टूटा हुआ है। यहां मोजाररा को कवर करने वाले दो लिंक दिए गए हैं: http://www-01.ibm.com/support/knowledgecenter/SSAW57_8.0.0/com.ibm.websphere.nd.doc/info/ae/ae/rweb_jsfengine.html, http://docs.jboss.org/jbossas/6/JSF_Guide/en-US/html/jsf.reference.html –

+2

@StephanRauh: मैंने इसे अपने ब्लॉग पर माइग्रेट किया: http://balusc.omnifaces.org/2015/09/what -mojarra-संदर्भ मानकों-are.html – BalusC

संबंधित मुद्दे