Mailing-List: contact dev-help@tomcat.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Tomcat Developers List" <dev@tomcat.apache.org>
Received-SPF: pass (athena.apache.org: domain of knst.kolinko@gmail.com
 designates 209.85.212.45 as permitted sender)
MIME-Version: 1.0
In-Reply-To: <20121127100644.681A923888E4@eris.apache.org>
References: <20121127100644.681A923888E4@eris.apache.org>
Date: Tue, 27 Nov 2012 14:25:11 +0400
Message-ID: 
 <CABzHfVmRKX-Fc=Ua6o4f1QzMHs=T4H319ZtyiqkoR50v4aWHAg@mail.gmail.com>
Subject: Re: svn commit: r1414053 -
 /tomcat/trunk/java/javax/servlet/ServletContainerInitializer.java
From: Konstantin Kolinko <knst.kolinko@gmail.com>
To: Tomcat Developers List <dev@tomcat.apache.org>
Content-Type: text/plain; charset=ISO-8859-1

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