Return to SCMOStreamer.h CVS log | Up to [Pegasus] / pegasus / src / Pegasus / Common |
File: [Pegasus] / pegasus / src / Pegasus / Common / SCMOStreamer.h
(download)
Revision: 1.6, Wed Feb 13 11:39:58 2013 UTC (11 years, 4 months ago) by marek Branch: MAIN CVS Tags: preBug9676, postBug9676, TASK-TASK_PEP362_RestfulService_branch-root, TASK-TASK_PEP362_RestfulService_branch-merged_out_from_trunk, TASK-TASK_PEP362_RestfulService_branch-merged_in_to_trunk, TASK-TASK_PEP362_RestfulService_branch-merged_in_from_branch, TASK-TASK_PEP362_RestfulService_branch-branch, TASK-PEP362_RestfulService-root, TASK-PEP362_RestfulService-merged_out_to_branch, TASK-PEP362_RestfulService-merged_out_from_trunk, TASK-PEP362_RestfulService-merged_in_to_trunk, TASK-PEP362_RestfulService-merged_in_from_branch, TASK-PEP362_RestfulService-branch, TASK-PEP317_pullop-merged_out_from_trunk, TASK-PEP317_pullop-merged_in_to_trunk, RELEASE_2_14_1, RELEASE_2_14_0-RC2, RELEASE_2_14_0-RC1, RELEASE_2_14_0, RELEASE_2_14-root, RELEASE_2_14-branch, RELEASE_2_13_0-RC2, RELEASE_2_13_0-RC1, RELEASE_2_13_0-FC, RELEASE_2_13_0, RELEASE_2_13-root, RELEASE_2_13-branch, HEAD, CIMRS_WORK_20130824 Changes since 1.5: +5 -0 lines BUG#:9400 TITLE: Add pointers to Single Chunk Memory Object Model design documents in code DESCRIPTION: |
//%LICENSE//////////////////////////////////////////////////////////////// // // Licensed to The Open Group (TOG) under one or more contributor license // agreements. Refer to the OpenPegasusNOTICE.txt file distributed with // this work for additional information regarding copyright ownership. // Each contributor licenses this file to you under the OpenPegasus Open // Source License; you may not use this file except in compliance with the // License. // // 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. // ////////////////////////////////////////////////////////////////////////// // // This code implements part of PEP#348 - The CMPI infrastructure using SCMO // (Single Chunk Memory Objects). // The design document can be found on the OpenPegasus website openpegasus.org // at https://collaboration.opengroup.org/pegasus/pp/documents/21210/PEP_348.pdf // //%///////////////////////////////////////////////////////////////////////////// #ifndef Pegasus_SCMOStreamer_h #define Pegasus_SCMOStreamer_h #include <Pegasus/Common/Config.h> #include <Pegasus/Common/ArrayInternal.h> #include <Pegasus/Common/SCMO.h> #include <Pegasus/Common/SCMOInstance.h> #include <Pegasus/Common/CIMBuffer.h> #include <Pegasus/Common/Array.h> PEGASUS_NAMESPACE_BEGIN struct SCMOResolutionTable { // Though we only store pointers here, it is stored as union of size 64bit // to become independent from 64bit versus 32bit incarnations of the struct. union { Uint64 uint64; SCMOInstance* scmoInst; SCMBInstance_Main * scmbMain; } scmbptr; Uint64 index; }; #define PEGASUS_ARRAY_T SCMOResolutionTable # include <Pegasus/Common/ArrayInter.h> #undef PEGASUS_ARRAY_T class PEGASUS_COMMON_LINKAGE SCMOStreamer { public: SCMOStreamer(CIMBuffer& out, Array<SCMOInstance>& x); // Writes the list of SCMOInstances stored in this instance of SCMOStreamer // to the output buffer, including their referenced Classes and Instances void serialize(); // Reads a list of SCMOInstances from the input buffer and stores them in // this instance of SCMOStreamer, including their referenced Classes and // Instances bool deserialize(); // Writes a single SCMOClass to the given CIMBuffer static void serializeClass(CIMBuffer& out, const SCMOClass& scmoClass); // Reads a single SCMOClass from the given CIMBuffer static bool deserializeClass(CIMBuffer& in, SCMOClass& scmoClass); private: // This function takes and instance and adds all of its external // references (SCMOClass and SCMOInstances) to the index tables // For referenced SCMOInstances, the function recusively calls itself. // // Returns the index position at which the class for this instance was // inserted in the class resolver table. Uint32 _appendToResolverTables(const SCMOInstance& inst); // This function adds the given instance to the instance resolver table, // which stores the connections between instances and their external // references. // // Returns the index position at which the instance was inserted in the // instance resolver table. Uint32 _appendToInstResolverTable(SCMOInstance& inst, Uint32 idx); // Adds an instance to the class resolution table. // Also adds the class to the class table when neccessary // // Returns the index position at which the instance was inserted in the // instance resolver table. Uint32 _appendToClassResolverTable(const SCMOInstance& inst); // Add the SCMOClass for the given instance to the class table. // If the class already exists in the table, it returns the index position // for this class, otherwise appends the class at the end of the table // and returns the new index position of the class. Uint32 _appendToClassTable(const SCMOInstance& inst); static void _putClasses(CIMBuffer& out,Array<SCMBClass_Main*>& classTable); static bool _getClasses(CIMBuffer& in,Array<SCMBClass_Main*>& classTable); void _putInstances(); bool _getInstances(); #ifdef PEGASUS_DEBUG void _dumpTables(); #endif // The Buffer for output streaming CIMBuffer& _buf; // The array of SCMOInstances to be streamed Array<SCMOInstance>& _scmoInstances; // Index table used to resolve the absolute pointers to SCMOClasses // to a relative sequence number (index) in the stream Array<SCMOResolutionTable> _clsResolverTable; // Index table used to resolve the absolute pointers to SCMOInstances // to a relative sequence number (index) in the stream Array<SCMOResolutionTable> _instResolverTable; // Table of pointers to SCMOClasses to be streamed Array<SCMBClass_Main*> _classTable; }; PEGASUS_NAMESPACE_END #endif /* Pegasus_SCMOStreamer_h */
No CVS admin address has been configured |
Powered by ViewCVS 0.9.2 |