2012/11/27 <ma...@apache.org>:
> Author: markt
> Date: Tue Nov 27 10:06:42 2012
> New Revision: 1414053
>
> URL: http://svn.apache.org/viewvc?rev=1414053&view=rev
> Log:
> Populate the SCI Javadoc
>
> Modified:
> tomcat/trunk/java/javax/servlet/ServletContainerInitializer.java
>
> Modified: tomcat/trunk/java/javax/servlet/ServletContainerInitializer.java
> URL:
> http://svn.apache.org/viewvc/tomcat/trunk/java/javax/servlet/ServletContainerInitializer.java?rev=1414053&r1=1414052&r2=1414053&view=diff
> ==============================================================================
> --- tomcat/trunk/java/javax/servlet/ServletContainerInitializer.java
> (original)
> +++ tomcat/trunk/java/javax/servlet/ServletContainerInitializer.java Tue Nov
> 27 10:06:42 2012
> @@ -19,18 +19,35 @@ package javax.servlet;
> import java.util.Set;
>
> /**
> + * ServletContainerInitializers (SCIs) are registered via an entry in the
> + * file META-INF/services/javax.servlet.ServletContainerInitializer that
> must be
> + * included in the JAR file that contains the SCI implementation.
> + * <p>
> + * SCIs processing is performed regardless of the setting of
> metadata-complete.
> + * SCI processing can be controlled be JAR file via fragment ordering. If an
I do not understand the second "be" in the above line.
> + * absolute ordering is defined, the only those fragments included in the
> + * ordering will be scanned. To disable SCI processing completely, an empty
> + * absolute ordering may be defined.
> + * <p>
> + * SCIs register an interest in annotations (class, method or field) or types
> + * via the {@link javax.servlet.HandlesTypes} annotation which is
> + * added to the {@link #onStartup(Set, ServletContext)} method.
I read it that one needs to add @HandlesTypes to the onStartup() method.
I have not used this feature yet, but in our WsSci class the
annotation is placed on the class as a whole, not on that particular
method.
http://svn.apache.org/viewvc/tomcat/trunk/java/org/apache/tomcat/websocket/WsSci.java?view=markup
> + *
> * @since Servlet 3.0
> */
> public interface ServletContainerInitializer {
Best regards,
Konstantin Kolinko
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
