Implémentation d'un client à l'aide du client de services Web RESTful JAX-RS 2.0 non géré

WebSphere Application Server fournit un environnement d'exécution de client léger de services Web RESTful pour Java™ Platform, Standard Edition 8 (Java SE 8) permettant aux développeurs d'applications de créer des applications client JAX-RS rapidement et facilement. Le client léger Thin Client for JAX-RS avec WebSphere Application Server est un environnement client autonome Java SE 8 permettant d'exécuter des applications client de services Web JAX-RS non gérées, dans un environnement non WebSphere, pour appeler les services Web JAX-RS RESTful hébergés par le serveur d'applications.

Avant de commencer

Configurations prises en charge Configurations prises en charge: Le client léger Thin Client for JAX-RS avec WebSphere Application Server peut être utilisé comme environnement d'exécution client autonome dans un environnement purement Java SE. L'exécution du client léger Thin Client for JAX-RS dans des environnements WebSphere Application Server ou WebSphere Application Client n'est pas prise en charge. Dans cette version du serveur d'applications, d'autres environnements d'exécution de client léger fournis avec le serveur d'applications peuvent également résider dans CLASSPATH et coexister avec Thin Client for JAX-RS.sptcfg

Avant d'installer un environnement d'exécution client non géré JAX-RS, obtenez le fichier d'archive JAR (Java archive) de Thin Client for JAX-RS. Pour obtenir Thin Client for JAX-RS, installez WebSphere Application Server Version 9.0 version 8.0 ou le client d'application WebSphere Application Server Version 9.0. Le fichier de Thin Client for JAX-RS JAR, com.ibm.jaxrs2.0.thinclient_9.0.jar, se trouve dans le répertoire racine_serveur_app\runtimes.

Copiez le fichier de Thin Client for JAX-RS, com.ibm.jaxrs2.0.thinclient_9.0.jar, sur d'autres machines pour créer un environnement de client léger permettant les communications avec le produit. Les copies de Thin Client for JAX-RS sont sujettes aux mêmes termes et conditions que le contrat de licence du produit WebSphere dans lequel vous avez obtenu Thin Client for JAX-RS. Pour connaître la syntaxe correcte et d'autres limitations, consultez le contrat de licence.

Thin Client for JAX-RS s'exécute avec IBM® Software Development Kits (SDKs) versions 8.0 et supérieures. Thin Client for JAX-RS est également compatible avec les kits de développement de logiciels non IBM versions 8.0 et supérieures.

Pourquoi et quand exécuter cette tâche

Pour configurer un environnement Thin Client for JAX-RS, procédez comme suit :

Procédure

  1. Configurez le chemin d'accès. Saisissez la commande suivante pour ajouter les répertoires Java bin à votre chemin :
    [Windows][z/OS]
    set PATH=<your_JDK_bin_directory>;%PATH%
    [AIX][HP-UX][Solaris][Linux]
    export PATH=<your_JDK_bin_directory>:$PATH
  2. Configurez le chemin d'accès aux classes. Ajoutez le fichier JAR de Thin Client for JAX-RS à la définition de chemin d'accès aux classes, par exemple :
    [Windows][z/OS]
    set CLASSPATH=.;<your_jax-rs_thin_client_install_directory>\com.ibm.jaxrs2.0.thinclient_9.0.jar;
    <your_application_jars>;%CLASSPATH%
    [AIX][HP-UX][Solaris][Linux][IBM i]
    export CLASSPATH=.:<your_JAX-RS_thin_client_install_directory>/com.ibm.jaxrs2.0.thinclient_9.0.jar:
    <your_application_jars>;$CLASSPATH
  3. Entrez la commande suivante pour exécuter votre application client :
    [Windows][z/OS]
    %JAVA_HOME%/bin/java <your_client_application>
    [AIX][HP-UX][Solaris][Linux][IBM i]
    $JAVA_HOME/bin/java <your_client_application>

Que faire ensuite

  • Utilisez les propriétés de client léger com.ibm.ws.jaxrs.client.connection.timeout et com.ibm.ws.jaxrs.client.receive.timeout pour définir les valeurs de délai d'attente.
    • 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 :
    CWTRS0700E: 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 léger suivantes pour la prise en charge du proxy client léger :
    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 :
      CWTRS0701E: 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 :
      CWTRS0702E: 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 léger JAX-RS à l'aide de SSL.
  • Utilisez la propriété de client léger com.ibm.ws.jaxrs.client.disableCNCheck pour désactiver la vérification des noms usuels.
    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_imp_thinclient_runningthinc.html