Référentiel Liberty[8.5.5.6 ou ultérieure]

Configuration du client JAX-RS 2.0

Concernant l'API Java pour XML poue XML RESTful Web Services 2.0, vous pouvez configurer le client afin qu'il accède aux noeuds finaux REST. JAX-RS 2.0 introduit une API client nouvelle et standardisée grâce à laquelle vous pouvez effectuer des demandes HTTP vers vos services Web RESTful distants.

Pourquoi et quand exécuter cette tâche

Une instance du Client est requise pour accéder à une ressource Web à l'aide de l'API client. L'instance par défaut du client peut être obtenue par l'appel de newClient ou build sur ClientBuilder.

Procédure

  1. Activez la fonction jaxrsClient-2.0 ou jaxrs-2.0 dans votre fichier server.xml :
    <featureManager>
        <feature>jaxrs-2.0</feature>// If you only need the JAX-RS 2.0 client feature, you can enable jaxrsClient-2.0 instead of  jaxrs-2.0 
    </featureManager>
  2. Créez un client JAX-RS 2.0 et envoyez la demande au serveur :
    javax.ws.rs.client.ClientBuilder cb = ClientBuilder.newBuilder();
    
    javax.ws.rs.client.Client c = cb.build();
    String res = null;
    
    try {
    	res = c.target("<Resource_URL>")
                 .path("<PATH>")
                 .request()
                 .get(String.class);
    	} catch (Exception e) {
          	res = "[Error]:" + e.toString();
          } finally {
                c.close();        
          }   
    For more information on async JAX-RS 2.0 client, voir Asynchronous processing.

Que faire ensuite

  • Utilisez la propriété client com.ibm.ws.jaxrs.client.timeout pour définir la valeur de délai d'attente.
    javax.ws.rs.client.ClientBuilder cb = ClientBuilder.newBuilder();
            cb.property("com.ibm.ws.jaxrs.client.timeout", "1000"); 
            Client c = cb.build();
    Conseil : La valeur de la propriété de délai d'attente est en millisecondes et le type doit être long ou int. Si le type de la valeur n'est pas valide, le message suivant s'affiche :
    CWWKW0700E: La valeur de délai d'attente {0} spécifiée dans la propriété com.ibm.ws.jaxrs.client.timeout côté client JAX-RS n'est pas valide. La valeur par défaut a été appliquée. {3}  
  • Utilisez les propriétés client suivantes pour la prise en charge du proxy client :
    ClientBuilder cb = ClientBuilder.newBuilder();
    cb.property("com.ibm.ws.jaxrs.client.proxy.host", "hostname");
    cb.property("com.ibm.ws.jaxrs.client.proxy.port", "8888";);
    cb.property("com.ibm.ws.jaxrs.client.proxy.type", "HTTP");
    
    Client c = cb.build();  
    • com.ibm.ws.jaxrs.client.proxy.host
    • com.ibm.ws.jaxrs.client.proxy.port
      Conseil : La valeur du port du serveur proxy doit être du type Int. La valeur par défaut est 80. Si le type de la valeur n'est pas valide, le message suivant s'affiche :
      CWWKW0701E: La valeur du port de serveur proxy {0} que
      vous avez spécifiée dans la propriété com.ibm.ws.jaxrs.client.proxy.port côté client JAX-RS n'est pas valide.. La valeur par défaut 80 a été appliquée. {3}
    • com.ibm.ws.jaxrs.client.proxy.type
      Conseil : La valeur du type de serveur proxy doit être HTTP ou SOCKS. La valeur par défaut est HTTP. Si le type du serveur proxy n'est pas valide, le message suivant s'affiche :
      CWWKW0702E: La valeur du type de serveur proxy {0} que vous avez spécifiée dans la propriété com.ibm.ws.jaxrs.client.proxy.type côte client JAX-RS n'est pas valide. La valeur par défaut HTTP a été appliquée. {3}
  • Utilisez la propriété client com.ibm.ws.jaxrs.client.ltpa.handler pour définir le cookie SSO et la valeur sur true.
    ClientBuilder cb = ClientBuilder.newBuilder();
            Client c = cb.build();
            c.property("com.ibm.ws.jaxrs.client.ltpa.handler", "true");
    Si vous voulez utiliser la fonctionnalité Secure Sockets Layer (SSL) dans JAX-RS 2.0, vous devez activer la fonction ssl-1.0 ou appSecurity-2.0. Pour la fonction de jeton LTPA, la fonction appSecurity-2.0 est nécessaire.
    Remarque : La fonction ssl-1.0 est une sous-fonction de la fonction appSecurity-2.0. Si vous activez la fonction jaxrsClient-2.0 et la fonction ssl-1.0, la fonction appSecurity-2.0 est activée automatiquement.
  • Utilisez la propriété client com.ibm.ws.jaxrs.client.ssl.config afin de définir l'ID référence SSL de server.xml.
    ClientBuilder cb = ClientBuilder.newBuilder();
            cb.property("com.ibm.ws.jaxrs.client.ssl.config", "mySSLRefId"); 
            Client c = cb.build();
    Remarque : La configuration dans server.xml est comme suit :
    <ssl id="mySSLRefId" keyStoreRef="clientKeyStore" trustStoreRef="clientTrustStore" />

Icône indiquant le type de rubrique Rubrique Tâche

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=twlp_jaxrs2.0_clientconfig
Nom du fichier : twlp_jaxrs2.0_clientconfig.html