Implementazione di un carrello e-commerce mediante EJB 3.0

Attraverso questo articolo vedremo come realizzare il carrello di un sito di e-commerce facendo uso degli EJB 3.0. In particolare faremo uso di Session Bean di tipo Stateful, per mantenere lo stato del carrello (la lista dei prodotti scelti dall’utente) fra una richiesta e l’altra.

Sebbene il progetto che svilupperemo sia abbastanza semplice da realizzare, è comunque buona norma quella di separare in moduli l’intera applicazione.
In particolare realizzeremo una Enterprise Application composta dai seguenti sottoprogetti:

• web-carrello
• ejb-carrello
• ejb-carrelloClient
• utils-carrello

A tali progetti farà riferimento il progetto principale: carrello, contenente il file application.xml di configurazione dei vari moduli.

Il risultato finale sarà un file ear (Enterprise Archive), che includerà al suo interno un file war (Web Archive) e delle librerie di ausilio (jar).
Prima di analizzare il modo in cui questi moduli sono inclusi e organizzati all’interno del file ear, esaminiamoli singolarmente, partendo dal progetto che descrive le classi di dominio (ovvero gli oggetti che verranno utilizzati dentro il carrello).

Il progetto utils-carrello

Il progetto utils-carrello, contiene la definizione della classe Oggetto.java, che rappresenta gli oggetti che verranno inseriti all’interno nel carrello.

Per ogni oggetto vengono memorizzati un id (identificativo univoco del prodotto) ed un nome ma nulla vieta, in implementazioni più complesse, di memorizzare informazioni aggiuntive (quali un url della foto che rappresenta l’oggetto, una descrizione etc...)

In ogni caso il progetto verrà tradotto in un file .jar incluso nella cartella lib dell’ear generato.

I progetti ejb-carrelloClient ed ejb-carrello

La definizione dell'EJB Stateful che verrà utilizzato per memorizzare lo stato del carrello consta di due differenti progetti: il primo ejb-carrelloClient contiene la definizione dell'interfaccia, il secondo ejb-carrello invece contiene l'implementazione di tale interfaccia.

Dal momento che l'EJB verrà utilizzato all'interno dell'Application Server, l'interfaccia verrà annotata con @Local:

Come vediamo essa contiene la definizione di tre metodi:

• aggiungi
• rimuovi
• getOggettiCarrello

Il progetto ejb-carrelo contiene quindi la classe (Carrello.java) che implementa l’interfaccia.
Come è possibile notare, tale classe è annotata con @Stateful e contiene l'implementazione dei tre metodi definiti nell'interfaccia oltre ad un costruttore che inizializza la variabile oggetti_carrello che rappresenta il contenuto del carrello stesso.

In particolare il metodo aggiungi effettua l'aggiunta dell'Oggetto passato come argomento alla variabile oggetti_carrello, il metodo rimuovi effettua la rimozione dell'oggetto di cui viene passato l'indice dal carrello, e il metodo getOggettiCarrello restituisce la variabile oggetti_carrello stessa.

Il progetto web-carrello

Il progetto web-carrello infine contiene l’implementazione di quello che è il livello View dell'applicazione di e-commerce che, nel nostro caso si compone di:

• una jsp che rappresenta l'elenco dei prodotti disponibili
• una servlet che inoltra all'EJB Stateful carrello

Se esaminiamo la Servlet, vediamo che questa tramite l'annotazione @EJB inietta nella variabile carrello l'EJB Stateful che abbiamo implementato.

Quindi l'implementazione del metodo doPost (che risponde alle richieste client di tipo POST) lavora in questo modo:

• se il parametro "azione" (passato come parametro della richiesta) ha valore "aggiungi" viene creato un nuovo Oggetto con id e nome passati sempre come parametri della richiesta e viene invocato il metodo aggiungi dell'EJB passando come parametro l'oggetto creato.
• se il parametro "azione" (passato sempre come parametro della richiesta) ha invece valore "rimuovi" viene invocato il metodo rimuovi dell’EJB passando come parametro l'indice dell'elemento del carrello da rimuovere.
• in ogni caso alla fine viene messo nella variabile di sessione carrello, il contenuto del carrello ottenuto invocando il metodo getOggettiCarrello /web-carrello

Per quanto riguarda la index.jsp

