latch_memo.h

/* Copyright (c) 2021 Xie Meiyi(xiemeiyi@hust.edu.cn) and OceanBase and/or its affiliates. All rights reserved.
miniob is licensed under Mulan PSL v2.
You can use this software according to the terms and conditions of the Mulan PSL v2.
You may obtain a copy of Mulan PSL v2 at:
         http://license.coscl.org.cn/MulanPSL2
THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
See the Mulan PSL v2 for more details. */

//
// Created by Wangyunlai on 2023/03/08.
//

#pragma once

#include <deque>
#include <vector>

#include "rc.h"
#include "storage/buffer/page.h"

class Frame;
class DiskBufferPool;

namespace common {
class SharedMutex;
}

enum class LatchMemoType
{
  NONE,
  SHARED,
  EXCLUSIVE,
  PIN,
};

struct LatchMemoItem
{
  LatchMemoItem() = default;
  LatchMemoItem(LatchMemoType type, Frame *frame);
  LatchMemoItem(LatchMemoType type, common::SharedMutex *lock);

  LatchMemoType type = LatchMemoType::NONE;
  Frame *frame = nullptr;
  common::SharedMutex *lock = nullptr;
};

class LatchMemo final
{
public:
  LatchMemo(DiskBufferPool *buffer_pool);
  ~LatchMemo();

  RC   get_page(PageNum page_num, Frame *&frame);
  RC   allocate_page(Frame *&frame);
  void dispose_page(PageNum page_num);
  void latch(Frame *frame, LatchMemoType type);
  void xlatch(Frame *frame);
  void slatch(Frame *frame);
  bool try_slatch(Frame *frame);

  void xlatch(common::SharedMutex *lock);
  void slatch(common::SharedMutex *lock);

  void release();

  /// 除了最后一个锁，其它的都释放掉
  void release_to(int point);

  int  memo_point() const { return static_cast<int>(items_.size()); }

private:
  void release_item(LatchMemoItem &item);
  
private:
  DiskBufferPool *           buffer_pool_ = nullptr;
  std::deque<LatchMemoItem>  items_;
  std::vector<PageNum>       disposed_pages_;
};