"

 COPYRIGHT (c) 1997 by eXept Software AG 

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

"{ Package: 'stx:libview2' }"

Object subclass:#MIMETypes

	instanceVariableNames:''

	classVariableNames:'TypeToImageReaderClassMapping TypeToCommentStringMapping

		SuffixToCommentStringMapping FileSuffixToTypeMapping

		FilenameToTypeMapping FileSuffixToImageReaderClassMapping

		CharSetToFontMapping LastSuffix LastType

		DefaultCommandPerMIMEPerOS'

	poolDictionaries:''

	category:'System-Communication-Support'

!

String variableByteSubclass:#MIMEType

	instanceVariableNames:''

	classVariableNames:'CachedTypes'

	poolDictionaries:''

	privateIn:MIMETypes

!

!MIMETypes class methodsFor:'documentation'!

copyright

"

 COPYRIGHT (c) 1997 by eXept Software AG 

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

!

documentation

"

    just a place to keep MIME information

    (avoid spreading things at many places)

    MIMETypes is abstract and functional.

    Actually, in some OperatingSystems, this information may

    be found in some config files (or registries).

    Therefore, this class may have to be extended to support this

    and fetch the information from there eventually.

    [author:]

        Claus Gittinger

"

!

knownTypes

"

    simply a reminder for me ...

    application         mime                            file extentsions

        powerpoint      application/ms-powerpoint       .pot, .ppz, .ppt, .pps, 

                        application/mspowerpoint        

                        application/vnd.ms-powerpoint   

                        application/x-mspowerpoint

        shockwave       application/x-shockwave-flash   .swf     

        futuresplash    application/futuresplash        .spl

"

! !

!MIMETypes class methodsFor:'initialization'!

initialize

    "initialize wellKnown facts"

    MIMEType initialize.   "must be initialized first"

    LastSuffix := LastType := nil.

    self initializeFileNameToMimeTypeMapping.

    self initializeImageReaderMappings.

    self initializeCommentStringMappings.

    "

     self initialize

    "

    "Modified: / 19.11.1999 / 15:01:53 / cg"

!

initializeCommentStringMappings

    TypeToCommentStringMapping := Dictionary new.

    SuffixToCommentStringMapping := Dictionary new.

    TypeToCommentStringMapping 

        at:'application/x-make'

        put:#('#' (nil nil)).           "/ '#' for EOL comments only

    TypeToCommentStringMapping 

        at:'application/x-sh'

        put:#('#' (nil nil)).           "/ '#' for EOL comments only

    #('text/html' 'text/xml' 'application/xml')

    do:[:eachXMLType |

        TypeToCommentStringMapping 

            at:eachXMLType

            put:#(nil ('<!!-- ' ' -->')). "/ '<!!-- ... -->' delimited comments only

    ].

    TypeToCommentStringMapping 

        at:'application/x-batch-script'

        put:#('rem ' (nil nil)).         "/ 'rem ' for EOL comments only

    "/ the following is ST/X specific

    TypeToCommentStringMapping 

        at:'application/x-smalltalk-source'

        put:#('"/' ('"' '"')).           "/ '"/ ' for EOL; ".." for delimited comments

    "/ this is for standard smalltalk

"/    TypeToCommentStringMapping 

"/        at:'application/x-smalltalk-source'

"/        put:#(nil ('"' '"')).            "/ ".." for delimited comments only

    TypeToCommentStringMapping 

        at:'application/x-pascal-source'

        put:#(nil ('{' '}')).           "/ '{'..'}' for delimited comments

    "/ the following is k&r

    TypeToCommentStringMapping 

        at:'application/x-c-source'

        put:#(nil ('/*' '*/')).          "/ '/*'..'*/' for delimited comments

    "/ this is ANSI-c

    TypeToCommentStringMapping 

        at:'application/x-c-source'

        put:#('//' ('/*' '*/')).          

    TypeToCommentStringMapping 

        at:'application/x-cpp-source'

        put:#('//' ('/*' '*/')).          

    TypeToCommentStringMapping 

        at:'application/x-java-source'

        put:#('//' ('/*' '*/')).          

    TypeToCommentStringMapping 

        at:'application/x-asn1-source'

        put:#('--' ('--' '--')).          

    "/ st/x support files

    SuffixToCommentStringMapping 

        at:'style'

        put:#(';' (nil nil)).          

    SuffixToCommentStringMapping 

        at:'rs'

        put:#(';' (nil nil)).          

!

initializeDefaultCommands

    "TODO: move this to OS"

    |unixCommands win32Commands|

    DefaultCommandPerMIMEPerOS := Dictionary new.

    DefaultCommandPerMIMEPerOS at:#unix  put:(unixCommands := Dictionary new).

    DefaultCommandPerMIMEPerOS at:#win32 put:(win32Commands := Dictionary new).

    unixCommands at:'application/x-tar-compressed' put:'gunzip < %1 | tar tvf -'.

    unixCommands at:'application/pdf'              put:'acroread -display %2 %1'.

    "

     self initializeDefaultCommands

    "

