Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Convierte la respuesta en mayúsculas con un texto destacado de Java

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X. info

Si es la primera vez que pruebas la llamada de código Java, te recomendamos que comiences con Cómo crear una llamada de código Java.

En este ejemplo de libro de recetas, se muestra cómo crear una política de JavaCallout simple que ejecuta código Java personalizado en el contexto de un flujo de proxy.

¿Qué hace el código de muestra?

El proxy de API de este ejemplo llama a un servicio de destino que muestra una respuesta JSON simple. La política de texto destacado de Java se coloca en el flujo de respuesta de destino. El código Java convierte los encabezados y el contenido de la respuesta a letras mayúsculas. Es un ejemplo simple; sin embargo, ilustra cómo hacer que el código Java personalizado funcione en el contexto de un proxy de API en Edge.

Prueba la muestra

Descarga el proyecto

Para simplificar el proceso, puedes descargar este proyecto del repositorio api-platform-samples de Apigee en GitHub.

Descarga o clona api-platform-samples en tu sistema.
En un editor de código o terminal de tu elección, ve al api-platform-samples/doc-samples/java-cookbook proyecto.

Compila tu código con Maven

El proyecto está configurado para que puedas compilar con Maven. Si quieres usar javac, también incluiremos un ejemplo después del ejemplo de Maven.

Asegúrate de haber instalado Maven:
```
mvn -version
```
Ejecuta la siguiente secuencia de comandos java-cookbook/buildsetup.sh. Esta secuencia de comandos instala las dependencias JAR necesarias en tu repositorio local de Maven.
cd al directorio java-cookbool/callout.
Ejecuta Maven:
```
mvn clean package
```
Nota: Si recibes un error de Maven, asegúrate de estar en el java-cookbook/callout directorio.
Si lo deseas, verifica que el archivo JAR edge-custom-policy-java-cookbook.jar se copió en java-cookbook/apiproxy/resources/java. Esta es la ubicación requerida para los archivos JAR que deseas implementar con un proxy.

Compila con javac

Si quieres usar javac para compilar el código, puedes hacer algo similar a lo siguiente (desde el java-cookbook directorio). Los archivos JAR necesarios se proporcionan en el directorio java-cookbook/lib.

cd a api-platform-samples/doc-samples/java-cookbook.
Asegúrate de tener javac en tu ruta de acceso.
```
javac -version
```

Ejecuta el siguiente comando de javac:

javac -d . -classpath ./lib/expressions-1.0.0.jar:./lib/message-flow-1.0.0.jar:. callout/src/main/java/ResponseUppercase.java

Copia el archivo JAR al directorio apiproxy/resources/java. Esta es la ubicación requerida para los archivos JAR que deseas implementar con un proxy.
```
cp com/apigeesample/ResponseUppercase.class apiproxy/resources/java
```

Implementa y llama al proxy

Se proporciona una secuencia de comandos de implementación en el directorio ./java-cookbook. Pero antes de ejecutarla, debes hacer una configuración rápida.

cd a api-platform-samples/doc-samples/java-cookbook
Si aún no lo has hecho, abre el archivo ../../setup/setenv.sh y edítalo como se indica con la información de tu cuenta de Apigee: tu nombre de usuario (la dirección de correo electrónico asociada con tu cuenta), el nombre de tu organización y el dominio que usas para realizar llamadas de administración de API. Por ejemplo, para la nube de Edge, el dominio es https://api.enterprise.apigee.com; sin embargo, tu dominio puede ser diferente si usas la nube privada de Edge.
Guarda el archivo setenv.sh.
Ejecuta la secuencia de comandos de implementación:
```
./deploy.sh
```
Si la implementación se realiza correctamente, ejecuta la secuencia de comandos de invocación:
```
./invoke.sh
```
La secuencia de comandos de invocación llama a un comando cURL que se ve de la siguiente manera:
```
curl  http://$org-$env.$api_domain/java-cookbook/json
```

La respuesta se ve de la siguiente manera:

< HTTP/1.1 200 OK
< Date: Tue, 09 May 2017 20:31:08 GMT
< Content-Type: APPLICATION/JSON; CHARSET=UTF-8
< Content-Length: 68
< Connection: keep-alive
< Access-Control-Allow-Origin: *
< ETag: W/"44-RA5ERT/MMLIK54NVBWBSZG"
< X-Powered-By: APIGEE
< Server: Apigee Router
<
* Curl_http_done: called premature == 0
* Connection #0 to host willwitman-test.apigee.net left intact
{"FIRSTNAME":"JOHN","LASTNAME":"DOE","CITY":"SAN JOSE","STATE":"CA"}

Flujo de proxy

Esta es una captura de pantalla de la herramienta de seguimiento que muestra el flujo del proxy:

Estructura del proxy

Esta es la estructura del proxy. Ten en cuenta que incluye un archivo JAR en el apiproxy/resources/java directorio. El archivo JAR es obligatorio. Lo proporcionamos para la muestra, pero si realizas un trabajo personalizado, debes compilarlo tú mismo y copiarlo en esta ubicación. Para obtener orientación sobre cómo compilar e implementar una llamada de código Java, consulta Cómo crear una llamada de código Java.

java-cookbook

    apiproxy
        java-cookbook.xml
    policies
        responseUppercase.xml
    proxies
        default.xml
    resources
        java
            ResponseUppercase.jar
    targets
        default.xml

Acerca del código Java

La política de texto destacado de Java ejecuta el siguiente código Java, que convierte los encabezados de respuesta y el cuerpo de la respuesta a mayúsculas. Ten en cuenta que el programa usa paquetes específicos de Apigee. Estos paquetes proporcionan objetos y métodos que puedes usar para interactuar directamente con el flujo del proxy. Existen métodos que te permiten obtener y configurar variables de flujo, encabezados, contenido de mensajes y mucho más.

package com.apigeesample;

import com.apigee.flow.execution.ExecutionContext;
import com.apigee.flow.execution.ExecutionResult;
import com.apigee.flow.execution.spi.Execution;
import com.apigee.flow.message.MessageContext;

import java.util.Set; 

public class ResponseUppercase implements Execution{
    public ExecutionResult execute(MessageContext messageContext, ExecutionContext executionContext) {
        try {
            Set headers = messageContext.getMessage().getHeaderNames();
            for (String header : headers) {
                String h = messageContext.getMessage().getHeader(header).toUpperCase();
                messageContext.getMessage().setHeader(header, h);
            }
            String content = messageContext.getMessage().getContent();
            messageContext.getMessage().setContent(content.toUpperCase());
            return ExecutionResult.SUCCESS;
        } catch (Exception e) {
                return ExecutionResult.ABORT;
        }
    }
}

Examina el proxy de muestra

Te dejamos que abras el proxy y examines los archivos. Esta es la política de texto destacado de Java. Ten en cuenta cómo hace referencia a la clase que ejecuta el texto destacado y al archivo JAR. Todas las políticas de texto destacado de Java siguen este patrón. Consulta también la política de texto destacado de Java.

<JavaCallout name="responseUppercase">         
    <ClassName>com.apigeesample.ResponseUppercase</ClassName>         
    <ResourceURL>java://ResponseUppercase.jar</ResourceURL> 
</JavaCallout>