nsIMIMEService

IID:5b3675a1-02db-4f8f-a560-b34736635f47
Inherits From:nsISupports

The MIME service is responsible for mapping file extensions to MIME-types (see RFC 2045). It also provides access to nsIMIMEInfo interfaces and acts as a general convenience wrapper of nsIMIMEInfo interfaces.

The MIME service maintains a database with a one MIME type to many file extensions rule. Adding the same file extension to multiple MIME types is illegal and behavior is undefined.

This interface is intended to be used as a service.

This interface is implemented by the following components:


Methods

nsIMIMEInfo getFromTypeAndExtension ( ACString MIMEType , AUTF8String fileExt ) AUTF8String getPrimaryExtension ( ACString MIMEType , AUTF8String fileExt ) ACString getTypeFromExtension ( AUTF8String fileExt ) ACString getTypeFromFile ( nsIFile file ) ACString getTypeFromURI ( nsIURI URI )

nsIMIMEInfo getFromTypeAndExtension ( ACString MIMEType , AUTF8String fileExt )

Retrieves an nsIMIMEInfo using both the extension and the type of a file. The type is given preference during the lookup. One of mIMEType and fileExt can be an empty string. At least one of mIMEType and fileExt must be nonempty.

Arguments:
MIMEType
fileExt

AUTF8String getPrimaryExtension ( ACString MIMEType , AUTF8String fileExt )

Given a Type/Extension combination, returns the default extension for this type. This may be identical to the passed-in extension.

Arguments:
MIMEType: The Type to get information on. Must not be empty.
fileExt: File Extension. Can be empty.

ACString getTypeFromExtension ( AUTF8String fileExt )

Retrieves a ACString representation of the MIME type associated with this file extension.

Arguments:
fileExt
Returns:
The MIME type, if any.

ACString getTypeFromFile ( nsIFile file )

Arguments:
file

ACString getTypeFromURI ( nsIURI URI )

Retrieves a ACString representation of the MIME type associated with this URI. The association is purely file extension to MIME type based. No attempt to determine the type via server headers or byte scanning is made.

Arguments:
URI
Returns:
The MIME type, if any.

Reference documentation is generated from Mozilla's source.

Add a note User Contributed Notes
No comments available

Copyright © 1999 - 2005 XULPlanet.com