Biến sinh mã
Một template không biết dự án của bạn. Các biến sinh mã là cầu nối: template khai báo các biến mà nó cần, và bạn điền giá trị của chúng trong Restorm. Khi sinh, mỗi giá trị được đánh giá rồi tiêm vào ngữ cảnh của template.
Khai báo và điền
Section titled “Khai báo và điền”Mỗi biến được khai báo bởi template (trong
restorm-template.json của nó) với một tên, một
phạm vi, một kiểu, một giá trị mặc định và một mô tả tùy chọn.
Về phía Restorm, bạn điền giá trị của nó dưới dạng biểu thức Handlebars —
được đánh giá cho từng thực thể liên quan, rồi chuyển đổi sang kiểu đã khai báo.
Các kiểu khả dĩ là string, boolean, number và enum (kèm
danh sách tùy chọn của nó).
Một hành động Khám phá các biến được template này dùng phân tích template và báo hiệu các biến được dùng nhưng không được khai báo, để tránh bỏ sót.
Các phạm vi
Section titled “Các phạm vi”Phạm vi quyết định biến được đánh giá ở cấp nào và nó nằm ở đâu trong ngữ cảnh của template:
| Phạm vi | Được đánh giá | Khả dụng trong template |
|---|---|---|
| Dự án | một lần | ctx.design.vars.<nom> |
| Mô hình | theo từng mô hình | ctx.models[].vars.<nom> |
| Thuộc tính | theo từng thuộc tính | ctx.models[].properties[].vars.<nom> |
| Tuyến | theo từng tuyến | ctx.groups[].routes[].vars.<nom> |
Giá trị chung và ghi đè
Section titled “Giá trị chung và ghi đè”Với mỗi template, bạn định nghĩa các giá trị chung theo phạm vi (các « biến chung », áp dụng chẳng hạn cho tất cả các mô hình). Sau đó bạn có thể ghi đè một biến cho một mô hình, một thuộc tính hoặc một tuyến nhất định, từ tab Code generation của thực thể đó. Một giá trị rỗng nghĩa là « kế thừa »: giá trị không rỗng đầu tiên thắng, và mọi giá trị không giải quyết được sẽ nổi lên thành một lỗi — không bao giờ trong im lặng.