xml/soap/webservice

开发平台：
Visual C++

VXICacheStream.hpp：源码内容
							
/****************License************************************************
 * Vocalocity OpenVXI
 * Copyright (C) 2004-2005 by Vocalocity, Inc. All Rights Reserved.
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *  
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 * Vocalocity, the Vocalocity logo, and VocalOS are trademarks or 
 * registered trademarks of Vocalocity, Inc. 
 * OpenVXI is a trademark of Scansoft, Inc. and used under license 
 * by Vocalocity.
 ***********************************************************************/
/***********************************************************************
 *
 * Routines to handle caching of documents and resources.
 *
 ***********************************************************************/
#include "VXMLDocument.hpp"         // For SerializerInput, SerializerOutput
#include "VXIcache.h"
/*
// VXICacheStream: Manages cache stream creation, access, and destruction.
//
// The typical usage will look something like this.  The stream is created from
// a VXIcacheInterface and a VXIbyte array of specified length.
//
//     VXICacheStream stream(cacheInterface, buffer, bufferSize);
//
//     if (stream.IsValid()) {
//       if (stream.IsWritable()) {
//         Process_And_Write_New_Entry();
//         stream.CommitEntry();
//       }
//       else Read_Existing_Entry();
//     }
//     else Handle_Error();
//
// There are two utility functions to determine if creation succeeded
// (IsInvalid) and if the stream is writable (IsWritable).  If the entry is
// successfully written, it may be committed.  Finally, the stream is closed
// automatically by the destructor.
*/
class VXICacheStream : public SerializerOutput, public SerializerInput {
public:
  // SerializerOutput & public SerializerInput functions.
  virtual void Write(const VXIbyte * data, VXIulong size);
  virtual VXIulong Read(VXIbyte * buffer, VXIulong bufSize);
  void CommitEntry();
  // The entry was successfully written.  This will close the stream.
  void DiscardEntry();
  // A failure occured while writing the entry; discard it.  This will close
  // the stream.
  bool IsValid() const     { return !bad; }
  bool IsWritable() const  { return writable; }
  // Status checks after stream creation.
  VXICacheStream(VXIcacheInterface *, const VXIbyte * buffer, VXIulong size);
  ~VXICacheStream();
private:
  VXICacheStream(const VXICacheStream &);                // not defined
  VXICacheStream & operator=(const VXICacheStream &);    // not defined
  bool writable;
  bool bad;
  VXIcacheStream * stream;
  VXIcacheInterface * cache;
};
inline void VXICacheStream::Write(const VXIbyte * data, VXIulong size)
{
  VXIulong temp;
  if (cache->Write(cache, data, size, &temp, stream) != VXIcache_RESULT_SUCCESS
      || temp != size)
    throw VXMLDocument::SerializationError();
}
inline VXIulong VXICacheStream::Read(VXIbyte * buffer, VXIulong bufSize)
{
  VXIulong temp;
  switch( cache->Read(cache, buffer, bufSize, &temp, stream) )
  {
    case VXIcache_RESULT_SUCCESS:
    case VXIcache_RESULT_END_OF_STREAM:
      break;
    default:
      throw VXMLDocument::SerializationError();
  }
  return temp;
}

						