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);
...
}
}