From 4179b09e7a8fb204782530bb423baf643b081b3e Mon Sep 17 00:00:00 2001 From: Jonir Rings Date: Mon, 7 Aug 2017 23:47:49 +0800 Subject: [PATCH 1/3] APIReference-Utilities translation done Signed-off-by: Jonir Rings --- site/graphql-js/APIReference-Utilities.md | 75 +++++++++-------------- 1 file changed, 29 insertions(+), 46 deletions(-) diff --git a/site/graphql-js/APIReference-Utilities.md b/site/graphql-js/APIReference-Utilities.md index e31d927ad..174cac9dc 100644 --- a/site/graphql-js/APIReference-Utilities.md +++ b/site/graphql-js/APIReference-Utilities.md @@ -1,21 +1,20 @@ --- title: graphql/utilities layout: ../_core/GraphQLJSLayout -category: API Reference +category: API 参考 permalink: /graphql-js/utilities/ sublinks: astFromValue,buildASTSchema,buildClientSchema,buildSchema,introspectionQuery,isValidJSValue,isValidLiteralValue,printIntrospectionSchema,printSchema,typeFromAST,TypeInfo next: /graphql-js/validation/ --- -The `graphql/utilities` module contains common useful computations to use with -the GraphQL language and type objects. You can import either from the `graphql/utilities` module, or from the root `graphql` module. For example: +`graphql/utilities` 模块包含用于 GraphQL 语言和类型对象的常用计算。你可以从 `graphql/utilities` 模块或是根 `graphql` 模块引入。如下： ```js import { introspectionQuery } from 'graphql'; // ES6 var { introspectionQuery } = require('graphql'); // CommonJS ``` -## Overview +## 概览 *Introspection* @@ -23,13 +22,13 @@ var { introspectionQuery } = require('graphql'); // CommonJS 
  • var introspectionQuery
    - A GraphQL introspection query containing enough information to reproduce a type system. + GraphQL 内省查询，包含足够的信息以重建类型系统。 
  • function buildClientSchema
    - Produces a client schema given the result of querying a schema with `introspectionQuery`. + 通过使用 `introspectionQuery` 查询 schema 的结果，生成客户端 schema。
    • @@ -40,37 +39,37 @@ var { introspectionQuery } = require('graphql'); // CommonJS 
  • function buildSchema
    - Builds a Schema object from GraphQL schema language. + 基于 GraphQL schema languag 构建一个 Schema 对象。 
  • function printSchema
    - Prints the schema in a standard format. + 使用标准格式打印 schema。 
  • function printIntrospectionSchema
    - Prints the introspections featurs of the schema in a standard format. + 使用标准格式打印 schema 的内省特性。 
  • function buildASTSchema
    - Builds a schema from a parsed AST Schema. + 基于分析后的 AST Schema 构建 schema。 
  • function typeFromAST
    - Looks up a type referenced in an AST in the GraphQLSchema. + 在 GraphQLSchema 的 AST 中查找一个类型引用。 
  • function astFromValue
    - Produces a GraphQL Input Value AST given a JavaScript value. + 基于一个 JavaScript 值生成一个 GraphQL Input Value AST。
    • @@ -81,7 +80,7 @@ var { introspectionQuery } = require('graphql'); // CommonJS 
  • class TypeInfo
    - Tracks type and field definitions during a visitor AST traversal.. + 在 visitor 遍历 AST 时追踪类型和字段定义。
    • @@ -92,13 +91,13 @@ var { introspectionQuery } = require('graphql'); // CommonJS 
  • function isValidJSValue
    - Determins if a JavaScript value is valid for a GraphQL type. + 判断一个 JavaScript 值是否是有效的 GraphQL 类型。 
  • function isValidLiteralValue
    - Determins if a literal value from an AST is valid for a GraphQL type. + 判断一个 AST 中的字面量值是否是有效的 GraphQL 类型。
    • @@ -111,8 +110,7 @@ var { introspectionQuery } = require('graphql'); // CommonJS var introspectionQuery: string ``` -A GraphQL query that queries a server's introspection system for enough -information to reproduce that server's type system. +GraphQL 内省查询，用于查询服务器的内省系统，得到足够的信息以重建服务器类型系统。 ### buildClientSchema @@ -122,13 +120,9 @@ function buildClientSchema( ): GraphQLSchema ``` -Build a GraphQLSchema for use by client tools. +构建客户端工具用的 GraphQLSchema。 -Given the result of a client running the introspection query, creates and -returns a GraphQLSchema instance which can be then used with all GraphQL.js -tools, but cannot be used to execute a query, as introspection does not -represent the "resolver", "parse" or "serialize" functions or any other -server-internal mechanisms. +假设客户端有运行内省查询的结果，创建并返回了一个 GraphQLSchema 实例，这个实例可以用于所有的 GraphQL.js工具，但不能用于执行查询，因为内省并不代表有“解析器”、“分析”或者“序列化”函数，或者其他服务器内部机制。 ## Schema Representation @@ -138,7 +132,7 @@ server-internal mechanisms. function buildSchema(source: string | Source): GraphQLSchema { ``` -Creates a GraphQLSchema object from GraphQL schema language. The schema will use default resolvers. For more detail on the GraphQL schema language, see the [schema language docs](/learn/schema/) or this [schema language cheat sheet](https://wehavefaces.net/graphql-shorthand-notation-cheatsheet-17cd715861b6#.9oztv0a7n). +基于 GraphQL schema language 创建一个 GraphQLSchema 对象。schema 将会使用默认解析器。关于 GraphQL schema language 的更多细节，请查看 [schema language 文档](/learn/schema/) 或者 [schema language 速查表](https://wehavefaces.net/graphql-shorthand-notation-cheatsheet-17cd715861b6#.9oztv0a7n)。 ### printSchema @@ -146,7 +140,7 @@ Creates a GraphQLSchema object from GraphQL schema language. The schema will use function printSchema(schema: GraphQLSchema): string { ``` -Prints the provided schema in the Schema Language format. +使用 Schema Language 格式打印给定的 schema。 ### printIntrospectionSchema @@ -154,7 +148,7 @@ Prints the provided schema in the Schema Language format. function printIntrospectionSchema(schema: GraphQLSchema): string { ``` -Prints the built-in introspection schema in the Schema Language format. +使用 Schema Language 格式打印内建的内省 schema。 ### buildASTSchema @@ -166,11 +160,7 @@ function buildASTSchema( ): GraphQLSchema ``` -This takes the ast of a schema document produced by `parseSchemaIntoAST` in -`graphql/language/schema` and constructs a GraphQLSchema instance which can be -then used with all GraphQL.js tools, but cannot be used to execute a query, as -introspection does not represent the "resolver", "parse" or "serialize" -functions or any other server-internal mechanisms. +这个函数需要一个 schema 文档的 ast（可通过 `graphql/language/schema` 的 `parseSchemaIntoAST` 生成）构建一个 GraphQLSchema 实例，这个实例可以用于所有的 GraphQL.js 工具，但不能用于执行查询，因为内省并不代表有“解析器”、“分析”或者“序列化”函数，或者其他服务器内部机制。 ### typeFromAST @@ -181,8 +171,7 @@ function typeFromAST( ): ?GraphQLType ``` -Given the name of a Type as it appears in a GraphQL AST and a Schema, return the -corresponding GraphQLType from that schema. +给定一个出现在 GraphQL AST 和 Schema 中的类型名称，返回其在 schema 中对应的 GraphQLType。 ### astFromValue @@ -192,10 +181,10 @@ function astFromValue( type?: ?GraphQLType ): ?Value ``` -Produces a GraphQL Input Value AST given a JavaScript value. -Optionally, a GraphQL type may be provided, which will be used to -disambiguate between value primitives. +基于一个 JavaScript 值生成一个 GraphQL Input Value AST。 + +可选参数，一个 GraphQL 类型，用于消除类型原生值之间的歧义。 ## Visitors @@ -213,9 +202,7 @@ class TypeInfo { } ``` -TypeInfo is a utility class which, given a GraphQL schema, can keep track -of the current field and type definitions at any point in a GraphQL document -AST during a recursive descent by calling `enter(node)` and `leave(node)`. +TypeInfo 是一个工具类，在 GraphQL 文档 AST 的递归分析中的任何位置上，调用 `enter(node)` 和 `leave(node)` 的时候，可以追踪当前字段和类型定义。 ## Value Validation @@ -225,9 +212,7 @@ AST during a recursive descent by calling `enter(node)` and `leave(node)`. function isValidJSValue(value: any, type: GraphQLInputType): string[] ``` -Given a JavaScript value and a GraphQL type, determine if the value will be -accepted for that type. This is primarily useful for validating the -runtime values of query variables. +给定一个 JavaScript 值和 GraphQL 类型，判断这个值是否能被这个类型接受。这个功能在验证运行时查询参数的时候特别有用。 ### isValidLiteralValue @@ -238,8 +223,6 @@ function isValidLiteralValue( ): string[] ``` -Utility for validators which determines if a value literal AST is valid given -an input type. +验证器的工具可以判断 AST 字面量值是否是一个给定输入类型的有效值。 -Note that this only validates literal values, variables are assumed to -provide values of the correct type. +注意，这个功能只验证字面量值，并假设变量值的是正确的类型。 From b595bc8e8272f5234b706e5561c2b8d3c736a9d4 Mon Sep 17 00:00:00 2001 From: Jonir Rings Date: Thu, 10 Aug 2017 11:32:18 +0800 Subject: [PATCH 2/3] =?UTF-8?q?=E4=BF=AE=E6=AD=A3=E7=94=A8=E8=AF=8D?= =?UTF-8?q?=EF=BC=8C=E6=B7=BB=E5=8A=A0=E5=87=A0=E4=B8=AA=E6=A0=87=E9=A2=98?= =?UTF-8?q?=E7=9A=84=E7=BF=BB=E8=AF=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Jonir Rings --- site/graphql-js/APIReference-Utilities.md | 34 +++++++++++------------ 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/site/graphql-js/APIReference-Utilities.md b/site/graphql-js/APIReference-Utilities.md index 174cac9dc..453dddc47 100644 --- a/site/graphql-js/APIReference-Utilities.md +++ b/site/graphql-js/APIReference-Utilities.md @@ -16,13 +16,13 @@ var { introspectionQuery } = require('graphql'); // CommonJS ## 概览 -*Introspection* +**内省** -*Schema Language* +**Schema Language** -*Visitors* +**Visitors**
    • @@ -85,24 +85,24 @@ var { introspectionQuery } = require('graphql'); // CommonJS
    -*Value Validation* +**值验证** -## Introspection +## 内省 ### introspectionQuery @@ -110,7 +110,7 @@ var { introspectionQuery } = require('graphql'); // CommonJS var introspectionQuery: string ``` -GraphQL 内省查询，用于查询服务器的内省系统，得到足够的信息以重建服务器类型系统。 +GraphQL 内省查询，用于查询服务器的内省系统，得到足够的信息以重现服务器类型系统。 ### buildClientSchema @@ -122,9 +122,9 @@ function buildClientSchema( 构建客户端工具用的 GraphQLSchema。 -假设客户端有运行内省查询的结果，创建并返回了一个 GraphQLSchema 实例，这个实例可以用于所有的 GraphQL.js工具，但不能用于执行查询，因为内省并不代表有“解析器”、“分析”或者“序列化”函数，或者其他服务器内部机制。 +假设客户端有运行内省查询的结果，创建并返回了一个 GraphQLSchema 实例，这个实例可以用于所有的 GraphQL.js 工具，但不能用于执行查询，因为内省并不代表有“解析器”、“分析”或者“序列化”函数，或者其他服务器内部机制。 -## Schema Representation +## Schema 表示 ### buildSchema @@ -132,7 +132,7 @@ function buildClientSchema( function buildSchema(source: string | Source): GraphQLSchema { ``` -基于 GraphQL schema language 创建一个 GraphQLSchema 对象。schema 将会使用默认解析器。关于 GraphQL schema language 的更多细节，请查看 [schema language 文档](/learn/schema/) 或者 [schema language 速查表](https://wehavefaces.net/graphql-shorthand-notation-cheatsheet-17cd715861b6#.9oztv0a7n)。 +基于 GraphQL schema language 创建一个 GraphQLSchema 对象。schema 将会使用默认解析器。关于 GraphQL schema language 的更多细节，请查看 [schema language 文档](/learn/schema/) 或者 [schema language 速查表](https://wehavefaces.net/graphql-shorthand-notation-cheatsheet-17cd715861b6#.9oztv0a7n)。 ### printSchema @@ -202,9 +202,9 @@ class TypeInfo { } ``` -TypeInfo 是一个工具类，在 GraphQL 文档 AST 的递归分析中的任何位置上，调用 `enter(node)` 和 `leave(node)` 的时候，可以追踪当前字段和类型定义。 +TypeInfo 是一个工具类，在 GraphQL 文档 AST 的递归分析中的任何位置上，调用 `enter(node)` 和 `leave(node)` 的时候，可以追踪指定 GraphQL schema 中当前字段和类型定义。 -## Value Validation +## 值验证 ### isValidJSValue @@ -212,7 +212,7 @@ TypeInfo 是一个工具类，在 GraphQL 文档 AST 的递归分析中的任何 function isValidJSValue(value: any, type: GraphQLInputType): string[] ``` -给定一个 JavaScript 值和 GraphQL 类型，判断这个值是否能被这个类型接受。这个功能在验证运行时查询参数的时候特别有用。 +给定一个 JavaScript 值和 GraphQL 类型，判断这个值是否能被这个类型接受。这个功能在验证运行时查询参数值的时候特别有用。 ### isValidLiteralValue @@ -225,4 +225,4 @@ function isValidLiteralValue( 验证器的工具可以判断 AST 字面量值是否是一个给定输入类型的有效值。 -注意，这个功能只验证字面量值，并假设变量值的是正确的类型。 +注意，这个功能只验证字面量值，并假设变量值是正确的类型。 From 9d038caf7f1b791b6e38a8d28ac2749dd7318f70 Mon Sep 17 00:00:00 2001 From: Jonir Rings Date: Thu, 10 Aug 2017 14:04:42 +0800 Subject: [PATCH 3/3] =?UTF-8?q?=E7=BB=9F=E4=B8=80=E2=80=9C=E6=A0=B9?= =?UTF-8?q?=E6=A8=A1=E5=9D=97=E2=80=9D=E8=BF=99=E4=B8=AA=E7=94=A8=E8=AF=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Jonir Rings --- site/graphql-js/APIReference-Utilities.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/graphql-js/APIReference-Utilities.md b/site/graphql-js/APIReference-Utilities.md index 453dddc47..b817bf8d9 100644 --- a/site/graphql-js/APIReference-Utilities.md +++ b/site/graphql-js/APIReference-Utilities.md @@ -7,7 +7,7 @@ sublinks: astFromValue,buildASTSchema,buildClientSchema,buildSchema,introspectio next: /graphql-js/validation/ --- -`graphql/utilities` 模块包含用于 GraphQL 语言和类型对象的常用计算。你可以从 `graphql/utilities` 模块或是根 `graphql` 模块引入。如下： +`graphql/utilities` 模块包含用于 GraphQL 语言和类型对象的常用计算。你可以从 `graphql/utilities` 模块或是 `graphql` 根模块引入。如下： ```js import { introspectionQuery } from 'graphql'; // ES6