svn commit: r775847 - /incubator/sling/trunk/bundles/commons/mime/src/main/java/org/apache/sling/commons/mime/MimeTypeProvider.java

[fm...@apache.org]

Author: fmeschbe
Date: Mon May 18 07:35:49 2009
New Revision: 775847

URL: http://svn.apache.org/viewvc?rev=775847&view=rev
Log:
JavaDoc

Modified:
    incubator/sling/trunk/bundles/commons/mime/src/main/java/org/apache/sling/commons/mime/MimeTypeProvider.java

Modified: incubator/sling/trunk/bundles/commons/mime/src/main/java/org/apache/sling/commons/mime/MimeTypeProvider.java
URL: http://svn.apache.org/viewvc/incubator/sling/trunk/bundles/commons/mime/src/main/java/org/apache/sling/commons/mime/MimeTypeProvider.java?rev=775847&r1=775846&r2=775847&view=diff
==============================================================================
--- incubator/sling/trunk/bundles/commons/mime/src/main/java/org/apache/sling/commons/mime/MimeTypeProvider.java (original)
+++ incubator/sling/trunk/bundles/commons/mime/src/main/java/org/apache/sling/commons/mime/MimeTypeProvider.java Mon May 18 07:35:49 2009
@@ -17,7 +17,14 @@
 package org.apache.sling.commons.mime;
 
 /**
- * The <code>MimeTypeProvider</code> TODO
+ * The <code>MimeTypeProvider</code> interface defines an API for services
+ * which are asked for MIME type mappings for unknown MIME types or extensions.
+ * <p>
+ * It is important to understand, that services registered with this interface
+ * are only called as a last resort and that the first service asked and
+ * replying with a non-<code>null</code> answer wins. Specifically if a MIME
+ * type mapping is configured by default or as an extension to the MIME type
+ * service, MimeTypeProvider services are not queried.
  * <p>
  * This interface may be implemented by bundles wishing to provide control over
  * how extensions are mapped to MIME types and vice-versa.