WebSockets & Real-Time Systems with Spring · درس

المراسلة الأساسية بين العميل والخادم

نفّذوا إرسال رسائل بسيطة من العميل إلى الخادم والعكس، مع توضيح أساسيات التفاعل الفوري.

المراسلة الأساسية بين العميل والخادم درس مجاني في WebSockets & Real-Time Systems with Spring على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في WebSockets & Real-Time Systems with Spring، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة WebSockets & Real-Time Systems with Spring 4 دروس في المجموع.

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

Messaging Fundamentals

In previous lessons, you set up your Spring WebSocket application and configured its endpoints. Now, let's make it talk!

Real-time communication is all about sending messages back and forth between clients (like web browsers) and the server. This lesson will show you the basics of how this interaction works.

Client Sends to Server

The most common interaction starts with a client sending a message to the server. This message might be a user action, a chat message, or a command.

The client establishes a WebSocket connection.
It then sends data to a specific server "destination".
Spring handles receiving this message on the server side.

Server-Side Receiver (Spring)

Spring uses annotations to make handling incoming messages easy. The @MessageMapping annotation maps a method to a specific destination path, similar to @GetMapping for HTTP.

When a client sends a message to, say, /app/hello, the method annotated with @MessageMapping("/hello") will be invoked.

Implementing Server Receiver

Let's see a simple server-side method that receives a message. Notice how the input message can be directly mapped to a Java object (e.g., a String).

import org.springframework.messaging.handler.annotation.MessageMapping;
import org.springframework.stereotype.Controller;

@Controller
public class GreetingController {

    @MessageMapping("/hello")
    public String handleHello(String message) {
        System.out.println("Received from client: " + message);
        return "Server received: " + message; 
    }
}

Server Sends to Client

After processing a client's message, the server often needs to send a response or broadcast updates to clients. This is how real-time interaction truly happens.

Spring provides convenient ways to send messages back to clients, often using a message broker.

Implementing Server Sender

To send an immediate response to the client who sent the message, you can use the @SendTo annotation. This routes the return value of your @MessageMapping method to a specific topic.

import org.springframework.messaging.handler.annotation.MessageMapping;
import org.springframework.messaging.handler.annotation.SendTo;
import org.springframework.stereotype.Controller;

@Controller
public class GreetingController {

    @MessageMapping("/hello")
    @SendTo("/topic/greetings")
    public String handleHello(String message) {
        System.out.println("Received: " + message);
        return "Hello from Server: " + message;
    }
}

Client-Side Sending (JavaScript)

On the client side, typically a web browser, you'll use JavaScript to interact with the WebSocket endpoint. Libraries like SockJS and STOMP.js simplify this process.

Connect to the WebSocket endpoint.
Send messages to the server's @MessageMapping destinations.
Subscribe to server "topic" destinations to receive messages.

Simple JavaScript Client

Here's how a basic JavaScript client sends a message. It uses a STOMP client to connect and send data to the server's /app/hello destination.

// This assumes SockJS and STOMP.js are loaded
var socket = new SockJS('/ws'); // Your WebSocket endpoint
var stompClient = Stomp.over(socket);

stompClient.connect({}, function (frame) {
    console.log('Connected: ' + frame);

    // Subscribe to a topic to receive messages
    stompClient.subscribe('/topic/greetings', function (greeting) {
        console.log("Received from server: " + greeting.body);
    });

    // Send a message to the server
    stompClient.send("/app/hello", {}, "Hello Spring!");
});

Full Echo Example (Server)

Let's put it together! This Spring Boot server will receive a message, print it, and then send a greeting back to a public topic. You can run this as a Spring Boot application.

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Configuration;
import org.springframework.messaging.handler.annotation.MessageMapping;
import org.springframework.messaging.handler.annotation.SendTo;
import org.springframework.messaging.simp.config.MessageBrokerRegistry;
import org.springframework.stereotype.Controller;
import org.springframework.web.socket.config.annotation.EnableWebSocketMessageBroker;
import org.springframework.web.socket.config.annotation.StompEndpointRegistry;
import org.springframework.web.socket.config.annotation.WebSocketMessageBrokerConfigurer;

@SpringBootApplication
public class WebSocketServerApp {
    public static void main(String[] args) {
        SpringApplication.run(WebSocketServerApp.class, args);
    }
}

@Configuration
@EnableWebSocketMessageBroker
class WebSocketConfig implements WebSocketMessageBrokerConfigurer {
    @Override
    public void registerStompEndpoints(StompEndpointRegistry registry) {
        registry.addEndpoint("/ws").withSockJS(); // WebSocket endpoint
    }

    @Override
    public void configureMessageBroker(MessageBrokerRegistry config) {
        config.enableSimpleBroker("/topic"); // Enable a simple broker for /topic destinations
        config.setApplicationDestinationPrefixes("/app"); // Client messages for @MessageMapping
    }
}

@Controller
class GreetingController {
    @MessageMapping("/hello") // Client sends to /app/hello
    @SendTo("/topic/greetings") // Server sends response to /topic/greetings
    public String greet(String message) throws Exception {
        Thread.sleep(1000); // Simulate processing delay
        System.out.println("Server received: " + message);
        return "Server says: " + message + "!";
    }
}

Message Flow Check

Consider a Spring WebSocket application where a client sends a message to /app/chat and the server responds to /topic/updates. Which of the following statements are true about this interaction?

Recap: Basic Messaging

Great job! You've learned the fundamentals of client-server messaging in Spring WebSockets:

Clients send messages to server destinations using client-side STOMP libraries.
Servers receive messages using @MessageMapping.
Servers can respond immediately using @SendTo to broadcast to topics.

This forms the foundation for all real-time interactions. Next, we'll dive deeper into the STOMP protocol for more structured messaging!

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

هل درس «المراسلة الأساسية بين العميل والخادم» مجاني؟

نعم — نص درس «المراسلة الأساسية بين العميل والخادم» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة WebSockets & Real-Time Systems with Spring، انتقل إلى CoddyKit PRO. تتضمن دورة WebSockets & Real-Time Systems with Spring 4 دروس في المجموع.

ماذا ستتعلم في «المراسلة الأساسية بين العميل والخادم»؟

نفّذوا إرسال رسائل بسيطة من العميل إلى الخادم والعكس، مع توضيح أساسيات التفاعل الفوري. تتمرن على WebSockets & Real-Time Systems with Spring مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ WebSockets & Real-Time Systems with Spring؟

لا تُشترط خبرة سابقة. WebSockets & Real-Time Systems with Spring على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.

كم من الوقت يستغرق درس «المراسلة الأساسية بين العميل والخادم»؟

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

هل يمكنني كتابة وتشغيل أكواد في درس WebSockets & Real-Time Systems with Spring هذا؟

نعم. كل درس في WebSockets & Real-Time Systems with Spring يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

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

Spring Boot لـ WebSockets
إعداد نقاط نهاية WebSocket
المراسلة الأساسية بين العميل والخادم
التعامل مع أحداث دورة حياة WebSocket في Spring

← العودة إلى WebSockets & Real-Time Systems with Spring