leveldb 源码分析---接口详解之include文件

leveldb头文件结构

include
└── leveldb
    ├── c.h              => c binding
    ├── cache.h          => cache接口
    ├── comparator.h     => 比较器接口
    ├── db.h             => DB接口
    ├── env.h            => 为跨平台准备的env接口
    ├── filter_policy.h  => fliter策略,用于缓存,请看到文档及相应实现
    ├── iterator.h       => 迭代器,用于遍历数据库中存储的数据
    ├── options.h        => 包含控制数据库的Options,控制读的WriteOptions,ReadOptions
    ├── slice.h          => Slice的接口
    ├── status.h         => leveldb中大多接口返回的Status接口
    ├── table.h           => immutable接口
    ├── table_builder.h  => 用于创建table的构建器接口
    └── write_batch.h    => 使多个写操作成为原子写的接口

1.options.h

主要有 Option: Options, ReadOptions, WriteOptions. 可以通过配置相关选项，进行性能的优化。

1.1 option

  const Comparator* comparator; 默认字典排序
  bool create_if_missing;默认false,如果为true,在数据库丢失的时候，会自动创建。
  bool error_if_exists;默认false;true:代表如果数据库存在，会报错误。
  bool paranoid_checks;默认false.true：代表检查比较严格，有任何歧义，都会上报错误。
  Env* env; 平台兼容性相关，  // Default: Env::Default()
  Logger* info_log;  // Default: NULL
  size_t write_buffer_size;  // Default: 4MB ，增大该值，可以提升效率，但是会导致在下次数据库打开 ，恢复的时候占用太长时间。
  int max_open_files;   // Default: 1000 数据库 可以被打开的最大次数，当数据库预计操作的文件数据较大时，可以提高该值
  Cache* block_cache; //默认为null 时，leveldb  会创建 一个8M 的内在缓存。
  size_t block_size;每一个block 的大小，可以动态改变，实际的数据可能要小些。默认为4k.
  int block_restart_interval;  // Default: 16 ，差分编码时key  的数目，可以动态改变，建议不修改。
  size_t max_file_size；  // Default: 2MB， 在 leveldb 写入的最大数量，建议不修改，当你的文件系统在处理大文件效率较高，或者 需要操作一个较大数据库时，可以适当增加。
  CompressionType compression; //默认kSnappyCompression，压缩算法配置。
  bool reuse_logs;//默认false,true:代表，当数据库打开时，把相关的信息增加到mainfest 和 logfile 中。
  const FilterPolicy* filter_policy;  //bloom-filter 在levledb  读数据库时，极大 的提升效率。

1.2 ​ReadOptions

  ReadOptions()
      : verify_checksums(false),//检验
        fill_cache(true),
        //当用户执行Get操作时,将会把获取到的数据放入cache中.如果数据库中的数据较大,放置在cache中              // 并不合适,就可以设置fill_cache为false,关闭这一特性.
        snapshot(NULL) {
  }

1.3 WriteOptions

  WriteOptions()
      : sync(false) { //是否要进行同步写,默认false .
  }

2.c.h

leveldb 中大部分代码，都通过c 语言实现了，常见的增删改查。以及一些不常用的函数接口。

3.cache.h

为了提高性能,cache是不可避免的.cache.h中提供了Cache接口.LevelDB提供了基于LRU(least recent used)策略的Cache.如果需要提供自定义的cache方法,可以继承Cache类,并实现其中的纯虚函数.