%% @author Marc Worrell %% @copyright 2018 Marc Worrell %% @doc JSON with records and 'undefined'/'null' mapping. Wrapper around jsx. %% Copyright 2018 Marc Worrell %% %% Licensed 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(jsxrecord). -author('Marc Worrell '). -export([ encode/1, decode/1, load_records/1, record_defs/0 ]). -define(RECORD_TYPE, <<"_type">>). %%==================================================================== %% API %%==================================================================== -spec encode( term() ) -> binary(). encode(Source) -> encode_json(Source). -spec decode( binary() ) -> term(). decode(Bin) when is_binary(Bin) -> decode_json(Bin). %% @doc Load all record definitions. -spec record_defs() -> map(). record_defs() -> try jsxrecord_defs:defs() catch _:_ -> _ = application:start(jsxrecord), {ok, Ms} = application:get_env(jsxrecord, record_modules), ok = do_load_records(Ms, #{}), jsxrecord_defs:defs() end. -spec load_records( module() | list( module( )) ) -> ok. load_records(Module) when is_atom(Module) -> load_records([ Module ]); load_records(Modules) -> do_load_records(Modules, record_defs_int()). %%==================================================================== %% Internal %%==================================================================== %% @doc Load all record definitions. -spec record_defs_int() -> map(). record_defs_int() -> try jsxrecord_defs:defs() catch _:_ -> #{} end. do_load_records(Modules, CurrRecordDefs) -> Records = lists:flatten( lists:map( fun(M) -> extract_records(M) end, Modules ) ), New = lists:foldl( fun({Name, Fs}, Acc) -> FsB = [ {atom_to_binary(F, utf8), Init} || {F,Init} <- Fs ], Acc#{ atom_to_binary(Name, utf8) => FsB } end, CurrRecordDefs, Records), compile_module(New). encode_json(undefined) -> <<"null">>; encode_json(null) -> <<"null">>; encode_json(true) -> <<"true">>; encode_json(false) -> <<"false">>; encode_json({struct, _} = MochiJSON) -> encode_json( mochijson_to_map(MochiJSON) ); encode_json(Term) -> jsx:encode( expand_records( Term ) ). decode_json(undefined) -> undefined; decode_json(<<>>) -> undefined; decode_json(<<"null">>) -> undefined; decode_json(<<"true">>) -> true; decode_json(<<"false">>) -> false; decode_json(B) -> reconstitute_records( jsx:decode(B, [return_maps]) ). reconstitute_records( M ) when is_map(M) -> M1 = maps:map( fun(_K, V) -> reconstitute_records(V) end, M ), case maps:find(?RECORD_TYPE, M1) of {ok, Type} -> case maps:find(Type, record_defs_int()) of {ok, Def} -> Rec = lists:foldl( fun({F, Default}, Acc) -> [ maps:get(F, M1, Default) | Acc ] end, [ binary_to_atom(Type, utf8) ], Def), list_to_tuple( lists:reverse(Rec) ); error -> M1 end; error -> M1 end; reconstitute_records( L ) when is_list(L) -> [ reconstitute_records(X) || X <- L ]; reconstitute_records( null ) -> undefined; reconstitute_records( T ) -> T. expand_records(R) when is_tuple(R), is_atom(element(1, R)) -> T = atom_to_binary(element(1, R), utf8), case maps:find(T, record_defs()) of {ok, Def} -> expand_record_1(Def, 2, R, #{ ?RECORD_TYPE => T }); error -> R end; expand_records({K, V}) when is_number(K) -> [ K, V ]; expand_records({K, V}) -> {expand_records(K), expand_records(V)}; expand_records(L) when is_list(L) -> lists:map( fun ({K, V}) -> {K, expand_records(V)}; (V) -> expand_records(V) end, L); expand_records(M) when is_map(M) -> maps:map( fun(_K, V) -> expand_records(V) end, M ); expand_records(undefined) -> null; expand_records(X) -> X. expand_record_1([ {F, _} | Fs ], N, R, Acc) -> Acc1 = Acc#{ F => expand_records( element(N, R) ) }, expand_record_1(Fs, N+1, R, Acc1); expand_record_1([], _N, _R, Acc) -> Acc. mochijson_to_map({struct, L}) -> maps:from_list([ mochijson_to_map(V) || V <- L ]); mochijson_to_map({K, V}) -> {K, mochijson_to_map(V)}; mochijson_to_map(V) -> V. %% @doc Compile the record defs to a module, for effictient caching of all definitions -spec compile_module( map() ) -> ok. compile_module( Defs ) -> {ok, Module, Bin} = compile(Defs), code:purge(Module), {module, _} = code:load_binary(Module, "jsxrecord_defs.erl", Bin), ok. -spec compile( map() ) -> {ok, atom(), binary()}. compile(Defs) -> ModuleAst = erl_syntax:attribute(erl_syntax:atom(module), [ erl_syntax:atom(jsxrecord_defs) ]), ExportAst = erl_syntax:attribute( erl_syntax:atom(export), [ erl_syntax:list([ erl_syntax:arity_qualifier(erl_syntax:atom(defs), erl_syntax:integer(0)) ]) ]), FunAst = erl_syntax:function( erl_syntax:atom(defs), [ erl_syntax:clause([], none, [ erl_syntax:abstract(Defs) ]) ]), Forms = [ erl_syntax:revert(X) || X <- [ ModuleAst, ExportAst, FunAst ] ], {ok, Module, Bin} = compile:forms(Forms, []), {ok, Module, Bin}. -spec extract_records( module() ) -> list( {atom(), list(atom())} ). extract_records(Module) -> case code:which(Module) of BeamFile when is_list(BeamFile) -> case beam_lib:chunks(BeamFile, [ abstract_code ]) of {ok, {_, [ {abstract_code, {_, AbstractCode }} ]} } -> extract_records_abs(AbstractCode); _ -> [] end; _Other -> [] end. %% @doc Extract all record definitions from the abstract code extract_records_abs( AbstractCode ) -> lists:filtermap( fun ({attribute, _Pos, record, {Name, Fields}}) -> {true, {Name, to_field_names(Fields)}}; (_) -> false end, AbstractCode). to_field_names(Fields) -> [ to_field_name(Field) || Field <- Fields ]. to_field_name({typed_record_field, RecField, _Type}) -> to_field_name(RecField); to_field_name({record_field, _Line, {atom, _, FieldName}}) -> {FieldName, undefined}; to_field_name({record_field, _Line, {atom, _, FieldName}, InitExpr}) -> {FieldName, erl_syntax:concrete(InitExpr)}.