commit | b36d339db4571b414124bc5df42c2ccc4db4cc45 | [log] [tgz] |
---|---|---|
author | Takeru Ohta <phjgt308@gmail.com> | Fri Aug 03 15:58:13 2018 +0900 |
committer | Takeru Ohta <phjgt308@gmail.com> | Fri Aug 03 15:58:13 2018 +0900 |
tree | b8ffd608b109a3cfaf34398d503fdf4e86e9e25e | |
parent | 832264212fe50b3c8da76e728ed2f08e5d54351c [diff] |
Support OTP-21
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]} }.