<div>
		<div style="font-family:Verdana; text-align:center; background-color: #ddd; border: 1px #ddd solid; width: 330px">
		Prodotti
		</div>
		<div style="border: 1px #ddd solid; width:330px">
			<form method="post" action="./CarrelloServlet" style="margin-top: 5px; margin-bottom:5px; position: relative;">
				<img src="./images/0.jpg" style="width:50px"/>
				<input type="hidden" name="azione" value="aggiungi" />
				<input type="hidden" name="id" value="0" />
				<input type="hidden" name="nome" value="Oggetto 0" />
				<input type="submit" value="Aggiungi Oggetto 0"  style="position: absolute; top:10px; left:50px; border: 1px #ddd solid; height:30px; width:270px; " />
			</form>
			<form method="post" action="./CarrelloServlet" style="margin-top: 5px; margin-bottom:5px; position: relative;">
				<img src="./images/1.jpg" style="width:50px"/>
				<input type="hidden" name="azione" value="aggiungi" />
				<input type="hidden" name="id" value="1" />
				<input type="hidden" name="nome" value="Oggetto 1" />
				<input type="submit" value="Aggiungi Oggetto 1"  style="position: absolute; top:10px; left:50px; border: 1px #ddd solid; height:30px; width:270px; "  />
			</form>
			<form method="post" action="./CarrelloServlet" style="margin-top: 5px; margin-bottom:5px; position: relative;">
				<img src="./images/2.jpg" style="width:50px"/>
				<input type="hidden" name="azione" value="aggiungi" />
				<input type="hidden" name="id" value="2" />
				<input type="hidden" name="nome" value="Oggetto 2" />
				<input type="submit" value="Aggiungi Oggetto 2" style="position: absolute; top:10px; left:50px; border: 1px #ddd solid; height:30px; width:270px; " />
			</form>
		</div>
	</div>

La seconda parte della jsp invece non fa altro che visualizzare tutti i prodotti contenuti nel carrello (recuperando l'ArrayList<Oggetto> dalla variabile di sessione "carrello"):

per ogni prodotto viene creato un form contenente l’immagine rappresentativa dell’oggetto, due campi hidden (“azione” con valore “rimuovi” e “indice” con valore progressivo) e un submit per inviare la richiesta di rimozione del prodotto dal carrello.

	<div>
		<div style="font-family:Verdana; text-align:center; background-color: #ddd; border: 1px #ddd solid; width: 330px">
		Carrello
		</div>
		<div style="border: 1px #ddd solid; width:330px">
		<%	
			ArrayList<Oggetto> contenuto_carrello = (ArrayList<Oggetto>)(session.getAttribute("carrello"));
			if (contenuto_carrello!=null) {
				int indice = 0;
				for (Oggetto oggetto: contenuto_carrello) {
		%>
		<form method="post" action="./CarrelloServlet" style="margin-top: 5px; margin-bottom:5px; position: relative;">
			<img src="./images/<% out.print(oggetto.getId()); %>.jpg" style="width:50px"/>
			<input type="hidden" name="azione" value="rimuovi" />
			<input type="hidden" name="indice" value="<% out.print(indice); %>" />
			<input type="submit" value="Rimuovi <% out.print(oggetto.getNome()); %>"   style="position: absolute; top:10px; left:50px; border: 1px #ddd solid; height:30px; width:270px; "  />
		</form>
		<%
					indice++;
				}
			}
		%>
		</div>
	</div>

Sia le richieste di aggiunta che quelle di rimozione di prodotti sono indirizzate verso l'url /CarrelloServlet web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app ... version="2.5">
<display-name>web-carrello</display-name>
	<welcome-file-list>
		<welcome-file>index.jsp</welcome-file>
	</welcome-file-list>
  	<servlet>
 		<description></description>
 		<display-name>CarrelloServlet</display-name>
 		<servlet-name>CarrelloServlet</servlet-name>
 		<servlet-class>web.servlet.CarrelloServlet</servlet-class>
	</servlet>
	<servlet-mapping>
 		<servlet-name>CarrelloServlet</servlet-name>
 		<url-pattern>/CarrelloServlet</url-pattern>
	</servlet-mapping>
</web-app>

Il progetto carrello

Il progetto carrello come già detto non fa altro che assemblare tutti gli altri progetti in un unico ear: il modo in cui tali progetti sono assemblati è definito all'interno del file application.xml

• il primo contenente la definizione dell'ejb (ejb-carrello.jar
• il secondo contenente la definizione del modulo web-carrello.war

<?xml version="1.0" encoding="UTF-8"?>
<application ... id="Application_ID" version="5">
<display-name>carrello</display-name>
	<module>
	 	<ejb>ejb-carrello.jar</ejb>
	</module>
	<module>
 		<web>
 			<web-uri>web-carrello.war</web-uri>
 			<context-root>web-carrello</context-root>
 		</web>
	</module>
</application>

Nella cartella lib dell’ear generato da eclipse troviamo invece il jar contenente la definizione della classe di ausilio Oggetto.java.

Con Eclipse è possibile generare automaticamente il file application.xml indicando al momento della creazione dell’Enterprise Application Project i progetti dai quali questo dipende e spuntando la casella "Generate application.xml deployment descriptor":

Ti consigliamo anche

Java

Java e Deep Learning, la guida

Java

Quarkus, guida allo stack Java Kubernetes

Java

Sviluppare Blockchain in Java, la guida

Java

Java per i sistemi Embedded, la guida