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
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
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](images/eclipse-install-swf-tools.png)
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:
-
Cree un proyecto de Java de AWS.
-
Habilite el procesamiento de anotaciones para su proyecto.
-
Habilite y configure AspectJ.
Cada uno de estos pasos se describe ahora de manera detallada.
Para crear un proyecto de Java de AWS
-
Lance Eclipse.
-
Para seleccionar la perspectiva de Java, elija Window (Ventana), Open Perspective (Abrir perspectiva), Java.
-
Elija Archivo, Nuevo, Proyecto de Java de AWS.
-
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
-
En el explorador de proyectos, haga clic con el botón derecho del ratón en su proyecto y seleccione Properties (Propiedades).
-
En el cuadro de diálogo Properties (Propiedades), navegue hasta Java Compiler (Compilador de Java) > Annotation Processing (Procesamiento de anotaciones).
-
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).
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@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.
Temas
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
-
Para abrir el cuadro de diálogo Preferences (Preferencias), elija choose Window (Ventana), Preferences (Preferencias).
-
Navegue hasta Java > Installed JREs (JRE instalados).
-
Seleccione el JRE apropiado y elija Edit.
-
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
Para configurar AspectJ para AWS Flow Framework para Java, añada un archivo aop.xml
al proyecto.
Para añadir un archivo aop.xml
-
En el directorio src de su proyecto, añada un directorio llamado
META-INF
. -
Añada un archivo llamado
aop.xml
aMETA-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
-
En el menú Help (Ayuda), elija Install New Software (Instalar software nuevo).
-
En el cuadro de diálogo Available Software (Software nuevo) escriba
http://download.eclipse.org/tools/ajdt/
, donde la versión representa su número de versión de Eclipse. Por ejemplo, si está utilizando Eclipse 4.6, debería escribir:version
/dev/updatehttp://download.eclipse.org/tools/ajdt/
46
/dev/updateimportante
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.
-
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.
-
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
-
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.
-
Vuelva a hacer clic con el botón derecho del ratón en el proyecto y, a continuación, elija Properties (Propiedades).
-
Elija AspectJ Build (Compilación de AspectJ) y, a continuación, elija la pestaña Aspect Path (Ruta de Aspect).
-
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/
, donde debe sustituirAWS Version
/libAWS 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 directoriolib
.
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
).