%% %% Copyright (c) 2016 SyncFree Consortium. All Rights Reserved. %% %% This file is provided to you under the Apache License, %% Version 2.0 (the "License"); you may not use this file %% except in compliance with the License. You may obtain %% a copy of the License at %% %% http://www.apache.org/licenses/LICENSE-2.0 %% %% Unless required by applicable law or agreed to in writing, %% software distributed under the License is distributed on an %% "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY %% KIND, either express or implied. See the License for the %% specific language governing permissions and limitations %% under the License. %% %% ------------------------------------------------------------------- -module(ldb_delta_based_backend). -author("Vitor Enes Duarte {ok, pid()} | ignore | {error, term()}. start_link() -> gen_server:start_link({local, ?MODULE}, ?MODULE, [], []). -spec create(key(), type()) -> ok. create(Key, Type) -> gen_server:call(?MODULE, {create, Key, Type}, infinity). -spec query(key()) -> {ok, value()} | not_found(). query(Key) -> gen_server:call(?MODULE, {query, Key}, infinity). -spec update(key(), operation()) -> ok | not_found() | error(). update(Key, Operation) -> gen_server:call(?MODULE, {update, Key, Operation}, infinity). -spec message_maker() -> function(). message_maker() -> fun(Key, {{Type, _}=CRDT, Sequence, DeltaBuffer, AckMap}, NodeName) -> MinSeq = min_seq(DeltaBuffer), LastAck = last_ack(NodeName, AckMap), case LastAck < Sequence of true -> Delta = case orddict:is_empty(DeltaBuffer) orelse MinSeq > LastAck of true -> CRDT; false -> orddict:fold( fun(N, {From, D}, Acc) -> ShouldSendDelta0 = LastAck =< N andalso N < Sequence, ShouldSendDelta1 = case ldb_config:get(ldb_dgroup_back_propagation, false) of true -> % when set to true, avoids back propagation of delta groups ShouldSendDelta0 andalso NodeName =/= From; false -> ShouldSendDelta0 end, case ShouldSendDelta1 of true -> Type:merge(Acc, D); false -> Acc end end, ldb_util:new_crdt(state, CRDT), DeltaBuffer ) end, Actor = ldb_config:id(), Message = { Key, delta, Actor, Sequence, Delta }, {ok, Message}; false -> nothing end end. -spec message_handler(term()) -> function(). message_handler({_, delta, _, _, _}) -> fun({Key, delta, From, N, {Type, _}=RemoteCRDT}) -> %% create bottom entry Bottom = ldb_util:new_crdt(state, RemoteCRDT), create_entry(Key, Bottom), ldb_store:update( Key, fun({LocalCRDT, Sequence0, DeltaBuffer0, AckMap}) -> Merged = Type:merge(LocalCRDT, RemoteCRDT), {Sequence, DeltaBuffer} = case ldb_config:get(ldb_redundant_dgroups, false) of true -> Delta = Type:delta(state, RemoteCRDT, LocalCRDT), %% If what we received, inflates the local state case not Type:is_bottom(Delta) of true -> DeltaBuffer1 = orddict:store(Sequence0, {From, Delta}, DeltaBuffer0), Sequence1 = Sequence0 + 1, {Sequence1, DeltaBuffer1}; false -> {Sequence0, DeltaBuffer0} end; false -> %% If what we received, inflates the local state case Type:is_strict_inflation(LocalCRDT, Merged) of true -> DeltaBuffer1 = orddict:store(Sequence0, {From, RemoteCRDT}, DeltaBuffer0), Sequence1 = Sequence0 + 1, {Sequence1, DeltaBuffer1}; false -> {Sequence0, DeltaBuffer0} end end, %% send ack Ack = { Key, delta_ack, ldb_config:id(), N }, ldb_whisperer:send(From, Ack), StoreValue = {Merged, Sequence, DeltaBuffer, AckMap}, {ok, StoreValue} end ) end; message_handler({_, delta_ack, _, _}) -> fun({Key, delta_ack, From, N}) -> ldb_store:update( Key, fun({LocalCRDT, Sequence, DeltaBuffer, AckMap0}) -> LastAck = last_ack(From, AckMap0), MaxAck = max(LastAck, N), AckMap1 = orddict:store(From, MaxAck, AckMap0), StoreValue = {LocalCRDT, Sequence, DeltaBuffer, AckMap1}, {ok, StoreValue} end ) end. -spec memory() -> {non_neg_integer(), non_neg_integer()}. memory() -> gen_server:call(?MODULE, memory, infinity). %% gen_server callbacks init([]) -> {ok, _Pid} = ldb_store:start_link(), Actor = ldb_config:id(), schedule_dbuffer_shrink(), ?LOG("ldb_delta_based_backend initialized!"), {ok, #state{actor=Actor}}. handle_call({create, Key, LDBType}, _From, State) -> Bottom = ldb_util:new_crdt(type, LDBType), Result = create_entry(Key, Bottom), {reply, Result, State}; handle_call({query, Key}, _From, State) -> Result = case ldb_store:get(Key) of {ok, {{Type, _}=CRDT, _, _, _}} -> {ok, Type:query(CRDT)}; Error -> Error end, {reply, Result, State}; handle_call({update, Key, Operation}, _From, #state{actor=Actor}=State) -> Function = fun({{Type, _}=CRDT0, Sequence, DeltaBuffer0, AckMap}) -> case Type:delta_mutate(Operation, Actor, CRDT0) of {ok, Delta} -> CRDT1 = Type:merge(CRDT0, Delta), DeltaBuffer1 = orddict:store(Sequence, {Actor, Delta}, DeltaBuffer0), StoreValue = {CRDT1, Sequence + 1, DeltaBuffer1, AckMap}, {ok, StoreValue}; Error -> Error end end, Result = ldb_store:update(Key, Function), {reply, Result, State}; handle_call(memory, _From, State) -> FoldFunction = fun({_Key, Value}, {C, R}) -> {CRDT, Sequence, DeltaBuffer, AckMap} = Value, CRDTSize = ldb_util:size(crdt, CRDT), RestSize = ldb_util:size(term, {Sequence, AckMap}) + ldb_util:size(delta_buffer, DeltaBuffer), {C + CRDTSize, R + RestSize} end, Result = ldb_store:fold(FoldFunction, {0, 0}), {reply, Result, State}; handle_call(Msg, _From, State) -> lager:warning("Unhandled call message: ~p", [Msg]), {noreply, State}. handle_cast(Msg, State) -> lager:warning("Unhandled cast message: ~p", [Msg]), {noreply, State}. handle_info(dbuffer_shrink, State) -> ShrinkFun = fun({LocalCRDT, Sequence, DeltaBuffer0, AckMap}) -> DeltaBuffer1 = case ldb_config:get(ldb_dbuffer_shrink_mode) of normal -> Acks = [N || {_, N} <- AckMap], %% Add the current `Sequence' to the list of acks %% to make sure we have a min; %% If we don't have acks, the buffer will be cleared. %% This ensures local progress. Min = lists:min([Sequence | Acks]), orddict:filter( fun(EntrySequence, {_Actor, _Delta}) -> EntrySequence >= Min end, DeltaBuffer0 ); dummy -> %% clear the delta buffer orddict:new() end, NewValue = {LocalCRDT, Sequence, DeltaBuffer1, AckMap}, {ok, NewValue} end, ldb_store:update_all(ShrinkFun), schedule_dbuffer_shrink(), {noreply, State}; handle_info(Msg, State) -> lager:warning("Unhandled info message: ~p", [Msg]), {noreply, State}. terminate(_Reason, _State) -> ok. code_change(_OldVsn, State, _Extra) -> {ok, State}. %% @private schedule_dbuffer_shrink() -> Interval = ldb_config:get(ldb_dbuffer_shrink_interval), timer:send_after(Interval, dbuffer_shrink). %% @private create_entry(Key, Bottom) -> Sequence = 0, DeltaBuffer = orddict:new(), AckMap = orddict:new(), StoreValue = {Bottom, Sequence, DeltaBuffer, AckMap}, Result = ldb_store:create(Key, StoreValue), Result. %% @private min_seq(DeltaBuffer) -> case orddict:fetch_keys(DeltaBuffer) of [] -> 0; Keys -> lists:nth(1, Keys) end. %% @private last_ack(NodeName, AckMap) -> orddict_ext:fetch(NodeName, AckMap, 0).