Sử dụng CoffeeScript trên máy chủ docx

Sử dụng CoffeeScript trên máy chủ Gọi tất cả các dịch vụ web Ứng dụng web trong Phần 3 đã dùng một từ khóa để thực hiện một tìm kiếm trên cả Google lẫn Twitter.. Để thực sự thực hiện các

Sử dụng CoffeeScript trên máy chủ

Gọi tất cả các dịch vụ web

Ứng dụng web trong Phần 3 đã dùng một từ khóa để thực hiện một tìm kiếm trên cả Google lẫn Twitter Về phía máy khách của của ứng dụng, bạn chỉ cần tạo mô hình giả định các kết quả từ máy chủ Để thực sự thực hiện các hàm như vậy, bạn cần phía máy chủ của ứng dụng để gọi các dịch vụ web được Google và Twitter cung cấp Cả hai công ty đều cung cấp các dịch vụ tìm kiếm rất đơn giản Tất cả những gì bạn cần làm là tạo ra các yêu cầu HTTP GET với các dịch vụ tìm kiếm Liệt kê 1 cho thấy một hàm tổng quát để tạo ra các yêu cầu HTTP GET

Liệt kê 1 Tìm nạp tài nguyên web

http = require "http"

fetchPage = (host, port, path, callback) ->

options =

host: host

port: port

path: path

req = http.get options, (res) ->

contents = ""

res.on 'data', (chunk) ->

contents += "#{chunk}"

res.on 'end', () ->

callback(contents)

req.on "error", (e) ->

console.log "Erorr: {e.message}"

Ở phần đầu của kịch bản lệnh này là câu lệnh require (yêu cầu), mà bạn đã thấy tóm tắt trong

Phần 1 của loạt bài này Đây là cú pháp nhập khẩu mô đun của Node.js hoặc ít nhất là phiên bản CoffeeScript của nó Phiên bản "nguyên gốc" sẽ là var http = require("http"); Trong bài này, bạn sẽ sử dụng một số mô đun lõi của Node.js (Thông tin chi tiết về việc cách hoạt động của các mô đun nằm ngoài phạm vi của bài viết này) Tất cả các mô đun được sử dụng trong bài này đều có sẵn cho bạn nếu bạn đã cài đặt Node.js (xem Phần 1) Với ví dụ trong Liệt kê 1, bạn đang sử dụng mô đun http, có cung cấp một vài lớp và các hàm có ích cho cả việc tạo ra lẫn tiếp nhận các yêu cầu HTTP

Sau đó Liệt kê 1 định nghĩa một hàm fetchPage nhận bốn tham số:

 Tên host (máy chủ) của tài nguyên

 port (cổng) của tài nguyên

 path (đường dẫn) của tài nguyên

 Một hàm callback (gọi lại)

Bất kỳ kiểu hàm Vào/Ra (I/O) nào trong Node.js về bản chất sẽ là không đồng bộ và do

đó sẽ cần một hàm callback để gọi khi nó hoàn thành Hàm fetchPage nhận một hàm

callback làm tham số thứ tư của mình Hàm fetchPage sẽ sử dụng ba tham số đầu tiên

để tạo ra một yêu cầu HTTP GET bằng cách sử dụng hàm get của mô đun http

Hàm fetchPage cũng nhận một hàm callback đã chuyển đi một cá thể ClientResponse

ClientResponse, là một đối tượng được định nghĩa trong mô đun http, thực hiện giao diện

ReadableStream (một giao diện cốt lõi trong Node.js) Nó là một giao diện không đồng bộ nhận hai sự kiện: data (dữ liệu) và end (kết thúc) Hàm duy nhất của nó được sử dụng để đăng ký gọi lại đến các sự kiện này Sự kiện dữ liệu xảy ra khi tiếp nhận dữ liệu từ tài nguyên mà bạn đã tạo

ra yêu cầu HTTP GET để lấy

Tất cả dữ liệu có thể được trả về cùng một lúc từ tài nguyên, nhưng phổ biến hơn, dữ liệu sẽ được gửi theo các bó (chunk) Khi nhận được mỗi bó, sự kiện dữ liệu được khởi động và hàm gọi lại được gọi ra Bạn đã tạo ra một biến có tên là contents (các nội dung); mỗi khi bạn nhận được một bó khác, bạn chỉ cần gắn thêm nó vào contents Khi đã nhận được tất cả dữ liệu, sự kiện end được khởi động Bây giờ bạn có tất cả dữ liệu, vì vậy bạn có thể chuyển contents trở lại cho hàm callback đã được chuyển tới hàm fetchPage Khi đã định nghĩa hàm đa năng này, chúng ta hãy tạo ra một số hàm chuyên dụng hơn cho các API tìm kiếm của Google và Twitter, như trong Liệt kê 2

