You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sling.apache.org by dk...@apache.org on 2014/06/06 16:49:42 UTC
svn commit: r1600902 - in /sling/site/trunk/content/documentation/bundles:
mime-type-support-commons-mime.mdtext mimetypes.png
Author: dklco
Date: Fri Jun 6 14:49:42 2014
New Revision: 1600902
URL: http://svn.apache.org/r1600902
Log:
Updating the mime type support page
Added:
sling/site/trunk/content/documentation/bundles/mimetypes.png (with props)
Modified:
sling/site/trunk/content/documentation/bundles/mime-type-support-commons-mime.mdtext
Modified: sling/site/trunk/content/documentation/bundles/mime-type-support-commons-mime.mdtext
URL: http://svn.apache.org/viewvc/sling/site/trunk/content/documentation/bundles/mime-type-support-commons-mime.mdtext?rev=1600902&r1=1600901&r2=1600902&view=diff
==============================================================================
--- sling/site/trunk/content/documentation/bundles/mime-type-support-commons-mime.mdtext (original)
+++ sling/site/trunk/content/documentation/bundles/mime-type-support-commons-mime.mdtext Fri Jun 6 14:49:42 2014
@@ -16,7 +16,7 @@ The Servlet API specification provides a
## Enter Sling: The MimeTypeService
-Already at the start of the Sling project we realized, that just basing the MIME type mapping decisions on the servlet container will not yield acceptable results. For this reason the Apache Sling projects provides a spezialized and configurable service supporting such mappings: The [`MimeTypeService`]({{ refs.http://incubator.apache.org/sling/apidocs/sling5/org/apache/sling/commons/mime/MimeTypeService.html.path }}).
+Already at the start of the Sling project we realized, that just basing the MIME type mapping decisions on the servlet container will not yield acceptable results. For this reason the Apache Sling projects provides a spezialized and configurable service supporting such mappings: The [`MimeTypeService`](/apidocs/sling6/org/apache/sling/commons/mime/MimeTypeService.html).
This service provides access to registered MIME types and their mappings with two methods:
@@ -35,7 +35,7 @@ Two more method allow to programmaticall
Besides the `MimeTypeService` provided by Apache Sling, there is actually more:
-* The [`SlingHttpServletRequest`](http://incubator.apache.org/sling/apidocs/sling5/org/apache/sling/api/SlingHttpServletRequest.html) provides the `getResponseContentType()` method, which returns the preferred *Content-Type* for the response based on the requests extension. This method is implemented by Apache Sling using the `MimeTypeService`. So servlets and scripts may just call this method to set the content type of the response to the desired value.
+* The [`SlingHttpServletRequest`](/apidocs/sling6/org/apache/sling/api/SlingHttpServletRequest.html) provides the `getResponseContentType()` method, which returns the preferred *Content-Type* for the response based on the requests extension. This method is implemented by Apache Sling using the `MimeTypeService`. So servlets and scripts may just call this method to set the content type of the response to the desired value.
* Each Servlet (and JSP scripts) is initialized by Apache Sling with a `ServletContext` instance whose implementation of the `getMimeType(String)` effectively calls the `MimeTypeService.getMimeType(String)` method.
* The Scripting support infrastructure of Sling sets the response content type on behalf of the script to the default value as returned by the `SlingHttpServletRequest.getResponseContentType()` method. At the same time the response character set is also set to `UTF-8` for *text* content types.
@@ -50,7 +50,7 @@ The implementation of the `MimeTypeServi
* Bundle provided mappings. Bundles registered in the OSGi framework may contain MIME type mappings files `META-INF/mime.types` which are loaded automatically by the Apache Sling MIME type mapping support bundle.
* Configuration. Mappings may be supplied by configuration of the `MimeTypeService` implementation as the multi-value string property `mime.types`. Each value of the property corresponds to a line in a MIME type configuration file (see below for the format).
* Registered Mappings. Mappings may be registered with the `MimeTypeService.registerMapping` methods.
-* [`MimeTypeProvider`](http://incubator.apache.org/sling/apidocs/sling5/org/apache/sling/commons/mime/MimeTypeProvider.html). Additional mappings may be provided by service implementing the `MimeTypeProvider` interface. The `MimeTypeService` implementation will call these services in turn until a service returns a mapping provided there is no static configuration to responde to the mapping request.
+* [`MimeTypeProvider`](/apidocs/sling6/org/apache/sling/commons/mime/MimeTypeProvider.html). Additional mappings may be provided by service implementing the `MimeTypeProvider` interface. The `MimeTypeService` implementation will call these services in turn until a service returns a mapping provided there is no static configuration to responde to the mapping request.
Please note, that existing mappings cannot be overwritten later. Thus mappings have an inherent priority:
@@ -62,7 +62,6 @@ Please note, that existing mappings cann
1. Mappings provided by `MimeTypeProvider` services
-
## MIME Type Mapping File Format
The file format for MIME type mapping files is rather simple:
@@ -75,9 +74,8 @@ The file format for MIME type mapping fi
THe data line format described here also applies to configuration provided by the values of the `mime.types` property of the MIME type service configuration. The file format description applies to all `META-INF/mime.types` files provided by the bundles as well as input streams supplied to the `MimeTypeService.registerMimeType(InputStream)` method.
-
## Web Console Plugin
The Apache Sling MIME type mapping support bundle implements a plugin for the Apache Felix Web Console which may be consulted to investigate the current contents of the MIME type mapping tables.
-!mimetypes.png|thumbnail!
\ No newline at end of file
+
\ No newline at end of file
Added: sling/site/trunk/content/documentation/bundles/mimetypes.png
URL: http://svn.apache.org/viewvc/sling/site/trunk/content/documentation/bundles/mimetypes.png?rev=1600902&view=auto
==============================================================================
Binary file - no diff available.
Propchange: sling/site/trunk/content/documentation/bundles/mimetypes.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream