الرئيسية / Enterprise / خدمات الويب SOAP مقابل Jakarta REST
Enterprise متوسط

خدمات الويب SOAP مقابل Jakarta REST

استبدل نقاط نهاية SOAP/WSDL الثقيلة بموارد Jakarta REST نظيفة تُرجع JSON.

مقارنة الكود
✕ Java EE 
@WebService
public class UserWebService {
    @WebMethod
    public UserResponse getUser(
            @WebParam(name = "id") String id) {
        User user = findUser(id);
        UserResponse res = new UserResponse();
        res.setId(user.getId());
        res.setName(user.getName());
        return res;
    }
}
✓ Jakarta EE 8+ 
@Path("/users")
@Produces(MediaType.APPLICATION_JSON)
public class UserResource {
    @Inject
    UserService userService;

    @GET
    @Path("/{id}")
    public User getUser(@PathParam("id") String id) {
        return userService.findById(id);
    }
}
هل ترى مشكلة في هذا الكود؟ أخبرنا.
لماذا يتفوق الأسلوب الحديث
🪶

حمولات أخف

JSON أكثر إيجازاً من مظاريف SOAP XML مما يقلل النطاق الترددي وتكلفة التحليل.

📐

تعليقات توضيحية بسيطة

@GET و @Path و @Produces تستبدل طقوس WSDL و @WebService و @WebMethod.

🔌

جاهز للخدمات المصغّرة

REST/JSON هو المعيار للتواصل بين الخدمات في البنى السحابية الأصلية.

الأسلوب القديم
JAX-WS / SOAP
الأسلوب الحديث
Jakarta REST / JSON
منذ JDK
11
الصعوبة
متوسط
دعم JDK
خدمات الويب SOAP مقابل Jakarta REST
متاح

متاح على نطاق واسع منذ Jakarta EE 8 / Java 11

كيف يعمل

تعتمد خدمات الويب القائمة على SOAP على عقود WSDL وتسلسل XML وتعليقات JAX-WS التوضيحية التي تضيف تكلفة كبيرة. تستخدم Jakarta REST تعليقات توضيحية بديهية مثل @GET و @Path و @Produces لكشف واجهات برمجية RESTful بـ JSON. نموذج البرمجة أبسط والحمولات أصغر والنهج يتوافق مع كيفية تواصل الخدمات المصغّرة الحديثة.

توثيق ذو صلة
Jakarta RESTful Web Services Specification ↗ Jakarta JSON Binding Specification ↗
أنماط ذات صلة
Enterprise متوسط

Servlet versus JAX-RS

Java EE
@WebServlet("/users")
public class UserServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req,
                         HttpServletResponse res)
            throws ServletException, IOException {
        String id = req.getParameter("id");
        res.setContentType("application/json");
        res.getWriter().write("{\"id\":\"" + id + "\"}");
    }
}
Jakarta EE 8+
@Path("/users")
public class UserResource {
    @GET
    @Produces(MediaType.APPLICATION_JSON)
    public Response getUser(
            @QueryParam("id") String id) {
        return Response.ok(new User(id)).build();
    }
}
مرر للرؤية الحديث ←
JDK 11+ →
I/O مبتدئ

Modern HTTP client

Java 8
URL url = new URL("https://api.com/data");
HttpURLConnection con =
    (HttpURLConnection) url.openConnection();
con.setRequestMethod("GET");
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
// read lines, close streams...
Java 11+
var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.com/data"))
    .build();
var response = client.send(
    request, BodyHandlers.ofString());
String body = response.body();
مرر للرؤية الحديث ←
JDK 11+ →
Enterprise متوسط

EJB versus CDI

Java EE
@Stateless
public class OrderEJB {
    @EJB
    private InventoryEJB inventory;

    public void placeOrder(Order order) {
        // container-managed transaction
        inventory.reserve(order.getItem());
    }
}
Jakarta EE 8+
@ApplicationScoped
public class OrderService {
    @Inject
    private InventoryService inventory;

    @Transactional
    public void placeOrder(Order order) {
        inventory.reserve(order.getItem());
    }
}
مرر للرؤية الحديث ←
JDK 11+ →
مشاركة 𝕏 🦋 in ⬡