Preparare la distribuzione di un'applicazione Web Oracle JET

Introduzione

Questa esercitazione descrive come preparare un'applicazione Web Oracle JavaScript Extension Toolkit (Oracle JET) per la distribuzione.

È possibile distribuire l'applicazione Web Oracle JET che contiene una raccolta di file HTML, JavaScript e CSS (Cascading Style Sheet) a qualsiasi tipo di Web o Application Server. Il metodo di distribuzione dipende dal tipo di ambiente server in cui viene eseguita l'applicazione.

Per distribuire l'applicazione Web Oracle JET, è possibile utilizzare lo stesso metodo utilizzato per distribuire qualsiasi altra interfaccia client nell'ambiente specifico.

Se in genere si distribuiscono applicazioni come file ZIP, è possibile comprimere la cartella /web dell'applicazione Web e seguire il processo di distribuzione standard.
Se in genere si distribuiscono applicazioni come file WAR, potrebbe essere necessario modificare anche l'applicazione Web prima di generare il file di archivio della cartella /web. Ad esempio, per creare un file .war, includere una cartella /WEB-INF che contiene un file di configurazione web.xml.

L'applicazione Web creata con l'interfaccia della riga di comando di Oracle JET contiene una cartella di file modello di script di collegamento che è possibile utilizzare per definire nuovi passi per il processo di creazione. Ad esempio, è possibile creare uno script di collegamento per archiviare la cartella /web dell'applicazione Web come file ZIP o come file WAR. Questo script after_build viene eseguito al termine del processo di creazione.

Questa esercitazione non illustra i passi di distribuzione che dipendono da un ambiente e una piattaforma specifici.

Obiettivi

Al termine di questa esercitazione, verrà descritto come archiviare la cartella /web dell'applicazione Web come file ZIP o file WAR. Verrà inoltre illustrato come modificare l'applicazione Web per automatizzare l'archiviazione nell'ambito del processo di creazione dell'applicazione Oracle JET.

Prerequisiti

Un ambiente di sviluppo impostato per creare applicazioni Oracle JET con runtime JavaScript, Node.js e l'interfaccia della riga di comando Oracle JET più recente installata
Completamento delle esercitazioni precedenti in questo percorso di apprendimento, in modo da creare l'applicazione Web Oracle JET nella cartella JET_Web_Application
Acquisire familiarità con le procedure di distribuzione dell'ambiente

Task 1: creare lo script di collegamento after_build

Lo script di collegamento after_build viene creato utilizzando il file modello di script di collegamento fornito che si sta modificando.

Passare alla directory JET_Web_Application/scripts/hooks e aprire il file modello di script hook after_build.js in un editor.
Copiare lo snippet di codice after-build-js.txt e sostituire il contenuto del file modello con lo snippet di codice copiato.

Task 2: Modificare lo script del gancio after_build

Modificare lo script di collegamento per specificare il tipo di file di archivio che si desidera generare per l'applicazione Web. Lo script hook utilizza lo stesso metodo di compressione per creare il file zip e il file WAR. Modificare lo script di collegamento after_build per specificare l'estensione del file di output, ovvero .war per impostazione predefinita.

Nel file after_build.js modificare il nome file passato a fs.createWriteStream() per utilizzare l'estensione appropriata: .zip o .war.
- Per generare un file WAR, assegnare un nome al file my-archive.war.
```
const output = fs.createWriteStream('my-archive.war');
```
- Per generare un file ZIP, assegnare un nome al file my-archive.zip.
```
const output = fs.createWriteStream('my-archive.zip');
```
Salvare il file after_build.js senza modificare il nome del file. I nomi file degli script di collegamento nella directory /scripts/hooks corrispondono a vari punti di collegamento per la creazione di Oracle JET.

Task 3: Creare l'applicazione in modalità rilascio

Quando si crea un'applicazione Web in modalità di rilascio, il comando build --release sostituisce la versione di sviluppo delle librerie e degli script nella cartella /web/ con le versioni miniate. Al termine del processo di generazione, la build eseguirà lo script di collegamento after_build e archivia il contenuto della cartella /web.

Aprire una finestra di terminale, passare alla directory JET_Web_Application e installare il pacchetto archiver npm.
```
$ npm install archiver
```
Installa il pacchetto archiver npm nel progetto JET_Web_Application. Il gancio after_build.js utilizza questo pacchetto per archiviare l'applicazione Web.
Aprire una finestra di terminale, passare alla directory JET_Web_Application e creare l'applicazione Web in modalità di rilascio.
```
$ ojet build web --release
```
Il processo di creazione attiva gli script di collegamento presenti nella directory /scripts/hooks e il completamento richiede alcuni minuti.

Attendere la conferma.

. . .
Running after_build hook.
Success: Build finished.
Files were successfully archived.

Passare alla directory JET_Web_Application e individuare il file di archivio generato dallo script hook. Ad esempio, se si modifica lo script di collegamento after_build per generare un file WAR denominato my-archive.war, nella cartella radice dell'applicazione verrà visualizzato un file WAR con il nome specificato.

Descrizione dell'illustrazione root-folder-with-war-archive.png

Altre risorse di apprendimento

Esplora altri laboratori su docs.oracle.com/learn o accedi a più contenuti di apprendimento gratuito sul canale Oracle Learning YouTube. Inoltre, visitare education.oracle.com/learning-explorer per diventare Oracle Learning Explorer.

Per la documentazione del prodotto, visitare il sito Oracle Help Center.

Titolo e informazioni sul copyright

Prepare to deploy an Oracle JET web app

F53074-01

February 2022