0Pricing
Erlang OTP: Distributed & Fault-Tolerant Systems Programming · درس

تنفيذ سلوك GenServer

تعلّم تنفيذ GenServer وإدارة الحالة ومعالجة الاستدعاءات المتزامنة وغير المتزامنة، بما يشكّل الأساس لمعظم مكوّنات Erlang

تنفيذ سلوك GenServer درس مجاني في Erlang OTP: Distributed & Fault-Tolerant Systems Programming على CoddyKit. هذا هو الدرس 2 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Erlang OTP: Distributed & Fault-Tolerant Systems Programming، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Erlang OTP: Distributed & Fault-Tolerant Systems Programming 4 دروس في المجموع.

بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.

What is a GenServer?

Welcome back! In the previous lesson, we learned about Erlang's OTP behaviors. One of the most important is the GenServer.

  • A GenServer is a generic server that handles requests.
  • It manages internal state and processes messages in a sequential manner.
  • Think of it as a standardized way to build reliable, fault-tolerant server processes in Erlang.

It's the foundation for many Erlang applications.

GenServer's Core: Callbacks

To implement a GenServer, you define a module that exports specific callback functions. These functions are called by the gen_server behavior at different stages.

  • init/1: Initializes the server's state.
  • handle_call/3: Handles synchronous client requests (expects a reply).
  • handle_cast/2: Handles asynchronous client requests (fire-and-forget).
  • terminate/2: Cleans up when the server stops.
  • code_change/3: Handles hot code upgrades.

We'll focus on init, handle_call, and handle_cast in this lesson.

Initializing State with `init/1`

Every GenServer starts by initializing its state. This is done in the init/1 callback function.

It takes one argument (typically a list of arguments passed during startup) and should return {ok, State}, where State is the initial data your GenServer will manage.

Here's a basic init function:

-module(my_counter).
-behaviour(gen_server).
-export([init/1]).

init([]) ->
    io:format("Counter initialized with state 0.~n"),
    {ok, 0}.

Starting a GenServer Process

To get our GenServer running, we need to start it. The common way is using gen_server:start_link/3 or gen_server:start_link/4. We'll add a start_link/0 function to our module.

The start_link function creates a new Erlang process and links it to the calling process, making it part of a supervision tree (more on this later!).

-module(my_counter).
-behaviour(gen_server).
-export([start_link/0, init/1]).

start_link() ->
    gen_server:start_link({local, ?MODULE}, ?MODULE, [], []).

init([]) ->
    io:format("Counter process started!~n"),
    {ok, 0}.

Synchronous Calls: `handle_call`

When a client needs a reply from the server, it makes a synchronous call using gen_server:call/2 or gen_server:call/3.

The GenServer handles these requests in its handle_call/3 callback. This function takes three arguments:

  • Request: The message from the client.
  • From: The sender's process ID (Pid) and a tag.
  • State: The current internal state of the GenServer.

It typically returns {reply, Reply, NewState}.

Implementing `handle_call` (Counter)

Let's add an increment function to our counter. This will be a synchronous call, meaning the client waits for the new count.

Try running this code. First, compile it (`c(my_counter).`), then start it (`my_counter:start_link().`). You can then call `my_counter:increment().` to see the counter increase.

-module(my_counter).
-behaviour(gen_server).
-export([start_link/0, increment/0, get_count/0]).
-export([init/1, handle_call/3, handle_cast/2, terminate/2, code_change/3]).

start_link() ->
    gen_server:start_link({local, ?MODULE}, ?MODULE, [], []).

increment() ->
    gen_server:call(?MODULE, increment).

get_count() ->
    gen_server:call(?MODULE, get_count).

init([]) ->
    {ok, 0}.

handle_call(increment, _From, State) ->
    NewState = State + 1,
    {reply, NewState, NewState};
handle_call(get_count, _From, State) ->
    {reply, State, State};
handle_call(_Request, _From, State) ->
    {reply, {error, bad_request}, State}.

handle_cast(_Msg, State) -> % Placeholder
    {noreply, State}.

terminate(_Reason, _State) -> ok.
code_change(_OldVsn, State, _Extra) -> {ok, State}.

Asynchronous Calls: `handle_cast`

