SuperCache
v0.5.2

View Source Guide

guide

 Guide

SuperCache is similar to Ets for easy to use. Current version, it's support limited function from Ets, ex: insert, lookup, delete, match_object, scan object.

Start SuperCache with default config:

SuperCache.start!()

(key_pos = partition_pos = 0, table_type = :set, num_partition = on_line schedulers of Erlang VM)

Start with config:

opts = [key_pos: 0, partition_pos: 1, table_type: :bag, num_partition: 3]
SuperCache.start!(opts)

Note:

  1. key_pos: Key's position of tuple use to lookup in Ets table.

  2. partition_pos: Position of element in tuple is used to calculate partition for store & lookup.

  3. table_type: Type of Ets table.

  4. num_partition: Number of partitions (= number of Ets table).

In almost case key_pos and partition_pos is same. If you need to organize data for fast access you can choose right data to calculate partition.

Basic usage:

opts = [key_pos: 0, partition_pos: 1, table_type: :bag, num_partition: 3]
SuperCache.start!(opts)

SuperCache.put!({:hello, :world, "hello world!"})

SuperCache.get_by_key_partition!(:hello, :world)

SuperCache.delete_by_key_partition!(:hello, :world)

SuperCache.put({:a, :b, 1, 3, "c"})

SuperCache.get_by_match_object!({:_, :_, 1, :_, "c"})
[{:a, :b, 1, 3, "c"}]

In case, key_pos & partition_pos is same:

SuperCache.put({:hello, :world, :example})
SuperCache.get_same_key_partition!(:hello)
SuperCache.delete