RoutesOverview#The most basic featu

Routes
Overview
#
The most basic feature of any web application is the ability to interpret a request sent to a URL, then send back a response. In order to do this, your application has to be able to distinguish one URL from another.
Like most web frameworks, Sails provides a router: a mechanism for mapping URLs to controllers and views. Routes are rules that tell Sails what to do when faced with an incoming request. There are two main types of routes in Sails: custom (or "explicit") and automatic (or "implicit").
Custom Routes
#
Sails lets you design your app's URLs in any way you like- there are no framework restrictions.
Every Sails project comes with config/routes.js, a simple Node.js module that exports an object of custom, or "explicit" routes. For example, this routes.js file defines six routes; some of them point to a controller's action, while others route directly to a view.
// config/routes.js
module.exports.routes = {
'get /signup': { view: 'conversion/signup' },
'post /signup': 'AuthController.processSignup',
'get /login': { view: 'portal/login' },
'post /login': 'AuthController.processLogin',
'/logout': 'AuthController.logout',
'get /me': 'UserController.profile'
}
Each route consists of an address (on the left, e.g. 'get /me') and a target (on the right, e.g. 'UserController.profile') The address is a URL path and (optionally) a specific HTTP method. The target can be defined a number of different ways (see the expanded concepts section on the subject), but the two different syntaxes above are the most common. When Sails receives an incoming request, it checks the address of all custom routes for matches. If a matching route is found, the request is then passed to its target.
For example, we might read 'get /me': 'UserController.profile' as:
"Hey Sails, when you receive a GET request to http://mydomain.com/me, run the profile action of UserController, would'ya?"
What if I want to change the view layout within the route itself? No problem we could:
'get /privacy': {
view: 'users/privacy',
locals: {
layout: 'users'
}
},
Notes
#
Just because a request matches a route address doesn't necessarily mean it will be passed to that route's target directly. For instance, HTTP requests will usually pass through some middleware first. And if the route points to a controller action, the request will need to pass through any configured policies first. Finally, there are a few special route options which allow a route to be "skipped" for certain kinds of requests.
The router can also programmatically bind a route to any valid route target, including canonical Node middleware functions (i.e. function (req, res, next) {}). However, you should always use the conventional route target syntax when possible- it streamlines development, simplifies training, and makes your app more maintainable.
Automatic Routes
#
In addition to your custom routes, Sails binds many routes for you automatically. If a URL doesn't match a custom route, it may match one of the automatic routes and still generate a response. The main types of automatic routes in Sails are:
Blueprint routes, which provide your controllers and models with a full REST API.
Assets, such as images, Javascript and stylesheet files.
CSRF, if turned on, provides a /csrfToken route to your app that can be used to retrieve the CSRF token.
Supported Protocols
#
The Sails router is "protocol-agnostic"; it knows how to handle both HTTP requests and messages sent via WebSockets. It accomplishes this by listening for Socket.io messages sent to reserved event handlers in a simple format, called JWR (JSON-WebSocket Request/Response). This specification is implemented and available out of the box in the client-side socket SDK.
Notes
#
Advanced users may opt to circumvent the router entirely and send low-level, completely customizable WebSocket messages directly to the underlying Socket.io server. You can bind socket events directly in your app's onConnect function (located in config/sockets.js.) But bear in mind that, in most cases, you are better off leveraging the request interpreter for socket communication - maintaining consistent routes across HTTP and WebSockets helps keep your app maintainable.
Is something missing?
If you notice something we've missed or could be improved on, please follow this link and submit a pull request to the sails-docs repo. Once we merge it, the changes will be reflected on the website the next time it is deployed.

Kết quả (Việt) 1:

