commit | 0b1c646a3b66cec14c052de4599573ebd323fe74 | [log] [tgz] |
---|---|---|
author | Takeru Ohta <phjgt308@gmail.com> | Fri Aug 03 15:58:24 2018 +0900 |
committer | Takeru Ohta <phjgt308@gmail.com> | Fri Aug 03 15:58:24 2018 +0900 |
tree | c371a56c82f073703b4d423d54c4268b3f14ce75 | |
parent | b36d339db4571b414124bc5df42c2ccc4db4cc45 [diff] |
v0.2.1
A Local Name Registration Facility.
The library provides the following features:
gen_server
(and other OTP behaviours) can use the registration facility through {via, local, local:name()}
formatted name# clone $ git clone git://github.com/sile/local.git $ cd local # compile $ make compile # run tests $ make eunit # dialyze $ make dialyze # Erlang shell $ make start 1> local:start(sample_name_server). ok
%% Starts name server > ok = local:start_name_server(sample_name_server). > local:which_name_servers(). [sample_name_server] %% Registers process name > self(). <0.42.0> > local:register_name({sample_name_server, hoge}, self()). % succeeded yes > local:register_name({sample_name_server, hoge}, self()). % failed: name collision no > local:whereis_name({sample_name_server, hoge}). <0.42.0> %% Registered name can be used as gen_server's via name > gen_server:cast({via, local, {sample_name_server, hoge}}, hello). ok > flush(). Shell got {'$gen_cast',hello} ok %% Unregisters process name > local:unregister_name({sample_name_server, hoge}). ok > local:whereis_name({sample_name_server, hoge}). undefined %% Stops name server > ok = local:stop_name_server(sample_name_server). > local:which_name_servers(). []
Local can be embedded in your application.
%% Embedding Example -module(your_app_sup). -behaviour(supervisor). -export([init/1]). % 'supervisor' callback API init([]) -> Child1 = local:name_server_child_spec(your_app_name_server_1), Child2 = local:name_server_child_spec(your_app_name_server_2), {ok, { {one_for_one, 5, 10}, [Child1, Child2]} }.