Crea il tuo primo bundle OSGi

Un bundle OSGi è un file di archivio Java™ contenente codice Java, risorse e un manifesto che descrive il bundle e le sue dipendenze. Il bundle è l'unità di distribuzione per un'applicazione. Questo articolo è destinato agli sviluppatori che desiderano creare un servizio OSGi o un servlet utilizzando AEM Forms 6.4 o 6.5. Per creare il tuo primo bundle OSGi, segui i seguenti passaggi:

Installa JDK

Installa la versione supportata di JDK. Ho usato JDK1.8. Assicurati di aver aggiunto JAVA_HOME nelle variabili di ambiente e punta alla cartella principale dell'installazione JDK.
Aggiungi il percorso %JAVA_HOME%/bin

sorgente dati

NOTA

Non utilizzare JDK 15. Non è supportato da AEM.

Verifica la versione JDK

Apri una nuova finestra del prompt dei comandi e digita: java -version. Devi recuperare la versione di JDK identificata da JAVA_HOME variable

sorgente dati

Installa Maven

Maven è uno strumento di automazione della build utilizzato principalmente per i progetti Java. Segui i seguenti passaggi per installare maven sul tuo sistema locale.

  • Crea una cartella denominata maven nell'unità C
  • Scarica la archivio zip binario
  • Estrai il contenuto dell’archivio zip in c:\maven
  • Creare una variabile di ambiente denominata M2_HOME con un valore di C:\maven\apache-maven-3.6.0. Nel mio caso, il mvn La versione è 3.6.0. Al momento della stesura di questo articolo la versione più recente di maven è 3.6.3
  • Aggiungi il %M2_HOME%\bin al tuo percorso
  • Salva le modifiche
  • Apri un nuovo prompt dei comandi e digita mvn -version. Dovresti vedere la mvn versione elencata come mostrato nella schermata seguente

sorgente dati

Installa Eclipse

Installa la versione più recente di eclissi

Crea il primo progetto

Archetype è un toolkit per modelli di progetto Maven. Un archetipo è definito come un modello o modello originale dal quale vengono realizzate tutte le altre cose dello stesso tipo. Il nome si adatta quando cerchiamo di fornire un sistema che fornisca un mezzo coerente per generare progetti Maven. Archetype aiuta gli autori a creare modelli di progetto Maven per gli utenti e fornisce agli utenti i mezzi per generare versioni con parametri di tali modelli di progetto.
Per creare il tuo primo progetto Maven, segui i seguenti passaggi:

  • Crea una nuova cartella denominata aemformsbundles nell'unità C
  • Apri un prompt dei comandi e passa a c:\aemformsbundles
  • Esegui il seguente comando nel prompt dei comandi
mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate -D archetypeGroupId=com.adobe.aem -D archetypeArtifactId=aem-project-archetype -D archetypeVersion=36 -D appTitle="My Site" -D appId="mysite" -D groupId="com.mysite" -D aemVersion=6.5.13

Al termine del completamento, nella finestra del comando dovrebbe essere visualizzato un messaggio di completamento della compilazione

Crea un progetto eclipse dal tuo progetto Maven

  • Cambia la directory di lavoro in mysite
  • Esegui mvn eclipse:eclipse dalla riga di comando. Il comando legge il file pom e crea progetti Eclipse con metadati corretti in modo che Eclipse possa comprendere i tipi di progetto, le relazioni, il percorso di classe, ecc.

Importa il progetto in eclissi

Launch Eclipse

Vai a File -> Importa e seleziona Progetti Maven esistenti come mostrato qui

sorgente dati

Fai clic su Avanti

Seleziona il c:\aemformsbundles\mysite by clicking the Sfoglia pulsante

sorgente dati

NOTA

Puoi scegliere di importare i moduli appropriati in base alle tue esigenze. Seleziona e importa solo il modulo principale, se hai intenzione di creare solo codice Java nel tuo progetto.

Fai clic su Fine per avviare il processo di importazione

Il progetto viene importato in Eclipse e vengono visualizzati diversi mysite.xxxx cartelle

Espandi la src/main/java in mysite.core cartella. Questa è la cartella in cui scriverai la maggior parte del codice.

sorgente dati

Includi SDK client AEM FD

Sarà necessario includere l’sdk client AEMFD nel progetto per sfruttare i vari servizi forniti con AEM Forms. Fai riferimento a SDK client AEMFD per includere l’SDK client appropriato nel progetto Maven. Devi includere l’SDK client FD AEM nella sezione dipendenze di pom.xml del progetto principale come mostrato di seguito.

<dependency>
    <groupId>com.adobe.aemfd</groupId>
    <artifactId>aemfd-client-sdk</artifactId>
    <version>6.0.122</version>
</dependency>

Per creare il progetto, effettua le seguenti operazioni:

  • Apri finestra del prompt dei comandi
  • Accedi a c:\aemformsbundles\mysite\core
  • Esegui il comando mvn clean install -PautoInstallBundle
    Il comando precedente crea e installa il bundle nel server AEM in esecuzione su http://localhost:4502. Il bundle sarà disponibile anche sul file system all'indirizzo
    C:\AEMFormsBundles\mysite\core\target e può essere distribuito utilizzando Console web Felix

In questa pagina