svn commit: r682725 - /webservices/xmlrpc/trunk/server/src/main/java/org/apache/xmlrpc/server/AbstractReflectiveHandlerMapping.java

[jo...@apache.org]

Author: jochen
Date: Tue Aug  5 07:43:28 2008
New Revision: 682725

URL: http://svn.apache.org/viewvc?rev=682725&view=rev
Log:
XMLRPC-155: Documented that methods are choosen based on their signature.

Modified:
    webservices/xmlrpc/trunk/server/src/main/java/org/apache/xmlrpc/server/AbstractReflectiveHandlerMapping.java

Modified: webservices/xmlrpc/trunk/server/src/main/java/org/apache/xmlrpc/server/AbstractReflectiveHandlerMapping.java
URL: http://svn.apache.org/viewvc/webservices/xmlrpc/trunk/server/src/main/java/org/apache/xmlrpc/server/AbstractReflectiveHandlerMapping.java?rev=682725&r1=682724&r2=682725&view=diff
==============================================================================
--- webservices/xmlrpc/trunk/server/src/main/java/org/apache/xmlrpc/server/AbstractReflectiveHandlerMapping.java (original)
+++ webservices/xmlrpc/trunk/server/src/main/java/org/apache/xmlrpc/server/AbstractReflectiveHandlerMapping.java Tue Aug  5 07:43:28 2008
@@ -122,8 +122,16 @@
      *   <li>The declaring class must not be
      *     {@link java.lang.Object}.</li>
      *   <li>If multiple methods with the same name exist,
-     *     which meet the above conditins, then only the
-     *     first method is valid.</li>
+     *     which meet the above conditins, then an attempt is
+     *     made to identify a method with a matching signature.
+     *     If such a method is found, then this method is
+     *     invoked. If multiple such methods are found, then
+     *     the first one is choosen. (This may be the case,
+     *     for example, if there are methods with a similar
+     *     signature, but varying subclasses.) Note, that
+     *     there is no concept of the "most matching" method.
+     *     If no matching method is found at all, then an
+     *     exception is thrown.</li>
      * </ul>
      * @param pKey Suffix for building handler names. A dot and
      * the method name are being added.