UrlRewriteFilter: emulare mod_rewrite in Java

UrlRewriteFilter: emulare mod_rewrite in Java

UrlRewriteFilter è una libreria nata con l’intento di emulare le funzionalità del modulo mod_rewrite di Apache: è stata utilizzata in molte applicazioni ed integrata anche in framework più complessi, ad esempio Appfuse e Spring.

Ecco alcune delle sue caratteristiche più evidenti:

  • ridotto consumo di risorse: l’archivio jar pesa poco meno di 200k, e non ha dipendenze verso altre librerie di terze parti;
  • focalizzazione su poche funzionalità;
  • documentazione piuttosto completa e semplice da comprendere.

Il principale punto a suo favore è chiaramente che moltissimi sviluppatori web hanno conoscenze pregresse dell’utilissimo mod_rewrite di Apache, e sanno quindi già “cosa aspettarsi” da UrlRewriteFilter.

Vediamo come utilizzare questa libreria per i nostri progetti.

Installazione

L’installazione di UrlRewriteFilter è molto semplice:

  • si scarica la libreria dal sito ufficiale. Alla data di stesura di questo articolo (Luglio 2011) l’ultima versione disponibile è la 3.2.0;
  • si copia la libreria nella directory /WEB-INF/lib della web application;
  • si crea il file di configurazione /WEB-INF/urlrewrite.xml (vedi sotto).

Ecco il codice sorgente di urlrewrite.xml:


<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE urlrewrite PUBLIC "-//tuckey.org//DTD UrlRewrite 3.2//EN"
        "http://tuckey.org/res/dtds/urlrewrite3.2.dtd">
<urlrewrite>
</urlrewrite>

Nei prossimi paragrafi esploreremo alcune regole icolarmente utili per il rewrite definibili all’interno di urlrewrite.xml.

Clean URLs

Le clean URLs sono uno stratagemma molto utilizzato nelle web application, soprattutto nei CMS (Content Management Systems), per via della facile fruibilità per gli utenti umani e per i crawler dei motori dei ricerca.

Di fatto si tratta di creare una versione “amichevole” di URL altrimenti anonime, eccone un esempio:

  • abbiamo un articolo dal titolo “Tutorial: impariamo a programmare in Java”;
  • sul database l’ID dell’articolo è 42;
  • l’articolo è stato scritto in data 30/07/2011;
  • attualmente per accedere all’articolo è sufficiente utilizzare la URL: 
    http://www.example.com/show_article.jsp?article_id=42

Per il momento non ci interessa l’implementazione reale della pagina show_article.jsp, che quindi sarà molto semplice:


<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<html>
<head>
  <title>show_article.jsp</title>
</head>
<body>
  Mostra articolo con ID = <%=request.getParameter("article_id")%>
</body>
</html>

Utilizzare una URL del genere ha diversi problemi, primo fra tutti il fatto che il percorso per arrivare ai contenuti è completamente anonimo, trattandosi di un semplice numero.

Avere una URL più leggibile porta diversi vantaggi:

  • comprensibilità: invoglia l’utente a cliccarci sopra, perché già dal link si può intuire di cosa parlerà l’articolo;
  • statistiche: per chi si occupa delle statistiche del sito avere URL “parlanti” semplifica tantissimo l’interpretazione di tabelle e grafici;
  • indicizzazione: i motori di ricerca hanno un elemento in più da analizzare, e le url possono essere utilizzate proficuamente per migliorare l’indicizzazione dei contenuti (ad esempio introducendo parole chiave nella url stessa), e possono rappresentare percorsi strutturati di navigazione.

Ecco gli accorgimenti più utilizzati per rendere le URL più facili da comprendere:

  • inserimento del titolo come nome della pagina, ovviamente rimuovendo tutti i caratteri non ammessi, la punteggiatura, eccetera. Nel nostro caso, la pagina potrebbe chiamarsi
    tutorial-impariamo-a-programmare-in-java.html
  • inserimento della data di pubblicazione (eventualmente limitandosi all’anno o al mese) nel path. Ad esempio:
    /2011/07/tutorial-impariamo-a-programmare-in-java.html

Questi elementi della URL vengono chiamati in gergo “slug”, la cui traduzione italiana è “lumacone” (!); in effetti il loro compito è allungare le URL, per guidare l’utente verso i contenuti facendogli seguire una “traccia” facilmente visibile…

