java.lang.Object
- javax.faces.lifecycle.ClientWindow
- - javax.faces.lifecycle.ClientWindowWrapper

All Implemented Interfaces:: FacesWrapper<ClientWindow>

public abstract class ClientWindowWrapper
extends ClientWindow
implements FacesWrapper<ClientWindow>

Wrapper for ClientWindow

Since:: 2.2

Field Summary
- Fields inherited from class javax.faces.lifecycle.ClientWindow
  CLIENT_WINDOW_MODE_PARAM_NAME

Constructor Summary

Constructors
Constructor and Description

ClientWindowWrapper()

Retour à la première page de API Java Table des matières Haut

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`decode(FacesContext context)` The implementation is responsible for examining the incoming request and extracting the value that must be returned from the `ClientWindow.getId()` method.
`void`	`disableClientWindowRenderMode(FacesContext context)` Components that permit per-use disabling of the appending of the ClientWindow in generated URLs must call this method first before rendering those URLs.
`void`	`enableClientWindowRenderMode(FacesContext context)` Components that permit per-use disabling of the appending of the ClientWindow in generated URLs must call this method first after rendering those URLs.
`String`	`getId()` Return a String value that uniquely identifies this `ClientWindow` within the scope of the current session.
`Map<String,String>`	`getQueryURLParameters(FacesContext context)` This method will be called whenever a URL is generated by the runtime where client window related parameters need to be inserted into the URL.
`abstract ClientWindow`	`getWrapped()` A class that implements this interface uses this method to return an instance of the class being wrapped.
`boolean`	`isClientWindowRenderModeEnabled(FacesContext context)` Methods that append the ClientWindow to generated URLs must call this method to see if they are permitted to do so.

Retour à la première page de API Java Table des matières Haut

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ClientWindowWrapper
```
public ClientWindowWrapper()
```
- Method Detail
  - getWrapped
```
public abstract ClientWindow getWrapped()
```
    Description copied from interface: FacesWrapper
    
    A class that implements this interface uses this method to return an instance of the class being wrapped.
    
    Specified by:
    
    getWrapped in interface FacesWrapper<ClientWindow>
  - getId
```
public String getId()
```
    Description copied from class: ClientWindow
    
    Return a String value that uniquely identifies this ClientWindow within the scope of the current session. See ClientWindow.decode(javax.faces.context.FacesContext) for the specification of how to derive this value.
    
    Specified by:
    
    getId in class ClientWindow
  - getQueryURLParameters
```
public Map<String,String> getQueryURLParameters(FacesContext context)
```
    Description copied from class: ClientWindow
    
    This method will be called whenever a URL is generated by the runtime where client window related parameters need to be inserted into the URL. This guarantees custom ClientWindow implementations that they will have the opportunity to insert any additional client window specific information in any case where a URL is generated, such as the rendering of hyperlinks. The returned map must be immutable. The default implementation of this method returns the empty map.
    
    Specified by:
    
    getQueryURLParameters in class ClientWindow
    
    Parameters:
    
    context - the FacesContext for this request.
    
    Returns:
    
    null or a map of parameters to insert into the URL query string.
  - disableClientWindowRenderMode
```
public void disableClientWindowRenderMode(FacesContext context)
```
    Description copied from class: ClientWindow
    
    Components that permit per-use disabling of the appending of the ClientWindow in generated URLs must call this method first before rendering those URLs. The caller must call ClientWindow.enableClientWindowRenderMode(javax.faces.context.FacesContext) from a finally block after rendering the URL. If ClientWindow.CLIENT_WINDOW_MODE_PARAM_NAME is "url" without the quotes, all generated URLs that cause a GET request must append the ClientWindow by default. This is specified as a static method because callsites need to access it without having access to an actual ClientWindow instance.
    
    Overrides:
    
    disableClientWindowRenderMode in class ClientWindow
    
    Parameters:
    
    context - the FacesContext for this request.
  - enableClientWindowRenderMode
```
public void enableClientWindowRenderMode(FacesContext context)
```
    Description copied from class: ClientWindow
    
    Components that permit per-use disabling of the appending of the ClientWindow in generated URLs must call this method first after rendering those URLs. If ClientWindow.CLIENT_WINDOW_MODE_PARAM_NAME is "url" without the quotes, all generated URLs that cause a GET request must append the ClientWindow by default. This is specified as a static method because callsites need to access it without having access to an actual ClientWindow instance.
    
    Overrides:
    
    enableClientWindowRenderMode in class ClientWindow
    
    Parameters:
    
    context - the FacesContext for this request.
  - isClientWindowRenderModeEnabled
```
public boolean isClientWindowRenderModeEnabled(FacesContext context)
```
    Description copied from class: ClientWindow
    
    Methods that append the ClientWindow to generated URLs must call this method to see if they are permitted to do so. If ClientWindow.CLIENT_WINDOW_MODE_PARAM_NAME is "url" without the quotes, all generated URLs that cause a GET request must append the ClientWindow by default. This is specified as a static method because callsites need to access it without having access to an actual ClientWindow instance.
    
    Overrides:
    
    isClientWindowRenderModeEnabled in class ClientWindow
    
    Parameters:
    
    context - the FacesContext for this request.
  - decode
```
public void decode(FacesContext context)
```
    Description copied from class: ClientWindow
    
    The implementation is responsible for examining the incoming request and extracting the value that must be returned from the ClientWindow.getId() method. If ClientWindow.CLIENT_WINDOW_MODE_PARAM_NAME is "none" this method must not be invoked. If ClientWindow.CLIENT_WINDOW_MODE_PARAM_NAME is "url" the implementation must first look for a request parameter under the name given by the value of ResponseStateManager.CLIENT_WINDOW_PARAM. If no value is found, look for a request parameter under the name given by the value of ResponseStateManager.CLIENT_WINDOW_URL_PARAM. If no value is found, fabricate an id that uniquely identifies this ClientWindow within the scope of the current session. This value must be made available to return from the ClientWindow.getId() method. The value must be suitable for inclusion as a hidden field or query parameter. If a value is found, decrypt it using the key from the session and make it available for return from ClientWindow.getId().
    
    Specified by:
    
    decode in class ClientWindow
    
    Parameters:
    
    context - the FacesContext for this request.

Traduction non disponible

Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.

Version en cache

21/08/2025 15:09:17 Cette version de la page est en cache (à la date du 21/08/2025 15:09:17) afin d'accélérer le traitement.
Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la version plus récente de la page.

Document créé le 11/06/2005, dernière modification le 18/08/2025
Source du document imprimé : https://www.gaudry.be/java-api-javaee-rf-javax/faces/lifecycle/ClientWindowWrapper.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : https://docs.oracle.com, ClientWindowWrapper (Java(TM) EE 7 Specification APIs)

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Class ClientWindowWrapper

Field Summary

Fields inherited from class javax.faces.lifecycle.ClientWindow

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ClientWindowWrapper

Method Detail

getWrapped

getId

getQueryURLParameters

disableClientWindowRenderMode

enableClientWindowRenderMode

isClientWindowRenderModeEnabled

decode

Références