associate-gw.h

Go to the documentation of this file.

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

  RCS information
   $Name: OSB_060808 $
   $Revision: 1.51 $

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

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

// + local headers
#include "osbid.h"
#include "osbconst.h"
#include "associate.h"

// + class declarations
namespace OSB_DB {
    class Session;
}

namespace OSB_LIB {
    class AnCFilter;
    class AnCList;
}

// ************************************************************************
// namespace extensions
namespace OSB_DB {

    class AssociateGw {
        AssociateGw(const AssociateGw& rhs);
        AssociateGw& operator=(const AssociateGw& rhs);
        friend class OSB_LIB::Associate;
        friend class OSB_LIB::AnCList;

        friend class OSB_LIB::Contract; // ToDo: remove
    public:
        typedef OSB_LIB::Id<OSB_LIB::Associate> AssociateId;
        typedef std::set<AssociateId>           AssociateIds;

    public:
        AssociateGw() {}

        OSB_LIB::Associate::AutoPtr fetch(
            const Session&                 session,
            const OSB_LIB::Associate::Oid& asId
        );

        bool fetch(
            const Session&            session,
                  OSB_LIB::Associate& assoc
        );

        long searchByName(
            const Session&            session,
                  AssociateIds&       idList,
                  OSB_LIB::AnCFilter& filter
        );

    private:
        long fetchChildren(
            const Session&            session,
                  OSB_LIB::Associate& associate
        );

        bool insert(
            const Session&            session,
                  OSB_LIB::Associate& assoc
        );

        bool update(
            const Session&            session,
            const OSB_LIB::Associate& assoc
        );

        bool remove(
            const Session&            session,
            const OSB_LIB::Associate& assoc
        );

        bool incObjVs(
            const Session&            session,
                  OSB_LIB::Associate& assoc
        );

    private:
        bool setPrefStatus(
            const Session&            session,
            const OSB_LIB::Associate& assoc
        );

        bool setEffStatus(
            const Session&            session,
            const OSB_LIB::Associate& assoc
        );

        void storeRequest(
            const Session&                 session,
            const OSB_LIB::Associate::Oid& asId,
                  OSB_LIB::StatusRequest&  status
        );

        void storeChange(
            const Session&                 session,
            const OSB_LIB::Associate::Oid& asId,
                  OSB_LIB::StatusChange&   change
        );

        OSB_LIB::ObjectStatus lock(
            const Session&                 session,
            const OSB_LIB::Associate::Oid& asId,
                  bool                     noWait
        );

        OSB_LIB::ObjectStatus lock(
            const Session&            session,
            const OSB_LIB::Associate& assoc,
                  bool                noWait
        );

        void lockChildren(
            const Session&                 session,
            const OSB_LIB::Associate::Oid& asId,
                  bool                     noWait
        );

        void lockContracts(
            const Session&                 session,
            const OSB_LIB::Associate::Oid& asId,
                  bool                     noWait
        );
    };                                  // class AssociateGw
}                                       // namespace OSB_DB

// ************************************************************************
// inline definitions
namespace OSB_DB {
}                                       // namespace OSB_DB
#endif                                  // #ifndef _ASSOCIATEGW_H_

---