OC4J prodotto dalla Oracle è un container di applicazioni J2EE scritto interamente in java, si integra perfettamente con tutti i prodotti di casa Oracle. E' un prodotto certificato per il jdk 1.3.xx ma garantisce ottime prestazioni anche con jdk superiori, poiché scritto in java è pienamente cross-platform.
OC4J oltre ad essere un container per JSP, Servlet ed EJB rispetta anche molte altre specifiche J2EE che riporto qui in una piccola tabella:

Per prima cosa bisogna scaricare oc4j reperibile all'indirizzo http://otn.oracle.com/software/products/ias/devuse.html sotto la voce - Oracle9iAS J2EE Downloads - il file ha dimensione 21Mb ed è multipiattaforma poiché è scritto interamente in java.
Per scaricare lo zip è necessaria la registrazione gratuita al sito della Oracle. Una volta scaricato il file oc4j_extended.zip si può estarre in una directory a piacere ad esempio C:\OC4J. Se lo zip è stato estratto correttamente dovremmo ottenere una struttura tipo quella in figura:

Fig. 1 Installazione di OC4J

Oc4j è stato sviluppato con il jdk1.3 di java standard edition quindi se si sviluppa con un jdk più recente (personalmente utilizzo il jdk1.4.1), bisogna sovrascrivere il file tools.jar della directory \jdk\ lib\ di oc4j con quello dalla propria directory di java, altrimenti jsp o servlet etc... potrebbero non essere compilate correttamente dal container.

 Fig. 2 Installazione di OC4J

Eseguita questa operazione si può proseguire con l' installazione del container.I passi da seguire sono aprire una shell dos, portarsi sotto la directory C:\OC4J\j2ee\home e lanciare il comando java -jar oc4j.jar -install. L'istallazione dura al massimo cinque minuti (ma in realtà appena pochi secondi) nell' ultima fase OC4J chiederà di digitare la password per poter usare la console di amministrazione a linea di comando. Una volta inserita la password l'installazione può considerarsi conclusa.

 Fig. 3 Installazione di OC4J

Appena completata la procedura di installazione, nella directory \j2ee\home si trovano tutti i file necessari per far girare OC4J e per la sua configurazione.

Fig. 4 Installazione di OC4J

All'interno della directory config\ sono collacati i file xml che servono per configurare il container e le webapp deployate al suo interno, nella cartella application andranno inserite tutte le nostre webapp, volendo si possono anche creare diverse directory per ogni applicazione che collochiamo nel container; se invece si vogliono provare singole JSP o servlet queste dovranno essere inserite nella cartella default-web-app.
Nella cartella demo possiamo trovare molti esempi relativi allo sviluppo di webapp contenenti ejb con relativi file di configurazione per una corretta installazione nel container, queste applicazioni richiedono l'utillizzo di Ant per essere compilate (Se non conoscete Ant potete leggere l'articolo relativo).
Sempre in questa directory sono presenti altri file importanti come il file oc4j.jar che serve per startare il server, e il file admin.jar cioè la console di amministrazione del container a linea di comando.
OC4J si mette in ascolto sulla porta 8888, quindi per poter verificare se l'installazione sia andata a buon fine si può aprire IE (o un altro browser) e digitare l'indirizzo http://host:8888 per accedere alla pagina di default del container dove abbiamo la possibilità di controllare delle JSP e delle Servlet di prova (dovrebbe essere una procedura famigliare per chi ha già utilizzato Tomcat).Per accedere alle nostre applicazioni bisogna digitare l'indirizzo: http://host:8888/mywebapp.
Per startare il container basta portarsi a linea di comando sulla directory \j2ee\home e digitare:
java -jar oc4j.jar

per vedere tutte le possibili opzioni con cui lanciare questo comando basta digitare :
java -jar oc4j.jar -help

Admin.jar è un tool di amministrazione per il server a linea di comando che si può rilevare molto utile. Può essere comodo per stoppare il container, per ristartarlo e per altre utilità come deployare un ear (ovviamente va lanciato con OC4J attivo). Questo tool usa l' OC4J Remote Method Invocation come protocollo per connettersi al server OC4J, quindi bisogna collegarsi all'indirizzo ormi://localhost:23791. I parametri di questa connessione sono modificabili tramite il file rmi.xml residente sotto \j2ee\home\config.
Quindi per utilizzare la console di amministrazione a linea di comando bisogna portarsi sulla directory \j2ee\home e digitare:
java -jar admin.jar ormi://<host>:23791 <user> <pwd> -option

Host identifica la macchina su cui si trova il container, user identifica l'utente con diritti di amministrazione che si sta connettendo e pwd la password per quell'utente. Se ci connettiamo come admin possiamo utilizzare la password che abbiamo inserito in fase di installazione.Per vedere tutte le possibili opzioni digitare:
java -jar admin.jar ormi://localhost:23791 -help

Ecco alcuni esempi:
OC4J individua in modo automatico le modifiche apportate nella applicazioni definite nel server.xml e le ricarica automaticamente. A volte si potrebbe avere la necessità di ristartare il server quando si rideploya un'applicazione; ad esempio nel caso in cui vengano modificati i file data-sources.xml, rmi.xml o principals.xml.

• Il comando da eseguire per ristartare è:
java -jar admin.jar ormi://localhost:23791 admin lupo -restart

• Se la JVM (Java Virtual Machine) non risponde o non accetta i messaggi RMI la procedura da seguire è quella di terminare la stessa JVM da processi attivi.

• Per stoppare OC4J basta eseguire il seguente comando:
java -jar admin.jar ormi://localhost:23791 admin lupo -shutdown