Tuyến đườngTổng quan#Các tính năng cơ bản nhất của bất kỳ ứng dụng web là khả năng để giải thích một yêu cầu được gửi đến một URL, sau đó gửi lại một phản ứng. Để làm điều này, ứng dụng của bạn đã có thể phân biệt một URL khác.Giống như hầu hết các khuôn khổ web, buồm cung cấp một bộ định tuyến: một cơ chế để ánh xạ URL cho các bộ điều khiển và tầm nhìn. Các tuyến đường là quy định cho buồm làm gì khi đối mặt với một yêu cầu đến. Có hai loại chính của các tuyến đường buồm: tùy chỉnh (hoặc "quá chi tiết") và tự động (hoặc "tiềm ẩn").Tùy chỉnh các tuyến đường#Buồm cho phép bạn thiết kế ứng dụng của bạn URL trong bất kỳ cách nào bạn có giống như là không có giới hạn khung.Mỗi dự án buồm đi kèm với config/routes.js, một mô-đun Node.js đơn giản xuất khẩu một đối tượng tùy chỉnh, hoặc tuyến đường "rõ ràng". Ví dụ, tệp routes.js này xác định 6 tuyến đường; một số người trong số họ chỉ hành động một bộ điều khiển, trong khi những người khác định tuyến trực tiếp đến một cái nhìn.Config/Routes.jsmodule.exports.Routes = {} 'nhận được /signup': {xem: 'chuyển đổi/đăng ký'}, 'đăng bài /signup': 'AuthController.processSignup', 'nhận được /login': {xem: 'Cổng thông tin nhập'}, 'đăng bài /login': 'AuthController.processLogin', ' / thoát ': 'AuthController.logout', ' có được / tôi ': 'UserController.profile'}Mỗi tuyến bao gồm địa chỉ (ở bên trái, ví dụ như ' có được / tôi ') và mục tiêu (bên phải, ví dụ như 'UserController.profile') địa chỉ là một đường dẫn URL (tùy chọn) một phương thức HTTP cụ thể. Mục tiêu có thể định nghĩa một số cách khác nhau (xem các khái niệm mở rộng phần trên các chủ đề), nhưng hai khác nhau cách ở trên là phổ biến nhất. Khi cánh buồm sẽ nhận được một yêu cầu đến, nó sẽ kiểm tra địa chỉ của tất cả các tuyến đường tùy chỉnh cho phù hợp. Nếu một con đường phù hợp được tìm thấy, các yêu cầu sau đó được thông qua để nhắm mục tiêu của mình.Ví dụ, chúng ta có thể đọc ' có được / tôi ': 'UserController.profile' là:"Hey Sails, khi bạn nhận được một GET yêu cầu để http://mydomain.com/me, chạy các hành động tiểu sử của UserController, would'ya?"Điều gì sẽ xảy ra nếu tôi muốn thay đổi bố trí xem trong các tuyến đường chính nó? Không có vấn đề chúng ta có thể:'nhận được /privacy': {} xem: 'người sử dụng/bảo mật', người dân địa phương: {} cách bố trí: 'người dùng' } },Ghi chú#Chỉ vì yêu cầu phù hợp với một địa chỉ đường không có nghĩa là nó sẽ được chuyển đến tuyến đường mà mục tiêu trực tiếp. Ví dụ, yêu cầu HTTP sẽ thường đi qua một số middleware lần đầu tiên. Và đường chỉ một hành động điều khiển, các yêu cầu cần phải vượt qua bất kỳ chính sách được cấu hình đầu tiên. Cuối cùng, có một vài lựa chọn con đường đặc biệt này cho phép một tuyến đường được "bỏ qua" cho một số loại yêu cầu.Router cũng lập trình có thể liên kết một lộ trình cho bất kỳ mục tiêu hợp lệ đường, bao gồm cả kinh điển nút middleware chức năng (tức là chức năng (req, res, tiếp theo) {}). Tuy nhiên, bạn nên luôn luôn sử dụng cú pháp mục tiêu các tuyến đường thông thường khi có thể, nó streamlines phát triển, đơn giản hoá việc đào tạo và làm cho ứng dụng của bạn duy trì thêm.Tuyến đường tự động#Ngoài các tuyến đường tùy chỉnh, buồm gắn bó với nhiều tuyến đường cho bạn tự động. Nếu URL không khớp với một tuyến đường tùy chỉnh, nó có thể phù hợp với một trong các tuyến đường tự động và vẫn tạo ra một phản ứng. Các loại chính của các tuyến đường tự động trong cánh buồm là:Kế hoạch chi tiết tuyến, cung cấp cho các bộ điều khiển của bạn và các mô hình với một API REST đầy đủ.Tài sản, chẳng hạn như hình ảnh, tập tin Javascript và stylesheet.CSRF, nếu bật, cung cấp một tuyến đường /csrfToken để các ứng dụng của bạn có thể được sử dụng để lấy CSRF token.Hỗ trợ giao thức#Router buồm là "giao thức-thuyết bất khả tri"; nó biết làm thế nào để xử lý các yêu cầu HTTP và tin nhắn được gửi thông qua WebSockets. Nó hoàn thành điều này bằng cách lắng nghe cho các tin nhắn Socket.io gửi đến xử lý sự kiện dành riêng trong một định dạng đơn giản, được gọi là JWR (JSON-WebSocket Request/phản ứng). Đặc điểm kỹ thuật này là thực hiện và sẵn sàng ra khỏi hộp ở phía khách hàng cắm SDK.Ghi chú#Người dùng có thể chọn để phá vỡ các bộ định tuyến hoàn toàn và gửi ở độ cao thấp, hoàn toàn tùy biến WebSocket thư trực tiếp đến máy chủ Socket.io tiềm ẩn. Bạn có thể ràng buộc sự kiện ổ cắm trực tiếp vào ứng dụng của bạn chức năng onConnect (nằm ở config/sockets.js.) Nhưng hãy nhớ rằng, trong hầu hết trường hợp, bạn nên tận dụng các yêu cầu thông dịch viên cho giao tiếp ổ cắm - duy trì nhất quán các tuyến đường qua HTTP và WebSockets sẽ giúp giữ cho ứng dụng của bạn duy trì.Là một cái gì đó thiếu?Nếu bạn nhận thấy một cái gì đó chúng tôi đã bỏ lỡ hoặc có thể được cải thiện trên, xin vui lòng thực hiện theo liên kết này và gửi một yêu cầu kéo buồm-Documents repo. Một khi chúng tôi kết hợp đó, những thay đổi sẽ được phản ánh trên các trang web sau khi nó được triển khai.

