Panoramica di tutti i nomi parametro context web.xml JSF legati e valori

Question

Ci sono diversi JavaServer Faces <context-param> in web.xml: facelets.REFRESH_PERIOD, facelets.DEVELOPMENT, facelets.SKIP_COMMENTS ecc Dove posso trovare un elenco completo di tutti quei params?

Answer 1

Prima di tutto, quelli che iniziano con facelets. non sono parametri di contesto JSF, ma parametri di contesto Facelets 1.x. In precedenza, durante l'era di JSF 1.x, Facelets non era integrato come parte di JSF. Tuttavia, dal momento che JSF 2.0, Facelets è integrato come parte di JSF, sostituendo JSP legacy come tecnologia di visualizzazione predefinita e gran parte dei parametri di contesto di Facelets 1.x sono stati rimappati in parametri di contesto JSF 2.x.

I nomi dei parametri di contesto JSF reali iniziano con javax.faces.. Sono elencati nel capitolo 11.1.3 di JSF specification. Ecco un estratto della rilevanza dalle specifiche JSF 2.0:

11.1.3 Parametri di configurazione dell'applicazione contenitori

Servlet supportano i parametri di configurazione di applicazioni che possono essere personalizzate includendo <context-param> elementi nel descrittore di distribuzione dell'applicazione web. Tutte le implementazioni JSF sono tenuti a sostenere i seguenti nomi dei parametri di configurazione dell'applicazione:

• javax.faces.CONFIG_FILES - elenco di percorsi di risorse al contesto relativo in base al quale l'implementazione JSF andrà a cercare le risorse di configurazione dell'applicazione (vedere la sezione 11.4 delimitato da virgole. 4 "Application Resource Format"), prima di caricare una risorsa di configurazione denominata "/WEB-INF/faces-config.xml" (se esiste una risorsa di questo tipo). Se "/WEB-INF/faces-config.xml" è presente nell'elenco, deve essere ignorato.

• javax.faces.DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SYSTEM_TIMEZONE - Se questo parametro è impostato, e chiamando toLowerCase().equals("true") su un String rappresentanza dei suoi rendimenti valore true, Application.createConverter() devono garantire che il valore predefinito per il fuso orario di tutte le istanze javax.faces.convert.DateTimeConverter deve essere uguale TimeZone.getDefault() invece di "GMT".

• javax.faces.DEFAULT_SUFFIX - Consente all'applicazione Web di definire un suffisso alternativo per le pagine JSP contenente il contenuto JSF. Vedi javadocs per la costante simbolica ViewHandler.DEFAULT_SUFFIX_PARAM_NAME per la specifica completa.

• javax.faces.DISABLE_FACELET_JSF_VIEWHANDLER - Se questo parametro è impostato, e chiamando toLowerCase().equals("true") su un String rappresentazione del suo valore restituisce true, il default ViewHandler deve comportarsi come specificato nella sua ultima versione 1.2 del presente disciplinare. Qualsiasi comportamento specificato in Sezione 7.5 "ViewHandler" e implementato nel valore predefinito ViewHandler relativo alla gestione delle richieste per le pagine create nella lingua dei volti vista JavaServer non deve essere eseguito dal runtime.

• javax.faces.FACELETS_LIBRARIES - Se questo parametro è impostato, il runtime deve interpretare come un punto e virgola (;) elenco separato dei percorsi, che inizia con “/” (senza le virgolette).Il runtime deve interpretare ogni voce nell'elenco come un percorso relativo alla root dell'applicazione Web e interpretare il file trovato in quel percorso come una libreria di tag facelet, conforme a lo schema dichiarato nella Sezione 1.1 "Definizione dello schema XML per la risorsa di configurazione dell'applicazione file "ed esporre i tag in esso contenuti in base alla Sezione 10.3.2" Meccanismo Libreria Tag Facelet ". Il runtime deve considerare anche il nome del parametrofacelets.LIBRARIES come alias di questo nome param per la compatibilità all'indietro con le librerie di tag facelets esistenti .

• javax.faces.FACELETS_BUFFER_SIZE - La dimensione del buffer da impostare sulla risposta quando viene generato lo ResponseWriter . Di default il valore è -1, che non assegnerà una dimensione del buffer alla risposta. Questo valore deve essere aumentato se si sta utilizzando la modalità di sviluppo per garantire che la risposta non sia parzialmente visualizzata quando viene generato un errore . Il runtime deve considerare anche il nome del parametro facelets.BUFFER_SIZE come alias al nome di questo parametro per la compatibilità all'indietro con le librerie di tag facelets esistenti.

