MacOSUnicodeConverter.hpp
上传用户:huihehuasu
上传日期:2007-01-10
资源大小:6948k
文件大小:11k
源码类别:

xml/soap/webservice

开发平台:

C/C++

  1. /*
  2.  * The Apache Software License, Version 1.1
  3.  * 
  4.  * Copyright (c) 1999-2000 The Apache Software Foundation.  All rights
  5.  * reserved.
  6.  * 
  7.  * Redistribution and use in source and binary forms, with or without
  8.  * modification, are permitted provided that the following conditions
  9.  * are met:
  10.  * 
  11.  * 1. Redistributions of source code must retain the above copyright
  12.  *    notice, this list of conditions and the following disclaimer. 
  13.  * 
  14.  * 2. Redistributions in binary form must reproduce the above copyright
  15.  *    notice, this list of conditions and the following disclaimer in
  16.  *    the documentation and/or other materials provided with the
  17.  *    distribution.
  18.  * 
  19.  * 3. The end-user documentation included with the redistribution,
  20.  *    if any, must include the following acknowledgment:  
  21.  *       "This product includes software developed by the
  22.  *        Apache Software Foundation (http://www.apache.org/)."
  23.  *    Alternately, this acknowledgment may appear in the software itself,
  24.  *    if and wherever such third-party acknowledgments normally appear.
  25.  * 
  26.  * 4. The names "Xerces" and "Apache Software Foundation" must
  27.  *    not be used to endorse or promote products derived from this
  28.  *    software without prior written permission. For written 
  29.  *    permission, please contact apache@apache.org.
  30.  * 
  31.  * 5. Products derived from this software may not be called "Apache",
  32.  *    nor may "Apache" appear in their name, without prior written
  33.  *    permission of the Apache Software Foundation.
  34.  * 
  35.  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
  36.  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  37.  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  38.  * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
  39.  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  40.  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  41.  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  42.  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  43.  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  44.  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  45.  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  46.  * SUCH DAMAGE.
  47.  * ====================================================================
  48.  * 
  49.  * This software consists of voluntary contributions made by many
  50.  * individuals on behalf of the Apache Software Foundation, and was
  51.  * originally based on software copyright (c) 1999, International
  52.  * Business Machines, Inc., http://www.ibm.com .  For more information
  53.  * on the Apache Software Foundation, please see
  54.  * <http://www.apache.org/>.
  55.  */
  56. /*
  57.  * $Id: MacOSUnicodeConverter.hpp,v 1.6 2001/05/22 20:37:49 jberry Exp $
  58.  */
  59. #ifndef MACOSUNICODECONVERTER_HPP
  60. #define MACOSUNICODECONVERTER_HPP
  61. #include <util/TransService.hpp>
  62. #include <cstddef>
  63. #if defined(XML_MACOSX)
  64.     // Framework includes from ProjectBuilder
  65.     #include <CoreServices/CoreServices.h>
  66. #else
  67.     // Classic includes otherwise
  68.     #include <UnicodeConverter.h>
  69. #endif
  70. //
  71. //  The transcoding service has to provide a couple of required string
  72. //  and character operations, but its most important service is the creation
  73. //  of transcoder objects. There are two types of transcoders, which are
  74. //  discussed below in the XMLTranscoder class' description.
  75. //
  76. class XMLUTIL_EXPORT MacOSUnicodeConverter : public XMLTransService
  77. {
  78. public :
  79.     // -----------------------------------------------------------------------
  80.     //  Public Constructors and Destructor
  81.     // -----------------------------------------------------------------------
  82.     ~MacOSUnicodeConverter();
  83.     // -----------------------------------------------------------------------
  84.     //  Implementation of the virtual transcoding service API
  85.     // -----------------------------------------------------------------------
  86.     virtual int compareIString
  87.     (
  88.         const   XMLCh* const    comp1
  89.         , const XMLCh* const    comp2
  90.     );
  91.     virtual int compareNIString
  92.     (
  93.         const   XMLCh* const    comp1
  94.         , const XMLCh* const    comp2
  95.         , const unsigned int    maxChars
  96.     );
  97.     virtual const XMLCh* getId() const;
  98.     virtual bool isSpace(const XMLCh toCheck) const;
  99.     virtual XMLLCPTranscoder* makeNewLCPTranscoder();
  100.     virtual bool supportsSrcOfs() const;
  101.     virtual void upperCase(XMLCh* const toUpperCase) const;
  102. protected :
  103.     // -----------------------------------------------------------------------
  104.     //  Hidden constructors
  105.     // -----------------------------------------------------------------------
  106.     MacOSUnicodeConverter();
  107.     // -----------------------------------------------------------------------
  108.     //  Protected virtual methods
  109.     // -----------------------------------------------------------------------
  110.     virtual XMLTranscoder* makeNewXMLTranscoder
  111.     (
  112.         const   XMLCh* const            encodingName
  113.         ,       XMLTransService::Codes& resValue
  114.         , const unsigned int            blockSize
  115.     );
  116.     
  117.     // Sniff for available functionality
  118.     static bool IsMacOSUnicodeConverterSupported(void);
  119. private :
  120. friend class XMLPlatformUtils;
  121. bool mHasUnicodeCollation; // True if unicode collation is available
  122.     // -----------------------------------------------------------------------
  123.     //  Unimplemented constructors and operators
  124.     // -----------------------------------------------------------------------
  125.     MacOSUnicodeConverter(const MacOSUnicodeConverter&);
  126.     void operator=(const MacOSUnicodeConverter&);
  127.     
  128.     // -----------------------------------------------------------------------
  129.     //  Private methods
  130.     // -----------------------------------------------------------------------
  131. void ConvertWideToNarrow(const XMLCh* wide, char* narrow, std::size_t maxChars);
  132. };
  133. //
  134. //  This type of transcoder is for non-local code page encodings, i.e.
  135. //  named encodings. These are used internally by the scanner to internalize
  136. //  raw XML into the internal Unicode format, and by writer classes to
  137. //  convert that internal Unicode format (which comes out of the parser)
  138. //  back out to a format that the receiving client code wants to use.
  139. //
  140. class XMLUTIL_EXPORT MacOSTranscoder : public XMLTranscoder
  141. {
  142. public :
  143.     // -----------------------------------------------------------------------
  144.     //  Constructors and Destructor
  145.     // -----------------------------------------------------------------------
  146.     MacOSTranscoder(
  147.     const XMLCh* const encodingName,
  148.     TextToUnicodeInfo textToUnicodeInfo,
  149.     UnicodeToTextInfo unicodeToTextInfo,
  150.     const unsigned int blockSize
  151. );
  152.     ~MacOSTranscoder();
  153.     // -----------------------------------------------------------------------
  154.     //  The virtual transcoding interface
  155.     // -----------------------------------------------------------------------
  156.     virtual unsigned int transcodeFrom
  157.     (
  158.         const   XMLByte* const          srcData
  159.         , const unsigned int            srcCount
  160.         ,       XMLCh* const            toFill
  161.         , const unsigned int            maxChars
  162.         ,       unsigned int&           bytesEaten
  163.         ,       unsigned char* const    charSizes
  164.     );
  165.     virtual unsigned int transcodeTo
  166.     (
  167.         const   XMLCh* const    srcData
  168.         , const unsigned int    srcCount
  169.         ,       XMLByte* const  toFill
  170.         , const unsigned int    maxBytes
  171.         ,       unsigned int&   charsEaten
  172.         , const UnRepOpts       options
  173.     );
  174.     virtual bool canTranscodeTo
  175.     (
  176.         const   unsigned int    toCheck
  177.     )   const;
  178. private :
  179.     // -----------------------------------------------------------------------
  180.     //  Unimplemented constructors and operators
  181.     // -----------------------------------------------------------------------
  182.     MacOSTranscoder(const MacOSTranscoder&);
  183.     void operator=(const MacOSTranscoder&);
  184.     
  185.     // -----------------------------------------------------------------------
  186.     //  Private members
  187.     // -----------------------------------------------------------------------
  188.     TextToUnicodeInfo mTextToUnicodeInfo;
  189.     UnicodeToTextInfo mUnicodeToTextInfo;
  190. };
  191. //
  192. //  This class is a specialized transcoder that only transcodes between
  193. //  the internal XMLCh format and the local code page. It is specialized
  194. //  for the very common job of translating data from the client app's
  195. //  native code page to the internal format and vice versa.
  196. //
  197. class XMLUTIL_EXPORT MacOSLCPTranscoder : public XMLLCPTranscoder
  198. {
  199. public :
  200.     // -----------------------------------------------------------------------
  201.     //  Constructors and Destructor
  202.     // -----------------------------------------------------------------------
  203.     MacOSLCPTranscoder(TextToUnicodeInfo textToUnicodeInfo, UnicodeToTextInfo unicodeToTextInfo);
  204.     ~MacOSLCPTranscoder();
  205.     // -----------------------------------------------------------------------
  206.     //  The virtual transcoder API
  207.     //
  208.     //  NOTE:   All these APIs don't include null terminator characters in
  209.     //          their parameters. So calcRequiredSize() returns the number
  210.     //          of actual chars, not including the null. maxBytes and maxChars
  211.     //          parameters refer to actual chars, not including the null so
  212.     //          its assumed that the buffer is physically one char or byte
  213.     //          larger.
  214.     // -----------------------------------------------------------------------
  215.     virtual unsigned int calcRequiredSize(const char* const srcText);
  216.     virtual unsigned int calcRequiredSize(const XMLCh* const srcText);
  217.     virtual char* transcode(const XMLCh* const toTranscode);
  218.     virtual XMLCh* transcode(const char* const toTranscode);
  219.     virtual bool transcode
  220.     (
  221.         const   char* const     toTranscode
  222.         ,       XMLCh* const    toFill
  223.         , const unsigned int    maxChars
  224.     );
  225.     virtual bool transcode
  226.     (
  227.         const   XMLCh* const    toTranscode
  228.         ,       char* const     toFill
  229.         , const unsigned int    maxChars
  230.     );
  231. private :
  232.     // -----------------------------------------------------------------------
  233.     //  Unimplemented constructors and operators
  234.     // -----------------------------------------------------------------------
  235.     MacOSLCPTranscoder(const MacOSLCPTranscoder&);
  236.     void operator=(const MacOSLCPTranscoder&);
  237.     
  238.     // -----------------------------------------------------------------------
  239.     //  Private data members
  240.     // -----------------------------------------------------------------------
  241.     TextToUnicodeInfo mTextToUnicodeInfo;
  242.     UnicodeToTextInfo mUnicodeToTextInfo;
  243.  };
  244. #endif