当您对外部模块的存储库进行了 fork (例如修复模块代码中的问题或添加功能)时,您可以让 Go 工具将您的 fork 用于模块的源代码。这对于测试您自己的代码的更改很有用。
为此,您可以使用gomod 文件中的replace指令将外部模块的原始模块路径替换为存储库中 fork 的路径。这指示 Go 工具在编译时使用替换路径(fork 的位置),例如,同时允许您保留import 原始模块路径中的语句不变。
在以下 gomod 文件示例中,当前模块需要外部模块examplecom/theirmodule。然后该replace指令将原始模块路径替换为examplecom/myfork/theirmodule模块自己的存储库的分支。
设置require/replace对时,使用 Go 工具命令确保文件描述的需求保持一致。使用go list命令获取当前模块正在使用的版本。然后使用go mod edit命令将需要的模块替换为fork:
注意: 当您使用该replace指令时,Go 工具不会像添加依赖项中所述对外部模块进行身份验证。
您可以使用go get命令从其存储库中的特定提交为模块添加未发布的代码。
为此,您使用go get命令,用符号@指定您想要的代码 。当您使用go get时,该命令将向您的 gomod 文件添加一个 需要外部模块的require指令,使用基于有关提交的详细信息的伪版本号。
以下示例提供了一些说明。这些基于源位于 git 存储库中的模块。
当您的代码不再使用模块中的任何包时,您可以停止将该模块作为依赖项进行跟踪。
要停止跟踪所有未使用的模块,请运行go mod tidy 命令。此命令还可能添加在模块中构建包所需的缺失依赖项。
要删除特定依赖项,请使用go get,指定模块的模块路径并附加 @none,如下例所示:
go get命令还将降级或删除依赖于已删除模块的其他依赖项。
当您使用 Go 工具处理模块时,这些工具默认从 proxygolangorg(一个公共的 Google 运行的模块镜像)或直接从模块的存储库下载模块。您可以指定 Go 工具应该使用另一个代理服务器来下载和验证模块。
如果您(或您的团队)已经设置或选择了您想要使用的不同模块代理服务器,您可能想要这样做。例如,有些人设置了模块代理服务器,以便更好地控制依赖项的使用方式。
要为 Go 工具指定另一个模块代理服务器,请将GOPROXY 环境变量设置为一个或多个服务器的 URL。Go 工具将按照您指定的顺序尝试每个 URL。默认情况下,GOPROXY首先指定一个公共的 Google 运行模块代理,然后从模块的存储库直接下载(在其模块路径中指定):
您可以将变量设置为其他模块代理服务器的 URL,用逗号或管道分隔 URL。
Go 模块经常在公共互联网上不可用的版本控制服务器和模块代理上开发和分发。您可以设置 GOPRIVATE环境变量。您可以设置GOPRIVATE环境变量来配置go命令以从私有源下载和构建模块。然后 go 命令可以从私有源下载和构建模块。
GOPRIVATE或环境变量可以设置为匹配模块前缀的全局模式列表,这些GONOPROXY前缀是私有的,不应从任何代理请求。例如:
以我就说只会 JavaScript 啊 Java EE 啊 PHP 的就不要冒充程序员了……先看看 Go 的 net 包和 net/>
欢迎golang同胞!在本教程中,我们将研究如何在基于 Go 的程序中与 GraphQL 服务器进行交互。在本教程结束时,我们应该知道如何执行以下 *** 作:
在本教程中,我们将专注于学习 GraphQL 的数据检索方面,并且我们将使用内存中的数据源来支持它。这应该为我们在后续教程的基础上建立一个良好的基础。
好的,所以在我们深入研究之前,我们应该真正了解 GraphQL 的基础知识。作为开发人员,使用它对我们有什么好处?
好吧,考虑使用每天处理数十万甚至数百万请求的系统。传统上,我们会使用位于数据库前面的系统 API,它会返回大量 JSON 响应,其中包含许多我们可能不一定需要的冗余信息。
如果我们正在处理大规模的应用程序,发送冗余数据的成本可能会很高,并且由于有效负载大小会阻塞我们的网络带宽。
GraphQL基本上可以让我们以减少噪音和描述数据,我们希望让我们的检索,从我们的API中检索 只有 我们需要为我们当前的任务/视图/不管。
这只是该技术为我们提供的众多好处的一个例子。希望在接下来的教程系列中,我们会提前看到更多这些好处。
需要注意的重要一点是,GraphQL 不像我们传统的 SQL 那样是一种查询语言。它是位于我们 API 前面的抽象, 不 依赖于任何特定的数据库或存储引擎。
这真的很酷。我们可以建立一个与现有服务商交互的 GraphQL 服务器,然后围绕着这个新的 GraphQL 服务器构建,而不必担心修改现有的 REST API。
让我们看看 RESTful 方法与 GraphQL 方法有何不同。现在,假设我们正在构建一个返回该站点上所有教程的服务,如果我们想要特定教程的信息,我们通常会创建一个 API 端点,允许我们根据 ID 检索特定教程:
如果给定一个 valid ID,这将返回一个响应,看起来像这样:
现在,假设我们想创建一个小部件,列出该作者撰写的书籍 5 个帖子。我们可以点击/author/:id端点以检索该作者撰写的所有帖子,然后进行后续调用以检索前 5 个帖子中的每一个。或者,我们可以制作一个全新的端点来为我们返回这些数据。
这两种解决方案听起来都不是特别吸引人,因为它们会创建不需要的请求量或返回过多的数据,这突出了 RESTful 方法开始出现一些裂缝的地方。
这就是 GraphQL 发挥作用的地方。使用 GraphQL,我们可以定义我们希望在查询中返回的数据的确切结构。所以如果我们想要上面的信息,我们可以创建一个看起来像这样的查询:
这将随后返回我们的教程、该教程的作者和一组表示该作者编写的教程的教程 ID,而无需发送额外的 x 多个 REST 请求来获取信息!那有多好?
好的,现在我们对 GraphQL 以及对它的用途有了更多的了解,让我们在实践中看看它。
我们将使用graphql-go/graphql实现在 Go 中创建一个简单的 GraphQL 服务器 。
让我们首先使用go mod init以下方法初始化我们的项目:
接下来,让我们创建一个名为maingo 我们将从简单开始创建一个非常简单的 GraphQL 服务器,它具有一个非常简单的解析器:
现在,如果我们尝试运行它,让我们看看会发生什么:
所以,如果一切正常,那么我们就可以设置一个非常简单的 GraphQL 服务器并对这个服务器进行非常简单的查询。
让我们分解上面代码中发生的事情,以便我们可以进一步扩展它。在lines 14-21我们定义我们的Schema 当我们对我们的 GraphQL API 进行查询时,我们基本上定义了我们想要返回给我们的对象上的哪些字段,因此我们必须在我们的 Schema 重新定义这些字段。
在 上line 17,我们定义了一个解析器函数,每当field请求此特定内容时就会触发该解析器函数。现在,我们只是返回字符串 "world",但我们将实现从这里查询数据库的能力。
让我们看一下maingo文件的第二部分。在line 30我们开始定义query请求领域hello。
然后我们创建一个params结构,其中包含对我们定义的Schema以及我们的RequestString请求的引用 。
最后,在line 36我们执行请求并将请求的结果填充到r 然后我们进行一些错误处理,然后将响应编组为 JSON 并将其打印到我们的控制台上。
现在我们已经启动并运行了一个非常简单的 GraphQL 服务器,并且我们能够对其进行查询,让我们更进一步,构建一个更复杂的示例。
我们将创建一个 GraphQL 服务器,它返回一系列内存中的教程及其作者,以及对这些特定教程的任何评论。
让我们定义一些struct代表 a Tutorial、 anAuthor和 a 的's Comment:
然后我们可以创建一个非常简单的populate()函数,它将返回一个类型数组Tutorial:
这将为我们提供一个简单的教程列表,然后我们可以稍后解决。
我们将从使用 GraphQL 创建一个新对象开始graphqlNewObject()。我们将使用 GraphQL 的严格类型定义 3 种不同的类型,它们将与structs我们已经定义的 3 种相匹配。
我们的Commentstruct 可以说是最简单的,它只包含一个 string Body,所以我们可以commentType很容易地将其表示为:
接下来,我们将处理该Author结构并将其定义为一个新的 graphqlNewObject() 这会稍微复杂一些,因为它既有一个 String字段,也有一个Int值列表,这些值代表他们编写的教程的 ID。
最后,让我们定义我们的tutorialTypewhich 将封装 an author和comment's的数组以及 anID和 a title:
现在我们已经定义了我们的Type系统,让我们着手更新我们的 Schema 以反映这些新类型。我们将定义 2 个 distinct Field,第一个将是我们的tutorial字段,它允许我们Tutorials 根据传入查询的 ID检索个人。第二个将是一个list字段,它将允许我们检索Tutorials我们在内存中定义的完整数组。
所以我们已经创建了我们的类型并更新了我们的 GraphQL 模式,我们做得还不错!
让我们尝试使用我们的新 GraphQL 服务器并处理我们提交的查询。让我们来尝试我们的list架构改变query ,我们已经在我们得到main()的功能:
让我们分解一下。所以在我们的查询中,我们有一个特殊的root对象。然后我们在其中说我们想要该list对象上的字段。在返回的名单list,我们希望看到的id,title,comments和 author。
当我们运行它时,我们应该会看到以下输出:
正如我们所见,我们的查询以 JSON 格式返回了我们所有的教程,看起来非常像我们初始查询的结构。
现在让我们尝试对我们的tutorial模式进行查询:
再一次,当我们运行它时,我们应该看到它已经成功地检索了内存中的单独教程ID=1:
完美,看起来我们已经让list我们的tutorial模式和我们的模式都按预期工作了。
这就是我们将在这个初始教程中介绍的全部内容。我们已经成功地设置了一个简单的 GraphQL 服务器,该服务器由内存数据存储支持。
在下一个教程中,我们将研究 GraphQL 突变并更改我们的数据源以使用 SQL 数据库
欢迎分享,转载请注明来源:内存溢出
评论列表(0条)