diff options
Diffstat (limited to 'chromium/net/base/mime_util.h')
-rw-r--r-- | chromium/net/base/mime_util.h | 133 |
1 files changed, 133 insertions, 0 deletions
diff --git a/chromium/net/base/mime_util.h b/chromium/net/base/mime_util.h new file mode 100644 index 00000000000..9662e9656e3 --- /dev/null +++ b/chromium/net/base/mime_util.h @@ -0,0 +1,133 @@ +// Copyright (c) 2012 The Chromium Authors. All rights reserved. +// Use of this source code is governed by a BSD-style license that can be +// found in the LICENSE file. + +#ifndef NET_BASE_MIME_UTIL_H__ +#define NET_BASE_MIME_UTIL_H__ + +#include <string> +#include <vector> + +#include "base/files/file_path.h" +#include "net/base/net_export.h" + +namespace net { + +// Get the mime type (if any) that is associated with the given file extension. +// Returns true if a corresponding mime type exists. +NET_EXPORT bool GetMimeTypeFromExtension(const base::FilePath::StringType& ext, + std::string* mime_type); + +// Get the mime type (if any) that is associated with the given file extension. +// Returns true if a corresponding mime type exists. In this method, +// the search for a mime type is constrained to a limited set of +// types known to the net library, the OS/registry is not consulted. +NET_EXPORT bool GetWellKnownMimeTypeFromExtension( + const base::FilePath::StringType& ext, + std::string* mime_type); + +// Get the mime type (if any) that is associated with the given file. Returns +// true if a corresponding mime type exists. +NET_EXPORT bool GetMimeTypeFromFile(const base::FilePath& file_path, + std::string* mime_type); + +// Get the preferred extension (if any) associated with the given mime type. +// Returns true if a corresponding file extension exists. The extension is +// returned without a prefixed dot, ex "html". +NET_EXPORT bool GetPreferredExtensionForMimeType( + const std::string& mime_type, + base::FilePath::StringType* extension); + +// Check to see if a particular MIME type is in our list. +NET_EXPORT bool IsSupportedImageMimeType(const std::string& mime_type); +NET_EXPORT bool IsSupportedMediaMimeType(const std::string& mime_type); +NET_EXPORT bool IsSupportedNonImageMimeType(const std::string& mime_type); +NET_EXPORT bool IsUnsupportedTextMimeType(const std::string& mime_type); +NET_EXPORT bool IsSupportedJavascriptMimeType(const std::string& mime_type); +NET_EXPORT bool IsSupportedCertificateMimeType(const std::string& mime_type); + +// Convenience function. +NET_EXPORT bool IsSupportedMimeType(const std::string& mime_type); + +// Returns true if this the mime_type_pattern matches a given mime-type. +// Checks for absolute matching and wildcards. mime-types should be in +// lower case. +NET_EXPORT bool MatchesMimeType(const std::string& mime_type_pattern, + const std::string& mime_type); + +// Returns true if the |type_string| is a correctly-formed mime type specifier. +// Allows strings of the form x/y[;params], where "x" is a legal mime type name. +// Also allows wildcard types -- "x/*", "*/*", and "*". +NET_EXPORT bool IsMimeType(const std::string& type_string); + +// Returns true if and only if all codecs are supported, false otherwise. +NET_EXPORT bool AreSupportedMediaCodecs(const std::vector<std::string>& codecs); + +// Parses a codec string, populating |codecs_out| with the prefix of each codec +// in the string |codecs_in|. For example, passed "aaa.b.c,dd.eee", if +// |strip| == true |codecs_out| will contain {"aaa", "dd"}, if |strip| == false +// |codecs_out| will contain {"aaa.b.c", "dd.eee"}. +// See http://www.ietf.org/rfc/rfc4281.txt. +NET_EXPORT void ParseCodecString(const std::string& codecs, + std::vector<std::string>* codecs_out, + bool strip); + +// Check to see if a particular MIME type is in our list which only supports a +// certain subset of codecs. +NET_EXPORT bool IsStrictMediaMimeType(const std::string& mime_type); + +// Check to see if a particular MIME type is in our list which only supports a +// certain subset of codecs. Returns true if and only if all codecs are +// supported for that specific MIME type, false otherwise. If this returns +// false you will still need to check if the media MIME tpyes and codecs are +// supported. +NET_EXPORT bool IsSupportedStrictMediaMimeType( + const std::string& mime_type, + const std::vector<std::string>& codecs); + +// Get the extensions associated with the given mime type. This should be passed +// in lower case. There could be multiple extensions for a given mime type, like +// "html,htm" for "text/html", or "txt,text,html,..." for "text/*". +// Note that we do not erase the existing elements in the the provided vector. +// Instead, we append the result to it. +NET_EXPORT void GetExtensionsForMimeType( + const std::string& mime_type, + std::vector<base::FilePath::StringType>* extensions); + +// Test only method that removes proprietary media types and codecs from the +// list of supported MIME types and codecs. These types and codecs must be +// removed to ensure consistent layout test results across all Chromium +// variations. +NET_EXPORT void RemoveProprietaryMediaTypesAndCodecsForTests(); + +// Returns the IANA media type contained in |mime_type|, or an empty +// string if |mime_type| does not specifify a known media type. +// Supported media types are defined at: +// http://www.iana.org/assignments/media-types/index.html +NET_EXPORT const std::string GetIANAMediaType(const std::string& mime_type); + +// A list of supported certificate-related mime types. +enum CertificateMimeType { +#define CERTIFICATE_MIME_TYPE(name, value) CERTIFICATE_MIME_TYPE_ ## name = value, +#include "net/base/mime_util_certificate_type_list.h" +#undef CERTIFICATE_MIME_TYPE +}; + +NET_EXPORT CertificateMimeType GetCertificateMimeTypeForMimeType( + const std::string& mime_type); + +// Prepares one value as part of a multi-part upload request. +NET_EXPORT void AddMultipartValueForUpload(const std::string& value_name, + const std::string& value, + const std::string& mime_boundary, + const std::string& content_type, + std::string* post_data); + +// Adds the final delimiter to a multi-part upload request. +NET_EXPORT void AddMultipartFinalDelimiterForUpload( + const std::string& mime_boundary, + std::string* post_data); + +} // namespace net + +#endif // NET_BASE_MIME_UTIL_H__ |