Configuration du client JAX-RS 2.0

Pour Java API for XML RESTful Web Services 2.0, vous pouvez configurer le client afin qu'il puisse accéder aux noeuds finaux REST. JAX-RS 2.0 introduit une nouvelle API client standardisée qui vous permet d'envoyer des demandes HTTP sur vos services Web RESTful éloignés.

Pourquoi et quand exécuter cette tâche

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

Procédure

Créez un client JAX-RS 2.0 et envoyez une 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();        
      }   
Pour plus d'informations sur le traitement asynchrone dans l'API client, voir Traitement asynchrone ou le chapitre 8 du document JSR 339: JAX-RS 2.0: The Java API for RESTful Web Services (la "Spécification").

Que faire ensuite

  • Utilisez la propriété client com.ibm.ws.jaxrs.client.connection.timeout et la propriété client com.ibm.ws.jaxrs.client.receive.timeout pour définir les valeurs de délai.
    • com.ibm.ws.jaxrs.client.connection.timeout
      javax.ws.rs.client.ClientBuilder cb = ClientBuilder.newBuilder();
      cb.property("com.ibm.ws.jaxrs.client.connection.timeout", "1000"); 
      Client c = cb.build();
    • com.ibm.ws.jaxrs.client.receive.timeout
      javax.ws.rs.client.ClientBuilder cb = ClientBuilder.newBuilder();
      cb.property("com.ibm.ws.jaxrs.client.receive.timeout", "1000"); 
      Client c = cb.build();
    Conseil : La valeur de la propriété de délai est exprimée en milliseconde, et le type doit être long ou intégral. 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.receive.timeout côté client JAX-RS n'est pas valide. La valeur par défaut 30000 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 : Le type de la valeur de port de serveur proxy doit être intégral. 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}
  • Configuration du client JAX-RS 2.0 pour la validation des informations relatives à l'authentification à l'aide d'un jeton LTPA
  • Sécurisation du client JAX-RS 2.0 à l'aide de SSL.
  • Utilisez la propriété client com.ibm.ws.jaxrs.client.disableCNCheck pour désactiver la vérification de nom usuel.
    ClientBuilder cb = ClientBuilder.newBuilder();
    cb.property("com.ibm.ws.jaxrs.client.disableCNCheck", true);

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



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_jaxrs2
Nom du fichier : twbs_jaxrs2.0_client.html