From: chang paek <changhyun_paek_at_tmax.co.kr>
Date: Thu, 23 Feb 2012 13:25:44 +0900

Hi, EG members,

My colleague found spec and API mismatch and I am forwarding his report.
Please look into this report.

Regards,

Chang.


---------- Forwarded message ----------
From: Eu-gene Chung<euigeun_chung_at_tmax.co.kr>
Date: 2012/2/23
Subject: [Servlet 3.0 Spec] unmatched contents between ServletContext API
and Spec. Document
To: 백창현 <changhyun_paek_at_tmax.co.kr>
Cc: was1_at_tmax.co.kr


Mr, Paek. Please forward this e-mail to EG.


I found that there were unmatched contents between ServletContext API and
Spec. Document.

API

public void addListener(Class <? extends EventListener> listenerClass);

     * @throws IllegalArgumentException if the given <tt>listenerClass</tt>
     * does not implement any of the above interfaces, or if it implements
     * {_at_link ServletContextListener} and this ServletContext was not passed
     * to {_at_link ServletContainerInitializer#onStartup}

Spec. Document

4.4.3.1 void addListener(String className)

If the ServletContext was passed to the ServletContainerInitializer’s
onStartup method, then the class with the given name MAY also implement
javax.servlet.ServletContextListener in addition to the interfaces listed
above.



API says that the method throws IllegalArgumentException if
ServletContextListener is NOT added by
ServletContainerInitializer#onStartup.
But Spec. Document says that it can be tolerant.
This unmatched explanation can also be found in other addListener methods.

-- 
Best regards,
Eugene Chung (Korean : 정의근)