Learn-Validation.md #56
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Signed-off-by: Jonir Rings <peterpuyi@live.cn>
jonirrings
commented
Aug 2, 2017
site/learn/Learn-Validation.md
Outdated
| @@ -91,8 +73,7 @@ Hero returns a `Character`, and we've been requesting fields like `name` and | |||
| } | |||
| ``` | |||
|
|
|||
| Similarly, if a field is a scalar, it doesn't make sense to query for | |||
| additional fields on it, and doing so will make the query invalid: | |||
| 类似的，如果一个字段是标量，进一步查询它上面的字段也没有意义，这样做也会导致查询无效： | |||
There was a problem hiding this comment.
类似的，类似地。
把握不准，前者是“类似的情况下”的简略写法，后者是状语副词，好像也适合这个场景。有劳校对指教。
Closed
ydfzgyj
requested changes
Aug 2, 2017
site/learn/Learn-Validation.md
Outdated
| To start, let's take a complex valid query. This is a nested query, similar to | ||
| an example from the previous section, but with the duplicated fields factored | ||
| out into a fragment: | ||
| 对于我们的《星球大战》的案例，[starWarsValidation-test.js](https://github.com/graphql/graphql-js/blob/master/src/__tests__/starWarsValidation-test.js)这个文件包含一些查询，演示了各种无效查询，它也是一个测试文件，用于检测参考实现的验证器。 |
There was a problem hiding this comment.
- 链接和中文之间加上一个空格
- “包含一些查询，演示了各种无效查询” => “包含了若干对于各种无效查询的演示”
site/learn/Learn-Validation.md
Outdated
| given type. So as `hero` returns a `Character`, we have to query for a field | ||
| on `Character`. That type does not have a `favoriteSpaceship` field, so this | ||
| query is invalid: | ||
| 查询字段的时候，我们只能查询给定类型上的字段。因此由于 `hero` 返回 `Character`类型，我们只能查询 `Character` 上的字段。因为这个类型上没有 `favoriteSpaceship` 字段，所以这个查询是无效的： |
site/learn/Learn-Validation.md
Outdated
| or an enum, we need to specify what data we want to get back from the field. | ||
| Hero returns a `Character`, and we've been requesting fields like `name` and | ||
| `appearsIn` on it; if we omit that, the query will not be valid: | ||
| 当我们查询一个字段时，如果其返回值不是标量或者枚举型，那我们就需要指明想要从这个字段中获取的数据。`hero` 返回 `Character`类型，我们也请求了像是 `name` 和`appearsIn` 的字段；但如果将其省略，这个查询就变无效的了： | ||
|
|
||
| ```graphql | ||
| # { "graphiql": true } |
site/learn/Learn-Validation.md
Outdated
| given type. So as `hero` returns a `Character`, we have to query for a field | ||
| on `Character`. That type does not have a `favoriteSpaceship` field, so this | ||
| query is invalid: | ||
| 查询字段的时候，我们只能查询给定类型上的字段。因此由于 `hero` 返回 `Character`类型，我们只能查询 `Character` 上的字段。因为这个类型上没有 `favoriteSpaceship` 字段，所以这个查询是无效的： | ||
|
|
||
| ```graphql | ||
| # { "graphiql": true } |
site/learn/Learn-Validation.md
Outdated
| or an enum, we need to specify what data we want to get back from the field. | ||
| Hero returns a `Character`, and we've been requesting fields like `name` and | ||
| `appearsIn` on it; if we omit that, the query will not be valid: | ||
| 当我们查询一个字段时，如果其返回值不是标量或者枚举型，那我们就需要指明想要从这个字段中获取的数据。`hero` 返回 `Character`类型，我们也请求了像是 `name` 和`appearsIn` 的字段；但如果将其省略，这个查询就变无效的了： |
There was a problem hiding this comment.
- 第一个
Character后加空格 - 我们也请求了“其中”像是……
- 这个查询就变“成”无效的了
site/learn/Learn-Validation.md
Outdated
| @@ -91,8 +73,7 @@ Hero returns a `Character`, and we've been requesting fields like `name` and | |||
| } | |||
| ``` | |||
|
|
|||
| Similarly, if a field is a scalar, it doesn't make sense to query for | |||
| additional fields on it, and doing so will make the query invalid: | |||
| 类似的，如果一个字段是标量，进一步查询它上面的字段也没有意义，这样做也会导致查询无效： | |||
site/learn/Learn-Validation.md
Outdated
| [validation](https://github.com/graphql/graphql-js/blob/master/src/validation) | ||
| directory in GraphQL.js contains code implementing a | ||
| specification-compliant GraphQL validator. | ||
| 这只是验正系统的冰山一角；事实上需要一大套验正规则才能保证 GraphQL 查询的语义意义。规范中的“验证”章节有关于本话题更详细的内容，GraphQL.js 的 [validation](https://github.com/graphql/graphql-js/blob/master/src/validation) 目录包含了规范兼容的 GraphQL 验证器实现代码。 |
There was a problem hiding this comment.
换了，这可能是脑子没转过去。:joy:
|
已修正，有劳再次审核 |
ydfzgyj
requested changes
Aug 3, 2017
site/learn/Learn-Validation.md
Outdated
| [validation](https://github.com/graphql/graphql-js/blob/master/src/validation) | ||
| directory in GraphQL.js contains code implementing a | ||
| specification-compliant GraphQL validator. | ||
| 这只是验正系统的冰山一角；事实上需要一大套验证规则才能保证 GraphQL 查询的语义意义。规范中的“验证”章节有关于本话题更详细的内容，GraphQL.js 的 [validation](https://github.com/graphql/graphql-js/blob/master/src/validation) 目录包含了规范兼容的 GraphQL 验证器实现代码。 |
Signed-off-by: Jonir Rings <peterpuyi@live.cn>
ydfzgyj
approved these changes
Aug 3, 2017
linhe0x0
approved these changes
Aug 10, 2017
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
pr晚了，有劳校对
close #12