• javax.faces.DECORATORS - Un punto e virgola (;) elenco dei nomi di classe di tipo javax.faces.view.facelets.TagDecorator delimitted, con un costruttore senza argomenti. Questi decoratori saranno caricati quando la prima richiesta di una vista VDL Facelets raggiunge ViewHandler per la compilazione della pagina. Il runtime deve anche considerare il nome del parametro facelets.DECORATORS come alias a questo nome param per la compatibilità all'indietro con le librerie di tag facelets esistenti.

• javax.faces.FACELETS_REFRESH_PERIOD - Quando viene richiesta una pagina, quale intervallo in secondi occorre che il compilatore controlli le modifiche. Se non si desidera che il compilatore verifichi le modifiche dopo aver compilato la pagina, utilizzare un valore di -1. L'impostazione di un periodo di aggiornamento basso consente di modificare le pagine in un'applicazione in esecuzione. Il runtime deve anche considerare il nome del parametro facelets.REFRESH_PERIOD come alias al nome del parametro per la compatibilità all'indietro con le librerie di tag facelets esistenti.

• javax.faces.FACELETS_RESOURCE_RESOLVER - Se questo parametro è impostato, il runtime deve interpretare il suo valore come nome classe completo di una classe Java che estende javax.faces.view.facelets.ResourceResolver e ha un costruttore pubblico argomento zero o un un argomento costruttore pubblico in cui il tipo l'argomento è ResourceResolver. Se questo parametro è impostato e il suo valore non è conforme a tali requisiti, il runtime deve registrare un messaggio e continuare. Se è conforme a questi requisiti e ha un costruttore con un argomento, il valore predefinito ResourceResolver deve essere passato al costruttore. Se ha un costruttore di argomenti zero viene invocato direttamente. In entrambi i casi, il nuovo ResourceResolver sostituisce il precedente. Il runtime deve considerare anche il nome del parametro facelets.RESOURCE_RESOLVERfacelets.RESOURCE_RESOLVER come alias di questo nome param per la compatibilità all'indietro con le librerie di tag facelets esistenti .

• javax.faces.FACELETS_SKIP_COMMENTS - Se questo parametro è impostato, e chiamando toLowerCase().equals("true") su un String rappresentanza dei suoi rendimenti valore true, il runtime deve garantire che eventuali commenti XML nella pagina di origine Facelets non vengono consegnati al cliente.Il runtime deve anche considerare il nome del parametro facelets.SKIP_COMMENTS come alias di questo nome param per la compatibilità all'indietro con le librerie di tag facelets esistenti.

• javax.faces.FACELETS_SUFFIX - Lasciare che l'applicazione web per definire un suffisso alternativo per pagine XHTML basate facelet con contenuti JSF. Vedi javadocs per la costante simbolica ViewHandler.FACELETS_SUFFIX_PARAM_NAME per la specifica completa.

• javax.faces.FACELETS_VIEW_MAPPINGS - Se questo parametro è impostato, il runtime deve interpretare come una virgola (;) lista di stringhe che viene utilizzato per dichiarare la forza che alcune pagine dell'applicazione deve essere interpretato nel usare Facelets separati, indipendentemente dalla loro estensione. Il runtime deve considerare il nome del parametro come un alias per questo nome param per la compatibilità all'indietro con le applicazioni facelet esistenti. Vedere i javadocs per la costante simbolica ViewHandler.FACELETS_VIEW_MAPPINGS_PARAM_NAME per la specifica completa.

• javax.faces.FULL_STATE_SAVING_VIEW_IDS - Il runtime deve interpretare il valore di questo parametro come elenco separato da virgole di ID vista, ciascuno dei quali deve avere il loro stato salvato utilizzando lo stato di risparmio meccanismo specificato in JSF 1.2.

• javax.faces.INTERPRET_EMPTY_STRING_SUBMITTED_VALUES_AS_NULL - Se questo parametro è impostato, e chiamando toLowerCase().equals("true") su un String rappresentazione del suo valore restituisce true, qualsiasi attuazione UIInput.validate() deve prendere le seguenti azioni supplementari. Se il valore del parametro javax.faces.INTERPRET_EMPTY_STRING_SUBMITTED_VALUES_AS_NULL contesto è true (caso ignorando), e UIInput.getSubmittedValue() restituisce una lunghezza zero String chiamata UIInput.setSubmittedValue(null) e proseguire l'elaborazione usare null come valore inviato corrente

