Verificar uma mudança de comportamento na interface ServletContextListener

Um esclarecimento da especificação Servlet 3.1 agora não permite que um implementador da interface ServletContextListener configure programaticamente servlets, filtros ou listeners, se o ServletContextListener não foi declarado no arquivo web.xml ou no arquivo web-fragment.xml ou não foi anotado com @WebListener. Como resultado como resultado, qualquer chamada na interface ServletContext para executar essa configuração programática resulta em uma mensagem de erro UnsupportedOperationException. Essa regra sinaliza classes que implementam a interface javax.servlet.ServletContextListener e não são anotadas com @WebListener nem são definidas como listener-class no arquivo web.xml ou web-fragment.xml.

Os seguintes métodos podem lançar o UnsupportedOperationException:

• addFilter(String,Class)
• addFilter(String,Filter)
• addFilter(String,String)
• addListener(Class)
• addListener(String)
• addListener(T)
• addServlet(String,Class)
• addServlet(String,Servlet)
• addServlet(String,String)
• createFilter(Class)
• createListener(class)
• createServlet(Class)
• declareRoles(String.....)
• getClassLoader()
• getDefaultSessionTrackingModes()
• getEffectiveSessionTrackingModes()
• getEffectiveMinorVersion()
• getEffectiveMajorVersion()
• getFilterRegistrations()
• getFilterRegistration(String)
• getJSPConfigDescriptor()
• getServletRegistration(String)
• getServletRegistrations()
• getSessionCookieConfig()
• getVirualServerName()
• setInitParameter()
• setSessionTrackingModes(Set<SessionTrackingMode>)

Para obter mais informações sobre esses métodos, veja Interface ServletContext.

Para obter informações adicionais sobre mudanças de comportamento do Servlet 3.1, veja o recurso a seguir: Mudanças de comportamento do Servlet 3.1.