Dirigir llamadas de API a servidores específicos

La aplicación proporciona la posibilidad de dirigir llamadas de API personalizadas a un servidor o grupo de servidores determinado cuando estas API se invocan de forma local o remota.

Acerca de esta tarea

Para habilitarlo, los servidores y el protocolo deben especificarse en el archivo yifclient.properties y en las API necesarias. El punto final es el servidor configurado o un protocolo que se utiliza para dirigir las llamadas de API.

Si el cliente XAPI está configurado para varios URL, se realiza un intento por conectarse con cada servidor en el grupo uno por uno. Si la conexión funciona pero algo más falla, no se intenta ningún otro servidor y se genera una excepción.

Para dirigir llamadas de API a un servidor o grupo de servidores específico, realice los pasos siguientes:

Procedimiento

  1. Especifique el atributo endpoint en el archivo yifclient.properties bajo el directorio <runtime_sandbox>/resources/. Modifique el archivo yifclient.properties para incluir la declaración y el uso del punto final en el formato siguiente:
    endpoint.Server_Name.apifactory.protocol=HTTP 
    endpoint.Server_Name.httpapi.url=http://server:port/context_root/
    interop/InteropHttpServlet
    Para configurar el cliente XAPI para varios URL, defina el grupo como una lista separada por comas:
    endpoint.Server_Name.httpapi.url=http://server1:port1/context_root1/
    interop/InteropHttpServlet,http://server2:port2/context_root2/
    interop/InteropHttpServlet... 

    La expresión endpoint.Server_Name especifica un servidor con el nombre Server_Name. Por ejemplo, endpoint.INBOXSERVER crea un punto final con el nombre NBOXSERVER. Puede asignar propiedades al nombre de punto final, que tiene prioridad sobre cualquier otra propiedad asignada.

    El protocolo configurado para el punto final es HTTP tal como se especifica en la línea: endpoint.Server_Name.apifactory.protocol=HTTP

    Los valores especificados en la segunda línea, endpoint.Server_Name.httpapi.url, se utilizan para conectarse al servidor especificado en el punto final.

  2. Configure un protocolo para que se utilice para conectarse con el servidor especificado. Los protocolos tales como HTTP, HTTPS, EJB, LOCAL, AUTO son nombres de puntos finales reservados. Si alguno de ellos está configurado para el punto final, el sistema utiliza los valores de conexión predeterminados (según proceda) para dirigir las llamadas de la API.
  3. Para cada API, especifique el punto final que se utilizará:
    yfs.api.apiname.endpoint=ENDPOINT

    A continuación, la API llama al servidor especificado en el atributo endpoint.

    Nota: Si un punto final no está configurado para una API, utiliza el servidor predeterminado (local) o uno general configurado para todas las API. El conjunto de prioridades en el nivel de la API tiene prioridad sobre las demás propiedades comunes.