翻译 | 《JavaScript Everywhere》第2章项目简介（^_^）

写在最前面

大家好呀，我是毛小悠，是一位前端开发工程师。正在翻译一本英文技术书籍。

为了提高大家的阅读体验，对语句的结构和内容略有调整。如果发现本文中有存在瑕疵的地方，或者您有任何意见或者建议，可以在评论区留言，或者加我的微信：code_maomao，欢迎相互沟通交流学习。

(σﾟ∀ﾟ)σ..:*☆哎哟不错哦

第2章项目简介

想象一下，你站在当地的一家小餐馆的店铺前，决定在那里点一个三明治。服务员把你点的菜都写在一张纸上，然后把纸递给厨师。厨师阅读订单，使用单独的配料来制作三明治，并将三明治交给服务员。服务员会把三明治拿给你吃。如果你想要一些甜点，这个过程会再次重复。

应用程序编程接口（API）是一组规范，它允许一个计算机程序与另一个计算机程序进行交互。

Web API的工作方式与订购三明治的方式几乎相同。客户端请求一些数据，该数据通过超文本传输协议（HTTP）传输到Web服务器应用程序，Web服务器应用程序接受请求并处理数据，然后将数据通过HTTP发送给客户端。在本章中，我们将探讨Web API的广泛内容，并通过将starter API项目克隆到本地计算机上来开始我们的开发。但是，在进行此操作之前，让我们先探讨将要构建的应用程序的需求。

在本书中，我们将构建一个名为Notedly的社交笔记应用程序。用户将能够创建一个帐户，用纯文本或Markdown编写笔记，编辑其笔记，查看其他用户笔记的摘要以及“收藏”其他用户的笔记。

在本书的这一部分中，我们将开发支持该应用程序的API。在我们的API中：用户将能够创建笔记、阅读、更新和删除他们创建的笔记。用户将能够查看其他用户创建的笔记的摘要，并阅读其他人创建的单个笔记，尽管他们将无法更新或删除它们。用户将能够创建帐户，登录和注销。用户将能够检索其个人资料信息以及其他用户的公共个人资料信息。

Markdown

Markdown是一种流行的文本标记语言，在编程社区以及诸如iA Writer，Ulysses，Byword等文本应用程序中很常见。要了解有关Markdown的更多信息，请访问 Markdown Guide网站。

尽管这听起来很多，但在本书的这一部分中，我将其细分为小块。一旦学会了执行这些类型的交互，就可以将它们应用于构建各种API。

我们将如何构建它

为了构建我们的API，我们将使用 GraphQL API查询语言。GraphQL是一个开放源代码的规范，于2012年在Facebook上首次创建。GraphQL的优势在于它允许客户端精确地请求其所需的数据，从而大大简化并限制了请求的数量。当我们向移动客户端发送数据时，这也提高了明显的性能优势，因为我们只需要发送客户端所需的数据。在本书的大部分内容中，我们将探索如何编写、开发和使用GraphQL API。

什么是REST？

如果你熟悉Web API术语，那么你可能听说过REST（代表状态传输）API。REST体系结构一直（并将继续是）API的主要格式。与GraphQL不同，这些API依赖于URL结构和查询参数来向服务器发出请求。尽管REST仍然很重要，但GraphQL的简单性，围绕GraphQL的工具的健壮性以及通过发送有限的数据的潜在性能提升，使GraphQL成为现代平台的首选。

开始

在开始开发之前，我们需要将项目启动程序文件复制到我们的电脑上。该项目的源代码包含我们开发应用程序所需的所有脚本和对第三方库的引用。要将代码克隆到本地计算机上，请打开终端，导航到项目保存的目录，也就是 git clone 项目库的目录，并使用npm install来安装依赖项。创建一个显目的目录名，可以使本书的代码井井有条。

$ cd Projects
$ mkdir notedly && cd notedly
$ git clone git@github.com:javascripteverywhere/api.git
$ cd api
$ npm install

安装第三方依赖项

通过制作本书的入门代码的副本并且在目录中运行npm install ，你就不需要再因为任何第三方依赖而再次运行它。

该代码的结构如下：

/src

这是你进行开发的目录。
/solutions

该目录包含每章的解决方案。如果你卡住了，这些可以供你参考。
/final

该目录包含最终的工作项目。

现在，你已经在本地计算机上获得了代码，你将需要复制项目的.env 文件。该文件是保存特定于环境的信息或项目私有数据（例如数据库URL，客户端ID和密码）的地方。因此，你永远不需要将其加入源代码管理。你需要自己的.env 文件副本。为此，请在api 目录中的终端中输入以下内容：

cp .env.example .env

现在，你应该在目录中看到一个 .env文件。你无需对该文件做任何事情，但是随着API后端的开发，我们将向其中添加信息。将该文件添加到.gitignore文件以确保你不会无意中提交了.env 文件。

求助，我看不到.env文件！

默认情况下，操作系统会隐藏以句点开头的文件，因为这些文件通常由系统使用，而不是给最终用户使用。如果看不到.env文件，请尝试在文本编辑器中打开目录。该文件应该在编辑器的文件浏览器中可见。或者，在终端窗口中键入ls -a ，会在当前工作目录中列出所有的文件。

结论

API为数据从数据库流向应用程序提供了接口。因此，它们是现代应用程序的中坚力量。通过使用GraphQL，我们可以快速开发基于可扩展API的现代应用程序。在下一章中，我们将通过使用Node.js和Express构建Web服务器来开始API开发。

译者语和书籍详情

如果有理解不到位的地方，欢迎大家纠错。如果觉得还可以，麻烦您点赞收藏或者分享一下，希望可以帮到更多人。

有看的么？有看的么？有看的么？

有的话，可以点个赞么？让我知道有人在看。(ಥ_ಥ)

英文书名：《JavaScript Everywhere: Building Cross-Platform Applications with GraphQL, React, React Native, and Electron》

中文译名：《随处可见的JavaScript:使用GraphQL、React、React Native和Electron构建跨平台应用程序》

作者：Adam D. Scott

译者：毛毛

出版时间：2020年2月6日。

翻译时间：2020年10月10日

书封面：