Liệt kê 2 Các hàm tìm kiếm Google và Twitter

googleSearch = (keyword, callback) ->

host = "ajax.googleapis.com"

path = "/ajax/services/search/web?v=1.0&q=#{encodeURI(keyword)}"

fetchPage host, 80, path, callback

twitterSearch = (keyword, callback) ->

host = "search.twitter.com"

path = "/search.json?q=#{encodeURI(keyword)}"

fetchPage host, 80, path, callback

Có hai hàm được định nghĩa trong Liệt kê 2:

 googleSearch, nhận một keyword (từ khóa) và một hàm callback Nó ấn định máy chủ, tạo động đường dẫn bằng cách sử dụng phép nội suy chuỗi của CoffeeScript và sau

đó sử dụng hàm fetchPage

 twitterSearch, rất giống với googleSearch nhưng có máy chủ và giá trị đường dẫn khác

Đối với cả hai giá trị đường dẫn, bạn sử dụng phép nội suy chuỗi và hàm encodeURI tiện dụng của JavaScript để xử lý bất kỳ khoảng trống hoặc các ký tự đặc biệt khác nào Vì bạn có các hàm tìm kiếm này, nên bạn có thể tạo ra một hàm chuyên dụng cho một kịch bản tìm kiếm kết hợp

Về đầu trang

Kết hợp các hàm không đồng bộ

Có một vài cách để bạn có thể thực hiện tìm kiếm kết hợp trên Google và Twitter Bạn có thể gọi

googleSearch và sau đó, trong hàm callback, gọi twitterSearch, hoặc ngược lại Tuy nhiên, kiến trúc không đồng bộ/gọi lại của Node.js cho phép bạn làm những việc này một cáchđẹp đẽ hơn và hiệu quả hơn Liệt kê 3 hiển thị tìm kiếm kết hợp

Liệt kê 3 Tìm kiếm cả Google lẫn Twitter

combinedSearch = (keyword, callback) ->

data =

google : ""

twitter : ""

googleSearch keyword, (contents) ->

contents = JSON.parse contents

data.google = contents.responseData.results

if data.twitter != ""

callback(data)

twitterSearch keyword, (contents) ->

contents = JSON.parse contents

data.twitter = contents.results

if data.google != ""

callback(data)

Hàm combinedSearch có một chữ ký mà bây giờ đã quen thuộc: nhận một từ khóa và một hàm gọi lại Sau đó, nó tạo ra một cấu trúc dữ liệu cho các kết quả tìm kiếm kết hợp được gọi là data Đối tượng data có một trường google và một trường twitter, cả hai đều được khởi tạo như các chuỗi rỗng Bước tiếp theo gọi hàm googleSearch Trong hàm gọi lại của nó, bạn phân tích cú pháp các kết quả từ Google bằng cách sử dụng hàm JSON.parse tiêu chuẩn Văn bản JSON được trả về từ Google được phân tích cú pháp thành một đối tượng JavaScript Sử dụng đối tượng này để thiết lập giá trị của trường data.google Sau khi gọi googleSearch, hãy gọi

twitterSearch Hàm callback của nó rất giống với hàm callback dùng cho googleSearch Điều quan trọng cần hiểu rằng trong cả hai hàm gọi lại mà bạn kiểm tra để xem liệu bạn có dữ liệu từ hàm gọi lại khác không Bạn không biết hàm gọi lại nào sẽ hoàn thành trước tiên Vì vậy, hãy kiểm tra để xem liệu bạn có dữ liệu từ cả Google lẫn Twitter không Một khi bạn làm điều

đó, bạn gọi hàm callback đã được chuyển tới hàm combinedSearch Bây giờ bạn có một hàm

sẽ tìm kiếm cả Google lẫn Twitter và đưa ra các kết quả kết hợp Nhiệm vụ tiếp theo là trưng ra hàm này cho trang web mà bạn đã tạo ra trong Phần 3 của loạt bài này Tất cả những gì bạn phải làm là viết một máy chủ web

