This is an automated email from the ASF dual-hosted git repository.
sseifert pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/sling-org-apache-sling-api.git
The following commit(s) were added to refs/heads/master by this push:
new ec3dcf2 SLING-7194 Document that AdapterManager sorts AdapterFactory
implementations lowest ranking first
ec3dcf2 is described below
commit ec3dcf291b26e833b07a1f9c485bbe713a7ad4d5
Author: sseifert <[email protected]>
AuthorDate: Tue Dec 12 11:40:26 2017 +0100
SLING-7194 Document that AdapterManager sorts AdapterFactory
implementations lowest ranking first
---
src/main/java/org/apache/sling/api/adapter/AdapterFactory.java | 7 +++++++
1 file changed, 7 insertions(+)
diff --git a/src/main/java/org/apache/sling/api/adapter/AdapterFactory.java
b/src/main/java/org/apache/sling/api/adapter/AdapterFactory.java
index 135cd00..01c2460 100644
--- a/src/main/java/org/apache/sling/api/adapter/AdapterFactory.java
+++ b/src/main/java/org/apache/sling/api/adapter/AdapterFactory.java
@@ -31,12 +31,19 @@ import org.osgi.annotation.versioning.ConsumerType;
* used by the {@link AdapterManager} to adapt objects on demand. The
* <code>AdapterFactory</code> services are not really intended to be used by
* clients directly.
+ * </p>
* <p>
* The {@link AdapterManager} implementations ensures that the
* {@link #getAdapter(Object, Class)} method is only called for the combination
* of adaptable and adapter type which is allowed as per the service
* registration properties {@link #ADAPTABLE_CLASSES} and
* {@link #ADAPTER_CLASSES}.
+ * </p>
+ * <p>
+ * If multiple implementations for the same combination of adapter and
adaptable
+ * are registered, the implementation with the lowest service ranking wins
+ * (or with the highest service id, if the ranking is the same).
+ * </p>
*/
@ConsumerType
public interface AdapterFactory {
--
To stop receiving notification emails like this one, please contact
['"[email protected]" <[email protected]>'].
