(file) Return to XmlWriter.cpp CVS log (file) (dir) Up to [Pegasus] / pegasus / src / Pegasus / Common

Diff for /pegasus/src/Pegasus/Common/XmlWriter.cpp between version 1.10 and 1.124.2.2

version 1.10, 2001/04/13 18:20:51 version 1.124.2.2, 2005/09/30 20:35:55
Line 1 
Line 1 
 //BEGIN_LICENSE  //%2005////////////////////////////////////////////////////////////////////////
 // //
 // Copyright (c) 2000 The Open Group, BMC Software, Tivoli Systems, IBM  // Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development
   // Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems.
   // Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.;
   // IBM Corp.; EMC Corporation, The Open Group.
   // Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.;
   // IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.
   // Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.;
   // EMC Corporation; VERITAS Software Corporation; The Open Group.
   //
   // Permission is hereby granted, free of charge, to any person obtaining a copy
   // of this software and associated documentation files (the "Software"), to
   // deal in the Software without restriction, including without limitation the
   // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
   // sell copies of the Software, and to permit persons to whom the Software is
   // furnished to do so, subject to the following conditions:
   //
   // THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN
   // ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED
   // "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
   // LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
   // PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
   // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
   // ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
   // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
   //
   //==============================================================================
   //
   // Author: Mike Brasher (mbrasher@bmc.com)
   //
   // Modified By: Nitin Upasani, Hewlett-Packard Company (Nitin_Upasani@hp.com)
   //              Nag Boranna, Hewlett-Packard Company (nagaraja_boranna@hp.com)
   //              Roger Kumpf, Hewlett-Packard Company (roger_kumpf@hp.com)
   //              Carol Ann Krug Graves, Hewlett-Packard Company
   //                  (carolann_graves@hp.com)
   //              Amit K Arora, IBM (amita@in.ibm.com) for PEP#101
   //         Brian G. Campbell, EMC (campbell_brian@emc.com) - PEP140/phase1
   //                               Willis White (whiwill@us.ibm.com) PEP 127 and 128
   //         Brian G. Campbell, EMC (campbell_brian@emc.com) - PEP140/phase2
   //              Dave Sudlik, IBM (dsudlik@us.ibm.com)
   //              David Dillard, VERITAS Software Corp.
   //                  (david.dillard@veritas.com)
   //              Vijay Eli, vijayeli@in.ibm.com, fix for #2571
 // //
 // Permission is hereby granted, free of charge, to any person obtaining a  //%/////////////////////////////////////////////////////////////////////////////
 // copy of this software and associated documentation files (the "Software"),  
 // to deal in the Software without restriction, including without limitation  
 // the rights to use, copy, modify, merge, publish, distribute, sublicense,  
 // and/or sell copies of the Software, and to permit persons to whom the  
 // Software is furnished to do so, subject to the following conditions:  
 //  
 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR  
 // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,  
 // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL  
 // THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER  
 // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING  
 // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER  
 // DEALINGS IN THE SOFTWARE.  
 //  
 //END_LICENSE  
 //BEGIN_HISTORY  
 //  
 // Author:  
 //  
 // $Log$  
 // Revision 1.10  2001/04/13 18:20:51  mike  
 // Ported so Solaris.  
 // Fixed memory leaks.  
 //  
 // Revision 1.9  2001/04/08 01:13:22  mike  
 // Changed "ConstCIM" to "CIMConst"  
 //  
 // Revision 1.7  2001/02/20 07:25:57  mike  
 // Added basic create-instance in repository and in client.  
 //  
 // Revision 1.6  2001/02/19 01:47:17  mike  
 // Renamed names of the form CIMConst to CIMConst.  
 //  
 // Revision 1.5  2001/02/18 03:56:01  mike  
 // Changed more class names (e.g., ConstClassDecl -> CIMConstClass)  
 //  
 // Revision 1.4  2001/02/16 02:06:07  mike  
 // Renamed many classes and headers.  
 //  
 // Revision 1.3  2001/01/31 08:20:51  mike  
 // Added dispatcher framework.  
 // Added enumerateInstanceNames.  
 //  
 // Revision 1.2  2001/01/29 02:23:44  mike  
 // Added support for GetInstance operation  
 //  
 // Revision 1.1.1.1  2001/01/14 19:53:36  mike  
 // Pegasus import  
 //  
 //  
 //END_HISTORY  
  
   #include <Pegasus/Common/Config.h>
 #include <cstdlib> #include <cstdlib>
 #include <cstdio> #include <cstdio>
   #include "Constants.h"
 #include "CIMClass.h" #include "CIMClass.h"
   #include "CIMClassRep.h"
 #include "CIMInstance.h" #include "CIMInstance.h"
   #include "CIMInstanceRep.h"
   #include "CIMProperty.h"
   #include "CIMPropertyRep.h"
   #include "CIMMethod.h"
   #include "CIMMethodRep.h"
   #include "CIMParameter.h"
   #include "CIMParameterRep.h"
   #include "CIMParamValue.h"
   #include "CIMParamValueRep.h"
   #include "CIMQualifier.h"
   #include "CIMQualifierRep.h"
 #include "CIMQualifierDecl.h" #include "CIMQualifierDecl.h"
   #include "CIMQualifierDeclRep.h"
   #include "CIMValue.h"
 #include "XmlWriter.h" #include "XmlWriter.h"
 #include "XmlParser.h" #include "XmlParser.h"
   #include "Tracer.h"
   #include <Pegasus/Common/StatisticalData.h>
   #include "CommonUTF.h"
  
 PEGASUS_NAMESPACE_BEGIN PEGASUS_NAMESPACE_BEGIN
  
 inline void AppendChar(Array<Sint8>& out, Char16 c)  // This is a shortcut macro for outputing content length. This
   // pads the output number to the max characters representing a Uint32 number
   // so that it can be overwritten easily with a transfer encoding line later
   // on in HTTPConnection if required. This is strictly for performance since
   // messages can be very large. This overwriting shortcut allows us to NOT have
   // to repackage a large message later.
   
   #define OUTPUT_CONTENTLENGTH                                            \
   {                                                                       \
       char contentLengthP[11];                                            \
       sprintf(contentLengthP,"%.10u", contentLength);                     \
       out << LIT("content-length: ") << contentLengthP << LIT("\r\n");    \
   }
   
   Buffer& operator<<(Buffer& out, const char* x)
   {
       XmlWriter::append(out, x);
       return out;
   }
   
   Buffer& operator<<(Buffer& out, char x)
   {
       XmlWriter::append(out, x);
       return out;
   }
   
   Buffer& operator<<(Buffer& out, const Char16& x)
   {
       XmlWriter::append(out, x);
       return out;
   }
   
   Buffer& operator<<(Buffer& out, const String& x)
   {
       XmlWriter::append(out, x);
       return out;
   }
   
   Buffer& operator<<(Buffer& out, const Indentor& x)
   {
       XmlWriter::append(out, x);
       return out;
   }
   
   Buffer& operator<<(Buffer& out, const Buffer& x)
   {
       out.append(x.getData(), x.size());
       return out;
   }
   
   Buffer& operator<<(Buffer& out, Uint32 x)
   {
       XmlWriter::append(out, x);
       return out;
   }
   
   Buffer& operator<<(Buffer& out, const CIMName& name)
   {
       XmlWriter::append(out, name.getString ());
       return out;
   }
   
   
   // l10n
   Buffer& operator<<(Buffer& out, const AcceptLanguages& al)
   {
       XmlWriter::append(out, al.toString ());
       return out;
   }
   
   // l10n
   Buffer& operator<<(Buffer& out, const ContentLanguages& cl)
   {
       XmlWriter::append(out, cl.toString ());
       return out;
   }
   
   
   PEGASUS_STD(ostream)& operator<<(PEGASUS_STD(ostream)& os, const CIMDateTime& x)
   {
       return os << x.toString();
   }
   
   PEGASUS_STD(ostream)& operator<<(PEGASUS_STD(ostream)& os, const CIMName& name)
   {
       os << name.getString();
       return os;
   }
   
   PEGASUS_STD(ostream)& operator<<(PEGASUS_STD(ostream)& os,
       const CIMNamespaceName& name)
 { {
     out.append(Sint8(c));      os << name.getString();
       return os;
 } }
  
 inline void AppendSpecialChar(Array<Sint8>& out, Char16 c)  inline void _xmlWritter_appendChar(Buffer& out, const Char16& c)
 { {
     // ATTN-B: Only UTF-8 handled for now.      // We need to convert the Char16 to UTF8 then append the UTF8
       // character into the array.
       // NOTE: The UTF8 character could be several bytes long.
       // WARNING: This function will put in replacement character for
       // all characters that have surogate pairs.
       char str[6];
       memset(str,0x00,sizeof(str));
       Uint8* charIN = (Uint8 *)&c;
  
       const Uint16 *strsrc = (Uint16 *)charIN;
       Uint16 *endsrc = (Uint16 *)&charIN[1];
   
       Uint8 *strtgt = (Uint8 *)str;
       Uint8 *endtgt = (Uint8 *)&str[5];
   
       UTF16toUTF8(&strsrc,
                   endsrc,
                   &strtgt,
                   endtgt);
   
       out.append(str, UTF_8_COUNT_TRAIL_BYTES(str[0]) + 1);
   }
   
   inline void _xmlWritter_appendSpecialChar(Buffer& out, const Char16& c)
   {
       if ( ((c < Char16(0x20)) && (c >= Char16(0x00))) || (c == Char16(0x7f)) )
       {
           char charref[7];
           sprintf(charref, "&#%u;", (Uint16)c);
           out.append(charref, static_cast<Uint32>(strlen(charref)));
       }
       else
       {
           switch (c)
           {
               case '&':
                   out.append("&amp;", 5);
                   break;
   
               case '<':
                   out.append("&lt;", 4);
                   break;
   
               case '>':
                   out.append("&gt;", 4);
                   break;
   
               case '"':
                   out.append("&quot;", 6);
                   break;
   
               case '\'':
                   out.append("&apos;", 6);
                   break;
   
               default:
                   {
                       // We need to convert the Char16 to UTF8 then append the UTF8
                       // character into the array.
                       // NOTE: The UTF8 character could be several bytes long.
                       // WARNING: This function will put in replacement character for
                       // all characters that have surogate pairs.
               char str[6];
                       memset(str,0x00,sizeof(str));
                       const char* charIN = reinterpret_cast<const char *>(&c);
   
                       const Uint16 *strsrc = (const Uint16 *)charIN;
                       const Uint16 *endsrc = (const Uint16 *)&charIN[1];
   
                       Uint8 *strtgt = (Uint8 *)str;
                       Uint8 *endtgt = (Uint8 *)&str[5];
   
                       UTF16toUTF8(&strsrc,
                                   endsrc,
                                   &strtgt,
                                   endtgt);
   
                       Uint32 number1 = UTF_8_COUNT_TRAIL_BYTES(str[0]) + 1;
   
                       out.append(str,number1);
                   }
           }
       }
   }
   
   inline void _xmlWritter_appendSpecialChar(Buffer& out, char c)
   {
           if ( ((c < 0x20) && (c >= 0)) || (c == 0x7f) )
       {
           char charref[7];
           sprintf(charref, "&#%u;", (Uint8)c);
           out.append(charref, static_cast<Uint32>(strlen(charref)));
       }
       else
       {
     switch (c)     switch (c)
     {     {
         case '&':         case '&':
Line 97 
Line 290 
             break;             break;
  
         default:         default:
             out.append(Sint8(c));                  out.append(static_cast<Sint8>(c));
           }
       }
   }
   
   
   inline void _xmlWritter_appendSpecialChar(PEGASUS_STD(ostream)& os, char c)
   {
       if ( ((c < 0x20) && (c >= 0)) || (c == 0x7f) )
       {
           char charref[7];
           sprintf(charref, "&#%u;", static_cast<Uint8>(c));
           os << charref;
       }
       else
       {
           switch (c)
           {
               case '&':
                   os << "&amp;";
                   break;
   
               case '<':
                   os << "&lt;";
                   break;
   
               case '>':
                   os << "&gt;";
                   break;
   
               case '"':
                   os << "&quot;";
                   break;
   
               case '\'':
                   os << "&apos;";
                   break;
   
               default:
                   os << c;
     }     }
 } }
   }
   
   void _xmlWritter_appendSurrogatePair(Buffer& out, Uint16 high, Uint16 low)
   {
       char str[6];
       Uint8 charIN[5];
       memset(str,0x00,sizeof(str));
       memcpy(&charIN,&high,2);
       memcpy(&charIN[2],&low,2);
       const Uint16 *strsrc = (Uint16 *)charIN;
       Uint16 *endsrc = (Uint16 *)&charIN[3];
   
       Uint8 *strtgt = (Uint8 *)str;
       Uint8 *endtgt = (Uint8 *)&str[5];
   
       UTF16toUTF8(&strsrc,
                   endsrc,
                   &strtgt,
                   endtgt);
   
       Uint32 number1 = UTF_8_COUNT_TRAIL_BYTES(str[0]) + 1;
       out.append(str,number1);
   }
   
   inline void _xmlWritter_appendSpecial(PEGASUS_STD(ostream)& os, const char* str)
   {
       while (*str)
           _xmlWritter_appendSpecialChar(os, *str++);
   }
   
   void XmlWriter::append(Buffer& out, const Char16& x)
   {
       _xmlWritter_appendChar(out, x);
   }
   
   void XmlWriter::append(Buffer& out, Boolean x)
   {
       append(out, (x ? "TRUE" : "FALSE"));
   }
  
 void XmlWriter::append(Array<Sint8>& out, Char16 x)  void XmlWriter::append(Buffer& out, Uint32 x)
 { {
     AppendChar(out, x);      char buffer[32];
       sprintf(buffer, "%u", x);
       append(out, buffer);
 } }
  
 void XmlWriter::append(Array<Sint8>& out, Uint32 x)  void XmlWriter::append(Buffer& out, Sint32 x)
 { {
     char buffer[32];     char buffer[32];
     sprintf(buffer, "%d", x);     sprintf(buffer, "%d", x);
     append(out, buffer);     append(out, buffer);
 } }
  
 void XmlWriter::append(Array<Sint8>& out, const char* str)  void XmlWriter::append(Buffer& out, Uint64 x)
   {
       char buffer[32];  // Should need 21 chars max
       sprintf(buffer, "%" PEGASUS_64BIT_CONVERSION_WIDTH "u", x);
       append(out, buffer);
   }
   
   void XmlWriter::append(Buffer& out, Sint64 x)
   {
       char buffer[32];  // Should need 21 chars max
       sprintf(buffer, "%" PEGASUS_64BIT_CONVERSION_WIDTH "d", x);
       append(out, buffer);
   }
   
   void XmlWriter::append(Buffer& out, Real32 x)
   {
       char buffer[128];
       // %.7e gives '[-]m.ddddddde+/-xx', which seems compatible with the format
       // given in the CIM/XML spec, and the precision required by the CIM 2.2 spec
       // (4 byte IEEE floating point)
       sprintf(buffer, "%.7e", x);
       append(out, buffer);
   }
   
   void XmlWriter::append(Buffer& out, Real64 x)
   {
       char buffer[128];
       // %.16e gives '[-]m.dddddddddddddddde+/-xx', which seems compatible with the format
       // given in the CIM/XML spec, and the precision required by the CIM 2.2 spec
       // (8 byte IEEE floating point)
       sprintf(buffer, "%.16e", x);
       append(out, buffer);
   }
   
   void XmlWriter::append(Buffer& out, const char* str)
   {
       while (*str)
         XmlWriter::append(out, *str++);
   }
   
   void XmlWriter::append(Buffer& out, const String& str)
   {
       for (Uint32 i = 0; i < str.size(); i++)
       {
           Uint16 c = str[i];
           if(((c >= FIRST_HIGH_SURROGATE) && (c <= LAST_HIGH_SURROGATE)) ||
              ((c >= FIRST_LOW_SURROGATE) && (c <= LAST_LOW_SURROGATE)))
           {
               Char16 highSurrogate = str[i];
               Char16 lowSurrogate = str[++i];
   
               _xmlWritter_appendSurrogatePair(out, Uint16(highSurrogate),Uint16(lowSurrogate));
           }
           else
           {
               _xmlWritter_appendChar(out, str[i]);
           }
       }
   }
   
   void XmlWriter::append(Buffer& out, const Indentor& x)
   {
       for (Uint32 i = 0; i < 4 * x.getLevel(); i++)
           out.append(' ');
   }
   
   void XmlWriter::appendSpecial(Buffer& out, const Char16& x)
   {
       _xmlWritter_appendSpecialChar(out, x);
   }
   
   void XmlWriter::appendSpecial(Buffer& out, char x)
   {
       _xmlWritter_appendSpecialChar(out, x);
   }
   
   void XmlWriter::appendSpecial(Buffer& out, const char* str)
 { {
     while (*str)     while (*str)
         AppendChar(out, *str++);          _xmlWritter_appendSpecialChar(out, *str++);
   }
   
   void XmlWriter::appendSpecial(Buffer& out, const String& str)
   {
       for (Uint32 i = 0; i < str.size(); i++)
       {
           Uint16 c = str[i];
   
           if(((c >= FIRST_HIGH_SURROGATE) && (c <= LAST_HIGH_SURROGATE)) ||
              ((c >= FIRST_LOW_SURROGATE) && (c <= LAST_LOW_SURROGATE)))
           {
               Char16 highSurrogate = str[i];
               Char16 lowSurrogate = str[++i];
   
               _xmlWritter_appendSurrogatePair(out, Uint16(highSurrogate),Uint16(lowSurrogate));
           }
           else
           {
               _xmlWritter_appendSpecialChar(out, str[i]);
           }
       }
   }
   
   // See http://www.ietf.org/rfc/rfc2396.txt section 2
   // Reserved characters = ';' '/' '?' ':' '@' '&' '=' '+' '$' ','
   // Excluded characters:
   //   Control characters = 0x00-0x1f, 0x7f
   //   Space character = 0x20
   //   Delimiters = '<' '>' '#' '%' '"'
   //   Unwise = '{' '}' '|' '\\' '^' '[' ']' '`'
   //
   
   inline void _xmlWritter_encodeURIChar(String& outString, Sint8 char8)
   {
       Uint8 c = (Uint8)char8;
   
   #ifndef PEGASUS_DO_NOT_IMPLEMENT_URI_ENCODING
       if ( (c <= 0x20) ||                     // Control characters + space char
            ( (c >= 0x22) && (c <= 0x26) ) ||  // '"' '#' '$' '%' '&'
            (c == 0x2b) ||                     // '+'
            (c == 0x2c) ||                     // ','
            (c == 0x2f) ||                     // '/'
            ( (c >= 0x3a) && (c <= 0x40) ) ||  // ':' ';' '<' '=' '>' '?' '@'
            ( (c >= 0x5b) && (c <= 0x5e) ) ||  // '[' '\\' ']' '^'
            (c == 0x60) ||                     // '`'
            ( (c >= 0x7b) && (c <= 0x7d) ) ||  // '{' '|' '}'
            (c >= 0x7f) )                      // Control character or non US-ASCII (UTF-8)
       {
           char hexencoding[4];
   
           sprintf(hexencoding, "%%%X%X", c/16, c%16);
           outString.append(hexencoding);
       }
       else
   #endif
       {
           outString.append((Uint16)c);
       }
   }
   
   String XmlWriter::encodeURICharacters(const Buffer& uriString)
   {
       String encodedString;
   
       for (Uint32 i=0; i<uriString.size(); i++)
       {
           _xmlWritter_encodeURIChar(encodedString, uriString[i]);
       }
   
       return encodedString;
   }
   
   String XmlWriter::encodeURICharacters(const String& uriString)
   {
       String encodedString;
   
   /* i18n remove - did not handle surrogate pairs
       for (Uint32 i=0; i<uriString.size(); i++)
       {
           _xmlWritter_encodeURIChar(encodedString, uriString[i]);
       }
   */
   
       // See the "CIM Operations over HTTP" spec, section 3.3.2 and
       // 3.3.3, for the treatment of non US-ASCII (UTF-8) chars
   
       // First, convert to UTF-8 (include handling of surrogate pairs)
       Buffer utf8;
       for (Uint32 i = 0; i < uriString.size(); i++)
       {
           Uint16 c = uriString[i];
   
           if(((c >= FIRST_HIGH_SURROGATE) && (c <= LAST_HIGH_SURROGATE)) ||
              ((c >= FIRST_LOW_SURROGATE) && (c <= LAST_LOW_SURROGATE)))
           {
               Char16 highSurrogate = uriString[i];
               Char16 lowSurrogate = uriString[++i];
   
               _xmlWritter_appendSurrogatePair(utf8, Uint16(highSurrogate),Uint16(lowSurrogate));
           }
           else
           {
               _xmlWritter_appendChar(utf8, uriString[i]);
           }
 } }
  
 void XmlWriter::appendSpecial(Array<Sint8>& out, Char16 x)      // Second, escape the non HTTP-safe chars
       for (Uint32 i=0; i<utf8.size(); i++)
       {
           _xmlWritter_encodeURIChar(encodedString, utf8[i]);
       }
   
       return encodedString;
   }
   
   //------------------------------------------------------------------------------
   //
   // appendLocalNameSpacePathElement()
   //
   //     <!ELEMENT LOCALNAMESPACEPATH (NAMESPACE+)>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendLocalNameSpacePathElement(
       Buffer& out,
       const CIMNamespaceName& nameSpace)
   {
       out << LIT("<LOCALNAMESPACEPATH>\n");
   
       char* nameSpaceCopy = strdup(nameSpace.getString().getCString());
   
   #if defined(PEGASUS_PLATFORM_SOLARIS_SPARC_CC) || \
       defined(PEGASUS_OS_HPUX) || \
       defined(PEGASUS_OS_LINUX)
       char *last;
       for (const char* p = strtok_r(nameSpaceCopy, "/", &last); p;
            p = strtok_r(NULL, "/", &last))
   #else
       for (const char* p = strtok(nameSpaceCopy, "/"); p; p = strtok(NULL, "/"))
   #endif
       {
           out << LIT("<NAMESPACE NAME=\"") << p << LIT("\"/>\n");
       }
       free(nameSpaceCopy);
   
       out << LIT("</LOCALNAMESPACEPATH>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // appendNameSpacePathElement()
   //
   //     <!ELEMENT NAMESPACEPATH (HOST,LOCALNAMESPACEPATH)>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendNameSpacePathElement(
       Buffer& out,
       const String& host,
       const CIMNamespaceName& nameSpace)
   {
       out << LIT("<NAMESPACEPATH>\n");
       out << LIT("<HOST>") << host << LIT("</HOST>\n");
       appendLocalNameSpacePathElement(out, nameSpace);
       out << LIT("</NAMESPACEPATH>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // appendClassNameElement()
   //
   //     <!ELEMENT CLASSNAME EMPTY>
   //     <!ATTLIST CLASSNAME
   //              %CIMName;>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendClassNameElement(
       Buffer& out,
       const CIMName& className)
   {
       out << LIT("<CLASSNAME NAME=\"") << className << LIT("\"/>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // appendInstanceNameElement()
   //
   //    <!ELEMENT INSTANCENAME (KEYBINDING*|KEYVALUE?|VALUE.REFERENCE?)>
   //    <!ATTLIST INSTANCENAME
   //              %ClassName;>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendInstanceNameElement(
       Buffer& out,
       const CIMObjectPath& instanceName)
   {
       out << LIT("<INSTANCENAME CLASSNAME=\"");
       out << instanceName.getClassName() << LIT("\">\n");
   
       Array<CIMKeyBinding> keyBindings = instanceName.getKeyBindings();
       for (Uint32 i = 0, n = keyBindings.size(); i < n; i++)
       {
           out << LIT("<KEYBINDING NAME=\"");
           out << keyBindings[i].getName() << LIT("\">\n");
   
           if (keyBindings[i].getType() == CIMKeyBinding::REFERENCE)
           {
               CIMObjectPath ref = keyBindings[i].getValue();
               appendValueReferenceElement(out, ref, true);
           }
           else {
               out << LIT("<KEYVALUE VALUETYPE=\"");
               out << keyBindingTypeToString(keyBindings[i].getType());
               out << LIT("\">");
   
               // fixed the special character problem - Markus
   
               appendSpecial(out, keyBindings[i].getValue());
               out << LIT("</KEYVALUE>\n");
           }
           out << LIT("</KEYBINDING>\n");
       }
       out << LIT("</INSTANCENAME>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // appendClassPathElement()
   //
   //     <!ELEMENT CLASSPATH (NAMESPACEPATH,CLASSNAME)>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendClassPathElement(
       Buffer& out,
       const CIMObjectPath& classPath)
   {
       out << LIT("<CLASSPATH>\n");
       appendNameSpacePathElement(out,
                                  classPath.getHost(),
                                  classPath.getNameSpace());
       appendClassNameElement(out, classPath.getClassName());
       out << LIT("</CLASSPATH>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // appendInstancePathElement()
   //
   //     <!ELEMENT INSTANCEPATH (NAMESPACEPATH,INSTANCENAME)>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendInstancePathElement(
       Buffer& out,
       const CIMObjectPath& instancePath)
   {
       out << LIT("<INSTANCEPATH>\n");
       appendNameSpacePathElement(out,
                                  instancePath.getHost(),
                                  instancePath.getNameSpace());
       appendInstanceNameElement(out, instancePath);
       out << LIT("</INSTANCEPATH>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // appendLocalClassPathElement()
   //
   //     <!ELEMENT LOCALCLASSPATH (LOCALNAMESPACEPATH, CLASSNAME)>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendLocalClassPathElement(
       Buffer& out,
       const CIMObjectPath& classPath)
   {
       out << LIT("<LOCALCLASSPATH>\n");
       appendLocalNameSpacePathElement(out, classPath.getNameSpace());
       appendClassNameElement(out, classPath.getClassName());
       out << LIT("</LOCALCLASSPATH>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // appendLocalInstancePathElement()
   //
   //     <!ELEMENT LOCALINSTANCEPATH (LOCALNAMESPACEPATH, INSTANCENAME)>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendLocalInstancePathElement(
       Buffer& out,
       const CIMObjectPath& instancePath)
   {
       out << LIT("<LOCALINSTANCEPATH>\n");
       appendLocalNameSpacePathElement(out, instancePath.getNameSpace());
       appendInstanceNameElement(out, instancePath);
       out << LIT("</LOCALINSTANCEPATH>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // appendLocalObjectPathElement()
   //
   //     If the reference refers to an instance, write a LOCALINSTANCEPATH;
   //     otherwise write a LOCALCLASSPATH.
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendLocalObjectPathElement(
       Buffer& out,
       const CIMObjectPath& objectPath)
   {
       //
       //  ATTN-CAKG-P2-20020726:  The following condition does not correctly
       //  distinguish instanceNames from classNames in every case
       //  The instanceName of a singleton instance of a keyless class has no
       //  key bindings
       //
       if (objectPath.getKeyBindings ().size () != 0)
       {
           appendLocalInstancePathElement(out, objectPath);
       }
       else
       {
           appendLocalClassPathElement(out, objectPath);
       }
   }
   
   //------------------------------------------------------------------------------
   //
   // Helper functions for appendValueElement()
   //
   //------------------------------------------------------------------------------
   
   inline void _xmlWritter_appendValue(Buffer& out, Boolean x)
   {
       XmlWriter::append(out, x);
   }
   
   inline void _xmlWritter_appendValue(Buffer& out, Uint8 x)
   {
       XmlWriter::append(out, Uint32(x));
   }
   
   inline void _xmlWritter_appendValue(Buffer& out, Sint8 x)
   {
       XmlWriter::append(out, Sint32(x));
   }
   
   inline void _xmlWritter_appendValue(Buffer& out, Uint16 x)
   {
       XmlWriter::append(out, Uint32(x));
   }
   
   inline void _xmlWritter_appendValue(Buffer& out, Sint16 x)
   {
       XmlWriter::append(out, Sint32(x));
   }
   
   inline void _xmlWritter_appendValue(Buffer& out, Uint32 x)
   {
       XmlWriter::append(out, x);
   }
   
   inline void _xmlWritter_appendValue(Buffer& out, Sint32 x)
   {
       XmlWriter::append(out, x);
   }
   
   inline void _xmlWritter_appendValue(Buffer& out, Uint64 x)
   {
       XmlWriter::append(out, x);
   }
   
   inline void _xmlWritter_appendValue(Buffer& out, Sint64 x)
   {
       XmlWriter::append(out, x);
   }
   
   inline void _xmlWritter_appendValue(Buffer& out, Real32 x)
   {
       XmlWriter::append(out, x);
   }
   
   inline void _xmlWritter_appendValue(Buffer& out, Real64 x)
   {
       XmlWriter::append(out, x);
   }
   
   inline void _xmlWritter_appendValue(Buffer& out, const Char16& x)
   {
       XmlWriter::appendSpecial(out, x);
   }
   
   inline void _xmlWritter_appendValue(Buffer& out, const String& x)
   {
       XmlWriter::appendSpecial(out, x);
   }
   
   inline void _xmlWritter_appendValue(Buffer& out, const CIMDateTime& x)
   {
       out << x.toString();  //ATTN: append() method?
   }
   
   inline void _xmlWritter_appendValue(Buffer& out, const CIMObjectPath& x)
   {
       XmlWriter::appendValueReferenceElement(out, x, true);
   }
   
   inline void _xmlWritter_appendValue(Buffer& out, const CIMObject& x)
   {
       String myStr = x.toString();
       _xmlWritter_appendValue(out, myStr);
   }
   
   void _xmlWritter_appendValueArray(Buffer& out, const CIMObjectPath* p, Uint32 size)
   {
       out << LIT("<VALUE.REFARRAY>\n");
       while (size--)
       {
           _xmlWritter_appendValue(out, *p++);
       }
       out << LIT("</VALUE.REFARRAY>\n");
   }
   
   template<class T>
   void _xmlWritter_appendValueArray(Buffer& out, const T* p, Uint32 size)
   {
       out << LIT("<VALUE.ARRAY>\n");
   
       while (size--)
       {
           out << LIT("<VALUE>");
           _xmlWritter_appendValue(out, *p++);
           out << LIT("</VALUE>\n");
       }
   
       out << LIT("</VALUE.ARRAY>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // appendValueElement()
   //
   //    <!ELEMENT VALUE (#PCDATA)>
   //    <!ELEMENT VALUE.ARRAY (VALUE*)>
   //    <!ELEMENT VALUE.REFERENCE
   //        (CLASSPATH|LOCALCLASSPATH|CLASSNAME|INSTANCEPATH|LOCALINSTANCEPATH|
   //         INSTANCENAME)>
   //    <!ELEMENT VALUE.REFARRAY (VALUE.REFERENCE*)>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendValueElement(
       Buffer& out,
       const CIMValue& value)
   {
       if (value.isNull())
       {
           return;
       }
       if (value.isArray())
       {
           switch (value.getType())
           {
               case CIMTYPE_BOOLEAN:
               {
                   Array<Boolean> a;
                   value.get(a);
                   _xmlWritter_appendValueArray(out, a.getData(), a.size());
                   break;
               }
   
               case CIMTYPE_UINT8:
               {
                   Array<Uint8> a;
                   value.get(a);
                   _xmlWritter_appendValueArray(out, a.getData(), a.size());
                   break;
               }
   
               case CIMTYPE_SINT8:
               {
                   Array<Sint8> a;
                   value.get(a);
                   _xmlWritter_appendValueArray(out, a.getData(), a.size());
                   break;
               }
   
               case CIMTYPE_UINT16:
               {
                   Array<Uint16> a;
                   value.get(a);
                   _xmlWritter_appendValueArray(out, a.getData(), a.size());
                   break;
               }
   
               case CIMTYPE_SINT16:
               {
                   Array<Sint16> a;
                   value.get(a);
                   _xmlWritter_appendValueArray(out, a.getData(), a.size());
                   break;
               }
   
               case CIMTYPE_UINT32:
               {
                   Array<Uint32> a;
                   value.get(a);
                   _xmlWritter_appendValueArray(out, a.getData(), a.size());
                   break;
               }
   
               case CIMTYPE_SINT32:
               {
                   Array<Sint32> a;
                   value.get(a);
                   _xmlWritter_appendValueArray(out, a.getData(), a.size());
                   break;
               }
   
               case CIMTYPE_UINT64:
               {
                   Array<Uint64> a;
                   value.get(a);
                   _xmlWritter_appendValueArray(out, a.getData(), a.size());
                   break;
               }
   
               case CIMTYPE_SINT64:
               {
                   Array<Sint64> a;
                   value.get(a);
                   _xmlWritter_appendValueArray(out, a.getData(), a.size());
                   break;
               }
   
               case CIMTYPE_REAL32:
               {
                   Array<Real32> a;
                   value.get(a);
                   _xmlWritter_appendValueArray(out, a.getData(), a.size());
                   break;
               }
   
               case CIMTYPE_REAL64:
               {
                   Array<Real64> a;
                   value.get(a);
                   _xmlWritter_appendValueArray(out, a.getData(), a.size());
                   break;
               }
   
               case CIMTYPE_CHAR16:
               {
                   Array<Char16> a;
                   value.get(a);
                   _xmlWritter_appendValueArray(out, a.getData(), a.size());
                   break;
               }
   
               case CIMTYPE_STRING:
               {
                   Array<String> a;
                   value.get(a);
                   _xmlWritter_appendValueArray(out, a.getData(), a.size());
                   break;
               }
   
               case CIMTYPE_DATETIME:
               {
                   Array<CIMDateTime> a;
                   value.get(a);
                   _xmlWritter_appendValueArray(out, a.getData(), a.size());
                   break;
               }
   
               case CIMTYPE_REFERENCE:
               {
                   Array<CIMObjectPath> a;
                   value.get(a);
                   _xmlWritter_appendValueArray(out, a.getData(), a.size());
                   break;
               }
   
               case CIMTYPE_OBJECT:
               {
                   Array<CIMObject> a;
                   value.get(a);
                   _xmlWritter_appendValueArray(out, a.getData(), a.size());
                   break;
               }
   
               default:
                   PEGASUS_ASSERT(false);
           }
       }
       else if (value.getType() == CIMTYPE_REFERENCE)
       {
           // Has to be separate because it uses VALUE.REFERENCE tag
           CIMObjectPath v;
           value.get(v);
           _xmlWritter_appendValue(out, v);
       }
       else
       {
           out << LIT("<VALUE>");
   
           switch (value.getType())
           {
               case CIMTYPE_BOOLEAN:
               {
                   Boolean v;
                   value.get(v);
                   _xmlWritter_appendValue(out, v);
                   break;
               }
   
               case CIMTYPE_UINT8:
               {
                   Uint8 v;
                   value.get(v);
                   _xmlWritter_appendValue(out, v);
                   break;
               }
   
               case CIMTYPE_SINT8:
               {
                   Sint8 v;
                   value.get(v);
                   _xmlWritter_appendValue(out, v);
                   break;
               }
   
               case CIMTYPE_UINT16:
               {
                   Uint16 v;
                   value.get(v);
                   _xmlWritter_appendValue(out, v);
                   break;
               }
   
               case CIMTYPE_SINT16:
               {
                   Sint16 v;
                   value.get(v);
                   _xmlWritter_appendValue(out, v);
                   break;
               }
   
               case CIMTYPE_UINT32:
               {
                   Uint32 v;
                   value.get(v);
                   _xmlWritter_appendValue(out, v);
                   break;
               }
   
               case CIMTYPE_SINT32:
               {
                   Sint32 v;
                   value.get(v);
                   _xmlWritter_appendValue(out, v);
                   break;
               }
   
               case CIMTYPE_UINT64:
               {
                   Uint64 v;
                   value.get(v);
                   _xmlWritter_appendValue(out, v);
                   break;
               }
   
               case CIMTYPE_SINT64:
               {
                   Sint64 v;
                   value.get(v);
                   _xmlWritter_appendValue(out, v);
                   break;
               }
   
               case CIMTYPE_REAL32:
               {
                   Real32 v;
                   value.get(v);
                   _xmlWritter_appendValue(out, v);
                   break;
               }
   
               case CIMTYPE_REAL64:
               {
                   Real64 v;
                   value.get(v);
                   _xmlWritter_appendValue(out, v);
                   break;
               }
   
               case CIMTYPE_CHAR16:
               {
                   Char16 v;
                   value.get(v);
                   _xmlWritter_appendValue(out, v);
                   break;
               }
   
               case CIMTYPE_STRING:
               {
                   String v;
                   value.get(v);
                   _xmlWritter_appendValue(out, v);
                   break;
               }
   
               case CIMTYPE_DATETIME:
               {
                   CIMDateTime v;
                   value.get(v);
                   _xmlWritter_appendValue(out, v);
                   break;
               }
   
               case CIMTYPE_OBJECT:
               {
                   CIMObject v;
                   value.get(v);
                   _xmlWritter_appendValue(out, v);
                   break;
               }
   
               default:
                   PEGASUS_ASSERT(false);
           }
   
           out << LIT("</VALUE>\n");
       }
   }
   
   void XmlWriter::printValueElement(
       const CIMValue& value,
       PEGASUS_STD(ostream)& os)
   {
       Buffer tmp;
       appendValueElement(tmp, value);
       tmp.append('\0');
       os << tmp.getData() << PEGASUS_STD(endl);
   }
   
   //------------------------------------------------------------------------------
   //
   // appendValueObjectWithPathElement()
   //
   //     <!ELEMENT VALUE.OBJECTWITHPATH
   //         ((CLASSPATH,CLASS)|(INSTANCEPATH,INSTANCE))>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendValueObjectWithPathElement(
       Buffer& out,
       const CIMObject& objectWithPath)
   {
       out << LIT("<VALUE.OBJECTWITHPATH>\n");
   
       appendValueReferenceElement(out, objectWithPath.getPath (), false);
       appendObjectElement(out, objectWithPath);
   
       out << LIT("</VALUE.OBJECTWITHPATH>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // appendValueReferenceElement()
   //
   //    <!ELEMENT VALUE.REFERENCE
   //        (CLASSPATH|LOCALCLASSPATH|CLASSNAME|INSTANCEPATH|LOCALINSTANCEPATH|
   //         INSTANCENAME)>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendValueReferenceElement(
       Buffer& out,
       const CIMObjectPath& reference,
       Boolean putValueWrapper)
   {
       if (putValueWrapper)
           out << LIT("<VALUE.REFERENCE>\n");
   
       // See if it is a class or instance reference (instance references have
       // key-bindings; class references do not).
       //
       //  ATTN-CAKG-P2-20020726:  The following condition does not correctly
       //  distinguish instanceNames from classNames in every case
       //  The instanceName of a singleton instance of a keyless class has no
       //  key bindings
       //
   
       Array<CIMKeyBinding> kbs = reference.getKeyBindings();
   
       if (kbs.size())
       {
           if (reference.getHost().size())
           {
               appendInstancePathElement(out, reference);
           }
           else if (!reference.getNameSpace().isNull())
           {
               appendLocalInstancePathElement(out, reference);
           }
           else
           {
               appendInstanceNameElement(out, reference);
           }
       }
       else
       {
           if (reference.getHost().size())
           {
               appendClassPathElement(out, reference);
           }
           else if (!reference.getNameSpace().isNull())
           {
               appendLocalClassPathElement(out, reference);
           }
           else
           {
               appendClassNameElement(out, reference.getClassName());
           }
       }
   
       if (putValueWrapper)
           out << LIT("</VALUE.REFERENCE>\n");
   }
   
   void XmlWriter::printValueReferenceElement(
       const CIMObjectPath& reference,
       PEGASUS_STD(ostream)& os)
   {
       Buffer tmp;
       appendValueReferenceElement(tmp, reference, true);
       tmp.append('\0');
       indentedPrint(os, tmp.getData());
   }
   
   //------------------------------------------------------------------------------
   //
   // appendValueNamedInstanceElement()
   //
   //     <!ELEMENT VALUE.NAMEDINSTANCE (INSTANCENAME,INSTANCE)>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendValueNamedInstanceElement(
       Buffer& out,
       const CIMInstance& namedInstance)
   {
       out << LIT("<VALUE.NAMEDINSTANCE>\n");
   
       appendInstanceNameElement(out, namedInstance.getPath ());
       appendInstanceElement(out, namedInstance);
   
       out << LIT("</VALUE.NAMEDINSTANCE>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // appendClassElement()
   //
   //     <!ELEMENT CLASS
   //         (QUALIFIER*,(PROPERTY|PROPERTY.ARRAY|PROPERTY.REFERENCE)*,METHOD*)>
   //     <!ATTLIST CLASS
   //         %CIMName;
   //         %SuperClass;>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendClassElement(
       Buffer& out,
       const CIMConstClass& cimclass)
   {
       cimclass._checkRep();
       cimclass._rep->toXml(out);
   }
   
   void XmlWriter::printClassElement(
       const CIMConstClass& cimclass,
       PEGASUS_STD(ostream)& os)
   {
       Buffer tmp;
       appendClassElement(tmp, cimclass);
       tmp.append('\0');
       indentedPrint(os, tmp.getData(), 4);
   }
   
   //------------------------------------------------------------------------------
   //
   // appendInstanceElement()
   //
   //     <!ELEMENT INSTANCE
   //         (QUALIFIER*,(PROPERTY|PROPERTY.ARRAY|PROPERTY.REFERENCE)*)>
   //     <!ATTLIST INSTANCE
   //         %ClassName;>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendInstanceElement(
       Buffer& out,
       const CIMConstInstance& instance)
   {
       instance._checkRep();
       instance._rep->toXml(out);
   }
   
   void XmlWriter::printInstanceElement(
       const CIMConstInstance& instance,
       PEGASUS_STD(ostream)& os)
   {
       Buffer tmp;
       appendInstanceElement(tmp, instance);
       tmp.append('\0');
       os << tmp.getData() << PEGASUS_STD(endl);
   }
   
   //------------------------------------------------------------------------------
   //
   // appendObjectElement()
   //
   // May refer to a CLASS or an INSTANCE
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendObjectElement(
       Buffer& out,
       const CIMConstObject& object)
   {
       if (object.isClass())
       {
           CIMConstClass c(object);
           appendClassElement(out, c);
       }
       else if (object.isInstance())
       {
           CIMConstInstance i(object);
           appendInstanceElement(out, i);
       }
       // else PEGASUS_ASSERT(0);
   }
   
   //------------------------------------------------------------------------------
   //
   // appendPropertyElement()
   //
   //     <!ELEMENT PROPERTY (QUALIFIER*,VALUE?)>
   //     <!ATTLIST PROPERTY
   //              %CIMName;
   //              %CIMType;           #REQUIRED
   //              %ClassOrigin;
   //              %Propagated;>
   //
   //     <!ELEMENT PROPERTY.ARRAY (QUALIFIER*,VALUE.ARRAY?)>
   //     <!ATTLIST PROPERTY.ARRAY
   //              %CIMName;
   //              %CIMType;           #REQUIRED
   //              %ArraySize;
   //              %ClassOrigin;
   //              %Propagated;>
   //
   //     <!ELEMENT PROPERTY.REFERENCE (QUALIFIER*,VALUE.REFERENCE?)>
   //     <!ATTLIST PROPERTY.REFERENCE
   //              %CIMName;
   //              %ReferenceClass;
   //              %ClassOrigin;
   //              %Propagated;>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendPropertyElement(
       Buffer& out,
       const CIMConstProperty& property)
   {
       property._checkRep();
       property._rep->toXml(out);
   }
   
   void XmlWriter::printPropertyElement(
       const CIMConstProperty& property,
       PEGASUS_STD(ostream)& os)
   {
       Buffer tmp;
       appendPropertyElement(tmp, property);
       tmp.append('\0');
       os << tmp.getData() << PEGASUS_STD(endl);
   }
   
   //------------------------------------------------------------------------------
   //
   // appendMethodElement()
   //
   //     <!ELEMENT METHOD (QUALIFIER*,
   //         (PARAMETER|PARAMETER.REFERENCE|PARAMETER.ARRAY|PARAMETER.REFARRAY)*)>
   //     <!ATTLIST METHOD
   //              %CIMName;
   //              %CIMType;          #IMPLIED
   //              %ClassOrigin;
   //              %Propagated;>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendMethodElement(
       Buffer& out,
       const CIMConstMethod& method)
   {
       method._checkRep();
       method._rep->toXml(out);
   }
   
   void XmlWriter::printMethodElement(
       const CIMConstMethod& method,
       PEGASUS_STD(ostream)& os)
   {
       Buffer tmp;
       appendMethodElement(tmp, method);
       tmp.append('\0');
       os << tmp.getData() << PEGASUS_STD(endl);
   }
   
   //------------------------------------------------------------------------------
   //
   // appendParameterElement()
   //
   //     <!ELEMENT PARAMETER (QUALIFIER*)>
   //     <!ATTLIST PARAMETER
   //              %CIMName;
   //              %CIMType;      #REQUIRED>
   //
   //     <!ELEMENT PARAMETER.REFERENCE (QUALIFIER*)>
   //     <!ATTLIST PARAMETER.REFERENCE
   //              %CIMName;
   //              %ReferenceClass;>
   //
   //     <!ELEMENT PARAMETER.ARRAY (QUALIFIER*)>
   //     <!ATTLIST PARAMETER.ARRAY
   //              %CIMName;
   //              %CIMType;           #REQUIRED
   //              %ArraySize;>
   //
   //     <!ELEMENT PARAMETER.REFARRAY (QUALIFIER*)>
   //     <!ATTLIST PARAMETER.REFARRAY
   //              %CIMName;
   //              %ReferenceClass;
   //              %ArraySize;>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendParameterElement(
       Buffer& out,
       const CIMConstParameter& parameter)
   {
       parameter._checkRep();
       parameter._rep->toXml(out);
   }
   
   void XmlWriter::printParameterElement(
       const CIMConstParameter& parameter,
       PEGASUS_STD(ostream)& os)
   {
       Buffer tmp;
       appendParameterElement(tmp, parameter);
       tmp.append('\0');
       os << tmp.getData() << PEGASUS_STD(endl);
   }
   
   //------------------------------------------------------------------------------
   //
   // appendParamValueElement()
   //
   //     <!ELEMENT PARAMVALUE (VALUE|VALUE.REFERENCE|VALUE.ARRAY|VALUE.REFARRAY)?>
   //     <!ATTLIST PARAMVALUE
   //              %CIMName;>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendParamValueElement(
       Buffer& out,
       const CIMParamValue& paramValue)
   {
       paramValue._checkRep();
       paramValue._rep->toXml(out);
   }
   
   void XmlWriter::printParamValueElement(
       const CIMParamValue& paramValue,
       PEGASUS_STD(ostream)& os)
   {
       Buffer tmp;
       appendParamValueElement(tmp, paramValue);
       tmp.append('\0');
       os << tmp.getData() << PEGASUS_STD(endl);
   }
   
   //------------------------------------------------------------------------------
   //
   // appendQualifierElement()
   //
   //     <!ELEMENT QUALIFIER (VALUE|VALUE.ARRAY)>
   //     <!ATTLIST QUALIFIER
   //              %CIMName;
   //              %CIMType;               #REQUIRED
   //              %Propagated;
   //              %QualifierFlavor;>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendQualifierElement(
       Buffer& out,
       const CIMConstQualifier& qualifier)
   {
       qualifier._checkRep();
       qualifier._rep->toXml(out);
   }
   
   void XmlWriter::printQualifierElement(
       const CIMConstQualifier& qualifier,
       PEGASUS_STD(ostream)& os)
   {
       Buffer tmp;
       appendQualifierElement(tmp, qualifier);
       tmp.append('\0');
       os << tmp.getData() << PEGASUS_STD(endl);
   }
   
   //------------------------------------------------------------------------------
   //
   // appendQualifierDeclElement()
   //
   //     <!ELEMENT QUALIFIER.DECLARATION (SCOPE?,(VALUE|VALUE.ARRAY)?)>
   //     <!ATTLIST QUALIFIER.DECLARATION
   //              %CIMName;
   //              %CIMType;                       #REQUIRED
   //              ISARRAY        (true|false)     #IMPLIED
   //              %ArraySize;
   //              %QualifierFlavor;>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendQualifierDeclElement(
       Buffer& out,
       const CIMConstQualifierDecl& qualifierDecl)
   {
       qualifierDecl._checkRep();
       qualifierDecl._rep->toXml(out);
   }
   
   void XmlWriter::printQualifierDeclElement(
       const CIMConstQualifierDecl& qualifierDecl,
       PEGASUS_STD(ostream)& os)
   {
       Buffer tmp;
       appendQualifierDeclElement(tmp, qualifierDecl);
       tmp.append('\0');
       os << tmp.getData() << PEGASUS_STD(endl);
   }
   
   //------------------------------------------------------------------------------
   //
   // appendQualifierFlavorEntity()
   //
   //     <!ENTITY % QualifierFlavor "OVERRIDABLE  (true|false)   'true'
   //                                 TOSUBCLASS   (true|false)   'true'
   //                                 TOINSTANCE   (true|false)   'false'
   //                                 TRANSLATABLE (true|false)   'false'">
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendQualifierFlavorEntity(
       Buffer& out,
       const CIMFlavor & flavor)
   {
       if (!(flavor.hasFlavor (CIMFlavor::OVERRIDABLE)))
           out << LIT(" OVERRIDABLE=\"false\"");
   
       if (!(flavor.hasFlavor (CIMFlavor::TOSUBCLASS)))
           out << LIT(" TOSUBCLASS=\"false\"");
   
       if (flavor.hasFlavor (CIMFlavor::TOINSTANCE))
           out << LIT(" TOINSTANCE=\"true\"");
   
       if (flavor.hasFlavor (CIMFlavor::TRANSLATABLE))
           out << LIT(" TRANSLATABLE=\"true\"");
   }
   
   //------------------------------------------------------------------------------
   //
   // appendScopeElement()
   //
   //     <!ELEMENT SCOPE EMPTY>
   //     <!ATTLIST SCOPE
   //              CLASS        (true|false)      'false'
   //              ASSOCIATION  (true|false)      'false'
   //              REFERENCE    (true|false)      'false'
   //              PROPERTY     (true|false)      'false'
   //              METHOD       (true|false)      'false'
   //              PARAMETER    (true|false)      'false'
   //              INDICATION   (true|false)      'false'>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendScopeElement(
       Buffer& out,
       const CIMScope & scope)
   {
       if (!(scope.equal (CIMScope ())))
       {
           out << LIT("<SCOPE");
   
           if (scope.hasScope (CIMScope::CLASS))
               out << LIT(" CLASS=\"true\"");
   
           if (scope.hasScope (CIMScope::ASSOCIATION))
               out << LIT(" ASSOCIATION=\"true\"");
   
           if (scope.hasScope (CIMScope::REFERENCE))
               out << LIT(" REFERENCE=\"true\"");
   
           if (scope.hasScope (CIMScope::PROPERTY))
               out << LIT(" PROPERTY=\"true\"");
   
           if (scope.hasScope (CIMScope::METHOD))
               out << LIT(" METHOD=\"true\"");
   
           if (scope.hasScope (CIMScope::PARAMETER))
               out << LIT(" PARAMETER=\"true\"");
   
           if (scope.hasScope (CIMScope::INDICATION))
               out << LIT(" INDICATION=\"true\"");
   
           out << LIT("/>");
       }
   }
   
   // l10n - added content language and accept language support to
   // the header methods below
   
   //------------------------------------------------------------------------------
   //
   // appendMethodCallHeader()
   //
   //     Build HTTP method call request header.
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendMethodCallHeader(
       Buffer& out,
       const char* host,
       const CIMName& cimMethod,
       const String& cimObject,
       const String& authenticationHeader,
       HttpMethod httpMethod,
       const AcceptLanguages & acceptLanguages,
       const ContentLanguages & contentLanguages,
       Uint32 contentLength)
   {
       char nn[] = { '0' + (rand() % 10), '0' + (rand() % 10), '\0' };
   
       // ATTN: KS 20020926 - Temporary change to issue only POST. This may
       // be changed in the DMTF CIM Operations standard in the future.
       // If we kept M-Post we would have to retry with Post. Does not
       // do that in client today. Permanent change is to retry until spec
       // updated. This change is temp to finish tests or until the retry
       // installed.  Required because of change to wbemservices cimom
       if (httpMethod == HTTP_METHOD_M_POST)
       {
           out << LIT("M-POST /cimom HTTP/1.1\r\n");
       }
       else
       {
           out << LIT("POST /cimom HTTP/1.1\r\n");
       }
       out << LIT("HOST: ") << host << LIT("\r\n");
       out << LIT("Content-Type: application/xml; charset=\"utf-8\"\r\n");
       OUTPUT_CONTENTLENGTH;
       if (acceptLanguages.size() > 0)
       {
           out << LIT("Accept-Language: ") << acceptLanguages << LIT("\r\n");
       }
       if (contentLanguages.size() > 0)
       {
           out << LIT("Content-Language: ") << contentLanguages << LIT("\r\n");
       }
   
   #ifdef PEGASUS_DEBUG
                   // backdoor environment variable to turn OFF client requesting transfer
                   // encoding. The default is on. to turn off, set this variable to zero.
                   // This should be removed when stable. This should only be turned off in
                   // a debugging/testing environment.
   
                   static const char *clientTransferEncodingOff =
                           getenv("PEGASUS_HTTP_TRANSFER_ENCODING_REQUEST");
                   if (!clientTransferEncodingOff || *clientTransferEncodingOff != '0')
   #endif
   
                           out << LIT("TE: chunked, trailers\r\n");
   
       if (httpMethod == HTTP_METHOD_M_POST)
       {
           out << LIT("Man: http://www.dmtf.org/cim/mapping/http/v1.0; ns=");
           out << nn << LIT("\r\n");
           out << nn << LIT("-CIMOperation: MethodCall\r\n");
           out << nn << LIT("-CIMMethod: ")
               << encodeURICharacters(cimMethod.getString()) << LIT("\r\n");
           out << nn << LIT("-CIMObject: ") << encodeURICharacters(cimObject)
               << LIT("\r\n");
       }
       else
       {
           out << LIT("CIMOperation: MethodCall\r\n");
           out << LIT("CIMMethod: ") << encodeURICharacters(cimMethod.getString())
               << LIT("\r\n");
           out << LIT("CIMObject: ") << encodeURICharacters(cimObject)
               << LIT("\r\n");
       }
   
       if (authenticationHeader.size())
       {
           out << authenticationHeader << LIT("\r\n");
       }
   
       out << LIT("\r\n");
   }
   
   
   void XmlWriter::appendMethodResponseHeader(
        Buffer& out,
        HttpMethod httpMethod,
        const ContentLanguages & contentLanguages,
        Uint32 contentLength,
        Uint32 serverResponseTime)
   {
        char nn[] = { '0' + (rand() % 10), '0' + (rand() % 10), '\0' };
        out << LIT("HTTP/1.1 " HTTP_STATUS_OK "\r\n");
        STAT_SERVERTIME
        out << LIT("Content-Type: application/xml; charset=\"utf-8\"\r\n");
        OUTPUT_CONTENTLENGTH;
   
        if (contentLanguages.size() > 0)
        {
            out << LIT("Content-Language: ") << contentLanguages << LIT("\r\n");
        }
        if (httpMethod == HTTP_METHOD_M_POST)
        {
            out << LIT("Ext:\r\n");
            out << LIT("Cache-Control: no-cache\r\n");
            out << LIT("Man: http://www.dmtf.org/cim/mapping/http/v1.0; ns=");
            out << nn << LIT("\r\n");
            out << nn << LIT("-CIMOperation: MethodResponse\r\n\r\n");
        }
        else
        {
            out << LIT("CIMOperation: MethodResponse\r\n\r\n");
        }
   }
   
   
   //------------------------------------------------------------------------------
   //
   // appendHttpErrorResponseHeader()
   //
   //     Build HTTP error response header.
   //
   //     Returns error response message in the following format:
   //
   //        HTTP/1.1 400 Bad Request       (using specified status code)
   //        CIMError: <error type>         (if specified by caller)
   //        PGErrorDetail: <error text>    (if specified by caller)
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendHttpErrorResponseHeader(
       Buffer& out,
       const String& status,
       const String& cimError,
       const String& errorDetail)
   {
       out << LIT("HTTP/1.1 ") << status << LIT("\r\n");
       if (cimError != String::EMPTY)
       {
           out << LIT("CIMError: ") << cimError << LIT("\r\n");
       }
       if (errorDetail != String::EMPTY)
       {
           // ATTN-RK-P3-20020404: It is critical that this text not contain '\n'
           // ATTN-RK-P3-20020404: Need to encode this value properly.  (See
           // CIM/HTTP Specification section 3.3.2
           out << LIT(PEGASUS_HTTPHEADERTAG_ERRORDETAIL ": ")
               << encodeURICharacters(errorDetail) << LIT("\r\n");
       }
       out << LIT("\r\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // appendUnauthorizedResponseHeader()
   //
   //     Build HTTP authentication response header for unauthorized requests.
   //
   //     Returns unauthorized message in the following format:
   //
   //        HTTP/1.1 401 Unauthorized
   //        WWW-Authenticate: Basic "hostname:80"
   //        <HTML><HEAD>
   //        <TITLE>401 Unauthorized</TITLE>
   //        </HEAD><BODY BGCOLOR="#99cc99">
   //        <H2>TEST401 Unauthorized</H2>
   //        <HR>
   //        </BODY></HTML>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendUnauthorizedResponseHeader(
       Buffer& out,
       const String& content)
   {
       out << LIT("HTTP/1.1 " HTTP_STATUS_UNAUTHORIZED "\r\n");
       out << content << LIT("\r\n");
       out << LIT("\r\n");
   
   //ATTN: We may need to include the following line, so that the browsers
   //      can display the error message.
   //    out << "<HTML><HEAD>\r\n";
   //    out << "<TITLE>" << "401 Unauthorized" <<  "</TITLE>\r\n";
   //    out << "</HEAD><BODY BGCOLOR=\"#99cc99\">\r\n";
   //    out << "<H2>TEST" << "401 Unauthorized" << "</H2>\r\n";
   //    out << "<HR>\r\n";
   //    out << "</BODY></HTML>\r\n";
   }
   
   #ifdef PEGASUS_KERBEROS_AUTHENTICATION
   //------------------------------------------------------------------------------
   //
   // appendOKResponseHeader()
   //
   //     Build HTTP authentication response header for unauthorized requests.
   //
   //     Returns OK message in the following format:
   //
   //        HTTP/1.1 200 OK
   //        Content-Length: 0
   //        WWW-Authenticate: Negotiate "token"
   //        <HTML><HEAD>
   //        <TITLE>200 OK</TITLE>
   //        </HEAD><BODY BGCOLOR="#99cc99">
   //        <H2>TEST200 OK</H2>
   //        <HR>
   //        </BODY></HTML>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendOKResponseHeader(
       Buffer& out,
       const String& content)
   {
       out << LIT("HTTP/1.1 " HTTP_STATUS_OK "\r\n");
       // Content-Length header needs to be added because 200 OK record
       // is usually intended to have content.  But, for Kerberos this
       // may not always be the case so we need to indicate that there
       // is no content
                   Uint32 contentLength = 0;
                   OUTPUT_CONTENTLENGTH;
       out << content << LIT("\r\n");
       out << LIT("\r\n");
   
   //ATTN: We may need to include the following line, so that the browsers
   //      can display the error message.
   //    out << "<HTML><HEAD>\r\n";
   //    out << "<TITLE>" << "200 OK" <<  "</TITLE>\r\n";
   //    out << "</HEAD><BODY BGCOLOR=\"#99cc99\">\r\n";
   //    out << "<H2>TEST" << "200 OK" << "</H2>\r\n";
   //    out << "<HR>\r\n";
   //    out << "</BODY></HTML>\r\n";
   }
   #endif
   
   //------------------------------------------------------------------------------
   //
   // _appendMessageElementBegin()
   // _appendMessageElementEnd()
   //
   //     <!ELEMENT MESSAGE (SIMPLEREQ|MULTIREQ|SIMPLERSP|MULTIRSP)>
   //     <!ATTLIST MESSAGE
   //         ID CDATA #REQUIRED
   //         PROTOCOLVERSION CDATA #REQUIRED>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::_appendMessageElementBegin(
       Buffer& out,
       const String& messageId)
   {
       out << LIT("<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n");
       out << LIT("<CIM CIMVERSION=\"2.0\" DTDVERSION=\"2.0\">\n");
       out << LIT("<MESSAGE ID=\"") << messageId;
       out << LIT("\" PROTOCOLVERSION=\"1.0\">\n");
   }
   
   void XmlWriter::_appendMessageElementEnd(
       Buffer& out)
   {
       out << LIT("</MESSAGE>\n");
       out << LIT("</CIM>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // _appendSimpleReqElementBegin()
   // _appendSimpleReqElementEnd()
   //
   //     <!ELEMENT SIMPLEREQ (IMETHODCALL|METHODCALL)>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::_appendSimpleReqElementBegin(
       Buffer& out)
   {
       out << LIT("<SIMPLEREQ>\n");
   }
   
   void XmlWriter::_appendSimpleReqElementEnd(
       Buffer& out)
   {
       out << LIT("</SIMPLEREQ>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // _appendMethodCallElementBegin()
   // _appendMethodCallElementEnd()
   //
   //     <!ELEMENT METHODCALL ((LOCALCLASSPATH|LOCALINSTANCEPATH),PARAMVALUE*)>
   //     <!ATTLIST METHODCALL %CIMName;>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::_appendMethodCallElementBegin(
       Buffer& out,
       const CIMName& name)
   {
       out << LIT("<METHODCALL NAME=\"") << name << LIT("\">\n");
   }
   
   void XmlWriter::_appendMethodCallElementEnd(
       Buffer& out)
   {
       out << LIT("</METHODCALL>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // _appendIMethodCallElementBegin()
   // _appendIMethodCallElementEnd()
   //
   //     <!ELEMENT IMETHODCALL (LOCALNAMESPACEPATH,IPARAMVALUE*)>
   //     <!ATTLIST IMETHODCALL %CIMName;>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::_appendIMethodCallElementBegin(
       Buffer& out,
       const CIMName& name)
   {
       out << LIT("<IMETHODCALL NAME=\"") << name << LIT("\">\n");
   }
   
   void XmlWriter::_appendIMethodCallElementEnd(
       Buffer& out)
   {
       out << LIT("</IMETHODCALL>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // _appendIParamValueElementBegin()
   // _appendIParamValueElementEnd()
   //
   //     <!ELEMENT IPARAMVALUE (VALUE|VALUE.ARRAY|VALUE.REFERENCE
   //         |INSTANCENAME|CLASSNAME|QUALIFIER.DECLARATION
   //         |CLASS|INSTANCE|VALUE.NAMEDINSTANCE)?>
   //     <!ATTLIST IPARAMVALUE %CIMName;>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::_appendIParamValueElementBegin(
       Buffer& out,
       const char* name)
   {
       out << LIT("<IPARAMVALUE NAME=\"") << name << LIT("\">\n");
   }
   
   void XmlWriter::_appendIParamValueElementEnd(
       Buffer& out)
   {
       out << LIT("</IPARAMVALUE>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // _appendSimpleRspElementBegin()
   // _appendSimpleRspElementEnd()
   //
   //     <!ELEMENT SIMPLERSP (METHODRESPONSE|IMETHODRESPONSE)>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::_appendSimpleRspElementBegin(
       Buffer& out)
   {
       out << LIT("<SIMPLERSP>\n");
   }
   
   void XmlWriter::_appendSimpleRspElementEnd(
       Buffer& out)
   {
       out << LIT("</SIMPLERSP>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // _appendMethodResponseElementBegin()
   // _appendMethodResponseElementEnd()
   //
   //     <!ELEMENT METHODRESPONSE (ERROR|IRETURNVALUE?)>
   //     <!ATTLIST METHODRESPONSE %CIMName;>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::_appendMethodResponseElementBegin(
       Buffer& out,
       const CIMName& name)
   {
       out << LIT("<METHODRESPONSE NAME=\"") << name << LIT("\">\n");
   }
   
   void XmlWriter::_appendMethodResponseElementEnd(
       Buffer& out)
   {
       out << LIT("</METHODRESPONSE>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // _appendIMethodResponseElementBegin()
   // _appendIMethodResponseElementEnd()
   //
   //     <!ELEMENT IMETHODRESPONSE (ERROR|IRETURNVALUE?)>
   //     <!ATTLIST IMETHODRESPONSE %CIMName;>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::_appendIMethodResponseElementBegin(
       Buffer& out,
       const CIMName& name)
   {
       out << LIT("<IMETHODRESPONSE NAME=\"") << name << LIT("\">\n");
   }
   
   void XmlWriter::_appendIMethodResponseElementEnd(
       Buffer& out)
   {
       out << LIT("</IMETHODRESPONSE>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // _appendErrorElement()
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::_appendErrorElement(
       Buffer& out,
       const CIMException& cimException)
   {
       Tracer::traceCIMException(TRC_XML_WRITER, Tracer::LEVEL2, cimException);
   
       out << LIT("<ERROR");
       out << LIT(" CODE=\"") << Uint32(cimException.getCode());
       out.append('"');
       String description = TraceableCIMException(cimException).getDescription();
       if (description != String::EMPTY)
       {
           out << LIT(" DESCRIPTION=\"");
           appendSpecial(out, description);
           out.append('"');
       }
       out << LIT("/>");
   }
   
   //------------------------------------------------------------------------------
   //
   // appendReturnValueElement()
   //
   // <!ELEMENT RETURNVALUE (VALUE|VALUE.REFERENCE)>
   // <!ATTLIST RETURNVALUE
   //     %EmbeddedObject; #IMPLIED
   //     %ParamType;>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendReturnValueElement(
       Buffer& out,
       const CIMValue& value)
   {
       out << LIT("<RETURNVALUE");
   
       CIMType type = value.getType();
       // If the property type is CIMObject, then
       //   encode the property in CIM-XML as a string with the EMBEDDEDOBJECT attribute
       //   (there is not currently a CIM-XML "object" datatype)
       // else
       //   output the real type
       if (type == CIMTYPE_OBJECT)
       {
           out << LIT(" PARAMTYPE=\"string\"");
           out << LIT(" EMBEDDEDOBJECT=\"object\"");
       }
       else
       {
           out << LIT(" PARAMTYPE=\"") << cimTypeToString (type);
           out.append('"');
       }
   
       out << LIT(">\n");
   
       // Add value.
       appendValueElement(out, value);
       out << LIT("</RETURNVALUE>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // _appendIReturnValueElementBegin()
   // _appendIReturnValueElementEnd()
   //
   //      <!ELEMENT IRETURNVALUE (CLASSNAME*|INSTANCENAME*|VALUE*|
   //          VALUE.OBJECTWITHPATH*|VALUE.OBJECTWITHLOCALPATH*|VALUE.OBJECT*|
   //          OBJECTPATH*|QUALIFIER.DECLARATION*|VALUE.ARRAY?|VALUE.REFERENCE?|
   //          CLASS*|INSTANCE*|VALUE.NAMEDINSTANCE*)>
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::_appendIReturnValueElementBegin(
       Buffer& out)
   {
       out << LIT("<IRETURNVALUE>\n");
   }
   
   void XmlWriter::_appendIReturnValueElementEnd(
       Buffer& out)
   {
       out << LIT("</IRETURNVALUE>\n");
   }
   
   //------------------------------------------------------------------------------
   //
   // appendBooleanIParameter()
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendBooleanIParameter(
       Buffer& out,
       const char* name,
       Boolean flag)
   {
       _appendIParamValueElementBegin(out, name);
       out << LIT("<VALUE>");
       append(out, flag);
       out << LIT("</VALUE>\n");
       _appendIParamValueElementEnd(out);
   }
   
   //------------------------------------------------------------------------------
   //
   // appendStringIParameter()
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendStringIParameter(
       Buffer& out,
       const char* name,
       const String& str)
   {
       _appendIParamValueElementBegin(out, name);
       out << LIT("<VALUE>");
       appendSpecial(out, str);
       out << LIT("</VALUE>\n");
       _appendIParamValueElementEnd(out);
   }
   
   //------------------------------------------------------------------------------
   //
   // appendQualifierNameIParameter()
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendQualifierNameIParameter(
       Buffer& out,
       const char* name,
       const String& qualifierName)
   {
       // <!ELEMENT IPARAMVALUE (VALUE|VALUE.ARRAY|VALUE.REFERENCE
       //     |INSTANCENAME|CLASSNAME|QUALIFIER.DECLARATION
       //     |CLASS|INSTANCE|VALUE.NAMEDINSTANCE)?>
       //
       // ATTN: notice that there is really no way to pass a qualifier name
       // as an IPARAMVALUE element according to the spec (look above). So we
       // just pass it as a class name. An answer must be obtained later.
   
       _appendIParamValueElementBegin(out, name);
       appendClassNameElement(out, qualifierName);
       _appendIParamValueElementEnd(out);
   }
   
   //------------------------------------------------------------------------------
   //
   // appendClassNameIParameter()
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendClassNameIParameter(
       Buffer& out,
       const char* name,
       const CIMName& className)
   {
       _appendIParamValueElementBegin(out, name);
   
       //
       //  A NULL (unassigned) value for a parameter is specified by an
       //  <IPARAMVALUE> element with no subelement
       //
       if (!className.isNull ())
       {
           appendClassNameElement(out, className);
       }
   
       _appendIParamValueElementEnd(out);
   }
   
   //------------------------------------------------------------------------------
   //
   // appendInstanceNameIParameter()
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendInstanceNameIParameter(
       Buffer& out,
       const char* name,
       const CIMObjectPath& instanceName)
 { {
     AppendSpecialChar(out, x);      _appendIParamValueElementBegin(out, name);
       appendInstanceNameElement(out, instanceName);
       _appendIParamValueElementEnd(out);
 } }
  
 void XmlWriter::appendSpecial(Array<Sint8>& out, char x)  void XmlWriter::appendObjectNameIParameter(
       Buffer& out,
       const char* name,
       const CIMObjectPath& objectName)
   {
       //
       //  ATTN-CAKG-P2-20020726:  The following condition does not correctly
       //  distinguish instanceNames from classNames in every case
       //  The instanceName of a singleton instance of a keyless class also
       //  has no key bindings
       //
       if (objectName.getKeyBindings ().size () == 0)
 { {
     AppendSpecialChar(out, Char16(x));          XmlWriter::appendClassNameIParameter(
               out, name, objectName.getClassName());
 } }
       else
 void XmlWriter::appendSpecial(Array<Sint8>& out, const char* str)  
 { {
     while (*str)          XmlWriter::appendInstanceNameIParameter(
         AppendSpecialChar(out, *str++);              out, name, objectName);
       }
 } }
  
 void XmlWriter::appendSpecial(Array<Sint8>& out, const String& str)  //------------------------------------------------------------------------------
 {  //
     const Char16* tmp = str.getData();  // appendClassIParameter()
   //
   //------------------------------------------------------------------------------
  
     while (*tmp)  void XmlWriter::appendClassIParameter(
         AppendSpecialChar(out, *tmp++);      Buffer& out,
       const char* name,
       const CIMConstClass& cimClass)
   {
       _appendIParamValueElementBegin(out, name);
       appendClassElement(out, cimClass);
       _appendIParamValueElementEnd(out);
 } }
  
 void XmlWriter::append(Array<Sint8>& out, const String& str)  //------------------------------------------------------------------------------
 {  //
     const Char16* tmp = str.getData();  // appendInstanceIParameter()
   //
   //------------------------------------------------------------------------------
  
     while (*tmp)  void XmlWriter::appendInstanceIParameter(
         AppendChar(out, *tmp++);      Buffer& out,
       const char* name,
       const CIMConstInstance& instance)
   {
       _appendIParamValueElementBegin(out, name);
       appendInstanceElement(out, instance);
       _appendIParamValueElementEnd(out);
 } }
  
 void XmlWriter::append(Array<Sint8>& out, const Indentor& x)  //------------------------------------------------------------------------------
   //
   // appendNamedInstanceIParameter()
   //
   //------------------------------------------------------------------------------
   
   void XmlWriter::appendNamedInstanceIParameter(
       Buffer& out,
       const char* name,
       const CIMInstance& namedInstance)
 { {
     for (Uint32 i = 0; i < 4 * x.getLevel(); i++)      _appendIParamValueElementBegin(out, name);
         out.append(' ');      appendValueNamedInstanceElement(out, namedInstance);
       _appendIParamValueElementEnd(out);
 } }
  
 void XmlWriter::appendLocalNameSpaceElement(  //----------------------------------------------------------
     Array<Sint8>& out,  //
     const String& nameSpace)  //  appendPropertyNameIParameter()
   //
   //     </IPARAMVALUE>
   //     <IPARAMVALUE NAME="PropertyName"><VALUE>FreeSpace</VALUE></IPARAMVALUE>
   //
   //     USE: Create parameter for getProperty operation
   //==========================================================
   void XmlWriter::appendPropertyNameIParameter(
       Buffer& out,
       const CIMName& propertyName)
 { {
     out << "<LOCALNAMESPACEPATH>\n";      _appendIParamValueElementBegin(out, "PropertyName");
       out << LIT("<VALUE>") << propertyName << LIT("</VALUE>\n");
       _appendIParamValueElementEnd(out);
   }
  
     char* tmp = nameSpace.allocateCString();  //------------------------------------------------------------------------------
   //
   // appendPropertyValueIParameter()
   //
   //------------------------------------------------------------------------------
  
     for (char* p = strtok(tmp, "/"); p; p = strtok(NULL, "/"))  void XmlWriter::appendPropertyValueIParameter(
       Buffer& out,
       const char* name,
       const CIMValue& value)
     {     {
         out << "<NAMESPACE NAME=\"" << p << "\"/>\n";      _appendIParamValueElementBegin(out, name);
       appendValueElement(out, value);
       _appendIParamValueElementEnd(out);
     }     }
  
     delete [] tmp;  //------------------------------------------------------------------------------
   //
   // appendPropertyListIParameter()
   //
   //------------------------------------------------------------------------------
  
     out << "</LOCALNAMESPACEPATH>\n";  void XmlWriter::appendPropertyListIParameter(
 }      Buffer& out,
       const CIMPropertyList& propertyList)
   {
       _appendIParamValueElementBegin(out, "PropertyList");
  
 static inline void AppendSpecialChar(std::ostream& os, char c)      //
       //  A NULL (unassigned) value for a parameter is specified by an
       //  <IPARAMVALUE> element with no subelement
       //
       if (!propertyList.isNull ())
 { {
     switch (c)          out << LIT("<VALUE.ARRAY>\n");
           for (Uint32 i = 0; i < propertyList.size(); i++)
     {     {
         case '&':              out << LIT("<VALUE>") << propertyList[i] << LIT("</VALUE>\n");
             os << "&amp;";  
             break;  
   
         case '<':  
             os << "&lt;";  
             break;  
   
         case '>':  
             os << "&gt;";  
             break;  
   
         case '"':  
             os << "&quot;";  
             break;  
   
         case '\'':  
             os << "&apos;";  
             break;  
   
         default:  
             os << c;  
     }     }
           out << LIT("</VALUE.ARRAY>\n");
 } }
  
 static inline void AppendSpecial(std::ostream& os, const char* str)      _appendIParamValueElementEnd(out);
 {  
     while (*str)  
         AppendSpecialChar(os, *str++);  
 } }
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // formatGetHeader()  // appendQualifierDeclarationIParameter()
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8> XmlWriter::formatGetHeader(  void XmlWriter::appendQualifierDeclarationIParameter(
     const char* documentPath)      Buffer& out,
       const char* name,
       const CIMConstQualifierDecl& qualifierDecl)
 { {
     Array<Sint8> out;      _appendIParamValueElementBegin(out, name);
     return out << "GET " << documentPath << "HTTP/1.0\r\n\r\n";      appendQualifierDeclElement(out, qualifierDecl);
       _appendIParamValueElementEnd(out);
 } }
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // formatMPostHeader()  // XmlWriter::formatHttpErrorRspMessage()
 //  
 //     Build HTTP request header.  
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8> XmlWriter::formatMPostHeader(  Buffer XmlWriter::formatHttpErrorRspMessage(
     const char* host,      const String& status,
     const char* cimOperation,      const String& cimError,
     const char* cimMethod,      const String& errorDetail)
     const String& cimObject,  
     const Array<Sint8>& content)  
 { {
     Array<Sint8> out;      Buffer out;
     out.reserve(1024);  
     char nn[] = { '0' + (rand() % 10), '0' + (rand() % 10), '\0' };      appendHttpErrorResponseHeader(out, status, cimError, errorDetail);
  
     out << "M-POST /cimom HTTP/1.1\r\n";  
     out << "HOST: " << host << "\r\n";  
     out << "Content-CIMType: application/xml; charset=\"utf-8\"\r\n";  
     out << "Content-Length: " << content.getSize() << "\r\n";  
     out << "Man: http://www.dmtf.org/cim/mapping/http/v1.0; ns=";  
     out << nn <<"\r\n";  
     out << nn << "-CIMOperation: " << cimOperation << "\r\n";  
     out << nn << "-CIMMethod: " << cimMethod << "\r\n";  
     out << nn << "-CIMObject: " << cimObject << "\r\n\r\n";  
     out << content;  
     return out;     return out;
 } }
  
   // l10n - add content language support to the format methods below
   
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // formatMethodResponseHeader()  // XmlWriter::formatSimpleMethodReqMessage()
 //  
 //     Build HTTP response header.  
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8> XmlWriter::formatMethodResponseHeader(  // ATTN-RK-P1-20020228: Need to complete copy elimination optimization
     const Array<Sint8>& content)  Buffer XmlWriter::formatSimpleMethodReqMessage(
       const char* host,
       const CIMNamespaceName& nameSpace,
       const CIMObjectPath& path,
       const CIMName& methodName,
       const Array<CIMParamValue>& parameters,
       const String& messageId,
       HttpMethod httpMethod,
       const String& authenticationHeader,
       const AcceptLanguages& httpAcceptLanguages,
       const ContentLanguages& httpContentLanguages)
   {
       Buffer out;
       Buffer tmp;
       CIMObjectPath localObjectPath = path;
       localObjectPath.setNameSpace(nameSpace.getString());
       localObjectPath.setHost(String::EMPTY);
   
       _appendMessageElementBegin(out, messageId);
       _appendSimpleReqElementBegin(out);
       _appendMethodCallElementBegin(out, methodName);
       appendLocalObjectPathElement(out, localObjectPath);
       for (Uint32 i=0; i < parameters.size(); i++)
       {
           appendParamValueElement(out, parameters[i]);
       }
       _appendMethodCallElementEnd(out);
       _appendSimpleReqElementEnd(out);
       _appendMessageElementEnd(out);
   
       appendMethodCallHeader(
           tmp,
           host,
           methodName,
           localObjectPath.toString(),
           authenticationHeader,
           httpMethod,
           httpAcceptLanguages,
           httpContentLanguages,
           out.size());
       tmp << out;
   
       return tmp;
   }
   
   //PEP 128 adding serverRsponseTime to header
   Buffer XmlWriter::formatSimpleMethodRspMessage(
       const CIMName& methodName,
       const String& messageId,
       HttpMethod httpMethod,
       const ContentLanguages & httpContentLanguages,
       const Buffer& body,
                   Uint32 serverResponseTime,
                   Boolean isFirst,
                   Boolean isLast)
   {
           Buffer out;
   
           if (isFirst == true)
           {
                   // NOTE: temporarily put zero for content length. the http code
                   // will later decide to fill in the length or remove it altogether
                   appendMethodResponseHeader(out, httpMethod, httpContentLanguages, 0,
                                                                                                                            serverResponseTime);
                   _appendMessageElementBegin(out, messageId);
                   _appendSimpleRspElementBegin(out);
                   _appendMethodResponseElementBegin(out, methodName);
           }
   
           if (body.size() != 0)
 { {
     Array<Sint8> out;                  out << body;
     out.reserve(1024);          }
     char nn[] = { '0' + (rand() % 10), '0' + (rand() % 10), '\0' };  
           if (isLast == true)
           {
                   _appendMethodResponseElementEnd(out);
                   _appendSimpleRspElementEnd(out);
                   _appendMessageElementEnd(out);
           }
  
     out << "HTTP/1.1 200 OK\r\n";  
     out << "Content-CIMType: application/xml; charset=\"utf-8\"\r\n";  
     out << "Content-Length: " << content.getSize() << "\r\n";  
     out << "Ext:\r\n";  
     out << "Cache-Control: no-cache\r\n";  
     out << "Man: http://www.dmtf.org/cim/mapping/http/v1.0; ns=";  
     out << nn <<"\r\n";  
     out << nn << "-CIMOperation: MethodResponse\r\n\r\n";  
     out << content;  
     return out;     return out;
 } }
  
   
   
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // formatMessageElement()  // XmlWriter::formatSimpleMethodErrorRspMessage()
 //  
 //     <!ELEMENT MESSAGE (SIMPLEREQ|MULTIREQ|SIMPLERSP|MULTIRSP)>  
 //     <!ATTLIST MESSAGE  
 //         ID CDATA #REQUIRED  
 //         PROTOCOLVERSION CDATA #REQUIRED>  
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8> XmlWriter::formatMessageElement(  Buffer XmlWriter::formatSimpleMethodErrorRspMessage(
     Uint32 messageId,      const CIMName& methodName,
     const Array<Sint8>& body)      const String& messageId,
 {      HttpMethod httpMethod,
     Array<Sint8> out;      const CIMException& cimException)
     out.reserve(1024);  {
       Buffer out;
     out << "<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n";      Buffer tmp;
     out << "<CIM CIMVERSION=\"2.0\" DTDVERSION=\"2.0\">\n";  
     out << "<MESSAGE ID=\"" << messageId << "\" PROTOCOLVERSION=\"1.0\">\n";      _appendMessageElementBegin(out, messageId);
     out << body;      _appendSimpleRspElementBegin(out);
     out << "</MESSAGE>\n";      _appendMethodResponseElementBegin(out, methodName);
     out << "</CIM>\n";      _appendErrorElement(out, cimException);
     return out;      _appendMethodResponseElementEnd(out);
       _appendSimpleRspElementEnd(out);
       _appendMessageElementEnd(out);
   
   // l10n
       appendMethodResponseHeader(tmp,
           httpMethod,
           cimException.getContentLanguages(),
           out.size());
       tmp << out;
   
       return tmp;
 } }
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // formatSimpleReqElement()  // XmlWriter::formatSimpleIMethodReqMessage()
 //  
 //     <!ELEMENT SIMPLEREQ (IMETHODCALL|METHODCALL)>  
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8> XmlWriter::formatSimpleReqElement(  Buffer XmlWriter::formatSimpleIMethodReqMessage(
     const Array<Sint8>& body)      const char* host,
 {      const CIMNamespaceName& nameSpace,
     Array<Sint8> out;      const CIMName& iMethodName,
     return out << "<SIMPLEREQ>\n" << body << "</SIMPLEREQ>\n";      const String& messageId,
       HttpMethod httpMethod,
       const String& authenticationHeader,
       const AcceptLanguages& httpAcceptLanguages,
       const ContentLanguages& httpContentLanguages,
       const Buffer& body)
   {
       Buffer out;
       Buffer tmp;
   
       _appendMessageElementBegin(out, messageId);
       _appendSimpleReqElementBegin(out);
       _appendIMethodCallElementBegin(out, iMethodName);
       appendLocalNameSpacePathElement(out, nameSpace.getString());
       out << body;
       _appendIMethodCallElementEnd(out);
       _appendSimpleReqElementEnd(out);
       _appendMessageElementEnd(out);
   
       appendMethodCallHeader(
           tmp,
           host,
           iMethodName,
           nameSpace.getString(),
           authenticationHeader,
           httpMethod,
           httpAcceptLanguages,
           httpContentLanguages,
           out.size());
       tmp << out;
   
       return tmp;
 } }
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // formatSimpleRspElement()  // XmlWriter::formatSimpleIMethodRspMessage()
 //  
 //     <!ELEMENT SIMPLERSP (METHODRESPONSE|IMETHODRESPONSE)>  
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8> XmlWriter::formatSimpleRspElement(  Buffer XmlWriter::formatSimpleIMethodRspMessage(
     const Array<Sint8>& body)      const CIMName& iMethodName,
       const String& messageId,
       HttpMethod httpMethod,
       const ContentLanguages & httpContentLanguages,
       const Buffer& body,
       Uint32 serverResponseTime,
       Boolean isFirst,
       Boolean isLast)
   {
       Buffer out;
   
                   if (isFirst == true)
 { {
     Array<Sint8> out;                          // NOTE: temporarily put zero for content length. the http code
     return out << "<SIMPLERSP>\n" << body << "</SIMPLERSP>\n";                          // will later decide to fill in the length or remove it altogether
                           appendMethodResponseHeader(out, httpMethod, httpContentLanguages, 0,
                                                                                                                                    serverResponseTime);
                           _appendMessageElementBegin(out, messageId);
                           _appendSimpleRspElementBegin(out);
                           _appendIMethodResponseElementBegin(out, iMethodName);
   
                           // output the start of the return tag. Test if there is response data by:
                           // 1. there is data on the first chunk OR
                           // 2. there is no data on the first chunk but isLast is false implying
                           //    there is more non-empty data to come. If all subsequent chunks
                           //    are empty, then this generates and empty response.
                           if (body.size() != 0 || isLast == false)
                                   _appendIReturnValueElementBegin(out);
 } }
  
 //------------------------------------------------------------------------------      if (body.size() != 0)
 //      {
 // formatIMethodCallElement()                          out << body;
 //      }
 //     <!ELEMENT IMETHODCALL (LOCALNAMESPACEPATH,IPARAMVALUE*)>  
 //     <!ATTLIST IMETHODCALL %CIMName;>  
 //  
 //------------------------------------------------------------------------------  
  
 Array<Sint8> XmlWriter::formatIMethodCallElement(                  if (isLast == true)
     const char* name,  
     const String& nameSpace,  
     const Array<Sint8>& iParamValues)  
 { {
     Array<Sint8> out;                          if (body.size() != 0 || isFirst == false)
     out << "<IMETHODCALL NAME=\"" << name << "\">\n";                                  _appendIReturnValueElementEnd(out);
     XmlWriter::appendLocalNameSpaceElement(out, nameSpace);                          _appendIMethodResponseElementEnd(out);
     out << iParamValues;                          _appendSimpleRspElementEnd(out);
     out << "</IMETHODCALL>\n";                          _appendMessageElementEnd(out);
                   }
   
     return out;     return out;
 } }
  
   
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // formatIMethodResponseElement()  // XmlWriter::formatSimpleIMethodErrorRspMessage()
 //  
 //     <!ELEMENT IMETHODRESPONSE (ERROR|IRETURNVALUE?)>  
 //     <!ATTLIST IMETHODRESPONSE %CIMName;>  
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8> XmlWriter::formatIMethodResponseElement(  Buffer XmlWriter::formatSimpleIMethodErrorRspMessage(
     const char* name,      const CIMName& iMethodName,
     const Array<Sint8>& body)      const String& messageId,
       HttpMethod httpMethod,
       const CIMException& cimException)
 { {
     Array<Sint8> out;      Buffer out;
     out << "<IMETHODRESPONSE NAME=\"" << name << "\">\n";      Buffer tmp;
     out << body;  
     out << "</IMETHODRESPONSE>\n";      _appendMessageElementBegin(out, messageId);
     return out;      _appendSimpleRspElementBegin(out);
       _appendIMethodResponseElementBegin(out, iMethodName);
       _appendErrorElement(out, cimException);
       _appendIMethodResponseElementEnd(out);
       _appendSimpleRspElementEnd(out);
       _appendMessageElementEnd(out);
   
   // l10n
       appendMethodResponseHeader(tmp,
            httpMethod,
            cimException.getContentLanguages(),
            out.size());
       tmp << out;
   
       return tmp;
 } }
  
   //******************************************************************************
   //
   // Export Messages (used for indications)
   //
   //******************************************************************************
   
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // formatIReturnValueElement()  // appendEMethodRequestHeader()
 // //
 //      <!ELEMENT IRETURNVALUE (CLASSNAME*|INSTANCENAME*|VALUE*|  //     Build HTTP request header for export operation.
 //          VALUE.OBJECTWITHPATH*|VALUE.OBJECTWITHLOCALPATH*|VALUE.OBJECT*|  
 //          OBJECTPATH*|QUALIFIER.DECLARATION*|VALUE.ARRAY?|VALUE.REFERENCE?|  
 //          CLASS*|INSTANCE*|VALUE.NAMEDINSTANCE*)>  
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8> XmlWriter::formatIReturnValueElement(  void XmlWriter::appendEMethodRequestHeader(
     const Array<Sint8>& body)      Buffer& out,
       const char* requestUri,
       const char* host,
       const CIMName& cimMethod,
       HttpMethod httpMethod,
       const String& authenticationHeader,
       const AcceptLanguages& acceptLanguages,
       const ContentLanguages& contentLanguages,
       Uint32 contentLength)
   {
       char nn[] = { '0' + (rand() % 10), '0' + (rand() % 10), '\0' };
   
       if (httpMethod == HTTP_METHOD_M_POST)
       {
         out << LIT("M-POST ") << requestUri << LIT(" HTTP/1.1\r\n");
       }
       else
 { {
     Array<Sint8> out;        out << LIT("POST ") << requestUri << LIT(" HTTP/1.1\r\n");
     return out << "<IRETURNVALUE>\n" << body << "</IRETURNVALUE>\n";  
 } }
       out << LIT("HOST: ") << host << LIT("\r\n");
       out << LIT("Content-Type: application/xml; charset=\"utf-8\"\r\n");
       OUTPUT_CONTENTLENGTH;
  
 //------------------------------------------------------------------------------      if (acceptLanguages.size() > 0)
 //      {
 // formatIParamValueElement()          out << LIT("Accept-Language: ") << acceptLanguages << LIT("\r\n");
 //      }
 //     <!ELEMENT IPARAMVALUE (VALUE|VALUE.ARRAY|VALUE.REFERENCE      if (contentLanguages.size() > 0)
 //         |INSTANCENAME|CLASSNAME|QUALIFIER.DECLARATION      {
 //         |CLASS|INSTANCE|VALUE.NAMEDINSTANCE)?>          out << LIT("Content-Language: ") << contentLanguages << LIT("\r\n");
 //     <!ATTLIST IPARAMVALUE %CIMName;>      }
 //  
 //------------------------------------------------------------------------------  
  
 Array<Sint8>& XmlWriter::formatIParamValueElement(  #ifdef PEGASUS_DEBUG
     Array<Sint8>& out,                  // backdoor environment variable to turn OFF client requesting transfer
     const char* name,                  // encoding. The default is on. to turn off, set this variable to zero.
     const Array<Sint8>& body)                  // This should be removed when stable. This should only be turned off in
                   // a debugging/testing environment.
   
                   static const char *clientTransferEncodingOff =
                           getenv("PEGASUS_HTTP_TRANSFER_ENCODING_REQUEST");
                   if (!clientTransferEncodingOff || *clientTransferEncodingOff != '0')
   #endif
                           out << LIT("TE: chunked, trailers\r\n");
   
       if (httpMethod == HTTP_METHOD_M_POST)
 { {
     out << "<IPARAMVALUE NAME=\"" << name << "\">\n";          out << LIT("Man: http://www.dmtf.org/cim/mapping/http/v1.0; ns=");
     out << body;          out << nn << LIT("\r\n");
     out << "</IPARAMVALUE>\n";          out << nn << LIT("-CIMExport: MethodRequest\r\n");
     return out;          out << nn << LIT("-CIMExportMethod: ") << cimMethod << LIT("\r\n");
       }
       else
       {
           out << LIT("CIMExport: MethodRequest\r\n");
           out << LIT("CIMExportMethod: ") << cimMethod << LIT("\r\n");
       }
   
       if (authenticationHeader.size())
       {
           out << authenticationHeader << LIT("\r\n");
       }
   
       out << LIT("\r\n");
 } }
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // formatErrorElement()  // appendEMethodResponseHeader()
   //
   //     Build HTTP response header for export operation.
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8> XmlWriter::formatErrorElement(  void XmlWriter::appendEMethodResponseHeader(
     CIMException::Code code,      Buffer& out,
     const char* description)      HttpMethod httpMethod,
       const ContentLanguages& contentLanguages,
       Uint32 contentLength)
 { {
     Array<Sint8> out;      char nn[] = { '0' + (rand() % 10), '0' + (rand() % 10), '\0' };
     out << "<ERROR";  
     out << " CODE=\"" << Uint32(code) << "\"";      out << LIT("HTTP/1.1 " HTTP_STATUS_OK "\r\n");
     out << " DESCRIPTION=\"";      out << LIT("Content-Type: application/xml; charset=\"utf-8\"\r\n");
     appendSpecial(out, description);      OUTPUT_CONTENTLENGTH;
     out << "\"/>";  
     return out;      if (contentLanguages.size() > 0)
       {
           out << LIT("Content-Language: ") << contentLanguages << LIT("\r\n");
       }
       if (httpMethod == HTTP_METHOD_M_POST)
       {
           out << LIT("Ext:\r\n");
           out << LIT("Cache-Control: no-cache\r\n");
           out << LIT("Man: http://www.dmtf.org/cim/mapping/http/v1.0; ns=");
           out << nn << LIT("\r\n");
           out << nn << LIT("-CIMExport: MethodResponse\r\n\r\n");
       }
       else
       {
           out << LIT("CIMExport: MethodResponse\r\n\r\n");
       }
 } }
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // appendBooleanParameter()  // _appendSimpleExportReqElementBegin()
   // _appendSimpleExportReqElementEnd()
   //
   //     <!ELEMENT SIMPLEEXPREQ (EXPMETHODCALL)>
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8>& XmlWriter::appendBooleanParameter(  void XmlWriter::_appendSimpleExportReqElementBegin(
     Array<Sint8>& out,      Buffer& out)
     const char* name,  
     Boolean flag)  
 { {
     Array<Sint8> tmp;      out << LIT("<SIMPLEEXPREQ>\n");
     tmp << "<VALUE>" << (flag ? "TRUE" : "FALSE") << "</VALUE>\n";  }
     return formatIParamValueElement(out, name, tmp);  
   void XmlWriter::_appendSimpleExportReqElementEnd(
       Buffer& out)
   {
       out << LIT("</SIMPLEEXPREQ>\n");
 } }
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // appendClassNameParameter()  // _appendEMethodCallElementBegin()
   // _appendEMethodCallElementEnd()
   //
   //     <!ELEMENT EXPMETHODCALL (IPARAMVALUE*)>
   //     <!ATTLIST EXPMETHODCALL %CIMName;>
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8>& XmlWriter::appendClassNameParameter(  void XmlWriter::_appendEMethodCallElementBegin(
     Array<Sint8>& out,      Buffer& out,
     const char* name,      const CIMName& name)
     const String& className)  {
       out << LIT("<EXPMETHODCALL NAME=\"") << name << LIT("\">\n");
   }
   
   void XmlWriter::_appendEMethodCallElementEnd(
       Buffer& out)
 { {
     Array<Sint8> tmp;      out << LIT("</EXPMETHODCALL>\n");
     appendClassNameElement(tmp, className);  
     return formatIParamValueElement(out, name, tmp);  
 } }
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // appendQualifierNameParameter()  // _appendEParamValueElementBegin()
   // _appendEParamValueElementEnd()
   //
   //     <!ELEMENT EXPPARAMVALUE (INSTANCE)>
   //     <!ATTLIST EXPPARAMVALUE
   //         %CIMName;>
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8>& XmlWriter::appendQualifierNameParameter(  void XmlWriter::_appendEParamValueElementBegin(
     Array<Sint8>& out,      Buffer& out,
     const char* name,      const char* name)
     const String& qualifierName)  
 { {
     // <!ELEMENT IPARAMVALUE (VALUE|VALUE.ARRAY|VALUE.REFERENCE      out << LIT("<EXPPARAMVALUE NAME=\"") << name << LIT("\">\n");
     //     |INSTANCENAME|CLASSNAME|QUALIFIER.DECLARATION  }
     //     |CLASS|INSTANCE|VALUE.NAMEDINSTANCE)?>  
     //  
     // ATTN: notice that there is really no way to pass a qualifier name  
     // as an IPARAMVALUE element according to the spec (look above). So we  
     // just pass it as a class name. An answer must be obtained later.  
  
     Array<Sint8> tmp;  void XmlWriter::_appendEParamValueElementEnd(
     appendClassNameElement(tmp, qualifierName);      Buffer& out)
     return formatIParamValueElement(out, name, tmp);  {
       out << LIT("</EXPPARAMVALUE>\n");
 } }
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // appendClassParameter()  // appendInstanceEParameter()
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8>& XmlWriter::appendClassParameter(  void XmlWriter::appendInstanceEParameter(
     Array<Sint8>& out,      Buffer& out,
     const char* parameterName,      const char* name,
     const CIMConstClass& cimClass)      const CIMInstance& instance)
 { {
     Array<Sint8> tmp;      _appendEParamValueElementBegin(out, name);
     cimClass.toXml(tmp);      appendInstanceElement(out, instance);
     return formatIParamValueElement(out, parameterName, tmp);      _appendEParamValueElementEnd(out);
 } }
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // appendInstanceNameParameter()  // _appendSimpleExportRspElementBegin()
   // _appendSimpleExportRspElementEnd()
   //
   //     <!ELEMENT SIMPLEEXPRSP (EXPMETHODRESPONSE)>
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8>& XmlWriter::appendInstanceNameParameter(  void XmlWriter::_appendSimpleExportRspElementBegin(
     Array<Sint8>& out,      Buffer& out)
     const char* parameterName,  {
     const CIMReference& instanceName)      out << LIT("<SIMPLEEXPRSP>\n");
   }
   
   void XmlWriter::_appendSimpleExportRspElementEnd(
       Buffer& out)
 { {
     Array<Sint8> tmp;      out << LIT("</SIMPLEEXPRSP>\n");
     instanceName.instanceNameToXml(tmp);  
     return formatIParamValueElement(out, parameterName, tmp);  
 } }
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // appendInstanceParameter()  // _appendEMethodResponseElementBegin()
   // _appendEMethodResponseElementEnd()
   //
   //     <!ELEMENT EXPMETHODRESPONSE (ERROR|IRETURNVALUE?)>
   //     <!ATTLIST EXPMETHODRESPONSE %CIMName;>
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8>& XmlWriter::appendInstanceParameter(  void XmlWriter::_appendEMethodResponseElementBegin(
     Array<Sint8>& out,      Buffer& out,
     const char* parameterName,      const CIMName& name)
     const CIMConstInstance& instance)  
 { {
     Array<Sint8> tmp;      out << LIT("<EXPMETHODRESPONSE NAME=\"") << name << LIT("\">\n");
     instance.toXml(tmp);  }
     return formatIParamValueElement(out, parameterName, tmp);  
   void XmlWriter::_appendEMethodResponseElementEnd(
       Buffer& out)
   {
       out << LIT("</EXPMETHODRESPONSE>\n");
 } }
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // appendClassParameter()  // XmlWriter::formatSimpleEMethodReqMessage()
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8>& XmlWriter::appendQualifierDeclarationParameter(  Buffer XmlWriter::formatSimpleEMethodReqMessage(
     Array<Sint8>& out,      const char* requestUri,
     const char* parameterName,      const char* host,
     const CIMConstQualifierDecl& qualifierDecl)      const CIMName& eMethodName,
 {      const String& messageId,
     Array<Sint8> tmp;      HttpMethod httpMethod,
     qualifierDecl.toXml(tmp);      const String& authenticationHeader,
     return formatIParamValueElement(out, parameterName, tmp);      const AcceptLanguages& httpAcceptLanguages,
       const ContentLanguages& httpContentLanguages,
       const Buffer& body)
   {
       Buffer out;
       Buffer tmp;
   
       _appendMessageElementBegin(out, messageId);
       _appendSimpleExportReqElementBegin(out);
       _appendEMethodCallElementBegin(out, eMethodName);
       out << body;
       _appendEMethodCallElementEnd(out);
       _appendSimpleExportReqElementEnd(out);
       _appendMessageElementEnd(out);
   
       appendEMethodRequestHeader(
           tmp,
           requestUri,
           host,
           eMethodName,
           httpMethod,
           authenticationHeader,
           httpAcceptLanguages,
           httpContentLanguages,
           out.size());
       tmp << out;
   
       return tmp;
 } }
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // appendClassNameElement()  // XmlWriter::formatSimpleEMethodRspMessage()
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8>& XmlWriter::appendClassNameElement(  Buffer XmlWriter::formatSimpleEMethodRspMessage(
     Array<Sint8>& out,      const CIMName& eMethodName,
     const String& className)      const String& messageId,
       HttpMethod httpMethod,
       const ContentLanguages& httpContentLanguages,
       const Buffer& body)
 { {
     return out << "<CLASSNAME NAME=\"" << className << "\"/>\n";      Buffer out;
       Buffer tmp;
   
       _appendMessageElementBegin(out, messageId);
       _appendSimpleExportRspElementBegin(out);
       _appendEMethodResponseElementBegin(out, eMethodName);
       out << body;
       _appendEMethodResponseElementEnd(out);
       _appendSimpleExportRspElementEnd(out);
       _appendMessageElementEnd(out);
   
       appendEMethodResponseHeader(tmp,
           httpMethod,
           httpContentLanguages,
           out.size());
       tmp << out;
   
       return tmp;
 } }
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // appendInstanceNameElement()  // XmlWriter::formatSimpleEMethodErrorRspMessage()
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Array<Sint8>& XmlWriter::appendInstanceNameElement(  Buffer XmlWriter::formatSimpleEMethodErrorRspMessage(
     Array<Sint8>& out,      const CIMName& eMethodName,
     const CIMReference& instanceName)      const String& messageId,
       HttpMethod httpMethod,
       const CIMException& cimException)
 { {
     instanceName.instanceNameToXml(out);      Buffer out;
     return out;      Buffer tmp;
   
       _appendMessageElementBegin(out, messageId);
       _appendSimpleExportRspElementBegin(out);
       _appendEMethodResponseElementBegin(out, eMethodName);
       _appendErrorElement(out, cimException);
       _appendEMethodResponseElementEnd(out);
       _appendSimpleExportRspElementEnd(out);
       _appendMessageElementEnd(out);
   
   // l10n
       appendEMethodResponseHeader(tmp,
            httpMethod,
            cimException.getContentLanguages(),
                    out.size());
       tmp << out;
   
       return tmp;
 } }
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // _printAttributes()  // _xmlWritter_printAttributes()
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 static void _printAttributes(  void _xmlWritter_printAttributes(
     std::ostream& os,      PEGASUS_STD(ostream)& os,
     const XmlAttribute* attributes,     const XmlAttribute* attributes,
     Uint32 attributeCount)     Uint32 attributeCount)
 { {
Line 603 
Line 3130 
         os << attributes[i].name << "=";         os << attributes[i].name << "=";
  
         os << '"';         os << '"';
         AppendSpecial(os, attributes[i].value);          _xmlWritter_appendSpecial(os, attributes[i].value);
         os << '"';         os << '"';
  
         if (i + 1 != attributeCount)         if (i + 1 != attributeCount)
Line 613 
Line 3140 
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // _indent()  // _xmlWritter_indent()
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 static void _indent(std::ostream& os, Uint32 level, Uint32 indentChars)  void _xmlWritter_indent(PEGASUS_STD(ostream)& os, Uint32 level, Uint32 indentChars)
 { {
     Uint32 n = level * indentChars;     Uint32 n = level * indentChars;
  
Line 632 
Line 3159 
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 void XmlWriter::indentedPrint( void XmlWriter::indentedPrint(
     std::ostream& os,      PEGASUS_STD(ostream)& os,
     const char* text,     const char* text,
     Uint32 indentChars)     Uint32 indentChars)
 { {
     char* tmp = strcpy(new char[strlen(text) + 1], text);      AutoArrayPtr<char> tmp(strcpy(new char[strlen(text) + 1], text));
  
     XmlParser parser(tmp);      XmlParser parser(tmp.get());
     XmlEntry entry;     XmlEntry entry;
     Stack<const char*> stack;     Stack<const char*> stack;
  
Line 648 
Line 3175 
         {         {
             case XmlEntry::XML_DECLARATION:             case XmlEntry::XML_DECLARATION:
             {             {
                 _indent(os, stack.getSize(), indentChars);                  _xmlWritter_indent(os, stack.size(), indentChars);
  
                 os << "<?" << entry.text << " ";                 os << "<?" << entry.text << " ";
                 _printAttributes(os, entry.attributes, entry.attributeCount);                  _xmlWritter_printAttributes(os, entry.attributes, entry.attributeCount);
                 os << "?>";                 os << "?>";
                 break;                 break;
             }             }
  
             case XmlEntry::START_TAG:             case XmlEntry::START_TAG:
             {             {
                 _indent(os, stack.getSize(), indentChars);                  _xmlWritter_indent(os, stack.size(), indentChars);
  
                 os << "<" << entry.text;                 os << "<" << entry.text;
  
                 if (entry.attributeCount)                 if (entry.attributeCount)
                     os << ' ';                     os << ' ';
  
                 _printAttributes(os, entry.attributes, entry.attributeCount);                  _xmlWritter_printAttributes(os, entry.attributes, entry.attributeCount);
                 os << ">";                 os << ">";
                 stack.push(entry.text);                 stack.push(entry.text);
                 break;                 break;
Line 673 
Line 3200 
  
             case XmlEntry::EMPTY_TAG:             case XmlEntry::EMPTY_TAG:
             {             {
                 _indent(os, stack.getSize(), indentChars);                  _xmlWritter_indent(os, stack.size(), indentChars);
  
                 os << "<" << entry.text << " ";                 os << "<" << entry.text << " ";
                 _printAttributes(os, entry.attributes, entry.attributeCount);                  _xmlWritter_printAttributes(os, entry.attributes, entry.attributeCount);
                 os << "/>";                 os << "/>";
                 break;                 break;
             }             }
Line 686 
Line 3213 
                 if (!stack.isEmpty() && strcmp(stack.top(), entry.text) == 0)                 if (!stack.isEmpty() && strcmp(stack.top(), entry.text) == 0)
                     stack.pop();                     stack.pop();
  
                 _indent(os, stack.getSize(), indentChars);                  _xmlWritter_indent(os, stack.size(), indentChars);
  
                 os << "</" << entry.text << ">";                 os << "</" << entry.text << ">";
                 break;                 break;
Line 695 
Line 3222 
             case XmlEntry::COMMENT:             case XmlEntry::COMMENT:
             {             {
  
                 _indent(os, stack.getSize(), indentChars);                  _xmlWritter_indent(os, stack.size(), indentChars);
                 os << "<!--";                 os << "<!--";
                 AppendSpecial(os, entry.text);                  _xmlWritter_appendSpecial(os, entry.text);
                 os << "-->";                 os << "-->";
                 break;                 break;
             }             }
  
             case XmlEntry::CONTENT:             case XmlEntry::CONTENT:
             {             {
                 _indent(os, stack.getSize(), indentChars);                  _xmlWritter_indent(os, stack.size(), indentChars);
                 AppendSpecial(os, entry.text);                  _xmlWritter_appendSpecial(os, entry.text);
                 break;                 break;
             }             }
  
             case XmlEntry::CDATA:             case XmlEntry::CDATA:
             {             {
                 _indent(os, stack.getSize(), indentChars);                  _xmlWritter_indent(os, stack.size(), indentChars);
                 os << "<![CDATA[...]]>";                 os << "<![CDATA[...]]>";
                 break;                 break;
             }             }
  
             case XmlEntry::DOCTYPE:             case XmlEntry::DOCTYPE:
             {             {
                 _indent(os, stack.getSize(), indentChars);                  _xmlWritter_indent(os, stack.size(), indentChars);
                 os << "<!DOCTYPE...>";                 os << "<!DOCTYPE...>";
                 break;                 break;
             }             }
         }         }
  
         os << std::endl;          os << PEGASUS_STD(endl);
     }     }
  
     delete [] tmp;  
 } }
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
Line 736 
Line 3262 
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
  
 Uint32 XmlWriter::getNextMessageId()  String XmlWriter::getNextMessageId()
 { {
     // ATTN: make thread-safe:     // ATTN: make thread-safe:
     static Uint32 messageId = 1000;     static Uint32 messageId = 1000;
Line 746 
Line 3272 
     if (messageId < 1000)     if (messageId < 1000)
         messageId = 1001;         messageId = 1001;
  
     return messageId;      char buffer[16];
       sprintf(buffer, "%d", messageId);
       return buffer;
 } }
  
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
 // //
 // XmlWriter::formatSimpleReqMessage()  // XmlWriter::keyBindingTypeToString
 // //
 //------------------------------------------------------------------------------ //------------------------------------------------------------------------------
   const char* XmlWriter::keyBindingTypeToString (CIMKeyBinding::Type type)
 Array<Sint8> XmlWriter::formatSimpleReqMessage(  
     const char* host,  
     const String& nameSpace,  
     const char* iMethodName,  
     const Array<Sint8>& body)  
 { {
     return XmlWriter::formatMPostHeader(      switch (type)
         host,      {
         "MethodCall",          case CIMKeyBinding::BOOLEAN:
         iMethodName,              return "boolean";
         nameSpace,  
         XmlWriter::formatMessageElement(          case CIMKeyBinding::STRING:
             XmlWriter::getNextMessageId(),              return "string";
             XmlWriter::formatSimpleReqElement(  
                 XmlWriter::formatIMethodCallElement(          case CIMKeyBinding::NUMERIC:
                     iMethodName,              return "numeric";
                     nameSpace,  
                     body))));          case CIMKeyBinding::REFERENCE:
           default:
               PEGASUS_ASSERT(false);
 } }
  
 Array<Sint8> XmlWriter::formatSimpleRspMessage(      return "unknown";
     const char* iMethodName,  
     const Array<Sint8>& body)  
 {  
     return XmlWriter::formatMethodResponseHeader(  
         XmlWriter::formatMessageElement(  
             XmlWriter::getNextMessageId(),  
             XmlWriter::formatSimpleRspElement(  
                 XmlWriter::formatIMethodResponseElement(  
                     iMethodName,  
                     XmlWriter::formatIReturnValueElement(body)))));  
 } }
  
 PEGASUS_NAMESPACE_END PEGASUS_NAMESPACE_END
   
   


Legend:
Removed from v.1.10  
changed lines
  Added in v.1.124.2.2

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2