Une clarification de la spécification Servlet 3.1 ne permet pas à un implémenteur de l'interface ServletContextListener de configurer par voie de programmation des servlets, des filtres ou des programmes d'écoute si l'interface ServletContextListener n'a pas été déclarée dans le fichier web.xml ou web-fragment.xml ou n'a pas été annotée avec @WebListener. En conséquence, les appels de l'interface ServletContext pour effectuer ces résultats de la configuration par voie de programmation entraîne une exception UnsupportedOperationException. Cette règle marque les classes qui implémentent l'interface javax.servlet.ServletContextListener et ne sont ni annotées par @WebListener ni définies comme élément listener-class dans le fichier web.xml ou web-fragment.xml.
Les méthodes ci-dessous peuvent générer l'exception UnsupportedOperationException :
Pour plus d'informations sur les changements de comportement dans Servlet 3.1, voir la ressource suivante : Changements de comportement dans Servlet 3.1.