Kết quả (Việt) 2:

Tuyến đường
Tổng quan
#
Các tính năng cơ bản nhất của bất kỳ ứng dụng web là khả năng để giải thích một yêu cầu được gửi đến một URL, sau đó gửi lại một phản ứng. Để làm điều này, ứng dụng của bạn có để có thể phân biệt một URL từ một.
Giống như hầu hết các khuôn khổ web, Sails cung cấp một router: một cơ chế để ánh xạ các URL để điều khiển và quan điểm. Đường bay quy tắc mà nói Sails phải làm gì khi phải đối mặt với một yêu cầu đến. Có hai loại chính của tuyến đường trong Sails: tùy chỉnh (hoặc "rõ ràng") và tự động (hay "ẩn").
Tuỳ chỉnh đường
#
Sails cho phép bạn thiết kế các URL của ứng dụng của bạn trong bất kỳ cách nào bạn như- không có giới hạn khuôn khổ.
Mỗi dự án Sails đi kèm với cấu hình / routes.js, một module đơn giản Node.js rằng xuất khẩu của một đối tượng tùy chỉnh, hoặc " ) Các địa chỉ là một đường dẫn URL và (tùy chọn) một phương thức HTTP cụ thể. Các mục tiêu có thể được định nghĩa theo nhiều cách khác nhau (xem phần khái niệm mở rộng về chủ đề này), nhưng hai cú pháp khác nhau ở trên là phổ biến nhất. Khi Sails nhận được một yêu cầu gửi đến, nó sẽ kiểm tra địa chỉ của tất cả các tuyến đường tùy chỉnh cho phù hợp. Nếu một tuyến kết hợp được tìm thấy, các yêu cầu sau đó được đưa đến mục tiêu của mình. Ví dụ, chúng ta có thể đọc 'được / tôi': 'UserController.profile' như: "Này Sails, khi bạn nhận được một yêu cầu GET để http://mydomain.com/me~~V, chạy các hành động hồ sơ của UserController, would'ya ? " Nếu tôi muốn thay đổi cách bố trí xem trong con đường riêng của mình? Không có vấn đề chúng ta có thể: 'get / riêng tư': { điểm: người sử dụng / quyền riêng tư ', người dân địa phương: { Bố trí: 'người sử dụng' } }, Ghi chú # Chỉ vì một yêu cầu phù hợp với một địa chỉ đường không nhất thiết có nghĩa là nó sẽ được thông qua với mục tiêu của tuyến đường trực tiếp. Ví dụ, các yêu cầu HTTP thường sẽ đi qua một số trung gian đầu tiên. Và nếu các điểm trên đường đến một hành động điều khiển, yêu cầu sẽ cần phải đi qua các chính sách cấu hình đầu tiên. Cuối cùng, có một vài lựa chọn tuyến đường đặc biệt cho phép một con đường để được "bỏ qua" cho một số loại yêu cầu. Các bộ định tuyến cũng có thể gắn nối một đường bất kỳ mục tiêu đường hợp lệ, bao gồm các chức năng Node kinh điển trung gian (tức là chức năng (req, res, tiếp theo) {}). Tuy nhiên, bạn nên luôn luôn sử dụng các cú pháp đích lộ trình thông thường khi possible- nó sắp xếp hợp lý phát triển, đơn giản hoá việc đào tạo, và làm cho ứng dụng của bạn duy trì nhiều hơn. Tự động tuyến # Ngoài tuyến đường tùy chỉnh của bạn, Sails gắn nhiều tuyến đường cho bạn tự động. Nếu một URL không phù hợp với lộ trình tùy chỉnh, nó có thể phù hợp với một trong những tuyến đường tự động và vẫn tạo ra một phản ứng. Các loại chính của các tuyến đường tự động trong Sails là: tuyến đường Blueprint, trong đó cung cấp các bộ điều khiển và mô hình của bạn với một API REST đầy đủ. Tài sản, chẳng hạn như hình ảnh, Javascript và các tập tin định kiểu. CSRF, nếu bật, cung cấp một tuyến đường / csrfToken để ứng dụng của bạn mà có thể được sử dụng để lấy token CSRF. Hỗ trợ các giao thức # Các Sails router là "giao thức-agnostic"; nó biết làm thế nào để xử lý cả hai yêu cầu HTTP và các tin nhắn được gửi qua WebSockets. Nó hoàn thành điều này bằng cách lắng nghe Socket. thông điệp io gửi đến xử lý sự kiện dành riêng trong một định dạng đơn giản, gọi là JWR (JSON-WebSocket Request / Response). đặc điểm kỹ thuật này được thực hiện và có sẵn ra khỏi hộp trong các khách hàng phía ổ cắm SDK. Ghi chú # Nâng cao người dùng có thể lựa chọn để phá vỡ các bộ định tuyến hoàn toàn và gửi ở mức độ thấp, hoàn toàn tin WebSocket tùy biến trực tiếp đến máy chủ Socket.io cơ bản. Bạn có thể liên kết các sự kiện ổ cắm trực tiếp vào onConnect chức năng của ứng dụng của bạn (nằm trong config / sockets.js.) Nhưng nhớ rằng, trong hầu hết trường hợp, bạn là tốt hơn tận dụng các thông dịch viên yêu cầu giao tiếp ổ cắm - bảo trì các tuyến đường nhất quán trên HTTP và WebSockets giúp giữ duy trì ứng dụng của bạn. Là một cái gì đó mất tích? Nếu bạn nhận thấy một cái gì đó chúng tôi đã bỏ lỡ hoặc có thể được cải thiện trên, xin vui lòng đi theo liên kết này và gửi một yêu cầu để kéo buồm-docs repo. Một khi chúng ta kết hợp nó, những thay đổi này sẽ được phản ánh trên các trang web trong thời gian tới nó được triển khai.

