entity_object_impl.h

Go to the documentation of this file.

/* Copyright (c) 2014, 2023, Oracle and/or its affiliates.
 
   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License, version 2.0,
   as published by the Free Software Foundation.
 
   This program is also distributed with certain software (including
   but not limited to OpenSSL) that is licensed under separate terms,
   as designated in a particular file or component or in included license
   documentation.  The authors of MySQL hereby grant you an additional
   permission to link the program and your derivative works with the
   separately licensed software that they have included with MySQL.
 
   This program 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, version 2.0, for more details.
 
   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301  USA */
 
#ifndef DD__ENTITY_OBJECT_IMPL_INCLUDED
#define DD__ENTITY_OBJECT_IMPL_INCLUDED
 
#include "sql/dd/impl/raw/raw_record.h"
#include "sql/dd/impl/types/weak_object_impl.h"  // Weak_object_impl
#include "sql/dd/object_id.h"
#include "sql/dd/sdi_fwd.h"
#include "sql/dd/string_type.h"
#include "sql/dd/types/entity_object.h"  // Entity_object
#include "sql/dd/types/weak_object.h"
 
namespace dd {
 
///////////////////////////////////////////////////////////////////////////
 
class Object_key;
class Sdi_rcontext;
class Sdi_wcontext;
 
class Entity_object_impl : virtual public Entity_object,
                           public Weak_object_impl {
 public:
  Entity_object_impl() : m_id(INVALID_OBJECT_ID), m_has_new_primary_key(true) {}
 
 public:
  Object_id id() const override { return m_id; }
 
  /* non-virtual */ void set_id(Object_id id) {
    m_id = id;
    fix_has_new_primary_key();
  }
 
  /* purecov: begin deadcode */
  bool is_persistent() const override { return (m_id != INVALID_OBJECT_ID); }
  /* purecov: end */
 
  const String_type &name() const override { return m_name; }
 
  void set_name(const String_type &name) override { m_name = name; }
 
  Object_key *create_primary_key() const override;
 
  bool has_new_primary_key() const override { return m_has_new_primary_key; }
 
  Entity_object_impl *impl() override { return this; }
  const Entity_object_impl *impl() const override { return this; }
 
 protected:
  void set_primary_key_value(const Raw_new_record &r) override;
 
  void fix_has_new_primary_key() override {
    m_has_new_primary_key = (m_id == INVALID_OBJECT_ID);
  }
 
  void restore_id(const Raw_record &r, int field_idx);
  void restore_name(const Raw_record &r, int field_idx);
 
  bool store_id(Raw_record *r, int field_idx);
  bool store_name(Raw_record *r, int field_idx);
  bool store_name(Raw_record *r, int field_idx, bool is_null);
 
  void serialize(Sdi_wcontext *wctx, Sdi_writer *w) const;
  bool deserialize(Sdi_rcontext *rctx, const RJ_Value &val);
 
 private:
  // NOTE: ID and Name attributes *must* remain private so that we can track
  // changes in them and prevent abuse.
 
  Object_id m_id;
 
  String_type m_name;
 
  /**
    Indicates that object is guaranteed to have ID which doesn't exist in
    database because it will be or just was generated using auto-increment.
    Main difference of this member from result of m_id == INVALID_OBJECT_ID
    check is that we delay resetting of this flag until end of store() method
    while m_id is updated right after object was inserted into the table.
    This is necessary to let entity's children figure out that their parent
    has new ID which was not used before (and hence their primary keys based
    on this ID will be new too) while still giving access to the exact value
    of new ID.
  */
  bool m_has_new_primary_key;
 
 protected:
  // The generated copy constructor could have been used,
  // but by adding this we force derived classes which define
  // their own copy constructor to also invoke the Entity_object_impl
  // copy constructor in the initializer list.
  // Note that we must copy the m_has_new_primary_key property to make sure
  // the clone is handled correctly if storing it persistently as part of
  // updating a DD object.
  Entity_object_impl(const Entity_object_impl &src)
      : Weak_object(src),
        m_id(src.m_id),
        m_name(src.m_name),
        m_has_new_primary_key(src.m_has_new_primary_key) {}
};
 
///////////////////////////////////////////////////////////////////////////
 
}  // namespace dd
 
#endif  // DD__ENTITY_OBJECT_IMPL_INCLUDED