Mục đích của hàm entity_metadata_wrapper () là gì và tại sao tôi nên sử dụng nó?

Tôi dường như đang phát triển các tiện ích bổ sung cho rất nhiều mô-đun sử dụng API thực thể tại thời điểm này và entity_metadata_wrapper()chức năng tiếp tục bật lên.

Các trang tài liệu nói này về nó:

Trả về một trình bao bọc thuộc tính cho dữ liệu đã cho.

Nếu một thực thể được bọc, trình bao bọc có thể được sử dụng để truy xuất các trình bao bọc tiếp theo cho các thuộc tính quyền lợi.

Bỏ qua cách đánh vần Freudian tuyệt vời của từ 'thực thể' trong đó, tôi không thực sự hiểu mục đích của các hàm bao này là gì.

Tôi hiểu rằng về cơ bản hàm trả về một EntityDrupalWrapperlớp:

Trình bao bọc giúp giảm bớt việc áp dụng các hàm gọi lại getter và setter của các thuộc tính thực thể

Nhưng những gì tôi không thể hiểu là làm thế nào nó làm cho mọi thứ dễ dàng hơn.

Ví dụ: để cập nhật thuộc tính trạng thái của một nút tôi có thể sử dụng mã này:

$node = node_load($nid);
$node->status = 1;
node_save($node);

Điều đó khá sạch sẽ. Theo tôi hiểu (nhưng có thể sai), mã tương đương sử dụng entity_metadata_wrapper()sẽ dài dòng hơn thế.

Tôi không chắc liệu nó có đơn giản chỉ là việc sử dụng thuật ngữ 'trình bao bọc' đã khiến tôi vấp ngã ở đây không, nhưng tôi cũng đã xem qua mã trong mô-đun Thực thể và tôi thực sự không hiểu gì hơn về nó.

Có ai có thể giải thích những lợi ích của việc sử dụng chức năng này là gì không, và có lẽ cung cấp một ví dụ mã đơn giản cho trường hợp sử dụng phổ biến?

Có, thay đổi trạng thái của một nút là không đáng kể, vì đó là một thuộc tính được mã hóa cứng.

Mặt khác, các lĩnh vực phức tạp hơn nhiều. Chúng được lồng sâu ba cấp độ, trong khi có field_get_items () để đưa chúng vào đúng ngôn ngữ, không có chức năng nào như vậy để đặt giá trị trường. Vì vậy, bạn luôn cần kiểm tra xem một trường có thể dịch được hay không và bạn cần biết chính xác thuộc tính nào chứa các giá trị bạn đang tìm / muốn đặt.

Hai ví dụ, cho thấy những gì trình bao bọc thực thể có thể làm:

• Dòng sau đây thêm mục hàng thương mại vào đơn hàng, chăm sóc ngôn ngữ và tài sản thực tế chứa id tham chiếu, được lấy từ câu trả lời sau /drupal//a/23513/31

  $order_wrapper->commerce_line_items[] = $line_item;

• Theo cách tương tự, có thể truy cập trực tiếp vào giá trị của một trường mà không phải kiểm tra ngôn ngữ hoặc đồng bằng, thậm chí có thể truy cập trực tiếp các thực thể được tham chiếu, được lấy từ /drupal//a/ 3301031

  $subnode = entity_metadata_wrapper('node', $node)->field_subnode->value();
  $default = $subnode->title;

Trình bao bọc thực thể là động lực thúc đẩy các mô-đun linh hoạt, mạnh mẽ như API tìm kiếm và Quy tắc vì nó cho phép chúng hoạt động theo nhiều cấp độ tham chiếu, do đó, bạn có thể truy cập vào một lĩnh vực sản phẩm mà người dùng đã mua theo thứ tự như [commerce-order:commerce-line-items:0:commerce-product:some-field](có thể không thực sự chính xác, nhưng một cái gì đó tương tự) hoặc thêm tóm tắt nội dung của một nút được tham chiếu vào chỉ mục tìm kiếm của bạn.

Điều đó nói rằng, tôi không nhất thiết phải thích API thực tế của trình bao bọc, đó là mảng nội bộ khổng lồ và thậm chí các thuộc tính đơn giản lại là các lớp trình bao bọc. Tôi hy vọng rằng hệ thống thực thể được cải thiện (và hy vọng trường) trong Drupal 8 sẽ loại bỏ sự cần thiết của một trình bao bọc như vậy nhờ có các thực thể được phân loại.