Sometimes, a client doesn't need a reply and just wants to send a message without waiting. This is an asynchronous call using gen_server:cast/2.

The GenServer handles these messages in its handle_cast/2 callback. It takes two arguments:

  • Message: The message from the client.
  • State: The current internal state of the GenServer.

It always returns {noreply, NewState} because no reply is sent back to the client.

Implementing `handle_cast` (Reset)

Let's add a reset function to our counter. This will be an asynchronous call, as the client doesn't need to know the new count immediately.

Compile and start the module as before. Call `my_counter:increment().` a few times, then `my_counter:reset().`. You'll notice `reset` returns immediately without a value.

-module(my_counter).
-behaviour(gen_server).
-export([start_link/0, increment/0, get_count/0, reset/0]).
-export([init/1, handle_call/3, handle_cast/2, terminate/2, code_change/3]).

start_link() ->
    gen_server:start_link({local, ?MODULE}, ?MODULE, [], []).

increment() ->
    gen_server:call(?MODULE, increment).

get_count() ->
    gen_server:call(?MODULE, get_count).

reset() ->
    gen_server:cast(?MODULE, reset).

init([]) ->
    {ok, 0}.

handle_call(increment, _From, State) ->
    NewState = State + 1,
    {reply, NewState, NewState};
handle_call(get_count, _From, State) ->
    {reply, State, State};
handle_call(_Request, _From, State) ->
    {reply, {error, bad_request}, State}.

handle_cast(reset, _State) ->
    {noreply, 0};
handle_cast(_Msg, State) ->
    {noreply, State}.

terminate(_Reason, _State) -> ok.
code_change(_OldVsn, State, _Extra) -> {ok, State}.

GenServer State Management

The power of GenServers lies in how they manage state. The State argument is passed into each callback, and the callback returns a NewState.

  • This ensures that only one process (the GenServer itself) ever modifies its state, preventing race conditions.
  • It makes the server's internal logic easier to reason about.
  • The state can be any Erlang term: an integer, a list, a map, a record, or a complex data structure.

This sequential processing of messages and explicit state passing is key to Erlang's concurrency model.

GenServer Call Types

Which of the following statements about GenServer calls are TRUE?

Recap: Implementing GenServer

You've successfully built your first GenServer! Here's what we covered:

  • GenServers are standard OTP behaviors for building stateful servers.
  • The init/1 callback initializes the server's state.
  • gen_server:start_link creates the GenServer process.
  • handle_call/3 handles synchronous requests (client waits for reply).
  • handle_cast/2 handles asynchronous messages (client doesn't wait).
  • GenServers manage their state by passing it between callbacks, ensuring sequential updates.

Next, we'll see how supervisors can automatically restart failed GenServers!

الأسئلة الشائعة

هل درس «تنفيذ سلوك GenServer» مجاني؟

نعم — نص درس «تنفيذ سلوك GenServer» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Erlang OTP: Distributed & Fault-Tolerant Systems Programming، انتقل إلى CoddyKit PRO. تتضمن دورة Erlang OTP: Distributed & Fault-Tolerant Systems Programming 4 دروس في المجموع.

ماذا ستتعلم في «تنفيذ سلوك GenServer»؟

تعلّم تنفيذ GenServer وإدارة الحالة ومعالجة الاستدعاءات المتزامنة وغير المتزامنة، بما يشكّل الأساس لمعظم مكوّنات Erlang تتمرن على Erlang OTP: Distributed & Fault-Tolerant Systems Programming مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Erlang OTP: Distributed & Fault-Tolerant Systems Programming؟

لا تُشترط خبرة سابقة. Erlang OTP: Distributed & Fault-Tolerant Systems Programming على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 2 من أصل 4.

كم من الوقت يستغرق درس «تنفيذ سلوك GenServer»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Erlang OTP: Distributed & Fault-Tolerant Systems Programming هذا؟

نعم. كل درس في Erlang OTP: Distributed & Fault-Tolerant Systems Programming يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

  1. فهم OTP والسلوكيات
  2. تنفيذ سلوك GenServer
  3. مقدمة إلى المشرفين
  4. بناء تطبيقات OTP وإصداراتها
← العودة إلى Erlang OTP: Distributed & Fault-Tolerant Systems Programming