Về đầu trang

Một máy chủ web CoffeeScript

Lúc này, bạn có:

 Một trang web có thể gửi các từ khoá và hiển thị các kết quả tìm kiếm

 Một hàm có thể dùng một từ khóa và tạo ra các kết quả tìm kiếm từ Google và Twitter

Cái gì gắn kết những thứ này lại với nhau? Bạn có thể gọi nó là một máy chủ web, máy chủ ứng dụng, hoặc thậm chí phần mềm trung gian Bất kể bạn muốn gọi nó là gì, không cần dùng nhiều

mã CoffeeScript để viết nó

Máy chủ web cần đáp ứng hai mục đích Rõ ràng, nó cần nhận các yêu cầu cho việc tìm kiếm kết hợp Nó cũng cần cung cấp tài nguyên tĩnh mà bạn đã tạo ra trong Phần 3 Bạn đang tạo ra một ứng dụng web, do đó, bạn phải chú ý đến các quy định Các cuộc gọi tìm kiếm phải đi tới cùng một nơi đã tạo ra trang web Trước tiên hãy xử lý tài nguyên tĩnh Liệt kê 4 cho thấy một hàm để cung cấp tài nguyên tĩnh

Liệt kê 4 Cung cấp tài nguyên tĩnh

path = require "path"

fs = require "fs"

serveStatic = (uri, response) ->

fileName = path.join process.cwd(), uri

path.exists fileName, (exists) ->

if not exists

response.writeHead 404, 'Content-Type': 'text/plain'

response.end "404 Not Found #{uri}!\n"

return

fs.readFile fileName, "binary", (err,file) ->

if err

response.writeHead 500,

'Content-Type': 'text/plain'

response.end "Error #{uri}: #{err} \n"

return

response.writeHead 200

response.write file, "binary"

response.end()

Hàm serveStatic xử lý các yêu cầu về nguồn tài nguyên tĩnh trong ứng dụng web Lưu ý rằng bạn cần sử dụng thêm hai mô đun Node.js nữa:

 path chỉ đơn giản là một thư viện tiện ích để xử lý các đường dẫn tệp

 Hệ thống tệp, hoặc fs, cung cấp tất cả Vào/Ra của tệp trong Node.js và về cơ bản là một trình bao gói dựa trên các hàm POSIX tiêu chuẩn

Hàm serveStatic nhận hai tham số:

 uri về bản chất là một đường dẫn tương đối đến tệp tĩnh đang được một trình duyệt web yêu cầu

 Một đối tượng ServerResponse, là một kiểu khác được định nghĩa trong mô đun http Ngoài nhiều thứ khác, nó mang lại cho bạn một luồng để ghi dữ liệu vào bất cứ thứ gì đã tạo ra yêu cầu HTTP GET về tài nguyên

Trong hàm serveStatic, chuyển đường dẫn tương đối đến tệp thành một đường dẫn tuyệt đối bằng cách sử dụng process.cwd Đối tượng process (tiến trình) là một đối tượng chung

(global), đại diện cho tiến trình hệ thống mà Node.js đang chạy trên đó Phương thức cwd của nó cung cấp thư mục làm việc hiện tại Sử dụng mô đun path để kết hợp thư mục làm việc hiện tại

và đường dẫn tương đối đến tệp mà bạn muốn; kết quả là đường dẫn tuyệt đối Với đường dẫn tuyệt đối, bạn có thể sử dụng lại mô đun path để kiểm tra xem tệp có tồn tại hay không Việc kiểm tra xem tệp có tồn tại không liên quan đến I/O (Vào/Ra), cho nên nó là một hàm không đồng bộ Chuyển cho nó fileName (tên tệp) và một hàm gọi lại Hàm gọi lại nhận một giá trị Boolean, cho bạn biết liệu tệp tồn tại hay không Nếu nó không tồn tại, thì bạn cần viết một thông báo HTTP 404 " không tìm thấy tệp"

Nếu tệp tồn tại, thì bạn cần đọc nội dung của nó bằng cách sử dụng mô đun fs và phương thức

readFile, phương thức readFile là không đồng bộ Nó nhận fileName, một kiểu và một hàm gọi lại Hàm gọi lại nhận hai thông số:

 Một tham số lỗi cho biết bất kỳ vấn đề gì khi đọc tài nguyên từ hệ thống tệp Nếu có vấn

