blob: db1aef5616d38135544884967953cd0a015941e6 [file] [log] [blame]
/**************************************************************
*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*
*************************************************************/
#ifndef _INETTYPE_HXX
#define _INETTYPE_HXX
#include "svl/svldllapi.h"
#include <tools/inetmime.hxx>
#include <com/sun/star/lang/Locale.hpp>
//============================================================================
/** Definitions for frequently used media type names.
*/
#define CONTENT_TYPE_STR_APP_OCTSTREAM "application/octet-stream"
#define CONTENT_TYPE_STR_APP_PDF "application/pdf"
#define CONTENT_TYPE_STR_APP_RTF "application/rtf"
#define CONTENT_TYPE_STR_APP_VND_CALC "application/vnd.stardivision.calc"
#define CONTENT_TYPE_STR_APP_VND_CHART "application/vnd.stardivision.chart"
#define CONTENT_TYPE_STR_APP_VND_DRAW "application/vnd.stardivision.draw"
#define CONTENT_TYPE_STR_APP_VND_IMAGE "application/vnd.stardivision.image"
#define CONTENT_TYPE_STR_APP_VND_IMPRESSPACKED \
"application/vnd.stardivision.impress-packed"
#define CONTENT_TYPE_STR_APP_VND_IMPRESS \
"application/vnd.stardivision.impress"
#define CONTENT_TYPE_STR_APP_VND_MAIL "application/vnd.stardivision.mail"
#define CONTENT_TYPE_STR_APP_VND_MATH "application/vnd.stardivision.math"
#define CONTENT_TYPE_STR_APP_VND_NEWS "application/vnd.stardivision.news"
#define CONTENT_TYPE_STR_APP_VND_OUTTRAY \
"application/vnd.stardivision.outtray"
#define CONTENT_TYPE_STR_APP_VND_TEMPLATE \
"application/vnd.stardivision.template"
#define CONTENT_TYPE_STR_APP_VND_WRITER_GLOBAL \
"application/vnd.stardivision.writer-global"
#define CONTENT_TYPE_STR_APP_VND_WRITER_WEB \
"application/vnd.stardivision.writer-web"
#define CONTENT_TYPE_STR_APP_VND_WRITER "application/vnd.stardivision.writer"
#define CONTENT_TYPE_STR_APP_FRAMESET "application/x-frameset"
#define CONTENT_TYPE_STR_APP_GALLERY_THEME "application/x-gallery-theme"
#define CONTENT_TYPE_STR_APP_GALLERY "application/x-gallery"
#define CONTENT_TYPE_STR_APP_JAR "application/x-jar"
#define CONTENT_TYPE_STR_APP_MACRO "application/x-macro"
#define CONTENT_TYPE_STR_APP_MSEXCEL_TEMPL "application/x-msexcel-template"
#define CONTENT_TYPE_STR_APP_MSEXCEL "application/x-msexcel"
#define CONTENT_TYPE_STR_APP_MSPPOINT_TEMPL "application/x-mspowerpoint-template"
#define CONTENT_TYPE_STR_APP_MSPPOINT "application/x-mspowerpoint"
#define CONTENT_TYPE_STR_APP_MSWORD_TEMPL "application/x-msword-template"
#define CONTENT_TYPE_STR_APP_MSWORD "application/x-msword"
#define CONTENT_TYPE_STR_APP_SCHEDULE_EVT "application/x-schedule-event"
#define CONTENT_TYPE_STR_APP_SCHEDULE_FEVT "application/x-schedule-form-event"
#define CONTENT_TYPE_STR_APP_SCHEDULE_FTASK "application/x-schedule-form-task"
#define CONTENT_TYPE_STR_APP_SCHEDULE_TASK "application/x-schedule-task"
#define CONTENT_TYPE_STR_APP_SCHEDULE_CMB "application/x-schedule"
#define CONTENT_TYPE_STR_APP_STARCALC "application/x-starcalc"
#define CONTENT_TYPE_STR_APP_STARCHART "application/x-starchart"
#define CONTENT_TYPE_STR_APP_STARDRAW "application/x-stardraw"
#define CONTENT_TYPE_STR_APP_STARHELP "application/x-starhelp"
#define CONTENT_TYPE_STR_APP_STARIMAGE "application/x-starimage"
#define CONTENT_TYPE_STR_APP_STARIMPRESS "application/x-starimpress"
#define CONTENT_TYPE_STR_APP_STARMAIL_SDM "application/x-starmail-sdm"
#define CONTENT_TYPE_STR_APP_STARMAIL_SMD "application/x-starmail-smd"
#define CONTENT_TYPE_STR_APP_STARMATH "application/x-starmath"
#define CONTENT_TYPE_STR_APP_STARWRITER_GLOB "application/x-starwriter-global"
#define CONTENT_TYPE_STR_APP_STARWRITER "application/x-starwriter"
#define CONTENT_TYPE_STR_APP_CDE_CALENDAR_APP "application/x-sun-ae-file"
#define CONTENT_TYPE_STR_APP_ZIP "application/x-zip-compressed"
#define CONTENT_TYPE_STR_AUDIO_AIFF "audio/aiff"
#define CONTENT_TYPE_STR_AUDIO_BASIC "audio/basic"
#define CONTENT_TYPE_STR_AUDIO_MIDI "audio/midi"
#define CONTENT_TYPE_STR_AUDIO_WAV "audio/wav"
#define CONTENT_TYPE_STR_X_CNT_DOCUMENT ".chaos/document"
#define CONTENT_TYPE_STR_X_CNT_FSYSBOX ".chaos/fsys-box"
#define CONTENT_TYPE_STR_X_CNT_CDROM_VOLUME ".chaos/fsys-cdrom-volume"
#define CONTENT_TYPE_STR_X_CNT_DISK_35 ".chaos/fsys-disk-35"
#define CONTENT_TYPE_STR_X_CNT_DISK_525 ".chaos/fsys-disk-525"
#define CONTENT_TYPE_STR_X_CNT_FSYSFILE ".chaos/fsys-file"
#define CONTENT_TYPE_STR_X_CNT_FIXED_VOLUME ".chaos/fsys-fixed-volume"
#define CONTENT_TYPE_STR_X_CNT_FSYSFOLDER ".chaos/fsys-folder"
#define CONTENT_TYPE_STR_X_CNT_RAM_VOLUME ".chaos/fsys-ram-volume"
#define CONTENT_TYPE_STR_X_CNT_REMOTE_VOLUME ".chaos/fsys-remote-volume"
#define CONTENT_TYPE_STR_X_CNT_REMOVEABLE_VOLUME \
".chaos/fsys-removeable-volume"
#define CONTENT_TYPE_STR_X_CNT_FSYSSPECIALFILE ".chaos/fsys-special-file"
#define CONTENT_TYPE_STR_X_CNT_FSYSSPECIALFOLDER ".chaos/fsys-special-folder"
#define CONTENT_TYPE_STR_X_CNT_TAPEDRIVE ".chaos/fsys-tapedrive"
#define CONTENT_TYPE_STR_X_CNT_FSYSURLFILE ".chaos/fsys-urlfile"
#define CONTENT_TYPE_STR_X_CNT_FTPBOX ".chaos/ftp-box"
#define CONTENT_TYPE_STR_X_CNT_FTPFILE ".chaos/ftp-file"
#define CONTENT_TYPE_STR_X_CNT_FTPFOLDER ".chaos/ftp-folder"
#define CONTENT_TYPE_STR_X_CNT_FTPLINK ".chaos/ftp-link"
#define CONTENT_TYPE_STR_X_CNT_HTTPBOX ".chaos/http-box"
#define CONTENT_TYPE_STR_X_CNT_HTTPFILE ".chaos/http-file"
#define CONTENT_TYPE_STR_X_CNT_IMAPBOX ".chaos/imap-box"
#define CONTENT_TYPE_STR_X_CNT_IMAPFOLDER ".chaos/imap-folder"
#define CONTENT_TYPE_STR_X_CNT_MESSAGE ".chaos/message"
#define CONTENT_TYPE_STR_X_CNT_NEWSBOX ".chaos/news-box"
#define CONTENT_TYPE_STR_X_CNT_NEWSGROUP ".chaos/news-group"
#define CONTENT_TYPE_STR_X_CNT_OUTBOX ".chaos/out-box"
#define CONTENT_TYPE_STR_X_CNT_POP3BOX ".chaos/pop3-box"
#define CONTENT_TYPE_STR_X_CNT_PUBLISHBOX ".chaos/publish-box"
#define CONTENT_TYPE_STR_X_CNT_SEARCHBOX ".chaos/search-box"
#define CONTENT_TYPE_STR_X_CNT_SEPARATOR ".chaos/separator"
#define CONTENT_TYPE_STR_X_CNT_BOOKMARK ".chaos/subscribe-bookmark"
#define CONTENT_TYPE_STR_X_CNT_SUBSCRIBEBOX ".chaos/subscribe-box"
#define CONTENT_TYPE_STR_X_CNT_CDFITEM ".chaos/subscribe-cdf-item"
#define CONTENT_TYPE_STR_X_CNT_CDFSUB ".chaos/subscribe-cdf-sub"
#define CONTENT_TYPE_STR_X_CNT_CDF ".chaos/subscribe-cdf"
#define CONTENT_TYPE_STR_X_CNT_STARCHANNEL ".chaos/subscribe-sdc"
#define CONTENT_TYPE_STR_X_CNT_TRASHBOX ".chaos/trash-box"
#define CONTENT_TYPE_STR_X_CNT_TRASH ".chaos/trash-item"
#define CONTENT_TYPE_STR_X_CNT_VIMBBOARDBOX ".chaos/vim-bboardbox"
#define CONTENT_TYPE_STR_X_CNT_VIMBBOARD ".chaos/vim-bboard"
#define CONTENT_TYPE_STR_X_CNT_VIMBOX ".chaos/vim-box"
#define CONTENT_TYPE_STR_X_CNT_VIMINBOX ".chaos/vim-inbox"
#define CONTENT_TYPE_STR_IMAGE_GENERIC "image/generic"
#define CONTENT_TYPE_STR_IMAGE_GIF "image/gif"
#define CONTENT_TYPE_STR_IMAGE_JPEG "image/jpeg"
#define CONTENT_TYPE_STR_IMAGE_PCX "image/pcx"
#define CONTENT_TYPE_STR_IMAGE_PNG "image/png"
#define CONTENT_TYPE_STR_IMAGE_TIFF "image/tiff"
#define CONTENT_TYPE_STR_IMAGE_BMP "image/x-MS-bmp"
#define CONTENT_TYPE_STR_INET_MSG_RFC822 "message/rfc822"
#define CONTENT_TYPE_STR_INET_MULTI_ALTERNATIVE "multipart/alternative"
#define CONTENT_TYPE_STR_INET_MULTI_DIGEST "multipart/digest"
#define CONTENT_TYPE_STR_INET_MULTI_MIXED "multipart/mixed"
#define CONTENT_TYPE_STR_INET_MULTI_PARALLEL "multipart/parallel"
#define CONTENT_TYPE_STR_INET_MULTI_RELATED "multipart/related"
#define CONTENT_TYPE_STR_TEXT_ICALENDAR "text/calendar"
#define CONTENT_TYPE_STR_TEXT_HTML "text/html"
#define CONTENT_TYPE_STR_TEXT_PLAIN "text/plain"
#define CONTENT_TYPE_STR_TEXT_XMLICALENDAR "text/x-icalxml"
#define CONTENT_TYPE_STR_TEXT_URL "text/x-url"
#define CONTENT_TYPE_STR_TEXT_VCALENDAR "text/x-vCalendar"
#define CONTENT_TYPE_STR_TEXT_VCARD "text/x-vCard"
#define CONTENT_TYPE_STR_VIDEO_VDO "video/vdo"
#define CONTENT_TYPE_STR_VIDEO_MSVIDEO "video/x-msvideo"
#define CONTENT_TYPE_STR_X_STARMAIL "x-starmail"
#define CONTENT_TYPE_STR_X_VRML "x-world/x-vrml"
#define CONTENT_TYPE_STR_APP_VND_SUN_XML_WRITER "application/vnd.sun.xml.writer"
#define CONTENT_TYPE_STR_APP_VND_SUN_XML_CALC "application/vnd.sun.xml.calc"
#define CONTENT_TYPE_STR_APP_VND_SUN_XML_IMPRESS "application/vnd.sun.xml.impress"
#define CONTENT_TYPE_STR_APP_VND_SUN_XML_DRAW "application/vnd.sun.xml.draw"
#define CONTENT_TYPE_STR_APP_VND_SUN_XML_CHART "application/vnd.sun.xml.chart"
#define CONTENT_TYPE_STR_APP_VND_SUN_XML_MATH "application/vnd.sun.xml.math"
#define CONTENT_TYPE_STR_APP_VND_SUN_XML_WRITER_GLOBAL "application/vnd.sun.xml.writer-global"
#define CONTENT_TYPE_STR_APP_VND_SUN_XML_IMPRESSPACKED "application/vnd.sun.xml.impress-packed"
//============================================================================
/** Definitions for frequently used media type parameter names.
*/
#define INET_CONTENT_TYPE_PARAMETER_CHARSET "charset"
//============================================================================
/** Definitions for matching parts of URIs.
*/
#define INETTYPE_URL_PROT_COMPONENT ".component"
#define INETTYPE_URL_PROT_DATA "data"
#define INETTYPE_URL_PROT_FILE "file"
#define INETTYPE_URL_PROT_HTTP "http"
#define INETTYPE_URL_PROT_HTTPS "https"
#define INETTYPE_URL_PROT_MACRO "macro"
#define INETTYPE_URL_PROT_MAILTO "mailto"
#define INETTYPE_URL_PROT_PRIVATE "private"
#define INETTYPE_URL_SUB_FACTORY "factory"
#define INETTYPE_URL_SUB_HELPID "helpid"
#define INETTYPE_URL_SSUB_FRAMESET "frameset"
#define INETTYPE_URL_SSUB_SCALC "scalc"
#define INETTYPE_URL_SSUB_SCHART "schart"
#define INETTYPE_URL_SSUB_SDRAW "sdraw"
#define INETTYPE_URL_SSUB_SIMAGE "simage"
#define INETTYPE_URL_SSUB_SIMPRESS "simpress"
#define INETTYPE_URL_SSUB_SMATH "smath"
#define INETTYPE_URL_SSUB_SS "ss"
#define INETTYPE_URL_SSUB_SWRITER "swriter"
#define INETTYPE_URL_SSSUB_GLOB "GlobalDocument"
#define INETTYPE_URL_SSSUB_WEB "web"
#define INETTYPE_URL_SCHED_CMB "cmbview"
#define INETTYPE_URL_SCHED_FORM "formular"
#define INETTYPE_URL_SCHED_EVENT "type=event"
#define INETTYPE_URL_SCHED_TASK "type=task"
//============================================================================
enum INetContentType
{
CONTENT_TYPE_UNKNOWN,
CONTENT_TYPE_APP_OCTSTREAM,
CONTENT_TYPE_APP_PDF,
CONTENT_TYPE_APP_RTF,
CONTENT_TYPE_APP_MSWORD,
CONTENT_TYPE_APP_MSWORD_TEMPL,
CONTENT_TYPE_APP_STARCALC,
CONTENT_TYPE_APP_STARCHART,
CONTENT_TYPE_APP_STARDRAW,
CONTENT_TYPE_APP_STARHELP,
CONTENT_TYPE_APP_STARIMAGE,
CONTENT_TYPE_APP_STARIMPRESS,
CONTENT_TYPE_APP_STARMATH,
CONTENT_TYPE_APP_STARWRITER,
CONTENT_TYPE_APP_ZIP,
CONTENT_TYPE_AUDIO_AIFF,
CONTENT_TYPE_AUDIO_BASIC,
CONTENT_TYPE_AUDIO_MIDI,
CONTENT_TYPE_AUDIO_WAV,
CONTENT_TYPE_IMAGE_GIF,
CONTENT_TYPE_IMAGE_JPEG,
CONTENT_TYPE_IMAGE_PCX,
CONTENT_TYPE_IMAGE_PNG,
CONTENT_TYPE_IMAGE_TIFF,
CONTENT_TYPE_IMAGE_BMP,
CONTENT_TYPE_TEXT_HTML,
CONTENT_TYPE_TEXT_PLAIN,
CONTENT_TYPE_TEXT_URL,
CONTENT_TYPE_TEXT_VCARD,
CONTENT_TYPE_VIDEO_VDO,
CONTENT_TYPE_VIDEO_MSVIDEO,
CONTENT_TYPE_X_CNT_MESSAGE,
CONTENT_TYPE_X_CNT_DOCUMENT,
CONTENT_TYPE_X_CNT_POP3BOX,
CONTENT_TYPE_X_CNT_IMAPBOX,
CONTENT_TYPE_X_CNT_IMAPFOLDER,
CONTENT_TYPE_X_CNT_VIMBOX,
CONTENT_TYPE_X_CNT_VIMINBOX,
CONTENT_TYPE_X_CNT_VIMBBOARDBOX,
CONTENT_TYPE_X_CNT_VIMBBOARD,
CONTENT_TYPE_X_CNT_NEWSBOX,
CONTENT_TYPE_X_CNT_NEWSGROUP,
CONTENT_TYPE_X_CNT_OUTBOX,
CONTENT_TYPE_X_CNT_FTPBOX,
CONTENT_TYPE_X_CNT_FTPFOLDER,
CONTENT_TYPE_X_CNT_FTPFILE,
CONTENT_TYPE_X_CNT_FTPLINK,
CONTENT_TYPE_X_CNT_HTTPBOX,
CONTENT_TYPE_X_CNT_FSYSBOX,
CONTENT_TYPE_X_CNT_FSYSFOLDER,
CONTENT_TYPE_X_CNT_FSYSFILE,
CONTENT_TYPE_X_CNT_FSYSURLFILE,
CONTENT_TYPE_X_CNT_PUBLISHBOX,
CONTENT_TYPE_X_CNT_SEARCHBOX,
CONTENT_TYPE_X_CNT_SUBSCRIBEBOX,
CONTENT_TYPE_X_CNT_BOOKMARK,
CONTENT_TYPE_X_CNT_CDF,
CONTENT_TYPE_X_CNT_CDFSUB,
CONTENT_TYPE_X_CNT_CDFITEM,
CONTENT_TYPE_X_CNT_TRASHBOX,
CONTENT_TYPE_X_CNT_TRASH,
CONTENT_TYPE_X_STARMAIL,
CONTENT_TYPE_X_VRML,
CONTENT_TYPE_X_CNT_REMOVEABLE_VOLUME,
CONTENT_TYPE_X_CNT_FIXED_VOLUME,
CONTENT_TYPE_X_CNT_REMOTE_VOLUME,
CONTENT_TYPE_X_CNT_RAM_VOLUME,
CONTENT_TYPE_X_CNT_CDROM_VOLUME,
CONTENT_TYPE_X_CNT_DISK_35,
CONTENT_TYPE_X_CNT_DISK_525,
CONTENT_TYPE_X_CNT_TAPEDRIVE,
CONTENT_TYPE_APP_GALLERY,
CONTENT_TYPE_APP_GALLERY_THEME,
CONTENT_TYPE_X_CNT_STARCHANNEL,
CONTENT_TYPE_X_CNT_SEPARATOR,
CONTENT_TYPE_APP_STARWRITER_GLOB,
CONTENT_TYPE_APP_STARMAIL_SDM,
CONTENT_TYPE_APP_STARMAIL_SMD,
CONTENT_TYPE_APP_VND_CALC,
CONTENT_TYPE_APP_VND_CHART,
CONTENT_TYPE_APP_VND_DRAW,
CONTENT_TYPE_APP_VND_IMAGE,
CONTENT_TYPE_APP_VND_IMPRESS,
CONTENT_TYPE_APP_VND_MAIL,
CONTENT_TYPE_APP_VND_MATH,
CONTENT_TYPE_APP_VND_WRITER,
CONTENT_TYPE_APP_VND_WRITER_GLOBAL,
CONTENT_TYPE_APP_VND_WRITER_WEB,
CONTENT_TYPE_APP_SCHEDULE,
CONTENT_TYPE_APP_SCHEDULE_EVT,
CONTENT_TYPE_APP_SCHEDULE_TASK,
CONTENT_TYPE_APP_SCHEDULE_FORM_EVT,
CONTENT_TYPE_APP_SCHEDULE_FORM_TASK,
CONTENT_TYPE_APP_FRAMESET,
CONTENT_TYPE_APP_MACRO,
CONTENT_TYPE_X_CNT_FSYSSPECIALFOLDER,
CONTENT_TYPE_X_CNT_FSYSSPECIALFILE,
CONTENT_TYPE_APP_VND_TEMPLATE,
CONTENT_TYPE_IMAGE_GENERIC,
CONTENT_TYPE_APP_VND_NEWS,
CONTENT_TYPE_APP_VND_OUTTRAY,
CONTENT_TYPE_X_CNT_HTTPFILE,
CONTENT_TYPE_APP_MSEXCEL,
CONTENT_TYPE_APP_MSEXCEL_TEMPL,
CONTENT_TYPE_APP_MSPPOINT,
CONTENT_TYPE_APP_MSPPOINT_TEMPL,
CONTENT_TYPE_TEXT_VCALENDAR,
CONTENT_TYPE_TEXT_ICALENDAR,
CONTENT_TYPE_TEXT_XMLICALENDAR,
CONTENT_TYPE_APP_CDE_CALENDAR_APP,
CONTENT_TYPE_INET_MESSAGE_RFC822,
CONTENT_TYPE_INET_MULTIPART_ALTERNATIVE,
CONTENT_TYPE_INET_MULTIPART_DIGEST,
CONTENT_TYPE_INET_MULTIPART_PARALLEL,
CONTENT_TYPE_INET_MULTIPART_RELATED,
CONTENT_TYPE_INET_MULTIPART_MIXED,
CONTENT_TYPE_APP_VND_IMPRESSPACKED,
CONTENT_TYPE_APP_JAR,
CONTENT_TYPE_APP_VND_SUN_XML_WRITER,
CONTENT_TYPE_APP_VND_SUN_XML_CALC,
CONTENT_TYPE_APP_VND_SUN_XML_IMPRESS,
CONTENT_TYPE_APP_VND_SUN_XML_DRAW,
CONTENT_TYPE_APP_VND_SUN_XML_CHART,
CONTENT_TYPE_APP_VND_SUN_XML_MATH,
CONTENT_TYPE_APP_VND_SUN_XML_WRITER_GLOBAL,
CONTENT_TYPE_APP_VND_SUN_XML_IMPRESSPACKED,
CONTENT_TYPE_LAST = CONTENT_TYPE_APP_VND_SUN_XML_IMPRESSPACKED
};
//============================================================================
class SVL_DLLPUBLIC INetContentTypes
{
public:
static void Uninitialize();
static INetContentType RegisterContentType(UniString const & rTypeName,
UniString const &
rPresentation,
UniString const * pExtension
= 0,
UniString const *
pSystemFileType = 0);
static INetContentType GetContentType(UniString const & rTypeName);
static UniString GetContentType(INetContentType eTypeID);
static UniString GetPresentation(INetContentType eTypeID,
const ::com::sun::star::lang::Locale& aLocale);
static UniString GetExtension(UniString const & rTypeName);
static INetContentType GetContentType4Extension(UniString const &
rExtension);
static INetContentType GetContentTypeFromURL(UniString const & rURL);
static bool GetExtensionFromURL(UniString const & rURL,
UniString & rExtension);
static INetContentType MapStringToContentType(UniString const &
rPresentation);
/** Parse the body of an RFC 2045 Content-Type header field.
@param rMediaType The body of the Content-Type header field. It must
be of the form
token "/" token *(";" token "=" (token / quoted-string))
with intervening linear white space and comments (cf. RFCs 822, 2045).
The RFC 2231 extension are supported. The encoding of rMediaType
should be US-ASCII, but any values in the range 0x80--0xFF are
interpretet 'as appropriate.'
@param rType Returns the type (the first of the above tokens), in US-
ASCII encoding and converted to lower case.
@param rSubType Returns the sub type (the second of the above
tokens), in US-ASCII encoding and converted to lower case.
@param rParameters If not null, returns the parameters as a list of
INetContentTypeParameters (the attributes are in US-ASCII encoding and
converted to lower case, the values are in Unicode encoding). If
null, only the syntax of the parameters is checked, but they are not
returned.
@return True if the syntax of the field body is correct. If false is
returned, none of the output parameters will be modified!
*/
static bool parse(ByteString const & rMediaType, ByteString & rType,
ByteString & rSubType,
INetContentTypeParameterList * pParameters = 0);
/** Parse the body of an RFC 2045 Content-Type header field.
@param rMediaType The body of the Content-Type header field. It must
be of the form
token "/" token *(";" token "=" (token / quoted-string))
with intervening linear white space and comments (cf. RFCs 822, 2045).
The RFC 2231 extension are supported. The encoding of rMediaType
should be US-ASCII, but any Unicode values in the range U+0080..U+FFFF
are interpretet 'as appropriate.'
@param rType Returns the type (the first of the above tokens), in US-
ASCII encoding and converted to lower case.
@param rSubType Returns the sub type (the second of the above
tokens), in US-ASCII encoding and converted to lower case.
@param rParameters If not null, returns the parameters as a list of
INetContentTypeParameters (the attributes are in US-ASCII encoding and
converted to lower case, the values are in Unicode encoding). If
null, only the syntax of the parameters is checked, but they are not
returned.
@return True if the syntax of the field body is correct. If false is
returned, none of the output parameters will be modified!
*/
static bool parse(UniString const & rMediaType, UniString & rType,
UniString & rSubType,
INetContentTypeParameterList * pParameters = 0);
/** Append a parameter to the string representation of a MIME media type.
@param rMediaType The string representation of a MIME media type.
@param rAttribute The name of the parameter. Must be a valid RFC
2045 token.
@param rValue The value of the paramter. Must only consist of US-
ASCII characters.
@return The string representation of rMediaType with the new
parameter appended. It is not checked whether a parameter with that
name already existed in rMediaType.
*/
static ByteString appendUSASCIIParameter(ByteString const & rMediaType,
ByteString const & rAttribute,
ByteString const & rValue);
/** Append a parameter to the string representation of a MIME media type.
@param rMediaType The string representation of a MIME media type.
@param rAttribute The name of the parameter. Must be a valid RFC
2045 token.
@param rValue The value of the paramter. Must only consist of US-
ASCII characters.
@return The string representation of rMediaType with the new
parameter appended. It is not checked whether a parameter with that
name already existed in rMediaType.
*/
static UniString appendUSASCIIParameter(UniString const & rMediaType,
UniString const & rAttribute,
UniString const & rValue);
};
#endif // _INETTYPE_HXX