Configuración del AWS Flow Framework para Java - AWS Flow Framework para Java
Instalación para MavenInstalación para Eclipse

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configuración del AWS Flow Framework para Java

El AWS Flow Framework para Java se incluye con el AWS SDK for Java. Si todavía no ha configurado el AWS SDK for Java, consulte la Introducción en la Guía para desarrolladores de AWS SDK for Java para obtener información sobre cómo instalar y configurar el SDK.

Este tema proporciona información acerca de los pasos adicionales necesarios para utilizar el AWS Flow Framework para Java. Se proporcionan pasos para Eclipse y Maven.

Instalación para Maven

Amazon proporciona herramientas de compilación de Amazon SWF en el repositorio central de Maven para facilitar la configuración del AWS Flow Framework para Java en los proyectos de Maven.

Para configurar el marco de trabajo del flujo para Maven, añada la siguiente dependencia al archivo pom.xml de sus proyectos:

<dependency>
  <groupId>log4j</groupId>
  <artifactId>log4j</artifactId>
  <version>1.2.17</version>
</dependency>
<dependency>
  <groupId>com.amazonaws</groupId>
  <artifactId>aws-swf-build-tools</artifactId>
  <version>1.0</version>
</dependency>

Las herramientas de compilación de Amazon SWF son de código abierto; para ver o descargar el código o para compilar las herramientas usted mismo, visite el repositorio en https://github.com/aws/aws-swf-build-tools.

Instalación para Eclipse

Si utiliza el IDE de Eclipse, instale el AWS Flow Framework para Java mediante el AWS Toolkit for Eclipse.

Instalación de AWS Toolkit for Eclipse

La manera más sencilla de comenzar a utilizar el AWS Flow Framework para Java es instalando el Kit de herramientas para Eclipse. Para instalar el Kit de herramientas para Eclipse, consulte Configuración del AWS Toolkit for Eclipse en la Guía de introducción al AWS Toolkit for Eclipse.

importante

Asegúrese de incluir tanto el AWS SDK for Java como AWS Simple Workflow Tools al seleccionar los paquetes que va a instalar en el cuadro de diálogo Software disponible de Eclipse:

Instalar el AWS Toolkit for Eclipse junto con el SDK para Java y las herramientas de Amazon SWF

Si instaló todos los paquetes disponibles (eligiendo el nodo de nivel superior AWS Toolkit for Eclipse o eligiendo Seleccionar todo), ambos paquetes se seleccionaron e instalaron automáticamente.

Creación de un proyecto de AWS Flow Framework para Java

Para crear un proyecto de AWS Flow Framework para Java configurado correctamente en Eclipse es necesario dar una serie de pasos:

  1. Cree un proyecto de Java de AWS.

  2. Habilite el procesamiento de anotaciones para su proyecto.

  3. Habilite y configure AspectJ.

Cada uno de estos pasos se describe ahora de manera detallada.

Para crear un proyecto de Java de AWS

  1. Lance Eclipse.

  2. Para seleccionar la perspectiva de Java, elija Window (Ventana), Open Perspective (Abrir perspectiva), Java.

  3. Elija Archivo, Nuevo, Proyecto de Java de AWS.

    Creación de un nuevo proyecto de Java de AWS

  4. Utilice el asistente de proyectos de Java de AWS para crear un proyecto nuevo.

    nota

    La primera vez que cree un proyecto de Java de AWS con Eclipse, el SDK para Java se descargará e instalará automáticamente al iniciarse el asistente del proyecto.

Después de crear su proyecto de Java de AWS, habilite el procesamiento de anotaciones para el proyecto. El AWS Flow Framework para Java incluye un procesador de anotaciones que genera varias clases principales basadas en código fuente anotado.

Para habilitar el procesamiento de anotaciones

  1. En el explorador de proyectos, haga clic con el botón derecho del ratón en su proyecto y seleccione Properties (Propiedades).

  2. En el cuadro de diálogo Properties (Propiedades), navegue hasta Java Compiler (Compilador de Java) > Annotation Processing (Procesamiento de anotaciones).

  3. Marque Enable project specific settings (Habilitar configuración específica del proyecto) (que también debería marcar Enable annotation processing (Habilitar procesamiento de anotaciones), pero si no lo hace asegúrese de que esta opción también aparece marcada). A continuación, seleccione OK (Aceptar).

    Habilitación del procesamiento de anotaciones en Eclipse
    nota

    Tendrá que volver a compilar su proyecto después de habilitar el procesamiento de anotaciones.

Habilitación y configuración de AspectJ

A continuación, tendrá que habilitar y configurar AspectJ. Algunas anotaciones de AWS Flow Framework para Java como @Asynchronous necesitan AspectJ. No tiene que utilizar AspectJ directamente, pero tiene que habilitarlo incorporando tiempo de carga o incorporando tiempo de compilación.

nota

El enfoque recomendado consiste en usar la incorporación de tiempo de carga.

Requisitos previos

Antes de configurar AspectJ, necesita la versión de AspectJ que corresponde a su versión de Java:

  • Si está utilizando Java 8, descargue la última versión de AspectJ 1.8.X.

  • Si está utilizando Java 7, descargue la última versión de AspectJ 1.7.X

  • Si está utilizando Java 6, descargue la última versión de AspectJ 1.6.X

Puede descargar cualquiera de estas versiones de AspectJ desde la página de descarga de Eclipse.

Cuando haya terminado de descargar AspectJ, ejecute el archivo .jar descargado para instalar AspectJ. La instalación de AspectJ le preguntará si desea instalar los archivos binarios y en la última pantalla, proporcionamos los pasos que se recomiendan para completar la instalación. Recuerde la ubicación del archivo aspectjweaver.jar; lo necesitará para configurar AspectJ en Eclipse.