Kết quả (Việt) 3:

Tuyến đườngOverview#Bất cứ ứng dụng web đặc điểm cơ bản nhất là có thể giải thích được gửi tới địa chỉ URL đáp ứng yêu cầu, rồi trở về.Để làm được điều đó, các ứng dụng phải có khả năng phân biệt một URL từ một người khác.Giống như hầu hết các web khung như cánh buồm cung cấp một router: một URL và cơ chế điều khiển ánh xạ tới xem.Định tuyến là nói với cánh buồm đang gặp phải làm gì khi đến đây yêu cầu luật;.Có hai loại chính: tùy chỉnh kiểu tàu tuyến (hay "rõ ràng") và tự động (hay "implicit").Con đường riêng#Buồm để bạn thiết kế ứng dụng của bạn ở bất cứ địa chỉ URL, anh thích cách đó. - Không có khung giới hạn.Mỗi dự án đều cấu hình đơn giản routes.js buồm, một mô - đun JS xuất đối tượng riêng, hay "ra đường".Ví dụ, nó routes.js file định nghĩa. Sáu đường; một số ít vào bộ điều khiển động, và những tuyến đường trực tiếp đến xem./ / config / routes.jsModule.exports.routes = {Có /: [quan: "đăng ký chuyển đổi / đăng ký"],"Sau khi / / Đăng ký": "authcontroller processsignup","Lấy / Đăng ký": [xem: "Portal / Đăng nhập"],"Sau khi đăng nhập /": "authcontroller processlogin","/ rút lui": "authcontroller gốm","/": "usercontroller profile".]Mọi tuyến đường địa chỉ (ở bên trái, như "/ I") và mục tiêu (bên hữu, như "usercontroller. Tập tin cấu hình") là một địa chỉ URL đường và (tùy chọn) một cách đặc biệt là HTTP.Mục tiêu có thể định nghĩa nhiều cách khác nhau (xem khái niệm phần mở rộng đối tượng), nhưng chúng khác nhau về ngữ pháp là phổ biến nhất.Khi nhận được yêu cầu khi buồm hướng tâm, nó kiểm tra tất cả các địa chỉ của tuyến tự chọn để tiến hành trùng khớp.Nếu tìm được khớp với lộ trình, thì sẽ phải yêu cầu chuyển cho mục tiêu của nó.Ví dụ, chúng ta có thể đọc / tôi':'usercontroller profile ":"Hey, buồm, khi ông nhận được một yêu cầu GET http://mydomain.com/me, chạy đường viền usercontroller, would'ya động?"Nếu tôi muốn thay đổi tuyến đường chính trong đó bố trí xem sao?Không có vấn đề gì, chúng ta có thể:"Lấy / riêng tư": [Xem: "người dùng / riêng tư".Người dân địa phương: [Bố trí: "người dùng".]],Ghi chép.#Chỉ vì yêu cầu tương ứng với địa chỉ tuyến không có nghĩa là nó sẽ được truyền trực tiếp tới nên mục tiêu của tuyến;.Ví dụ, yêu cầu HTTP thông thường sẽ thông qua một số middleware đầu tiên.Nếu tuyến đường vào bộ điều khiển động là yêu cầu đầu tiên vượt qua bất kỳ chiến lược sẽ được cấu hình.Cuối cùng, có một số tuyến đường đặc biệt tùy chọn cho phép định tuyến "bỏ qua" một số loại yêu cầu.Router cũng có thể được lập trình hướng đến bất kỳ hiệu quả sẽ hướng mục tiêu, bao gồm cả node middleware điển hình (tức là chức năng của chức năng (REQ, RES, dưới) []).Tuy nhiên, anh phải luôn sử dụng tuyến đường truyền thống của Pháp khi mục tiêu có thể đơn giản hóa phát triển, đơn giản hóa. Chương trình huấn luyện, làm cho anh dễ bảo trì.Tuyến tự động.#Ngoại trừ các tuyến bay kết nối nhiều tùy chỉnh, buồm cho bạn tự động.Nếu địa chỉ URL không hợp với tuyến đường riêng và tự động, nó có thể là một trong số tuyến phù hợp, và vẫn sẽ tạo ra phản ứng.Thuyền buồm hướng bay tự động kiểu chính là:Bản thiết kế cho các tuyến đường, điều khiển và cung cấp một mô hình hoàn toàn REST API.Tài sản, như hình ảnh, JavaScript và các kiểu tập tin bảng.CSRF, nếu mở, cung cấp một / csrftoken trên đường tới các ứng dụng có thể được dùng để tìm CSRF tấm thẻ.Thỏa thuận hỗ trợ#Buồm router là thỏa thuận không liên quan gì đến mạng lưới "; nó biết cách xử lý yêu cầu HTTP và gửi tin nhắn qua WebSockets.Đây là chương trình xử lý sự kiện bằng cách lắng nghe để giữ lại một định dạng đơn giản socket.io tin gọi nên (JSON WebSocket đáp ứng yêu cầu /).Ben, Norm thực hiện và ổ cắm ở khách SDK cung cấp ra khỏi hộp.Ghi chép.#Người dùng có thể lựa chọn cao cấp đi vòng qua router hoàn toàn đặt thấp, hoàn toàn có thể được chọn WebSocket trực tiếp liên quan đến thông tin socket.io server.Anh có thể kết nối ổ cắm trực tiếp vào các sự kiện của ứng dụng (nằm ở khả năng liên kết cấu hình / ổ cắm. JS.), nhưng hãy nhớ rằng, trong hầu hết trường hợp, anh tốt nhất là sử dụng ổ cắm thông tin dịch giữ phù hợp với yêu cầu của tuyến đường qua HTTP và WebSockets giúp ông ứng dụng của chương trình để bảo vệ tình dục.Có mất gì nữa chứ?Nếu anh để ý đến chúng ta đã bỏ lỡ vẫn có thể cải thiện, xin hãy liên kết và đưa ra yêu cầu báo cáo Docs Pull buồm.Một khi chúng ta kết hợp nó, sự thay đổi sẽ được phản ánh trong lần tiếp theo được triển khai trên trang web.