/home/master/UCL/VisualizationLibrary/src/vlCore/VLXSerializer.hpp

Go to the documentation of this file.

/**************************************************************************************/
/*                                                                                    */
/*  Visualization Library                                                             */
/*  http://visualizationlibrary.org                                                   */
/*                                                                                    */
/*  Copyright (c) 2005-2010, Michele Bosi                                             */
/*  All rights reserved.                                                              */
/*                                                                                    */
/*  Redistribution and use in source and binary forms, with or without modification,  */
/*  are permitted provided that the following conditions are met:                     */
/*                                                                                    */
/*  - Redistributions of source code must retain the above copyright notice, this     */
/*  list of conditions and the following disclaimer.                                  */
/*                                                                                    */
/*  - Redistributions in binary form must reproduce the above copyright notice, this  */
/*  list of conditions and the following disclaimer in the documentation and/or       */
/*  other materials provided with the distribution.                                   */
/*                                                                                    */
/*  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND   */
/*  ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED     */
/*  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE            */
/*  DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR  */
/*  ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES    */
/*  (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;      */
/*  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON    */
/*  ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT           */
/*  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS     */
/*  SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.                      */
/*                                                                                    */
/**************************************************************************************/

#ifndef VLXSerializer_INCLUDE_ONCE
#define VLXSerializer_INCLUDE_ONCE

#include <vlCore/VLXRegistry.hpp>
#include <vlCore/VLXValue.hpp>
#include <vlCore/String.hpp>
#include <string>
#include <map>

namespace vl
{
  class VirtualFile;
  class VLCORE_EXPORT VLXSerializer: public Object
  {
    VL_INSTRUMENT_CLASS(vl::VLXSerializer, Object)

  public:
    typedef enum { NoError, ImportError, ExportError, ReadError, WriteError } EError;

  public:
    VLXSerializer(): mError(NoError), mIDCounter(0)
    {
      setRegistry( defVLXRegistry() );
    }

    const char* errorString() const;

    bool saveVLT(const String& path, const Object* obj, bool start_fresh=true);

    bool saveVLT(VirtualFile* file, const Object* obj, bool start_fresh=true);

    bool saveVLB(const String& path, const Object* obj, bool start_fresh=true);

    bool saveVLB(VirtualFile* file, const Object* obj, bool start_fresh=true);

    ref<Object> loadVLT(const String& path, bool start_fresh=true);

    ref<Object> loadVLT(VirtualFile* file, bool start_fresh=true);

    ref<Object> loadVLB(const String& path, bool start_fresh=true);

    ref<Object> loadVLB(VirtualFile* file, bool start_fresh=true);

    Object* importVLX(const VLXStructure* st);

    VLXStructure* exportVLX(const Object* obj);

    bool canExport(const Object* obj) const;

    bool canImport(const VLXStructure* st) const;

    void registerImportedStructure(const VLXStructure* st, Object* obj);

    void registerExportedObject(const Object* obj, VLXStructure* st);

    Object* getImportedStructure(const VLXStructure* st);

    VLXStructure* getExportedObject(const Object* obj);
    
    VLXRegistry* registry() { return mRegistry.get(); }

    const VLXRegistry* registry() const { return mRegistry.get(); }
    
    void setRegistry(const VLXRegistry* registry) { mRegistry = registry; }

    std::map< std::string, VLXValue >& metadata() { return mMetadata; }

    const std::map< std::string, VLXValue >& metadata() const { return mMetadata; }

    VLXValue* getMetadata(const char* key)
    {
      std::map< std::string, VLXValue >::iterator it = metadata().find(key);
      if (it == metadata().end())
        return NULL;
      else
        return &it->second;
    }

    const VLXValue* getMetadata(const char* key) const
    {
      std::map< std::string, VLXValue >::const_iterator it = metadata().find(key);
      if (it == metadata().end())
        return NULL;
      else
        return &it->second;
    }

    void reset()
    {
      mError = NoError;
      mIDCounter = 0;
      mImportedStructures.clear();
      mExportedObjects.clear();
    }

    std::string generateID(const char* prefix);

    void setError(EError err) { mError = err; }

    EError error() const { return mError; }

    void signalImportError(const String& str);

    void signalExportError(const String& str);

    void setDocumentURL(const String& location) { mDocumentURL = location; }

    const String& documentURL() const { return mDocumentURL; }

    void resolvePath(std::string& path);

    void setDirective(const char* directive, const char* value) { mDirectives[directive] = value; }

    void eraseDirective(const char* directive) { mDirectives.erase(directive); }

    const std::string& directive(const char* directive) const
    {
      static const std::string no_directive = "NO_SUCH_DIRECTIVE";
      std::map<std::string, std::string>::const_iterator it = mDirectives.find(directive);
      if (it != mDirectives.end())
        return it->second;
      else
        return no_directive;
    }

    bool hasDirective(const char* directive) { return mDirectives.find(directive) != mDirectives.end(); }

    void eraseAllDirectives() { mDirectives.clear(); }

  private:
    String mDocumentURL;
    std::map<std::string, std::string> mDirectives;
    EError mError;
    int mIDCounter;
    std::map< ref<VLXStructure>, ref<Object> > mImportedStructures; // structure --> object
    std::map< ref<Object>, ref<VLXStructure> > mExportedObjects;    // object --> structure
    std::map< std::string, VLXValue > mMetadata; // metadata to import or to export
    ref<VLXRegistry> mRegistry;
  };
}

#endif