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'
}
},

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.

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' } },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.

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' } }, 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à kiểu file. 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 các thông điệp Socket.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. 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 các thông điệp Socket.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. 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 các thông điệp Socket.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.

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".]],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.