(tomcat) branch 9.0.x updated: Update javadoc

[remm]

This is an automated email from the ASF dual-hosted git repository.

remm pushed a commit to branch 9.0.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git


The following commit(s) were added to refs/heads/9.0.x by this push:
     new 8f5e3b8e15 Update javadoc
8f5e3b8e15 is described below

commit 8f5e3b8e15d8fd9ff3099223a510d9c82aa51774
Author: remm <r...@apache.org>
AuthorDate: Wed Oct 23 13:19:56 2024 +0200

    Update javadoc
    
    Cleanup exception list.
---
 .../apache/catalina/servlets/WebdavServlet.java    | 29 ++++++++++++++++------
 1 file changed, 21 insertions(+), 8 deletions(-)

diff --git a/java/org/apache/catalina/servlets/WebdavServlet.java 
b/java/org/apache/catalina/servlets/WebdavServlet.java
index 3e9a69247a..f36dfc0892 100644
--- a/java/org/apache/catalina/servlets/WebdavServlet.java
+++ b/java/org/apache/catalina/servlets/WebdavServlet.java
@@ -23,7 +23,6 @@ import java.io.Serializable;
 import java.io.StringReader;
 import java.io.StringWriter;
 import java.io.Writer;
-import java.lang.reflect.InvocationTargetException;
 import java.net.URI;
 import java.net.URISyntaxException;
 import java.nio.charset.StandardCharsets;
@@ -136,11 +135,26 @@ import org.xml.sax.SAXException;
  * access will be able to edit content available via 
http://host:port/context/content using
  * http://host:port/context/webdavedit/content
  * <p>
- * There are some known limitations of this Servlet due to it not implementing 
PROPPATCH and PROPFIND methods support
- * for dead properties. The Servlet does provide extension points to add 
support for some as required by user. Details
- * of these limitations and progress towards addressing them are being tracked 
under
- * <a href="https://bz.apache.org/bugzilla/show_bug.cgi?id=69046";>bug 
69046</a>.
- * </p>
+ * The Servlet provides support for arbitrary dead properties on all resources 
(dead properties are properties
+ * whose values are not protected by the server, such as the content length of 
a resource). By default the Servlet
+ * will use non persistent memory storage for them. Persistence can be 
achieved by implementing
+ * the <code>PropertyStore</code> interface and configuring the Servlet to use 
that store.
+ * The <code>propertyStore</code> init-param allows configuring the classname 
of the store to use, while the
+ * parameters in the form of <code>store.xxx</code> will be set on the store 
object as bean properties.
+ * For example, this would configure a store with class 
<code>com.MyPropertyStore</code>, and set its field
+ * <code>myName</code> to value <code>myValue</code>:
+ *
+ * <pre>
+ *  &lt;init-param&gt;
+ *    &lt;param-name&gt;propertyStore&lt;/param-name&gt;
+ *    &lt;param-value&gt;com.MyPropertyStore&lt;/param-value&gt;
+ *  &lt;/init-param&gt;
+ *  &lt;init-param&gt;
+ *    &lt;param-name&gt;store.myName&lt;/param-name&gt;
+ *    &lt;param-value&gt;myValue&lt;/param-value&gt;
+ *  &lt;/init-param&gt;
+ * </pre>
+ * <p>
  *
  * @see <a href="https://tools.ietf.org/html/rfc4918";>RFC 4918</a>
  */
@@ -319,8 +333,7 @@ public class WebdavServlet extends DefaultServlet 
implements PeriodicEventListen
                         }
                     }
                 }
-            } catch (ClassNotFoundException | InstantiationException | 
IllegalAccessException
-                    | IllegalArgumentException | InvocationTargetException | 
NoSuchMethodException | SecurityException e) {
+            } catch (Exception e) {
                 log(sm.getString("webdavservlet.storeError"), e);
             }
         }


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