This is an automated email from the ASF dual-hosted git repository. markt pushed a commit to branch 8.5.x in repository https://gitbox.apache.org/repos/asf/tomcat.git
commit 1da55f61be99808051030075b21a4c118c5c96c9 Author: Igal Sapir <isa...@apache.org> AuthorDate: Sat Oct 3 13:53:51 2020 -0700 Added Javadoc comments for Java 15 --- java/javax/servlet/FilterRegistration.java | 19 +++++++++++----- java/javax/servlet/Registration.java | 5 +++++ java/javax/servlet/ServletRegistration.java | 34 ++++++++++++++++++++++++----- 3 files changed, 48 insertions(+), 10 deletions(-) diff --git a/java/javax/servlet/FilterRegistration.java b/java/javax/servlet/FilterRegistration.java index b9b10ed..3817aff 100644 --- a/java/javax/servlet/FilterRegistration.java +++ b/java/javax/servlet/FilterRegistration.java @@ -20,8 +20,9 @@ import java.util.Collection; import java.util.EnumSet; /** + * Interface through which a Filter may be further configured. + * * @since Servlet 3.0 - * TODO SERVLET3 - Add comments */ public interface FilterRegistration extends Registration { @@ -43,9 +44,12 @@ public interface FilterRegistration extends Registration { public void addMappingForServletNames( EnumSet<DispatcherType> dispatcherTypes, boolean isMatchAfter, String... servletNames); + /** + * Gets the currently available servlet name mappings of the Filter + * represented by this FilterRegistration. * - * @return TODO + * @return a Collection of the Servlet name mappings */ public Collection<String> getServletNameMappings(); @@ -69,13 +73,18 @@ public interface FilterRegistration extends Registration { boolean isMatchAfter, String... urlPatterns); /** + * Gets the currently available URL pattern mappings of the Filter + * represented by this FilterRegistration. * - * @return TODO + * @return a Collection of the URL pattern mappings */ public Collection<String> getUrlPatternMappings(); - public static interface Dynamic - extends FilterRegistration, Registration.Dynamic { + /** + * Interface through which a Filter registered via one of the addFilter + * methods on ServletContext may be further configured. + */ + public static interface Dynamic extends FilterRegistration, Registration.Dynamic { // No additional methods } } diff --git a/java/javax/servlet/Registration.java b/java/javax/servlet/Registration.java index 3eebca5..49ecd9c 100644 --- a/java/javax/servlet/Registration.java +++ b/java/javax/servlet/Registration.java @@ -78,6 +78,11 @@ public interface Registration { */ public Map<String, String> getInitParameters(); + /** + * Interface through which a Servlet or Filter registered via one of the + * addServlet or addFilter methods, respectively, on ServletContext may be + * further configured. + */ public interface Dynamic extends Registration { /** diff --git a/java/javax/servlet/ServletRegistration.java b/java/javax/servlet/ServletRegistration.java index de26618..4b7fd94 100644 --- a/java/javax/servlet/ServletRegistration.java +++ b/java/javax/servlet/ServletRegistration.java @@ -20,27 +20,51 @@ import java.util.Collection; import java.util.Set; /** - * TODO SERVLET3 - Add comments + * Interface through which a Servlet may be further configured. + * * @since Servlet 3.0 */ public interface ServletRegistration extends Registration { /** - * TODO + * Adds a servlet mapping with the given URL patterns for the Servlet + * represented by this ServletRegistration. If any of the specified URL + * patterns are already mapped to a different Servlet, no updates will + * be performed. + * + * If this method is called multiple times, each successive call adds to + * the effects of the former. The returned set is not backed by the + * ServletRegistration object, so changes in the returned set are not + * reflected in the ServletRegistration object, and vice-versa. + * * @param urlPatterns The URL patterns that this Servlet should be mapped to - * @return TODO + * @return the (possibly empty) Set of URL patterns that are already mapped + * to a different Servlet * @throws IllegalArgumentException if urlPattern is null or empty * @throws IllegalStateException if the associated ServletContext has * already been initialised */ public Set<String> addMapping(String... urlPatterns); + /** + * Gets the currently available mappings of the Servlet represented by this + * ServletRegistration. + * + * If permitted, any changes to the returned Collection must not affect this + * ServletRegistration. + * + * @return a (possibly empty) Collection of the currently available mappings + * of the Servlet represented by this ServletRegistration + */ public Collection<String> getMappings(); public String getRunAsRole(); - public static interface Dynamic - extends ServletRegistration, Registration.Dynamic { + /** + * Interface through which a Servlet registered via one of the addServlet + * methods on ServletContext may be further configured. + */ + public static interface Dynamic extends ServletRegistration, Registration.Dynamic { public void setLoadOnStartup(int loadOnStartup); public void setMultipartConfig(MultipartConfigElement multipartConfig); public void setRunAsRole(String roleName); --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org