đề, một thông báo lỗi HTTP 500 được trả ngược lại tới phía máy khách

 Nếu không có vấn đề gì, một thông báo HTTP 200 OK được viết và các nội dung của tệp được gửi lại tới phía máy khách

Hàm này xử lý trường hợp cung cấp các tệp tĩnh tương đối dễ dàng Phần tiếp theo sẽ thảo luận

về kịch bản khó hơn, ở đó bạn cần đáp ứng động với một yêu cầu tìm kiếm

Về đầu trang

Các đáp ứng động và máy chủ

Ví dụ máy chủ web chủ yếu xử lý các yêu cầu tài nguyên tĩnh và các yêu cầu tìm kiếm động Chiến lược là sử dụng một URL cụ thể để xử lý các yêu cầu tìm kiếm và sau đó chuyển các yêu cầu khác tới hàm serveStatic Hãy sử dụng URL tương đối là /doSearch cho các yêu cầu tìm kiếm Liệt kê 5 cho thấy mã của máy chủ web

Liệt kê 5 Máy chủ web CoffeeScript

url = require "url"

server = http.createServer (request, response) ->

uri = url.parse(request.url)

if uri.pathname is "/doSearch"

doSearch uri, response

else

serveStatic uri.pathname, response

server.listen 8080

console.log "Server running at http://127.0.0.1:8080"

Một lần nữa, kịch bản lệnh này bắt đầu bằng cách nạp một mô đun Node.js Mô đun url là một thư viện có ích để phân tích cú pháp các URL Bước tiếp theo là tạo ra máy chủ web bằng cách

sử dụng mô đun http mà bạn nạp trong Liệt kê 1 Sử dụng phương thức createServer của mô đun đó, phương thức này nhận một hàm gọi lại sẽ được gọi mỗi khi có yêu cầu được gửi đến máy chủ web Hàm gọi lại có hai tham số: một cá thể ServerRequest và một cá thể

ServerResponse Cả hai kiều đều được định nghĩa trong mô đun http Trong hàm gọi lại này, việc phân tích cú pháp URL của yêu cầu đã được gửi đến máy chủ bằng cách sử dụng phương thức parse (phân tích cú pháp) của mô đun url Việc này sẽ cung cấp cho bạn một đối tượng URL và bạn có thể sử dụng thuộc tính pathname (tên đường dẫn) của nó để nhận được đường dẫn tương đối Nếu pathname là /doSearch, bạn gọi hàm doSearch (được thảo luận dưới đây) Nếu không, hãy gọi hàm serveStatic từ Liệt kê 5 Liệt kê 6 cho thấy cách doSearch hoạt động

Liệt kê 6 Xử lý các yêu cầu tìm kiếm

doSearch = (uri, response) ->

query = uri.query.split "&"

params = {}

query.forEach (nv) ->

nvp = nv.split "="

params[nvp[0]] = nvp[1]

keyword = params["q"]

combinedSearch keyword, (results) ->

response.writeHead 200, 'Content-Type': 'text/plain'

response.end JSON.stringify results

Hàm doSearch phân tích cú pháp chuỗi truy vấn đối với URL, mà có thể tìm thấy nó trong thuộc tính query (truy vấn) của đối tượng uri Chia nhỏ chuỗi truy vấn này ra bằng cách tách chuỗi này tại vị trí các ký tự & Sau đó chia tách từng chuỗi con tại vị trí dấu bằng để nhận được các cặp giá trị- tên từ chuỗi truy vấn Hãy lưu trữ từng cặp tên-giá trị vào đối tượng params Lấy ra tham số "q" để có được từ khóa mà bạn muốn tìm kiếm Chuyển từ khóa này tới hàm

combinedSearch trong Liệt kê 3 Bạn phải chuyển cho hàm này một hàm gọi lại Hàm gọi lại ví

dụ chỉ cần viết một thông báo HTTP 200 OK và chuyển các kết quả tìm kiếm thành một chuỗi bằng cách sử dụng hàm tiêu chuẩn JSON.stringify

Đó là tất cả những gì bạn cần cho máy chủ Trong phần tiếp theo, hãy xem cách móc nối máy chủ này vào mã máy khách trong Phần 3 của loạt bài này

Về đầu trang

Gọi máy chủ tìm kiếm

