Author: markt
Date: Tue Oct 14 19:21:04 2014
New Revision: 1631845

URL: http://svn.apache.org/r1631845
Log:
Java 8 Javadoc issues for o.a.c.webresources package

Modified:
    tomcat/trunk/java/org/apache/catalina/webresources/JarResourceSet.java
    tomcat/trunk/java/org/apache/catalina/webresources/JarWarResourceSet.java
    
tomcat/trunk/java/org/apache/catalina/webresources/TomcatURLStreamHandlerFactory.java

Modified: tomcat/trunk/java/org/apache/catalina/webresources/JarResourceSet.java
URL: 
http://svn.apache.org/viewvc/tomcat/trunk/java/org/apache/catalina/webresources/JarResourceSet.java?rev=1631845&r1=1631844&r2=1631845&view=diff
==============================================================================
--- tomcat/trunk/java/org/apache/catalina/webresources/JarResourceSet.java 
(original)
+++ tomcat/trunk/java/org/apache/catalina/webresources/JarResourceSet.java Tue 
Oct 14 19:21:04 2014
@@ -55,6 +55,9 @@ public class JarResourceSet extends Abst
      *                          org.apache.catalina.WebResourceSet} where
      *                          resources will be served from. E.g. for a
      *                          resource JAR, this would be 
"META-INF/resources"
+     *
+     * @throws IllegalArgumentException if the webAppMount or internalPath is
+     *         not valid (valid paths must start with '/')
      */
     public JarResourceSet(WebResourceRoot root, String webAppMount, String 
base,
             String internalPath) throws IllegalArgumentException {

Modified: 
tomcat/trunk/java/org/apache/catalina/webresources/JarWarResourceSet.java
URL: 
http://svn.apache.org/viewvc/tomcat/trunk/java/org/apache/catalina/webresources/JarWarResourceSet.java?rev=1631845&r1=1631844&r2=1631845&view=diff
==============================================================================
--- tomcat/trunk/java/org/apache/catalina/webresources/JarWarResourceSet.java 
(original)
+++ tomcat/trunk/java/org/apache/catalina/webresources/JarWarResourceSet.java 
Tue Oct 14 19:21:04 2014
@@ -56,6 +56,9 @@ public class JarWarResourceSet extends A
      *                          org.apache.catalina.WebResourceSet} where
      *                          resources will be served from. E.g. for a
      *                          resource JAR, this would be 
"META-INF/resources"
+     *
+     * @throws IllegalArgumentException if the webAppMount or internalPath is
+     *         not valid (valid paths must start with '/')
      */
     public JarWarResourceSet(WebResourceRoot root, String webAppMount,
             String base, String archivePath, String internalPath)

Modified: 
tomcat/trunk/java/org/apache/catalina/webresources/TomcatURLStreamHandlerFactory.java
URL: 
http://svn.apache.org/viewvc/tomcat/trunk/java/org/apache/catalina/webresources/TomcatURLStreamHandlerFactory.java?rev=1631845&r1=1631844&r2=1631845&view=diff
==============================================================================
--- 
tomcat/trunk/java/org/apache/catalina/webresources/TomcatURLStreamHandlerFactory.java
 (original)
+++ 
tomcat/trunk/java/org/apache/catalina/webresources/TomcatURLStreamHandlerFactory.java
 Tue Oct 14 19:21:04 2014
@@ -34,6 +34,8 @@ public class TomcatURLStreamHandlerFacto
      * Obtain a reference to the singleton instance. It is recommended that
      * callers check the value of {@link #isRegistered()} before using the
      * returned instance.
+     *
+     * @return A reference to the singleton instance
      */
     public static TomcatURLStreamHandlerFactory getInstance() {
         getInstanceInternal(true);
@@ -93,6 +95,8 @@ public class TomcatURLStreamHandlerFacto
      * Release references to any user provided factories that have been loaded
      * using the provided class loader. Called during web application stop to
      * prevent memory leaks.
+     *
+     * @param classLoader The class loader to release
      */
     public static void release(ClassLoader classLoader) {
         Iterator<URLStreamHandlerFactory> iter = 
instance.userFactories.iterator();
@@ -130,6 +134,9 @@ public class TomcatURLStreamHandlerFacto
      * {@link URL#setURLStreamHandlerFactory(URLStreamHandlerFactory)} and
      * Tomcat needs to register a handler, provide a mechanism to allow
      * applications to register their own handlers.
+     *
+     * @param factory The user provided factory to add to the factories Tomcat
+     *                has alredy registered
      */
     public void addUserFactory(URLStreamHandlerFactory factory) {
         userFactories.add(factory);



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org

Reply via email to