!

initializeFileNameToMimeTypeMapping

    "initialize wellKnown facts"

    |types|

    FileSuffixToTypeMapping isNil ifTrue:[

        FileSuffixToTypeMapping := Dictionary new

    ].

    FilenameToTypeMapping isNil ifTrue:[

        FilenameToTypeMapping := Dictionary new.

    ].

    types := OrderedCollection new.

    types addAll:self textTypeList.

    types addAll:self imageTypeList.

    types addAll:self videoTypeList.

    types addAll:self audioTypeList.

    types addAll:self applicationTypeList.

    types pairWiseDo:[:suff :typeString|

        |type|

        type := MIMEType fromString:typeString.

        suff isArray ifTrue:[

            suff do:[:s | FileSuffixToTypeMapping at:s put:type]

        ] ifFalse:[

            FileSuffixToTypeMapping at:suff put:type

        ]

    ].

    self miscFilenameList pairWiseDo:[:nm :typeString|

        |type|

        type := MIMEType fromString:typeString.

        nm isArray ifTrue:[

            nm do:[:s | FilenameToTypeMapping at:s put:type]

        ] ifFalse:[

            FilenameToTypeMapping at:nm put:type

        ]

    ].

!

initializeImageReaderMappings

    FileSuffixToImageReaderClassMapping isNil ifTrue:[

        FileSuffixToImageReaderClassMapping := Dictionary new

    ].

    "MIME" TypeToImageReaderClassMapping isNil ifTrue:[

        TypeToImageReaderClassMapping := Dictionary new

    ].

    "/ setup mimeType to image reader class mapping ...

    TypeToImageReaderClassMapping at:'image/jpeg' put:JPEGReader.

    TypeToImageReaderClassMapping at:'image/gif'  put:GIFReader.

    TypeToImageReaderClassMapping at:'image/tiff' put:TIFFReader.

    "/ setup suffix to image reader class mapping ...

    FileSuffixToImageReaderClassMapping at:'jpg'  put:JPEGReader.

    FileSuffixToImageReaderClassMapping at:'gif'  put:GIFReader.

    FileSuffixToImageReaderClassMapping at:'tif'  put:TIFFReader.

! !

!MIMETypes class methodsFor:'initialization-lists'!

applicationCompressorsAndArchiveTypeList

    ^ #(

        'tar'                   'application/x-tar'

        'gtar'                  'application/x-gtar'

        'tgz'                   'application/x-tar-compressed'

        'zip'                   'application/x-zip-compressed'

        ('gz' 'z')              'application/x-gzip-compressed'

        'cpio'                  'application/x-cpio'

        'shar'                  'application/x-shar'

        'jar'                   'application/java-archive'

    )

!

applicationMiscTypeList

    "misc applications"

    ^ #(

        ('a' 'o' 'obj' )                        'application/binary'

        'a'                                     'application/library'

        ('dll' 'so')                            'application/shared-library'

    )

!

applicationProgLangTypeList

    "applications for programm languages"

    ^ #(

        ('st' 'cls' 'rc')            'application/x-smalltalk-source'

        'sif'                        'application/x-smalltalk-source-sif'

        'pac'                        'application/x-smalltalk-dolphin-package'

        'c'                          'application/x-c-source'

        ('cc' 'cpp')                 'application/x-cpp-source'

        ('h' 'hi')                   'application/x-c-header'

        ('js' 'mocha')               'application/x-javascript'

        ('java' 'jav')               'application/x-java-source'

        'sh'                         'application/x-sh'

        'csh'                        'application/x-csh'

        'tcl'                        'application/x-tcl'

        'pl'                         'application/x-perl'

        'mak'                        'application/x-make'

        'bat'                        'application/x-batch-script'

        ('asn1' 'x409' 'gdmo' 'gdm') 'application/x-asn1-source'

    )

!

applicationTextTypeList

    "text applications"

    ^ #(

        ('ps' 'eps')                 'application/postscript'

        'pdf'                        'application/pdf'

        'rtf'                        'application/rtf'

        'doc'                        'application/winword'

    )

!

applicationTypeList

    "applications"

    |typeList|                            

    typeList := OrderedCollection new.

    typeList addAll:self applicationProgLangTypeList.

    typeList addAll:self applicationTextTypeList.

    typeList addAll:self applicationCompressorsAndArchiveTypeList.

    typeList addAll:self applicationMiscTypeList.

    ^ typeList

!

audioTypeList

    "audio formats ..."

    ^ #(

        ('au' 'snd')            'audio/basic'

        ('ra' 'ram')            'audio/x-pn-realaudio'

        'rpm'                   'audio/x-pn-realaudio-plugin'

        ('mpa' 'mpega')         'audio/mpeg'

        'mp3'                   'audio/x-mp3'

        'wav'                   'audio/x-wav'

        ('aif' 'aiff' 'aifc')   'audio/x-aiff'

    )

