credit.h

Go to the documentation of this file.

// OSB library ********************************************* -*- C++ -*-
/*
  AUTHOR(S): Lilian Qin Lan (lan)

  RCS information
   $Name: OSB_060808 $
   $Revision: 1.40 $

  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 _CREDIT_H_
#define _CREDIT_H_

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

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

// *********************************************************************
// class declarations
namespace OSB_DB {
    class CreditItemGw;
    class PersCreditGw;
}

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

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

// *********************************************************************
// class definitions

    class PersCredit : public PersProductItem {
        friend class OSB_DB::PersCreditGw;
    public:
        static const Type type_;

        // Documentation from base class.
        typedef std::auto_ptr<PersCredit> AutoPtr;

    public:
        explicit PersCredit(
            const Oid&   oid    = Oid(),
            const Money& credit = Money()
        ) : PersProductItem(oid), credit_(credit)
        {
            // empty
        }

        explicit PersCredit(
            const Money& credit
        ) : credit_(credit)
        {
            // empty
        }

    public:
        Type type() const;

        // Documentation from base class.
        AutoPtr clone() const;

        virtual std::string personalization() const;

        virtual bool canConfig() const;

        const Money& credit() const { return credit_; }

        bool add(
            const OSB_DB::Session& session,
            const Money&           money,
                  long             objVs,
                  bool             uptodate
        );

        bool deduct(
            const OSB_DB::Session& session,
            const Money&           money,
                  long             objVs,
                  bool             uptodate
        );

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

        bool unlock(
            const OSB_DB::Session& session,
                  bool             nowait
        );
    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);

        // Documentation from base class.
        PersProductItem* clone_() const;

    private:
        Money credit_;
    };                                  // class PersCredit

    class CreditItem : public ProductItem {
        friend class OSB_DB::CreditItemGw;

    public:
        static const Type type_;
        // Documentation from base class.
        typedef std::auto_ptr<CreditItem> AutoPtr;

    public:
        CreditItem(const ProductItem::Oid& oid);

        CreditItem(const ProductItem::Oid& oid,
                   const std::string&      name,
                   const std::string&      des,
                   const Money&            money);

    public:
        Type type() const;

        // Documentation from base class.
        AutoPtr clone() const;

        std::auto_ptr<PersProductItem> crePersProductItem() const;

        const Money& initValue() const;

        void setInitValue(const Money& money);

        ProductItem::CfgType canConfigure() const
        {
            return ProductItem::cfgNone;
        }

        ProductItem::DefPersType canDefPers() const
        {
            return ProductItem::defPersMandatory;
        }

        virtual CfgPersType canPersonalize() const;

        const PersProductItem* defPersItem() const;

    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);

        // Documentation from base class.
        ProductItem* clone_() const;

    private:
        PersCredit defPersCredit_;
    };                                  // class CreditItem

// *********************************************************************
// inline definitions

}
#endif                                  // #ifndef _CREDIT_H_

---