coherence/io/pof/UserTypeReader.hpp

/*
* UserTypeReader.hpp
*
* Copyright (c) 2000, 2009, Oracle and/or its affiliates. All rights reserved.
*
* Oracle is a registered trademarks of Oracle Corporation and/or its
* affiliates.
*
* This software is the confidential and proprietary information of Oracle
* Corporation. You shall not disclose such confidential and proprietary
* information and shall use it only in accordance with the terms of the
* license agreement you entered into with Oracle.
*
* This notice may not be removed or altered.
*/
#ifndef COH_USER_TYPE_READER_HPP
#define COH_USER_TYPE_READER_HPP

#include "coherence/lang.ns"

#include "coherence/io/ReadBuffer.hpp"
#include "coherence/io/pof/PofBufferReader.hpp"
#include "coherence/io/pof/PofContext.hpp"
#include "coherence/util/Binary.hpp"

COH_OPEN_NAMESPACE3(coherence,io,pof)

using coherence::io::ReadBuffer;
using coherence::util::Binary;


/**
* The UserTypeReader implementation is a contextually-aware PofReader whose
* purpose is to advance through the properties of a value of a specified user
* type. The "contextual awareness" refers to the fact that the UserTypeReader
* maintains state about the type identifier and version of the user type, the
* parser's property index position within the user type value, and a
* PofContext that may differ from the PofContext that provided the
* PofSerializer which is using this UserTypeReader to parse a user type.
*
* @author jh  2008.04.11
*/
class COH_EXPORT UserTypeReader
    : public class_spec<UserTypeReader,
        extends<PofBufferReader> >
    {
    friend class factory<UserTypeReader>;

    // ----- constructors ---------------------------------------------------

    public:
        /**
        * Construct a parser for parsing the property values of a user type.
        *
        * @param hIn         the BufferInput that contains the user type
        *                    data, except for the user type id itself (which
        *                    is passed passed as a constructor argument)
        * @param vCtx        the PofContext to use for parsing the user type
        *                    property values within the user type that this
        *                    parser will be parsing
        * @param nTypeId     the type id of the user type
        * @param nVersionId  the version id of the user type
        *
        * @throws IOException  if an I/O error occurs
        */
        UserTypeReader(ReadBuffer::BufferInput::Handle hIn,
                PofContext::View vCtx, int32_t nTypeId, int32_t nVersionId);


    // ----- PofReader interface --------------------------------------------

    public:
        /**
        * {@inheritDoc}
        */
        virtual int32_t getUserTypeId() const;

        /**
        * {@inheritDoc}
        */
        virtual int32_t getVersionId() const;

        /**
        * {@inheritDoc}
        */
        virtual Binary::View readRemainder();


    // ----- internal methods -----------------------------------------------

    protected:
        /**
        * {@inheritDoc}
        */
        virtual bool advanceTo(int32_t iProp);

        /**
        * {@inheritDoc}
        */
        virtual void complete(int32_t iProp);


    // ----- data members ---------------------------------------------------

    protected:
        /**
        * The type identifier of the user type that is being parsed.
        */
        const int32_t m_nTypeId;

        /**
        * The version identifier of the user type that is being parsed.
        */
        const int32_t m_nVersionId;

        /**
        * Most recent property read or (if it were missing) requested. This
        * is used to determine if the client is attempting to read properties
        * in the wrong order.
        */
        int32_t m_iPrevProp;

        /**
        * The index of the next property in the POF stream.
        */
        int32_t m_iNextProp;

        /**
        * The offset of the index of the next property to read.
        */
        size32_t m_ofNextProp;
    };

COH_CLOSE_NAMESPACE3

#endif // COH_USER_TYPE_READER_HPP

Copyright (c) 2000, 2009, Oracle and/or its affiliates. All rights reserved.