tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Konstantin Kolinko <knst.koli...@gmail.com>
Subject Re: svn commit: r1414053 - /tomcat/trunk/java/javax/servlet/ServletContainerInitializer.java
Date Tue, 27 Nov 2012 10:25:11 GMT
2012/11/27  <markt@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-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org


Mime
View raw message