deviceitem.h

Go to the documentation of this file.

// OSB library ************************************************ -*- C++ -*-
/*
  AUTHOR(S): Stephan Broennimann (vb)

  RCS information
   $Name: OSB_060808 $
   $Revision: 1.7 $

  License
   OSB rating and billing library for communication networks
   Copyright (C) 2004, 2005, 2006  OSB systems

   This file may be distributed and/or modify under the terms of the
   GNU General Public License (GPL) as published by the Free Software
   Foundation which is provided in the file LICENSE.GPL included in the
   packaging of this file.

   The file 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.

   Holders of a OSB Commercial License may use this file under the terms
   and conditions of this commercial license.
 */
#ifndef _DEVICEITEM_H_
#define _DEVICEITEM_H_

// ************************************************************************
// included header files
// + standard includes

// + libraries

// + local headers
#include "devicetype.h"
#include "persitem.h"
#include "productitem.h"

// + class declarations

// ************************************************************************
// namespace extensions
namespace OSB_LIB {

// ************************************************************************
// forward declarations

// ************************************************************************
// type definitions

// ************************************************************************
// class definitions
    class DeviceItem : public ProductItem {
    public:
        static const Type type_;
        // doc from base class
        typedef std::auto_ptr<DeviceItem> AutoPtr;
        typedef TypeId<Device> DvcType;

    public:
        explicit DeviceItem(
            const Oid&         oid,
            const std::string& name = "",
            const std::string& des  = ""
        );
        // doc from base class
        AutoPtr clone() const;

    public:                             // implement ProductItem
        // doc from base class
        Type type() const;
        CfgType canConfigure() const;
        DefPersType canDefPers() const;
        CfgPersType canPersonalize() const;
        const PersProductItem* defPersItem() const;
        std::auto_ptr<PersProductItem> crePersProductItem() const;

    public:                             // specific functions
        DvcType deviceType() const;
        void setDeviceType(const DvcType dvcType);

    private:
        bool readSpecific(
            const OSB_DB::Session& session
        );

        bool insSpecific(
            const OSB_DB::Session& session
        );

        bool updSpecific(
            const OSB_DB::Session& session
        );

        bool delSpecific(
            const OSB_DB::Session& session
        );

    private:
        // doc from base class
        virtual ProductItem* clone_() const;
    private:
        DvcType dvcType_;
    };                                  // class DeviceItem

    class PersDevice : public PersProductItem {
    public:
        // doc from base class
        typedef std::auto_ptr<PersDevice> AutoPtr;
    public:
        explicit PersDevice(const Oid& oid = Oid());

        // doc from base class
        AutoPtr clone() const;

    protected:
        PersDevice(const PersDevice& rhs);
        PersDevice& operator=(const PersDevice& rhs);

    public:
        Id<Device> dvcId() const;

        virtual const Device* device() const = 0;
        virtual const Device* oldDevice() const = 0;

    private:
        virtual Device* device() = 0;

        virtual Device* oldDevice() = 0;

        virtual Device* mkDevice(
            const Id<Device>& dvcId
        ) = 0;

    protected:
        bool readPersDevice(
            const OSB_DB::Session& session
        );

        bool insPersDevice(
            const OSB_DB::Session& session
        );

        bool delPersDevice(
            const OSB_DB::Session& session
        );

        virtual bool overwrite(
            const OSB_DB::Session& session
        );

        // Documentation from base class.
        virtual bool deassignOld(
            const OSB_DB::Session& session
        );

        virtual bool changeAssignTs(
            const OSB_DB::Session& session,
            const DateTime&        newTs
        );
    };                                  // class PersDevice
}                                       // namespace OSB_LIB

// ************************************************************************
// inline definitions
namespace OSB_LIB {
}                                       // namespace OSB_LIB
#endif                                  // #ifndef _DEVICEITEM_H_

---