Implementación del behavior GenServer
Aprenda a implementar un GenServer, gestionar el estado y atender llamadas síncronas y asíncronas, formando la base de la mayoría de los componentes de Erlang.
Implementación del behavior GenServer es una lección gratuita de Erlang OTP: Distributed & Fault-Tolerant Systems Programming en CoddyKit. Esta es la lección 2 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Erlang OTP: Distributed & Fault-Tolerant Systems Programming, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Erlang OTP: Distributed & Fault-Tolerant Systems Programming incluye 4 lecciones en total.
Partes de esta lección aún no han sido traducidas y se muestran en inglés.
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/1callback initializes the server's state. gen_server:start_linkcreates the GenServer process.handle_call/3handles synchronous requests (client waits for reply).handle_cast/2handles 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!
Aprende Erlang con un tutor de IA — gratis
Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.
- Cursos
- 12
- Lecciones
- 48
Preguntas frecuentes
¿La lección «Implementación del behavior GenServer» es gratis?
Sí — el texto completo de «Implementación del behavior GenServer» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Erlang OTP: Distributed & Fault-Tolerant Systems Programming, actualiza a CoddyKit PRO. El curso de Erlang OTP: Distributed & Fault-Tolerant Systems Programming incluye 4 lecciones en total.
¿Qué aprenderé en «Implementación del behavior GenServer»?
Aprenda a implementar un GenServer, gestionar el estado y atender llamadas síncronas y asíncronas, formando la base de la mayoría de los componentes de Erlang. Practicas Erlang OTP: Distributed & Fault-Tolerant Systems Programming con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Erlang OTP: Distributed & Fault-Tolerant Systems Programming?
No se requiere experiencia previa. Erlang OTP: Distributed & Fault-Tolerant Systems Programming en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 2 de 4.
¿Cuánto tiempo toma la lección «Implementación del behavior GenServer»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Erlang OTP: Distributed & Fault-Tolerant Systems Programming?
Sí. Cada lección de Erlang OTP: Distributed & Fault-Tolerant Systems Programming incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Comprensión de OTP y los behaviors
- Implementación del behavior GenServer
- Introducción a los supervisores
- Construcción de aplicaciones y releases OTP