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: [email protected]
For additional commands, e-mail: [email protected]