Les autres propriétés suivantes sont disponibles pour un serveur virtuel.
Indique le nombre de secondes au-delà duquel l’enregistrement de connexion unique d’un utilisateur peut être supprimé si aucune activité cliente n’est reçue. Étant donné que la connexion unique s’applique à plusieurs applications du même serveur virtuel, le fait d’accéder à une application maintient l’enregistrement de connexion unique actif.
La valeur par défaut est de 300 secondes (5 minutes). Des valeurs supérieures offrent une persistance de connexion unique supérieure au détriment d’une plus grande consommation de mémoire sur le serveur.
Indique le nombre de secondes entre les purges des enregistrements de connexion unique expirés.
La valeur par défaut est 60.
Définit l’attribut Secure de tous les cookies JSESSIONIDSSO associés aux applications Web déployées sur ce serveur virtuel. Cette propriété s’applique uniquement si la fonction de connexion unique est activée. Les valeurs autorisées sont :
Définit Secure sur true.
Définit Secure sur false.
Le cookie JSESSIONIDSSO hérite du paramètre Secure de la première session participant à la SSO.
Pour définir l’attribut Secure d’un cookie JSESSIONID, utilisez la propriété cookie-properties de cookieSecure dans le fichier Sun-web.xml. Pour de plus amples détails, reportez-vous à la section cookie-properties du Oracle GlassFish Server 3.1 Application Deployment Guide.
Spécifie une liste séparée par des virgules des directives de réponse Cache-Control. Pour obtenir une liste des directives valides, reportez-vous à la Section 14.9 du document à l’adresse http://www.ietf.org/rfc/rfc2616.txt .
Indique la taille (en octets) du tampon dans lequel sont enregistrés les appels du journal d’accès. Si la valeur est inférieure à 5120, un message d’avertissement est émis et la valeur est définie sur 5120. La valeur par défaut est 32768.
Spécifie le délai (en secondes) avant que le journal ne soit écrit sur le disque. Le journal d’accès est écrit lorsque le tampon est saturé ou que l’intervalle expire. Si la valeur est égale à zéro, le tampon est toujours écrit, même s’il n’est pas plein. Autrement dit, chaque fois que l’utilisateur accède au serveur, le message journal est directement enregistré dans le fichier. La valeur par défaut est 300.
Spécifie une liste séparée par des virgules de modèles d’expressions régulières auxquels l’adresse IP du client distant est comparée. Si cette propriété est spécifiée, l’adresse distante doit correspondre pour que cette requête soit acceptée. Si cette propriété n’est pas spécifiée, toutes les requêtes sont acceptées à moins que l’adresse distante ne corresponde à un modèle denyRemoteAddress .
Spécifie une liste séparée par des virgules de modèles d’expressions régulières auxquels l’adresse IP du client distant est comparée. Si cette propriété est spécifiée, l’adresse distante ne doit pas correspondre pour que cette requête soit acceptée. Si cette propriété n’est pas spécifiée, l’acceptation de la requête est régie uniquement par la propriété allowRemoteAddress.
Spécifie une liste séparée par des virgules de modèles d’expressions régulières auxquels le nom d’hôte du client distant (tel que renvoyé par [java.net.]Socket.getInetAddress().getHostName() ) est comparé. Si cette propriété est spécifiée, le nom d’hôte distant doit correspondre pour que cette requête soit acceptée. Si cette propriété n’est pas spécifiée, toutes les requêtes sont acceptées à moins que le nom d’hôte distant ne corresponde à un modèle denyRemoteHost .
Spécifie une liste séparée par des virgules de modèles d’expressions régulières auxquels le nom d’hôte du client distant (tel que renvoyé par [java.net.]Socket.getInetAddress().getHostName() ) est comparé. Si cette propriété est spécifiée, le nom d’hôte distant ne doit pas correspondre pour que cette requête soit acceptée. Si cette propriété n’est pas spécifiée, l’acceptation de la requête est régie uniquement par la propriété allowRemoteHost.
Définir cette propriété n’a aucun effet si l’accès au domaine de GlassFish Server s’effectue par l’intermédiaire d’un auditeur de réseau dont l’option Listener JK est activée.
Spécifie le nom d’un domaine d’authentification, qui remplace le domaine par défaut de l’instance du serveur pour les applications Web autonomes déployées sur ce serveur virtuel. Un domaine défini dans le fichier web.xml d’une application Web autonome remplace le domaine du serveur virtuel. Pour plus d’informations, reportez-vous à la rubrique Realms.
Définissez cette propriété sur false pour vous assurer que, pour toutes les applications Web sur ce serveur virtuel, les téléchargements de fichiers utilisant SSL fonctionnent correctement dans Internet Explorer.
Les applications Web individuelles peuvent remplacer ce paramètre en utilisant l’élément sun-web-app du fichier sun-web.xml. Pour de plus amples détails, reportez-vous à la section glassfish-web-app du Oracle GlassFish Server 3.1 Application Deployment Guide.
La valeur par défaut est true.
Spécifie une racine de document (docroot) alternative, où n est un entier positif qui permet la spécification de plus d’une racine. Les racines de document alternatives permettent aux applications Web de servir des requêtes pour certaines ressources en dehors de leur propre racine de document, selon que ces requêtes correspondent à un (ou plusieurs) des modèles URI des autres racines de document de l’application Web.
Si une requête correspond au modèle URI d’une racine de document alternative, elle est mappée à cette autre racine en ajoutant l’URI de requête (moins la racine contexte de l’application Web) à l’emplacement physique (répertoire) de la racine de document alternative. Si une requête correspond à plusieurs modèles URI, la racine de document alternative est déterminée en fonction de l’ordre de priorité suivant :
Correspondance exacte
Correspondance du chemin le plus long
Correspondance d’extension
Par exemple, les propriétés suivantes spécifient trois racines de document alternatives. Le modèle URI de la première racine de document alternative utilise une correspondance exacte, tandis que les modèles URI des deuxième et troisième racines de document alternatives utilisent des correspondances d’extension et de préfixe de chemin le plus long, respectivement.
<property name="alternatedocroot_1" value="from=/my.jpg dir=/srv/images/jpg"/> <property name="alternatedocroot_2" value="from=*.jpg dir=/srv/images/jpg"/> <property name="alternatedocroot_3" value="from=/jpg/* dir=/src/images"/>
La valeur de chaque racine de document alternative dispose de deux composants : le premier composant, from, spécifie le modèle URI de la racine de document alternative et le second composant, dir, spécifie l’emplacement physique (répertoire) de la racine de document alternative. Les espaces sont autorisés dans le composant dir.
Les applications Web individuelles peuvent remplacer ce paramètre en utilisant l’élément sun-web-app du fichier sun-web.xml. Pour de plus amples détails, reportez-vous à la section glassfish-web-app du Oracle GlassFish Server 3.1 Application Deployment Guide.
Spécifie l’emplacement, relatif à domain-dir, du fichier context.xml pour ce serveur virtuel, le cas échéant. Pour plus d’informations sur le fichier context.xml, consultez The Context Container.
Si la valeur est true (vrai), les ressources représentant des liens symboliques seront utilisées pour toutes les applications Web déployées sur ce serveur virtuel. Les applications Web individuelles peuvent remplacer ce paramètre en utilisant la propriété sun-web-app allowLinking du fichier sun-web.xml :
<sun-web-app> <property name="allowLinking" value="{true|false}"/> </sun-web-app>
Pour de plus amples détails, reportez-vous à la section glassfish-web-app du Oracle GlassFish Server 3.1 Application Deployment Guide.
La valeur par défaut est false.
Attention - Sur les systèmes Windows, définir cette propriété sur true a pour effet d’exposer le code source JSP.
Spécifie les mappages de la page d’erreur personnalisée pour le serveur virtuel, qui sont hérités par toutes les applications Web déployées sur ce serveur virtuel. Une application Web peut remplacer les mappages de la page d’erreur personnalisée dans son descripteur de déploiement web.xml. La valeur de chaque propriété send-error_ n a trois composants, qui peuvent être spécifiés dans n’importe quel ordre :
Le premier composant, code, spécifie le code d’état de réponse HTTP à trois chiffres pour lequel la page d’erreur personnalisée doit être renvoyée dans la réponse.
Le deuxième composant, path, spécifie le chemin du système de fichiers absolu ou relatif de la page d’erreur personnalisée. Un chemin de système de fichiers relatif est interprété comme relatif au répertoire domain-dir/config.
Le troisième composant, reason, est facultatif et spécifie le texte de la chaîne de raison (comme Unauthorized ou Forbidden) à renvoyer.
Exemple :
<property name="send-error_1" value="code=401 path=/myhost/401.html reason=MY-401-REASON"/>
Cet exemple de définition de propriété entraîne le renvoi du contenu de /myhost/401.html avec les réponses 401, avec la ligne de réponse suivante :
HTTP/1.1 401 MY-401-REASON
Spécifie qu’une requête pour une ancienne URL est traitée comme une requête pour une nouvelle URL. Ces propriétés sont héritées par toutes les applications Web déployées sur le serveur virtuel. La valeur de chaque propriété redirect_n a deux composants, qui peuvent être spécifiés dans n’importe quel ordre :
Le premier composant, from, spécifie le préfixe de l’URI requis à associer.
Le second composant, url-prefix, spécifie le nouveau préfixe de l’URL à retourner au client. Le préfixe from est simplement remplacé par ce préfixe d’URL.
Exemple :
<property name="redirect_1" value="from=/dummy url-prefix=http://etude"/>
Spécifie le nom de classe qualifié complet d’une valve personnalisée, où n est un entier positif qui permet d’en spécifier plusieurs. La classe de valve doit implémenter l’interface org.apache.catalina.Valve à partir de Tomcat ou de versions précédentes de GlassFish Server ou l’interface org.glassfish.web.valve.GlassFishValve à partir de la version GlassFish Server actuelle. Exemple :
<property name="valve_1" value="org.glassfish.extension.Valve"/>
Vous pouvez définir cette propriété pour une application Web spécifique. Pour de plus amples détails, reportez-vous à la section glassfish-web-app du Oracle GlassFish Server 3.1 Application Deployment Guide.
Spécifie le nom de classe qualifié complet d’un module d’écoute Catalina personnalisé, où n est un entier positif qui permet d’en spécifier plusieurs. La classe du module d’écoute doit implémenter l’interface org.apache.catalina.ContainerListener ou org.apache.catalina.LifecycleListener . Par exemple :
<property name="listener_1" value="org.glassfish.extension.MyLifecycleListener"/>
Vous pouvez définir cette propriété pour une application Web spécifique. Pour de plus amples détails, reportez-vous à la section glassfish-web-app du Oracle GlassFish Server 3.1 Application Deployment Guide.
Spécifie le nom de classe complet d'une valve personnalisée produisant des pages d'erreur par défaut pour les applications sur ce serveur virtuel. Spécifiez une chaîne vide pour désactiver le mécanisme de page d'erreur par défaut pour ce serveur virtuel.