Un miglioramento ulteriore può essere costituito dall’eliminazione dei parametri (o almeno dalla loro riduzione): in questo modo i contenuti apparirebbero agli utenti e ai motori di ricerca come un insieme strutturato e ordinato, facilitandone la fruizione e la ricerca.

Vediamo quindi alcuni esempi, di complessità crescente: 

http://www.example.com/article/42.html
http://www.example.com/article/42/tutorial-impariamo-a-programmare-in-java.html
http://www.example.com/2011/07/article/42/tutorial-impariamo-a-programmare-in-java.html

Decisamente meglio, non trovate? Possiamo inserire le regole necessarie nel file di configurazione /WEB-INF/urlrewrite.xml, inserendo queste righe all’interno dell’elemento <urlrewrite>: 


<rule>
  <from>^/article/(d+).html</from>
  <to>/show_article.jsp?article_id=$1</to>
</rule>
<rule>
  <from>^/article/(d+)/.*.html</from>
  <to>/show_article.jsp?article_id=$1</to>
</rule>
<rule>
  <from>^/(d+)/(d+)/article/(d+)/.*.html</from>
  <to>/show_article.jsp?article_id=$3</to>
</rule>

Ecco qualche dettaglio sul funzionamento:

  • ogni regola è contenuta in un elemento <rule>;
  • l’elemento <from> contiene una regular expression che fa un match sulla URL della richiesta HTTP;
  • l’elemento <to> invece è utilizzato per redirigere il flusso su un’altro path. Il simbolo "$1" è una cosiddetta back reference, ovvero un riferimento (il primo) identificato dalle parentesi nell’espressione utilizzata in <from>;
  • il metodo di redirezione di default (per i cui dettagli rimandiamo alla documentazione ufficiale di UrlRewriteFilter) è un FORWARD, quindi il client non si accorge di questa “traduzione”.

Un mapping migliore per le servlet

Il servlet mapping serve per indicare al container quando richiamare una certa servlet; il meccanismo standard, che viene configurato dall’elemento <servlet-mapping> nel file web.xml, è sempre stato piuttosto carente, ed una delle principali lamentele (rimasta purtroppo inascoltata anche nella versione 3.0 delle specifiche) è il fatto che sia impossibile eseguire dei mapping complessi in web.xml; le possibilità infatti sono molto limitate:

  • se inizia con uno slash, è utilizzato per identificare un path:
    • /miopath1/*: tutti i path che iniziano per /miopath1/
    • /miopath2: esattamente il /miopath2
  • se inizia con un asterisco, è utilizzato per mappare delle estensioni di file: .html, .do, .pincopallino e così via.

Chiaramente una delle possibili migliorie sarebbe poter utilizzare le regular expression, ed è qui che UrlRewriteFilter ci vene in aiuto; possiamo infatti delegare l’esecuzione di una chiamata HTTP ad un metodo di una classe, che non deve essere per forza una servlet ma basta che il metodo in questione sia pubblico e che abbia i parametri HttpServletRequest e HttpServletResponse:

Nell’esempio che segue vogliamo intercettare tutte le chiamate a pagine con estensione *.html in un qualsiasi sotto-path di /app/, e di far gestire la richiesta alla classe it.html.examples.MiaServlet. Ecco la regola da inserire in urlrewrite.xml: 


<rule>
  <from>/app/.*.html</from>
  <run class="it.html.examples.MiaServlet" method="mioMetodo" />
</rule>

mentre questo è il codice della “servlet” (come viene impropriamente definita sulla documentazione): 


package it.html.examples;
import java.io.IOException;
import javax.servlet.http.*;
public class MiaServlet {
    public void mioMetodo(HttpServletRequest req, HttpServletResponse resp) throws IOException {
        resp.getWriter().println("MiaServlet.mioMetodo() invocato!");
    }
}

Ecco alcune URL che vengono correttamente intercettate:

/app/bla.html
/app/bla.html?param1=1¶m2=2
/app/sottopath/bla.html
/app/sottopath/bla.html
/app/bla1.bla2.html?param1=1¶m2=2
/app/bla1.bla2.html?param1=1¶m2=2

Qualche link di approfondimento:

I Video di HTML.it

Stefano Maraspin, Agile per progetti di valore