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

翻译 | 《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 [email protected]: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.jsExpress构建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日

你可能感兴趣的