• javax.faces.LIFECYCLE_ID - identificatore del ciclo di vita dell'istanza Lifecycle da utilizzare durante l'elaborazione delle richieste JSF per questa applicazione Web. Se non specificato, l'istanza predefinita JSF, identificata da LifecycleFactory.DEFAULT_LIFECYCLE, deve essere utilizzata.

• javax.faces.PARTIAL_STATE_SAVING --Il ServletContext parametro init consultato dal runtime per determinare se deve essere usato allo stato parziale meccanismo risparmio. Se non definito, il runtime deve determinare il livello di versione dell'applicazione.

  • Per le applicazioni con versione 1.2 o inferiore, il runtime non deve utilizzare il meccanismo di salvataggio parziale dello stato.
  • Per le applicazioni con versione 2.0 o superiore, il runtime deve utilizzare il meccanismo di salvataggio parziale dello stato.

  Se questo parametro è definito, e l'applicazione è di versione a 1,2 e sotto, il runtime non deve utilizzare il meccanismo di risparmio stato parziale. Altrimenti, se questo parametro è definito e chiamando toLowerCase().equals("true") su una rappresentazione String restituisce il valore true, il runtime deve utilizzare il meccanismo dello stato parziale. In caso contrario, non è possibile utilizzare il meccanismo di salvataggio dello stato parziale .

• javax.faces.PROJECT_STAGE - Una stringa leggibile da umani che descrive dove questa particolare applicazione JSF è in il ciclo di vita dello sviluppo del software. I valori validi sono "Development", "UnitTest", "SystemTest" o "Production", corrispondenti alle costanti di enumerazione della classe javax.faces.application.ProjectStage. È anche possibile impostare questo valore tramite JNDI. Vedi il javadocs per Application.getProjectStage().

• javax.faces.STATE_SAVING_METHOD - La posizione in cui vengono salvate le informazioni di stato. I valori validi sono “server” (tipicamente salvati in HttpSession) e “client” (in genere salvati come un campo nascosto nella forma successiva submit). Se non specificato, deve essere utilizzato il valore predefinito "server".

• javax.faces.VALIDATE_EMPTY_FIELDS - Se questo parametro è impostato, e chiamando toLowerCase().equals("true") su un String rappresentanza dei suoi rendimenti valore true, tutti i campi presentati saranno convalidati . Questo è necessario per consentire al validatore del modello di decidere se i valori nulli o vuoti sono consentiti nell'applicazione corrente. Se il valore è false, i valori nulli o vuoti non saranno passati ai validatori. Se il valore è la stringa "auto", il runtime deve verificare se la convalida dei bean JSR-303 è presente nell'ambiente corrente . In tal caso, il runtime deve procedere come se fosse stato specificato il valore "true". Se la convalida dei bean JSR-303 non è presente nell'ambiente corrente, il runtime continua come se fosse stato specificato il valore "false". Se il parametro non è impostato, il sistema deve comportarsi come se il parametro fosse impostato con il valore "auto".

• javax.faces.validator.DISABLE_DEFAULT_BEAN_VALIDATOR - Se questo parametro è impostato, e chiamando toLowerCase().equals("true") su un String rappresentazione del suo valore restituisce true, il runtime non deve aggiungere automaticamente il validatore con validatore-id uguale al valore della costante simbolica javax.faces.validator.VALIDATOR_ID all'elenco dei validatori predefiniti. Impostando questo parametro su true, avrà l'effetto di disabilitare l'installazione automatica di convalida del bean su ogni componente di input in ogni vista in dell'applicazione, sebbene l'installazione manuale sia ancora possibile.

implementazioni JSF possono decidere di supportare ulteriori parametri di configurazione, nonché meccanismi aggiuntivi per personalizzare l'implementazione JSF; tuttavia, le applicazioni che si basano su queste strutture non saranno trasferibili ad altre implementazioni JSF .

Come si può leggere nell'ultimo paragrafo, le implementazioni JSF possono anche avere il proprio set di parametri di contesto. Per Mojarra che sono quelli che iniziano con com.sun.faces. che sono elencati su questo blog: What Mojarra context parameters are available? Per MyFaces che sono quelli che iniziano con org.apache.myfaces. che sono elencati anche sul loro sito: MyFaces documentation - Web Context Parameters.