!

imageTypeList

    ^ #(

        "/ image formats ...

        ('jpg' 'jpeg')  'image/jpeg'

        'gif'           'image/gif'

        ('tif' 'tiff')  'image/tiff'

        'xbm'           'image/x-xbitmap'

        'xpm'           'image/x-xpixmap'

        'png'           'image/png'

        'pcd'           'image/x-photo-cd'

        'bmp'           'image/x-MS-bmp'

        'rgb'           'image/x-rgb'

        'ppm'           'image/x-portable-pixmap'

        'pgm'           'image/x-portable-graymap'

        'pbm'           'image/x-portable-bitmap'

        'pnm'           'image/x-portable-anymap'

        'xwd'           'image/x-xwindowdump'

        'ras'           'image/x-cmu-raster'

        'tga'           'image/x-targa'

    ) 

!

miscFilenameList

    "other formats (not by suffix, but by fileName isnstead) ..."

    ^ #(

        ('makefile' 'make.proto')  'application/x-make'

        'swf'                      'application/x-shockwave-flash'

    )

!

textTypeList

   "/ misc text ...

    ^ #(

        ('htm' 'html')          'text/html'

        'shtml'                 'text/html'

        ('txt' 'text')          'text/plain'

        'xml'                   'text/xml'

    )

!

videoTypeList

    "/ video formats ...

    ^ #(

        ('qt' 'mov' 'moov')                'video/quicktime'

        ('mpv' 'mpegv' 'mpg' 'mpeg' 'mpe') 'video/mpeg'

        'movie'                            'video/x-sgi-movie'

        'avi'                              'video/x-msvideo'

        ('mpv2' 'mp2v' 'mp2' 'mpeg2')      'video/x-mpeg2'

        'rm'                               'application/vnd.rn-realmedia'

        'rv'                               'video/x-pn-realvideo'

    )

! !

!MIMETypes class methodsFor:'obsolete'!

fontForCharset:aCharSetName

    "return the font-encoding for an iso-charset"

    self obsoleteMethodWarning:'use FontDescription >> fontNamePatternForCharset:'.

    ^ FontDescription fontNamePatternForCharset:aCharSetName.

    "

     MIMETypes fontForCharset:'iso2022-jp'       

     MIMETypes fontForCharset:'euc-jp'     

    "

    "Modified: / 1.8.1998 / 17:00:57 / cg"

! !

!MIMETypes class methodsFor:'queries'!

defaultCommandPerMIME

    "TODO: move this to OS/UserPreferences"

    DefaultCommandPerMIMEPerOS isNil ifTrue:[

        self initializeDefaultCommands

    ].

    OperatingSystem isUNIXlike ifTrue:[

        ^ DefaultCommandPerMIMEPerOS at:#unix

    ].

    ^ DefaultCommandPerMIMEPerOS at:#win32

!

defineImageType:mimeType suffix:aSuffix reader:aReaderClass

    "register an image reader."

    aSuffix notNil ifTrue:[

        self imageReaderForSuffix:aSuffix put:aReaderClass.

    ].

    mimeType notNil ifTrue:[

        self imageReaderForType:mimeType put:aReaderClass

    ].

    (aSuffix notNil and:[mimeType notNil]) ifTrue:[

        self mimeTypeForSuffix:aSuffix put:mimeType

    ].

!

fileSuffixToImageReaderMapping

    "return the suffix-to-imageReader mapping"

    ^ FileSuffixToImageReaderClassMapping ? #()

    "Modified: / 1.8.1998 / 17:00:11 / cg"

!

imageFileSuffixes

    "return a collection with known file suffixes"

    FileSuffixToImageReaderClassMapping isNil ifTrue:[^ #()].

    ^ FileSuffixToImageReaderClassMapping keys

    "Created: / 30.6.1997 / 22:04:48 / cg"

    "Modified: / 1.8.1998 / 17:01:26 / cg"

!

mimeTypeForFilename:filenameArg

    "given a filename, return the mime-type or nil, if unknown"

    |type filename lcFilename suff|

    filename := filenameArg asFilename.

    lcFilename := filename baseName asLowercase.

    type := FilenameToTypeMapping at:lcFilename ifAbsent:nil.

    type isNil ifTrue:[

        "/ allow for fallback ...

        type := OperatingSystem mimeTypeForFilename:lcFilename.

        "/ the special value #unknown is returned as nil;

        "/ this avoids constant retry if a mimeType is not known in

        "/ the OS.

"/        type isNil ifTrue:[

"/            FilenameToTypeMapping at:lcFilename put:#unknown

"/        ].

    ].

    type == #unknown ifTrue:[

        type := nil.

    ].

    type isNil ifTrue:[

        suff := filename suffix.

        suff size ~~ 0 ifTrue:[

            ^ self mimeTypeForSuffix:suff

        ]