Configurazione diAWS Flow Frameworkper Java

LaAWS Flow Frameworkper Java è incluso con ilAWS SDK for Java. Se non hai ancora configurato AWS SDK for Java, visita Nozioni di base nella Guida per gli sviluppatori di AWS SDK for Java per informazioni su come installare e configurare lo stesso SDK.

In questo argomento vengono fornite informazioni sui passaggi aggiuntivi necessari per utilizzareAWS Flow Frameworkper Java. Le informazioni fornite sono relative a Eclipse e Maven.

Installazione per Maven

Amazon fornisceStrumenti di compilazione di Amazon SWFnel repository centrale di Maven per facilitare la configurazione diAWS Flow Frameworkper Java nei tuoi progetti Maven.

Per configurare il framework per Maven, aggiungi la seguente dipendenza al file pom.xml del tuo progetto:

<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>

Gli strumenti di compilazione di Amazon SWF sono open source: per visualizzare o scaricare il codice o per creare autonomamente gli strumenti, visita il repository all'indirizzohttps://github.com/aws/aws-swf-build-tools.

Installazione per Eclipse

Se utilizzi l'IDE di Eclipse, installaAWS Flow Frameworkper Java utilizzandoAWS Toolkit for Eclipse.

Argomenti

• Installazione di AWS Toolkit for Eclipse
• Creazione di unAWS Flow Frameworkper Java Project

Installazione di AWS Toolkit for Eclipse

L'installazione del Toolkit for Eclipse è il modo più semplice per iniziare a utilizzareAWS Flow Frameworkper Java. Per installare il Toolkit for Eclipse, vedereConfigurazione dellaAWS Toolkit for EclipsenellaAWS Toolkit for EclipseGuida alle operazioni di base.

Importante

Assicurarsi di includere entrambi iAWS SDK for JavaeAWSStrumenti di flusso di lavoro sempliciquando si selezionano i pacchetti da installare in EclipseSoftware disponibilefinestra di dialogo:

Se installi tutti i pacchetti disponibili, scegliendo il nodo di primo livello AWS Toolkit for Eclipse oppure Select All (Seleziona tutto), entrambi i pacchetti vengono selezionati e installati automaticamente.

Creazione di unAWS Flow Frameworkper Java Project

Creazione di una configurazione correttaAWS Flow Frameworkper il progetto Java in Eclipse comporta varie fasi:

1. Creazione di unAWSProgetto Java.

2. Attivazione dell'elaborazione delle annotazioni per il progetto.

3. Attivazione e configurazione di AspectJ.

Una descrizione dettagliata di ogni fase è riportata di seguito.

Per creare unAWSprogetto Java

1. Avvia Eclipse.

2. Per selezionare la prospettiva Java, scegli Window (Finestra), Open Perspective (Apri prospettiva), Java.

3. ScegliereFile,Novità,AWSProgetto Java.

   

4. Utilizzo dell'AWSCreazione guidata Java Project (Progetto Java).

   Nota

   La prima volta che crei unAWSJava Project con Eclipse, l'SDK for Java viene scaricato e installato automaticamente all'avvio della procedura guidata.

Dopo aver creato il tuoAWSProgetto Java, abilitaelaborazione delle annotazioniper il progetto. LaAWS Flow Frameworkper Java include un processore di annotazione che genera varie classi di chiavi basate sul codice sorgente annotato.

Per attivare l'elaborazione delle annotazioni

1. In Project Explorer (Esplora progetti), fai clic con il pulsante destro del mouse e seleziona Properties (Proprietà).

2. Nella finestra di dialogo Properties (Proprietà), seleziona Java Compiler (Compilatore Java) > Annotation Processing (Elaborazione annotazioni).

3. Seleziona Enable project specific settings (Attiva impostazioni specifiche del progetto). Questa operazione dovrebbe comportare la selezione automatica di Enable annotation processing (Attiva elaborazione annotazioni), ma se non è così, seleziona anche questa opzione. Quindi scegli OK.

   

   Nota

   Dopo l'attivazione dell'elaborazione delle annotazioni, devi ricompilare il progetto.

Attivazione e configurazione di AspectJ

A questo punto, è necessario attivare e configurare AspectJ. CertoAWS Flow Frameworkper annotazioni Java come@Asynchronousrichiede AspectJ. Non devi utilizzare AspectJ direttamente, ma attivarlo con la tessitura in fase di caricamento o in fase di compilazione.

Nota

L'approccio consigliato è utilizzare la tessitura in fase di caricamento.

Argomenti

• Prerequisiti
• Configurazione della tessitura in fase di caricamento di AspectJ
• Tessitura in fase di compilazione di AspectJ
• Risoluzione dei problemi relativi a AspectJ ed Eclipse

Prerequisiti

Prima di configurare AspectJ, devi procurarti la versione di AspectJ corrispondente alla versione di Java in uso:

• Se utilizzi Java 8, scarica l'ultima versione di AspectJ 1.8.X.

• Se utilizzi Java 7, scarica l'ultima versione di AspectJ 1.7.X.

• Se utilizzi Java 6, scarica l'ultima versione di AspectJ 1.6.X.

