Ransack hay ActiveRecord sử dụng abstract syntax tree (AST) để compose query thay vì build query trực tiếp. AST sẽ bao gồm các node (Arel::Nodes::Note) chứa thông tin để tạo thành từng SQL fragment. Mỗi node được tạo nên bởi hai thành phần chính là attribute và predicate. Hiểu được điều này, chúng ta có thể chuyển hầu hết các case sử dụng query thuần sang AST thông qua việc định nghĩa các node tương ứng.
Ransack matcher
Để hiểu hơn về cách mà ransack hoạt động, chúng ta sẽ phân tích các thành phần trong một matcher thông qua ví dụ sau:
User.ransack(first_name_cont_any: "Rya").result.to_sql # SELECT "users".* FROM "users" WHERE ("users"."first_name" LIKE '%Rya%')
Ở đây matcher là first_name_cout_any trong đó:
first_name: là attribute, hay là column trong tablecont: là predicate, xác định condition sẽ được sử dụngany: là biến thể của predicate. Phần này là optional, tuỳ thuộc predicate có hỗ trợ hay không.
Ransack sẽ parse matcher thành các phần như ở trên, sau đó sẽ tạo node tương ứng trong AST. Vì vậy, nếu muốn thêm một custom matcher, ta sẽ cần define đầy đủ các thành phần của nó.
Custom ransacker
Thực tế, không phải lúc nào yêu cầu cũng chỉ là search theo một attribute như trong ví dụ trên. Trường hợp cần kết hợp nhiều attributes khác nhau trong một điều kiện search, đó sẽ là lúc ransacker được sử dụng. Hãy cùng xem ví dụ sau:
User.where("CONCAT_WS('', first_name, last_name) LIKE '%Rya%'").to_sql # SELECT "users".* FROM "users" WHERE (CONCAT_WS('', first_name, last_name) LIKE '%Rya%')
Nếu muốn sử dụng ransack trong trường hợp này, ta cần định nghĩa một ransacker trong model User:
ransacker :full_name do Arel.sql("CONCAT_WS(' ', first_name, last_name)")
end
Sau đó, có thể kết hợp ransacker ở trên với các predicates mặc định để search như bình thường:
User.ransack(full_name_cont: "Rya").result.to_sql # SELECT "users".* FROM "users" WHERE (CONCAT_WS(' ', first_name, last_name) LIKE '%Rya%')
User.ransack(full_name_matches: "Rya").result.to_sql # SELECT "users".* FROM "users" WHERE (CONCAT_WS(' ', first_name, last_name) LIKE 'Rya')
Như vậy, ransacker ở đây chính là cách chúng ta định nghĩa attrbiute của một Ransack matcher.
Custom predicate
Ở trên, chúng ta vừa sử dụng ransacker để định nghĩa thành phần attribute trong một Ransack matcher. Trong trường hợp muốn tạo một custom predicate, bạn cần phải thực hiện các bước sau:
Thêm một predicate mới
Để thêm một predicate mới, ta có thể thêm method vào module Arel::Predications:
module Arel module Predications def prefix_admin other self.eq("[admin] #{other}") end end
end
Ở trên, chúng ta vừa thêm predicate prefix_admin có chức năng tự động thêm [admin] vào phía trước search value (other). Nghĩa là, nếu bạn nhập Rya thì search value thực tế sẽ là [admin] Rya. Mỗi một predicate sẽ cần phải trả về một Arel::Nodes::Note, chi tiết các node và cách sử dụng bạn có thể xem ở đây.
Khai báo predicate với Ransack
Trước khi có thể sử dụng, predicate cần phải được khai báo với Ransack. Tại đây bạn cũng có thể thêm các config khác liên quan đến format hay validate:
Ransack.configure do |config| config.add_predicate("perfix_admin", arel_predicate: "perfix_admin", formatter: proc {|v| v.titleize}, validator: proc {|v| v.present?}, compounds: false )
end
Trường hợp muốn sử dụng các predicates mặc định, bạn chỉ cần khai báo với Ransack predicate cần dùng:
Ransack.configure do |config| config.add_predicate("upcase", arel_predicate: "matches", formatter: proc {|v| v.upcase}, validator: proc {|v| v.present?} )
end
Chi tiết các predicates mặc định bạn có thể tham khảo ở đây.
Sử dụng custom predicate
Bây giờ ta có thể sử dụng predicate vừa tạo kết hợp với các attributes mặc định hoặc với ransacker vừa định nghĩa ở trên:
User.ransack(first_name_prefix_admin: "Rya").result.to_sql # SELECT "users".* FROM "users" WHERE "users"."first_name" = '[admin] Rya'
User.ransack(full_name_prefix_admin: "Rya").result.to_sql # SELECT "users".* FROM "users" WHERE (CONCAT_WS(' ', first_name, last_name) = '[admin] Rya')
User.ransack(first_name_upcase: "rya").result.to_sql # SELECT "users".* FROM "users" WHERE "users"."first_name" LIKE 'RYA'
Custom predicate compouds
Mặc định option compounds khi định nghĩa predicate là true. Nghĩa là bạn có thể sử dụng predicate kết hợp với biến thể như all, any. Việc cần làm là thêm predicate của các biến thể tương ứng. Dưới đây là ví dụ:
module Arel module Predications def concat others self.in(others.flatten) end def concat_any others self.in_any(others.flatten) end def concat_all others self.in_all(others.flatten) end end
end
Ở trên chúng ta thêm predicate concat và các biến thể concat_any, concat_all của nó.
Tiếp theo chúng ta sẽ khai báo predicate này với Ransack.
Ransack.configure do |config| config.add_predicate("concat", arel_predicate: "concat", formatter: proc {|v| v.split(",").map(&:strip)}, validator: proc {|v| v.present?}, compounds: true, type: :string )
end
Ở phần formatter ta biến đổi search value từ một chuỗi thành một mảng. Và bây giờ ta có thể search theo các cách sau:
User.ransack(id_concat: "1,2").result.to_sql # SELECT "users".* FROM "users" WHERE "users"."id" IN (1, 2)
User.ransack(id_concat_any: "1,2").result.to_sql # SELECT "users".* FROM "users" WHERE ("users"."id" IN (1) OR "users"."id" IN (2))
User.ransack(id_concat_all: "1,2").result.to_sql # SELECT "users".* FROM "users" WHERE ("users"."id" IN (1) AND "users"."id" IN (2))
Summary
Vừa rồi chúng ta đã cùng nhau tìm hiểu về cách màn Ransack hoạt động cũng như việc custom các thành phần của nó. Hi vọng bài viết sẽ hữu ích và có thể giúp bạn phần nào trong việc giải quyết các vấn đề lên quan đến chức năng search hay query trong Rails.