Java WebSocket 1.0

Cette fonction permet la prise en charge des applications WebSocket dans l'API Java pour la spécification WebSocket 1.0.

Activation de cette fonction

Pour activer la fonction Java WebSocket 1.0, ajoutez la déclaration d'élément suivante dans l'élément featureManager de votre fichier server.xml :
<feature>websocket-1.0</feature>

Versions de Java™ prises en charge

  • JavaSE-1.7
  • JavaSE-1.8

Développement d'une fonction qui dépend de cette fonction

Si vous développez une fonction qui dépend de la fonction Java WebSocket 1.0, incluez l'élément suivant dans l'en-tête Subsystem-Content du fichier manifeste de fonction pour votre nouvelle fonction :
com.ibm.websphere.appserver.websocket-1.0; type="osgi.subsystem.feature"

Fonctions que cette fonction active

Fonctions qui activent cette fonction

    Packages d'API standard fournis par cette fonction

    • javax.websocket
    • javax.websocket.server

    Eléments de configuration de la fonction

    Vous pouvez utiliser les éléments suivants dans votre fichier server.xml pour configurer la fonction Java WebSocket 1.0 :

    wsocOutbound
    Propriétés de configuration pour demandes de connexion WebSocket WAS sortant.
    Nom de l'attribut Type de données Valeur par défaut Description
    httpOptionsRef Référence à lélément {0} de niveau supérieur (chaîne). defaultHttpOptions Options HTTPprotocol pour WebSocket WAS sortant
    sslOptionsRef Référence à lélément {0} de niveau supérieur (chaîne).   Options de protocole SSL pour WebSocket WAS sortant
    tcpOptionsRef Référence à lélément {0} de niveau supérieur (chaîne). defaultTCPOptions Options de protocole TCP pour WebSocket WAS sortant
    wsocOutbound > httpOptions
    Description : Options HTTPprotocol pour WebSocket WAS sortant
    Obligatoire : false
    Type de données
    Nom de l'attribut Type de données Valeur par défaut Description
    keepAliveEnabled boolean true Active les connexions persistantes (HTTP keepalive). Si cette propriété est true, les connexions sont maintenues en vie et réutilisées par plusieurs demandes et réponses consécutives. Si la valeur est false, les connexions sont fermées une fois la réponse envoyée.
    maxKeepAliveRequests int

    Minimum : -1

    100 Nombre maximal de demandes admises sur une même connexion HTTP, lorsque les connexions persistantes sont activées. La valeur -1 correspond à un nombre illimité.
    persistTimeout Période avec une précision à la seconde près 30s Durée pendant laquelle un socket peut rester au repos entre deux demandes. Cette propriété s'applique uniquement si les connexions persistantes sont activées. Indiquez une valeur entière suivie d'une unité de temps, qui peut être heure (h), minute (m) ou seconde (s). Par exemple, pour 30 secondes, indiquez 30s. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1m30s correspond à 90 secondes.
    readTimeout Période avec une précision à la seconde près 60s Délai maximal, accordé à l'exécution d'une demande de lecture sur un socket une fois que la première lecture a eu lieu. Indiquez une valeur entière suivie d'une unité de temps, qui peut être heure (h), minute (m) ou seconde (s). Par exemple, pour 30 secondes, indiquez 30s. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1m30s correspond à 90 secondes.
    removeServerHeader boolean false Retire les informations d'implémentation de serveur des en-têtes HTTP et désactive également la page d'accueil par défaut du profil Liberty.
    writeTimeout Période avec une précision à la seconde près 60s Durée accordée à l'attente sur un socket de chaque partie des données de réponse à transmettre. Indiquez une valeur entière suivie d'une unité de temps, qui peut être heure (h), minute (m) ou seconde (s). Par exemple, pour 30 secondes, indiquez 30s. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1m30s correspond à 90 secondes.
    wsocOutbound > sslOptions
    Description : Options de protocole SSL pour WebSocket WAS sortant
    Obligatoire : false
    Type de données
    Nom de l'attribut Type de données Valeur par défaut Description
    sessionTimeout Période avec une précision à la seconde près 1d Délai d'attente avant qu'une demande de lecture ou d'écriture n'aboutisse sur un socket. Cette valeur est supplantée par les temporisations (timeouts) propres au protocole. Indiquez une valeur entière suivie d'une unité de temps, qui peut être heure (h), minute (m) ou seconde (s). Par exemple, pour 30 secondes, indiquez 30s. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1m30s correspond à 90 secondes.
    sslRef string   Répertoire de configuration SSL par défaut. La valeur par défaut est defaultSSLSettings.
    suppressHandshakeErrors boolean false Désactiver la consignation des erreurs d'établissement de liaison SSL. Ces erreurs peuvent se produire en mode de fonctionnement normal ; toutefois, ces messages peuvent être utiles lorsque SSL se comporte de manière inattendue.
    wsocOutbound > tcpOptions
    Description : Options de protocole TCP pour WebSocket WAS sortant
    Obligatoire : false
    Type de données
    Nom de l'attribut Type de données Valeur par défaut Description
    inactivityTimeout Période avec une précision à la milliseconde près 60s Délai d'attente avant qu'une demande de lecture ou d'écriture n'aboutisse sur un socket. Cette valeur est supplantée par les temporisations (timeouts) propres au protocole. Indiquez une valeur entière positive suivie d'une unité de temps, qui peut être heure (h), minute (m), seconde (s) ou milliseconde (ms). Par exemple, pour 500 millisecondes, indiquez 500ms. Vous pouvez inclure plusieurs valeurs dans une même entrée. Par exemple, 1s500ms correspond à 1 seconde et demie.
    soReuseAddr boolean true Permet une nouvelle liaison immédiate à un port sans écouteur actif.

    Icône indiquant le type de rubrique Rubrique de référence

    Dispositions pour les centres de documentation | Commentaires


    Icône d'horodatage Dernière mise à jour: Wednesday, 2 September 2015
    http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=rwlp_feature_websocket-1.0
    Nom du fichier : rwlp_feature_websocket-1.0.html