Compilare l'estensione (Linux)

• Se non si è interessati a ri-compilare l'estensione, si prega di saltare direttamente alla sezione Setup.
• Installare la versione più recente di Oracle JDeveloper 12c.
• Clonare il repository.
• Aprire "SQL Developer 4 keepalive.jws" con JDeveloper, migrarlo alla versione più recente se JDeveloper lo richiede.
• Compilare il progetto con il profilo "JAR-Deploy", confermando le opzioni di default.
• Lanciare lo script "pack_extension.sh". Il file keepalive.zip created dallo script può essere installato in SQL Developer.

Installazione

• Scaricare questo file: keepalive.zip (disponibile nei download del repository).

• Assicurarsi di avere i permessi di scrittura sulla cartella di installazione di SQL Developer. Per acquisirli, lanciare il seguente comando (cambiando eventualmente la cartella di installazione in modo opportuno): sudo chmod -R o+w /opt/sqldeveloper.

• Aprire SQL Developer.

• Dal menu Guida selezionare Rileva aggiornamenti.

• Nella popup, selezionare Installa da file locale mettendo in Nome file il path di keepalive.zip sul PC locale.

• SQL Developer dovrebbe chiedere di riavviarsi, rispondere sì.

• Al riavvio, dovrebbe comparire l'icona di un'etichetta nella toolbar (vicino al pulsante Salva tutto). Verificare che sia l'icona corretta posizionandovi sopra il mouse (dovrebbe comparire il tooltip "keepalive").

Utilizzo

• La extension non parte in automatico; è necessario cliccare sull'icona per avviarla.

• Quando si avvia la extension, viene richiesto il timeout T desiderato in secondi. Se per sbaglio non si inserisce un timeout valido (un intero maggiore di 59), esso viene impostato di default a 600.

• Ogni T secondi, viene inviata la query SELECT SYSDATE FROM DUAL; su ogni connessione aperta per impedirne la chiusura.

• Per disattivare il keepalive, premere nuovamente sull'icona.

Note

• Il plugin è dotato di un sistema di log che informa l'utente sulle operazioni compiute.
• ATTENZIONE | La scrittura dei log da parte del plugin porta il focus sulla finestra dei log di SQL Developer, il che potrebbe interferire con la funzionalità di autocompletamento. Tuttavia, la extension è pensata per essere utilizzata con tempi medio-lunghi (es. T=600), e un click ogni 10 minuti per riportare il focus sul documento di lavoro non dovrebbe disturbare l'utente. SISTEMATO NELLA RELEASE 1.2
• ATTENZIONE | Qualche utente ha segnalato la perdita di modifiche apportate alle connessioni (le rinomine e i raggruppamenti) a seguito dell'installazione dell'estensione. Questo non dovrebbe dipendere da un bug nel codice, ma avvisiamo ugualmente che potrebbe succedere.