Levin - A Quick Way to Bulk Loading

Description

Levin provides a highly efficient solution in bulk loading scenario. A collection of STL-like containers are implemented with high performance and memory efficiency. Levin containers arrange memory layout SEQUENTIALLY, allocated at share memory region for inter-process reuse. In which case, we can extend the lifetime of data resources, and prevent unnecessary time-consuming reload.

Loading with levin is fast, let's get started.

Getting Started

• Brief Intro for Levin Container

| STD Container | Levin Container | Notes | Suggestion | | --------------------------------- | ------------------------------ | --------------- | ------------------------------------- | | vector<T> | SharedVector<T> | T is POD type | | | set<K, Compare> | SharedSet<K, Compare> | K is POD type | use SharedHashSet if no comparison | | map<K, V, Compare> | SharedMap<K, V, Compare> | K/V is POD type | use SharedHashMap if no comparison | | unordered_set<K, Hash, Pred> | SharedHashSet<K, Hash, Pred> | K is POD type | | | unordered_map<K, V, Hash, Pred> | SharedHashMap<K, V, Hash> | K/V is POD type | | | vector<vector<T> > | SharedNestedVector<T, SizeType> | T is POD type; SizeType is unsigned integral type | specified SizeType for memory space efficiency | | unordered_map<K, vector<V> > | SharedNestedHashMap<K, V> | K/V is POD type | | | vector<map<K, V, Compare> > | SharedNestedMap<K, V, Compare, SizeType> | K/V is POD type; SizeType is unsigned integral type | |

• How to Dump Container Data to A File

// vector dump demo
std::vector<int> vec_data = {1, 2, 3, 4, 5};
levin::SharedVector<int>::Dump("./vec_demo.dat", vec_data);

// map/hashmap dump demo
std::unordered_map<int64_t, int32_t> map_data = { {1, 100}, {2, 200}, {3, 300} };
// or std::map<int64_t, int32_t> map_data = { {1, 100}, {2, 200}, {3, 300} };
levin::SharedHashMap<int64_t, int32_t>::Dump("./map_demo.dat", map_data);

• How to Use Container

Tips: Levin container SHOULD be immutable, NOT suggest to modify or reallocate.

// shared vector use demo
levin::SharedVector<int> vec("./vec_demo.dat");
if (vec.Init() == levin::SC_RET_OK && vec.Load() == levin::SC_RET_OK) {
    ...
}
vec.Destroy();

// shared hashmap use demo
auto map_ptr = new levin::SharedHashMap<int64_t, int32_t>("./map_demo.dat");
if (map_ptr->Init() == levin::SC_RET_OK && map_ptr->Load() == levin::SC_RET_OK) {
    ...
}
map_ptr->Destroy();
delete map_ptr;

• How to Manage a set of Containers

example code of container manager usage

Dependencies

Levin depends on following packages, required deps:

• gcc >= 4.8.5
• cmake >= 2.6.0
• boost >= 1.56.0
• openssl
• gtest

Compile

• create directory build, cd build
• compile: cmake .. && make

Documentation

About the details, please see Wiki.

Contributing

Welcome to contribute by creating issues or sending pull requests. See Contributing Guide for guidelines.

Communication

License

Levin is licensed under the Apache License 2.0. See the LICENSE file.