• Se lo shutdown non avviene si può forzare l'arresto passando al comando precedente il parametro force in questo modo:
java -jar admin.jar ormi://localhost:23791 admin lupo -shutdown force. Questo comando potrebbe anche non effettuare il kill del processo; tutto dipende dal sistema operativo su cui è installato il container.

Creiamo una semplice webapp, facciamone un war e proviamo a deployarlo su oc4j. Una volta ottenuto il file war ad esempio (per essere originali) prova.war copiamo il file all'interno della directory \j2ee\home\applications\ di seguito apriamo il file http-web-site.xml residente all'interno della directory \j2ee\home\config e aggiungiamo un tag

<web-site port="8888" display-name="Oracle9iAS Containers for J2EE HTTP Web Site">
   <default-web-app application="default" name="defaultWebApp" />
   <web-app application="default" name="dms0" root="/dms0" />
   <web-app application="default" name="dms" root="/dmsoc4j" />
   <web-app application="default" name="prova" root="/myapp" />
   <!-- Access Log, where requests are logged to -->
   <access-log path="../log/http-web-access.log" />
</web-site>

Con l'attributo application facciamo riferimento al nome della webapp definito nel server.xml ma questo avviene solo quando abbiamo un ear(lo vedremo successivamente). Siccome nel caso esaminato abbiamo solo un war, bisogna valorizzare l'attributo con default; in questo modo il container capisce che si sta deployando semplicemente un file war e che deve fare riferimento al file application.xml.
Con l'attributo name si fa riferimento al nome del war senza estensione, e con root identifichiamo l'uri per raggiungere la nostra webapp (http://localhost:8888/myapp).
In seguito sempre nella stessa directory dobbiamo modificare il file application.xml inserendo un tag di questo genere:

<orion-application autocreate-tables="true" default-data-source="jdbc/OracleDS">
   <web-module id="prova" path="../../home/applications/prova.war" />
   <web-module id="defaultWebApp" path="../../home/default-web-app" />
   <web-module id="dms0" path="../../home/applications/dms0.war" />
   <web-module id="dms" path="../../home/applications/dms.war" />
    .........
</orion-application>

Per deployare un file ear il procedimento è simile al precedente questa volta i file xml che entrano in gioco sono: il server.xml e l'http-web-site.xml che si trovano sempre all'interno di \j2ee\home\config il tag da aggiungere nel primo file è il seguente :

<application-server application-directory="../applications" deployment-directory="../application-deployments"
connector-directory="../connectors">
 <rmi-config path="./rmi.xml" />
   <!-- JMS-server config link, uncomment to activate the JMS service -->
   <jms-config path="./jms.xml" />
   <log>
        <file path="../log/server.log" />
   </log>
   <global-application name="default" path="application.xml" />
   <global-web-app-config path="global-web-application.xml" />
   <!-- <web-site path="./secure-web-site.xml" /> -->
   <web-site path="./http-web-site.xml" />
   <application name="prova" path="../applications/prova.ear" />
.....
</application-server>

L'attributo name rappresenta il nome dell'applicazione; path il percorso di dove si trova l'ear. Volendo si potrebbe aggiungere anche un altro attributo auto-start che può prendere il valore di true o false: se viene settato a true fa in modo che l'applicazione venga automaticamente ristartata insieme al processo equivalente del container; con il valore false l'applicazione non viene ristartata insieme al container.
Mentre all' http-web-site.xml dobbiamo aggiungere :

<web-site port="8888" display-name="Oracle9iAS Containers for J2EE HTTP Web Site">
     <default-web-app application="default" name="defaultWebApp" />
     <web-app application="default" name="dms0" root="/dms0" />
     <web-app application="default" name="dms" root="/dmsoc4j" />
     <web-app application="prova" name="prova" root="/myapp" />
     <!-Access Log, where requests are logged to -->
     <access-log path="../log/http-web-access.log" />
</web-site>

Questa volta all'attributo application possiamo dare un valore diverso da default poichè è presente l'ear.
Mi raccomado i valori degli attributi application(l'http-web-site.xml) e name(server.xml) devo essere uguali!!

Se non ci vogliamo "complicare la vita" con i file xml possiamo optare, per deployare un ea,r (si può fare solo con gli enterprise archive) con il tool admin.jar tramite l'opzione -deploy :
java -jar admin.jar ormi://<host>:23791 <user> <pwd> -deploy -file <filename> -deploymentName < deploymentName > -targetpath <targetpath>

Nel nostro caso potremmo digitare:
java -jar admin.jar ormi://localhost:23791 admin lupo -deploy -file /myapp/prova.ear -deploymentName prova

Questo comando copia l'ear nella dir applications di OC4J e crea la riga

<application name="prova" path="../applications/prova.ear" />

nel file server.xml visto prima.
Dopo di che dobbiamo "bindare" la nostra webapp sul server OC4J quindi digitiamo:
java -jar admin.jar ormi://localhost:23791 admin lupo -bindWebApp <app-deploy-name> <web-app-name> <web-site-name> <context-root>

Ad esempio :
java -jar admin.jar ormi://localhost:23791 admin lupo -bindWebApp prova provawar file:config/http-web-site.xml /prova

praticamente con questa istruzione andiamo ad inserire nel file http-web-site.xml questa riga:
<web-app application="prova" name="prova" root="/myapp" />

Queste operazioni possono essere eseguite sia con oc4j attivo che non, tranne nel caso in cui l'applicazione venga deployata da linea di comando con il tool admin.jar (in questo caso OC4J deve essere regolarmente startato). Se tutte è andato a buon fine aprendo IE possiamo ammirare la nostra prima webapp con OC4J.
Prima di fare questo se non è stato startato OC4J bisogna portarsi da riga di comando su \j2ee\home e lanciare il comando: java -jar oc4j.jar

Emiliano Belli