Filtres dans Servlet

Les filtres typiquement eux-m�mes ne cr�ent pas des r�ponses, mais fournissent � la place les fonctions universelles qui peuvent ��tre attach�es�� n'importe quel type du servlet ou de page de JSP.

Importance des filtres dans Servlet

Les filtres sont les importants pour un certain nombre de raisons.

D'abord, ils fournissent la capacit� encapsulent se reproduire charge dans les unit�s r�utilisables. Les r�alisateurs organis�s sont constamment sur la surveillance pour des mani�res modularize leur code. Le code modulaire est plus maniable et documentable, est plus facile � corriger, et si fait bien, peut �tre r�utilis� dans des autres qui placent.

En second lieu, des filtres peuvent �tre utilis�s pour transformer la r�ponse d'un servlet ou d'une page de JSP. Un terrain communal chargent pour l'application de Web est de composer des donn�es envoy�es de nouveau au client. De plus en plus les clients ont besoin du format (par exemple, WML) autre que le HTML juste. Pour adapter � ces clients, il y a habituellement un composant fort de transformation ou du filtrage dans enti�rement d�crit l'application de Web. Beaucoup de servlets et r�cipients de JSP ont pr�sent� les m�canismes de propri�t� industrielle de filtre, ayant pour r�sultat un gain pour le r�alisateur qui se d�ploie sur ce r�cipient, mais pour r�duire la r�utilisabilit� d'un tel code. Avec l'introduction des filtres en tant qu'�l�ment des sp�cifications de Java Servlet, les r�alisateurs ont maintenant l'occasion d'�crire les composants r�utilisables de transformation qui sont portatifs � travers des r�cipients.

Fonction des filtres

Les filtres peuvent ex�cuter beaucoup de diff�rents types de fonction :

Authentification-Bloquant des demandes bas�es sur l'identit� d'utilisateur.
Cartes de conversion-Graduation d'image, et ainsi de suite.
Notant et auditer-D�pistant des utilisateurs d'une application de Web.
T�l�chargements de compression-Fabrication de donn�es plus petits.
Localisation-Optimisation de la demande et de la r�ponse vers un lieu particulier.
Transformations de XSL/T des r�ponses de contenu-Optimisation d'application de Web de XML � plus ce un type de client.

M�thode de filtres

La m�thode la plus importante dans l'interface de filtre est la m�thode de doFilter, qui est le coeur du filtre. Cette m�thode effectue habituellement certaines des actions suivantes :

Examine les en-t�tes de demande
Adapte l'objet de demande s'il souhaite modifier des en-t�tes ou des donn�es de demande ou bloquer la demande enti�rement
Appelle la prochaine entit� dans la cha�ne de filtre.
Adapte l'objet de r�ponse s'il souhaite modifier des en-t�tes ou des donn�es de r�ponse

Si le filtre courant est le dernier filtre dans la cha�ne qui finissent avec le servlet de cible, la prochaine entit� est la ressource � l'extr�mit� de la cha�ne ; autrement, c'est le prochain filtre qui a �t� configur� dans la GUERRE. Il appelle la prochaine entit� en appelant la m�thode de doFilter sur l'objet � cha�nes (passant dans la demande et la r�ponse il s'est appel� avec, ou les versions envelopp�es qu'il a pu avoir cr��es). Alternativement, il peut choisir de bloquer la demande en ne faisant pas l'appel pour appeler la prochaine entit�. Dans le dernier cas, le filtre est responsable du remplissage dehors la r�ponse. Examine des en-t�tes de r�ponse apr�s qu'il ait appel� le prochain filtre dans les jets de cha�ne une exception pour indiquer une erreur dans le traitement en plus du doFilter, vous doit mettre en application l'init et d�truire des m�thodes. La m�thode d'init s'appelle par le r�cipient quand le filtre est instantiated. Si vous souhaitez passer des param�tres d'initialisation au filtre vous les recherchez de l'objet de FilterConfig pass� � l'init.

Exemple d'utiliser des filtres dans Servlet

L'exemple suivant appel� HitCounter indique le nombre de coups faits dans un site Web paricular

public final class HitCounterFilter implements Filter
{
private FilterConfig filterConfig = null;
public void init(FilterConfig filterConfig)
throws ServletException
{

this.filterConfig = filterConfig;
}
public void destroy()
{
this.filterConfig = null;
}
public void doFilter(ServletRequest request,
ServletResponse response, FilterChain chain)
throws IOException, ServletException
{
if (filterConfig == null)
return;
StringWriter sw = new StringWriter();
PrintWriter writer = new PrintWriter(sw);
Counter counter = (Counter)filterConfig.
getServletContext().
getAttribute("hitCounter");
writer.println();
writer.println("===============");
writer.println("The number of hits is: " +
counter.incCounter());
writer.println("===============");

// Log the resulting string
writer.flush();
filterConfig.getServletContext().
log(sw.getBuffer().toString());

...
chain.doFilter(request, wrapper);
...
}
}