Trong Phần 3 bạn đã có một lớp MockSearch đã sử dụng dữ liệu giả đinh để cung cấp các kết quả tìm kiếm Bây giờ bạn sẽ định nghĩa một lớp mới để thực hiện một tìm kiếm thực gọi máy chủ tìm kiếm Liệt kê 7 cho thấy lớp tìm kiếm mới

Liệt kê 7 Lớp tìm kiếm thực

class CombinedSearch

search: (keyword, callback) ->

xhr = new XMLHttpRequest

xhr.open "GET", "/doSearch?q=#{encodeURI(keyword)}", true

xhr.onreadystatechange = ->

if xhr.readyState is 4

if xhr.status is 200

response = JSON.parse xhr.responseText

results =

google: response.google.map (result) ->

new GoogleSearchResult result

twitter: response.twitter.map (result) ->

new TwitterSearchResult result

callback results

xhr.send null

Lớp CombinedSearch có một phương thức duy nhất là search có chữ ký giống như phương thức search của MockSearch Nó nhận một từ khóa và một hàm gọi lại Bên trong hàm này:

 Sử dụng XMLHttpRequest, một "người bạn cũ" quen thuộc của bất kỳ nhà phát triển web nào, để tạo một yêu cầu HTTP đến máy chủ bằng cách sử dụng đường dẫn /doSearch và

từ khóa đã được chuyển đến hàm này

 Khi bạn nhận được một phản hồi, hãy phân tích cú pháp của nó bằng cách sử dụng

JSON.parse

 Tạo một đối tượng các kết quả với các trường google và twitter Tạo ra chúng bằng cách sử dụng các lớp GoogleSearchResult và TwitterSearchResult trong Phần 3

 Chỉ cần chuyển các kết quả trở lại hàm callback

Bây giờ, bạn chỉ cần sử dụng lớp doSearch này trong phương thức MockSearch Liệt kê 8 cho thấy cách sử dụng lớp CombinedSearch

Liệt kê 8 Sử dụng lớp CombinedSearch

@doSearch = ->

$ = (id) -> document.getElementById(id)

kw = $("searchQuery").value

appender = (id, data) ->

data.forEach (x) ->

$(id).innerHTML += "<p>#{x.toHtml()}</p>"

ms = new CombinedSearch

ms.search kw, (results) ->

appender("gr", results.google)

appender("tr", results.twitter)

Nếu bạn so sánh Liệt kê 8 với doSearch trong Phần 3, bạn sẽ không thấy nhiều sự khác biệt Điều duy nhất có khác là ở dòng thứ bảy Thay vì tạo một cá thể là MockSearch thì bạn tạo một

cá thể là CombinedSearch Những thứ khác đều như nhau Bạn nhận được từ khóa từ trang web, gọi tìm kiếm và sau đó gắn thêm các kết quả bằng cách gọi phương thức toHtml của từng đối tượng SearchResult Hình 1 cho thấy ứng dụng web với các kết quả tìm kiếm "sống" đến từ máy chủ

Hình 1 Chạy ứng dụng web ví dụ

Để nhận được các thay đổi bạn đã làm đối với mã phía máy khách, bạn cần biên dịch lại nó bằng

coffee -c search.coffee Để chạy ứng dụng, hãy sử dụng coffee search-server.coffee Sau đó, bạn có thể mở một trình duyệt tới địa chỉ http://127.0.0.1:8080 và thử một số truy vấn khác nhau

Về đầu trang

Kết luận

Trong bài này, bạn đã hoàn thành ứng dụng web bằng cách xây dựng thành phần phía máy chủ

để bổ sung cho mã phía máy khách trong Phần 3 Giờ đây, sau khi hoàn thành phần cuối của loạt

bài này, bạn đã có một ứng dụng hoàn chỉnh—tất cả được viết bằng CoffeeScript Bạn đã sử dụng rất nhiều tính năng của Node.js đã cho phép bạn sử dụng CoffeeScript như một công nghệ phía máy chủ

Một hạn chế đáng trách của Node.js là nó không chặn các hàm callback khi gọi từ tầng này sang tầng khác Điều này có thể khiến cho việc tư duy sắp xếp/phân loại khó khăn và với cú pháp dài dòng của JavaScript thậm chí còn khiến mọi việc phức tạp hơn CoffeeScript không thay đổi nhu cầu sử dụng của tất cả các hàm callback, nhưng với cú pháp rõ ràng của nó đã giúp dễ viết và dễ hiểu những đoạn mã như thế này hơn một chút