Configuración de la incorporación del tiempo de carga de AspectJ

Para configurar la incorporación del tiempo de carga de AspectJ para su proyecto de AWS Flow Framework para Java, en primer lugar designe el archivo JAR de AspectJ como agente de Java y, a continuación, configúrelo añadiendo un archivo aop.xml al proyecto.

Para añadir AspectJ como agente de Java

  1. Para abrir el cuadro de diálogo Preferences (Preferencias), elija choose Window (Ventana), Preferences (Preferencias).

  2. Navegue hasta Java > Installed JREs (JRE instalados).

  3. Seleccione el JRE apropiado y elija Edit.

  4. En el cuadro Default VM arguments (Argumentos de VM predeterminados), escriba la ruta al archivo binario AspectJ instalado. Será una ruta como por ejemplo /home/user/aspectj1.7/lib/aspectjweaver.jar, dependiendo de su sistema operativo y de la versión de AspectJ que ha descargado.

    En Linux, macOS o Unix, utilice:

    -javaagent:/your_path/aspectj/lib/aspectjweaver.jar

    En Windows, utilice una ruta de estilo Windows estándar:

    -javaagent:C:\your_path\aspectj\lib\aspectjweaver.jar

    Habilitación de la incorporación del tiempo de carga de AspectJ en Eclipse

Para configurar AspectJ para AWS Flow Framework para Java, añada un archivo aop.xml al proyecto.

Para añadir un archivo aop.xml

  1. En el directorio src de su proyecto, añada un directorio llamado META-INF.

  2. Añada un archivo llamado aop.xml a META-INF con el siguiente contenido.

    <aspectj>
   <aspects>
      <aspect name="com.amazonaws.services.simpleworkflow.flow.aspectj.AsynchronousAspect"/>
      <aspect name="com.amazonaws.services.simpleworkflow.flow.aspectj.ExponentialRetryAspect"/>
   </aspects>
   <weaver options="-verbose">
     <include within="MySimpleWorkflow.*"/>
   </weaver>
</aspectj>

    El valor de <include within=""/> depende de cómo nombre los paquetes de su proyecto. El ejemplo anterior presupone que los paquetes del proyecto han seguido el patrón MySimpleWorkflow.*. Utilice un valor adecuado para sus propios paquetes de proyectos.

Incorporación del tiempo de compilación de AspectJ

Para habilitar y configurar la incorporación del tiempo de compilación de AspectJ, en primer lugar tiene que instalar las herramientas para desarrolladores de AspectJ para Eclipse, que están disponibles a través de http://www.eclipse.org/aspectj/downloads.php.

Para instalar las herramientas para desarrolladores de AspectJ en Eclipse

  1. En el menú Help (Ayuda), elija Install New Software (Instalar software nuevo).

  2. En el cuadro de diálogo Available Software (Software nuevo) escriba http://download.eclipse.org/tools/ajdt/version/dev/update, donde la versión representa su número de versión de Eclipse. Por ejemplo, si está utilizando Eclipse 4.6, debería escribir: http://download.eclipse.org/tools/ajdt/46/dev/update

    importante

    Asegúrese de que la versión de AspectJ coincide con su versión de Eclipse, de lo contrario se producirá un error en la instalación de AspectJ.

  3. Elija Add (Añadir) para añadir la ubicación. Una vez que se haya añadido la ubicación, se enumerarán las herramientas para desarrolladores de AspectJ.

  4. Elija Select All (Seleccionar todo) para seleccionar todas las herramientas para desarrolladores de AspectJ, a continuación elija Next (Siguiente) para instalarlas.

    nota

    Tendrá que reiniciar Eclipse para completar la instalación.

A continuación tiene que configurar su proyecto.

Para configurar su proyecto para la incorporación del tiempo de compilación de AspectJ

  1. En el explorador de proyectos, haga clic con el botón derecho del ratón y seleccione Configure (Configurar) > Convert to AspectJ Project (Convertir a proyecto AspectJ).

    Se añadirá a su proyecto la biblioteca del tiempo de ejecución de AspectJ.

  2. Vuelva a hacer clic con el botón derecho del ratón en el proyecto y, a continuación, elija Properties (Propiedades).

  3. Elija AspectJ Build (Compilación de AspectJ) y, a continuación, elija la pestaña Aspect Path (Ruta de Aspect).

  4. Elija Add External JARs (Añadir JAR externos) y añada el archivo JAR de AWS SDK for Java a la ruta de aspecto del proyecto.

    nota

    El AWS Toolkit for Eclipse instala el archivo JAR de AWS SDK for Java en su espacio de trabajo, en el directorio .metadata/.plugins/com.amazonaws.eclipse.core/aws-java-sdk/AWS Version/lib, donde debe sustituir AWS Version por el número de versión del SDK de AWS instalado. De lo contrario, puede utilizar el archivo JAR que se incluye con la instalación normal de AWS SDK, que se encuentra en el directorio lib.

Solución de problemas con AspectJ y Eclipse

El complemento de Eclipse de AspectJ tiene un problema que puede evitar que se compile el código generado. La manera más rápida de forzar el reconocimiento del código generado después de volver a compilarlo consiste en cambiar el orden del directorio de origen que contiene el código generado en la pestaña Order and Export (Ordenar y exportar) de la página de configuración Java Build Path (Ruta de compilación de Java) (por ejemplo, puede establecer el valor predeterminado en apt/java).