Puoi scaricare una qualsiasi delle suddette versioni di AspectJ dalla pagina di download di Eclipse.

Al termine del caricamento, esegui il file .jar scaricato per installare AspectJ. Nel corso dell'installazione ti viene richiesto di specificare la posizione in cui intendi installare i binari e nella schermata finale viene visualizzata la procedura necessaria per completare l'installazione. Prendi nota del percorso del file aspectjweaver.jar in quanto sarà necessario per configurare AspectJ in Eclipse.

Configurazione della tessitura in fase di caricamento di AspectJ

Per configurare la tessitura in fase di caricamento di AspectJ per il tuoAWS Flow Frameworkper il progetto Java, dapprima designa il file JAR di AspectJ come agente Java, quindi configuralo aggiungendo unaop.xmlfile nel tuo progetto.

Per aggiungere AspectJ come agente Java

1. Per aprirePreferenzefinestra di dialogo, selezionareWindow,Preferenze.

2. Seleziona Java > Installed JREs (JRE installati).

3. Seleziona il JRE appropriato e scegli Edit (Modifica).

4. Nella casella Default VM arguments (Argomenti VM di default), immetti il percorso al binario AspectJ installato. Il percorso sarà simile a /home/user/aspectj1.7/lib/aspectjweaver.jar, a seconda del sistema operativo utilizzato e della versione di AspectJ che hai scaricato.

   Su Linux, macOS o Unix utilizza:

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

   In Windows, utilizza un percorso Windows standard:

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

   

Per configurare AspectJ perAWS Flow Frameworkper Java, aggiungi unaop.xmlfile al progetto.

Per aggiungere un file aop.xml

1. Nella directory src del progetto, crea una directory denominata META-INF.

2. Aggiungi un file denominato aop.xml a META-INF con il contenuto seguente.

   <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>

   Il valore di <include within=""/> dipende da come vengono denominati i pacchetti del progetto. L'esempio qui sopra presuppone che sia stato utilizzato il modello MySimpleWorkflow.* Utilizza un valore appropriato per i pacchetti del tuo progetto.

Tessitura in fase di compilazione di AspectJ

Per attivare e configurare la tessitura in fase di compilazione di AspectJ, devi dapprima installare gli strumenti di sviluppo di AspectJ per Eclipse, disponibili all'indirizzo http://www.eclipse.org/aspectj/downloads.php.

Per installare gli strumenti di sviluppo di AspectJ in Eclipse

1. Nel menu Help (?), scegli Install New Software (Installa nuovo software).

2. Nella finestra di dialogo Available Software (Software disponibile), immetti http://download.eclipse.org/tools/ajdt/version/dev/update, dove version rappresenta il numero di versione di Eclipse. Ad esempio, se si sta utilizzando Eclipse 4.6, digita:http://download.eclipse.org/tools/ajdt/46/dev/update

   Importante

   Assicurati che la versione di AspectJ corrisponda alla versione di Eclipse in uso, altrimenti l'installazione di AspectJ non riuscirà.

3. Scegli Add (Aggiungi) per aggiungere il percorso e visualizzare gli strumenti di sviluppo di AspectJ nell'elenco.

   

4. Scegli Select All (Seleziona tutto) per selezionare tutti gli strumenti di sviluppo di AspectJ, quindi scegli Next (Avanti) per installarli.

   Nota

   Per completare l'installazione, devi riavviare Eclipse.

A questo punto, è necessario configurare il progetto.

Per configurare il progetto per la tessitura in fase di compilazione di AspectJ

1. In Project Explorer (Esplora progetti), fai clic con il pulsante destro del mouse e seleziona Configure (Configura) > Convert to AspectJ Project (Converti in progetto AspectJ).

   

   La libreria di runtime di AspectJ viene aggiunta al progetto.

2. Fai di nuovo clic con il pulsante destro del mouse sul progetto e scegli Properties (Proprietà).

3. Scegli AspectJ Build (Compila AspectJ), quindi scegli la scheda Aspect Path (Percorso Aspect).

4. Scegliere Add External JARs (Aggiungi JAR esterni) e aggiungi il file JAR del kit AWS SDK for Java al percorso Aspect del progetto.

   Nota

   LaAWS Toolkit for Eclipseinstalla ilAWS SDK for JavaFile JAR nel tuo spazio di lavoro, nel.metadata/.plugins/com.amazonaws.eclipse.core/aws-java-sdk/AWS Version/libdirectory, dove sostituisciAWS Versioncon installatoAWSNumero di versione dell'SDK. In alternativa, puoi utilizzare il file JAR incluso con l'installazione standard del kit SDK AWS, che si trova nella directory lib.

Risoluzione dei problemi relativi a AspectJ ed Eclipse

Il plug-in AspectJ Eclipse presenta un problema che può impedire la compilazione del codice generato. Il modo più veloce di forzare il riconoscimento del codice generato dopo la ricompilazione dello stesso è cambiare l'ordine della directory di origine che contiene il codice generato nella scheda Order and Export (Ordina ed esporta) della pagina delle impostazioni Java Build Path (Percorso di compilazione Java) (ad esempio, puoi impostare apt/java come valore di default).