You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<!DOCTYPE html><htmllang="zh-Hans-CN"><head><metacharset="utf-8"/><metahttp-equiv="X-UA-Compatible" content="IE=edge,chrome=1"/><title>GraphQL: A data query language | GraphQL</title><metaname="viewport" content="width=640"/><metaname="description" content="GraphQL 提供了 API 中数据的完整描述，提供让客户端能够准确地获取需要的数据而不包含任何冗余的能力，让 API 更加容易随着时间推移而演进，并提供强大的开发者工具。"/><metaproperty="og:title" content="GraphQL: 一种用于 API 的查询语言。"/><metaproperty="og:description" content="GraphQL 提供了 API 中数据的完整描述，提供让客户端能够准确地获取需要的数据而不包含任何冗余的能力，让 API 更加容易随着时间推移而演进，并提供强大的开发者工具。"/><metaproperty="og:type" content="website"/><metaproperty="og:url" content="http://graphql.cn/"/><metaproperty="og:image" content="/img/og_image.png"/><metaproperty="og:image:type" content="image/png"/><metaname="twitter:card" content="summary"/><metaname="twitter:site" content="@graphql"/><metaname="twitter:title" content="GraphQL: 一种用于 API 的查询语言。"/><metaname="twitter:description" content="GraphQL 提供让客户端能够准确地获取需要的数据而不包含任何冗余的能力，并让 API 更加容易随着时间推移而演进。"/><metaname="twitter:image" content="/img/twitter_image.png"/><linkrel="shortcut icon" href="/img/favicon.png"/><linkrel="home" type="application/rss+xml" href="/blog/rss.xml" title="GraphQL 团队博客"/><linkrel="stylesheet" href="/style.css"/><linkrel="stylesheet" href="https://fonts.googleapis.com/css?family=Rubik:300|Roboto:300"/><linkrel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto+Mono:400,400i,600"/><linkrel="stylesheet" href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css"/></head><body><header><section><aclass="nav-home" href="/"><imgclass="nav-logo" src="/img/logo.svg" alt="GraphQL Logo" width="30" height="30"/>GraphQL</a><nav><ahref="/learn/">学习</a><ahref="/code/">代码</a><ahref="/community/">社区</a><ahref="https://spec.graphql.cn/" target="_blank" rel="noopener noreferrer">规范</a><ahref="/codeofconduct/">行为守则</a><ahref="https://foundation.graphql.org/" target="_blank" rel="noopener noreferrer">基金会</a><ahref="https://l.graphql.org/" target="_blank" rel="noopener noreferrer">社区总览</a><ahref="https://principles.graphql.cn/" target="_blank" rel="noopener noreferrer">开发原则</a></nav><divclass="algolia-search-wrapper"><inputtype="text" id="algolia-search-input" placeholder="搜索文档..." aria-label="搜索文档"/></div></section></header><section><divclass="documentationContent"><divclass="inner-content"><h1>GraphQL: A data query language</h1><p>9/14/2015 by Lee Byron</p><hr/><div><div>
2
+
3
+
</div><p>When we built Facebook's mobile applications, we needed a data-fetching API powerful enough to describe all of Facebook, yet simple and easy to learn so product developers can focus on building things quickly. We developed GraphQL three years ago to fill this need. Today it powers hundreds of billions of API calls a day. This year we've begun the process of open-sourcing GraphQL by drafting a specification, releasing a reference implementation, and forming a community around it here at <ahref="http://graphql.org/" target="_blank" rel="nofollow noopener noreferrer">graphql.org</a>.</p><h2><aclass="anchor" name="why-graphql?"></a>Why GraphQL? <aclass="hash-link" href="#why-graphql?">#</a></h2><p>Back in 2012, we began an effort to rebuild Facebook's native mobile applications.</p><p>At the time, our iOS and Android apps were thin wrappers around views of our mobile website. While this brought us close to a platonic ideal of the "write one, run anywhere" mobile application, in practice it pushed our mobile-webview apps beyond their limits. As Facebook's mobile apps became more complex, they suffered poor performance and frequently crashed.</p><p>As we transitioned to natively implemented models and views, we found ourselves for the first time needing an API data version of News Feed — which up until that point had only been delivered as HTML. We evaluated our options for delivering News Feed data to our mobile apps, including RESTful server resources and FQL tables (Facebook's SQL-like API). We were frustrated with the differences between the data we wanted to use in our apps and the server queries they required. We don't think of data in terms of resource URLs, secondary keys, or join tables; we think about it in terms of a graph of objects and the models we ultimately use in our apps like NSObjects or JSON.</p><p>There was also a considerable amount of code to write on both the server to prepare the data and on the client to parse it. This frustration inspired a few of us to start the project that ultimately became GraphQL. GraphQL was our opportunity to rethink mobile app data-fetching from the perspective of product designers and developers. It moved the focus of development to the client apps, where designers and developers spend their time and attention.</p><h2><aclass="anchor" name="what-is-graphql?"></a>What is GraphQL? <aclass="hash-link" href="#what-is-graphql?">#</a></h2><p>A GraphQL query is a string that is sent to a server to be interpreted and fulfilled, which then returns JSON back to the client.</p><div><divid="r101"><divclass="miniGraphiQL" data-reactroot="" data-reactid="1" data-react-checksum="-1260504911"><divclass="query-editor" data-reactid="2"></div><divclass="result-window" data-reactid="3"></div></div></div>
4
+
5
+
</div><p><strong>Defines a data shape:</strong> The first thing you'll notice is that GraphQL queries mirror their response. This makes it easy to predict the shape of the data returned from a query, as well as to write a query if you know the data your app needs. More important, this makes GraphQL really easy to learn and use. GraphQL is unapologetically driven by the data requirements of products and of the designers and developers who build them.</p><p><strong>Hierarchical:</strong> Another important aspect of GraphQL is its hierarchical nature. GraphQL naturally follows relationships between objects, where a RESTful service may require multiple round-trips (resource-intensive on mobile networks) or a complex join statement in SQL. This data hierarchy pairs well with graph-structured data stores and ultimately with the hierarchical user interfaces it's used within.</p><p><strong>Strongly typed:</strong> Each level of a GraphQL query corresponds to a particular type, and each type describes a set of available fields. Similar to SQL, this allows GraphQL to provide descriptive error messages before executing a query. It also plays well with the strongly typed native environments of Obj-C and Java.</p><p><strong>Protocol, not storage:</strong> Each GraphQL field on the server is backed by a function - code linking to your application layer. While we were building GraphQL to support News Feed, we already had a sophisticated feed ranking and storage model, along with existing databases and business logic. GraphQL had to leverage all this existing work to be useful, and so does not dictate or provide any backing storage. Instead, GraphQL takes advantage of your existing code by exposing your application layer, not your storage layer.</p><p><strong>Introspective:</strong> A GraphQL server can be queried for the types it supports. This creates a powerful platform for tools and client software to build atop this information like code generation in statically typed languages, our application framework, Relay, or IDEs like GraphiQL (pictured below). GraphiQL helps developers learn and explore an API quickly without grepping the codebase or wrangling with cURL.</p><div><divid="r102"><divclass="miniGraphiQL" data-reactroot="" data-reactid="1" data-react-checksum="-1260504911"><divclass="query-editor" data-reactid="2"></div><divclass="result-window" data-reactid="3"></div></div></div>
6
+
7
+
</div><p><strong>Version free:</strong> The shape of the returned data is determined entirely by the client's query, so servers become simpler and easy to generalize. When you're adding new product features, additional fields can be added to the server, leaving existing clients unaffected. When you're sunsetting older features, the corresponding server fields can be deprecated but continue to function. This gradual, backward-compatible process removes the need for an incrementing version number. We still support three years of released Facebook applications on a single version of our GraphQL API.</p><p>With GraphQL, we were able to build full-featured native News Feed on iOS in 2012, and on Android shortly after. Since then, GraphQL has become the primary way we build our mobile apps and the servers that power them. More than three years later, GraphQL powers almost all data-fetching in our mobile applications, serving millions of requests per second from nearly 1,000 shipped application versions.</p><p>When we built GraphQL in 2012 we had no idea how important it would become to how we build things at Facebook and didn't anticipate its value beyond Facebook. However earlier this year we announced Relay, our application framework for the web and React Native built atop GraphQL. The community excitement for Relay inspired us to revisit GraphQL to evaluate every detail, make improvements, fix inconsistencies, and write a specification describing GraphQL and how it works.</p><p>Two months ago, we <ahref="https://www.youtube.com/watch?v=WQLzZf34FJ8" target="_blank" rel="nofollow noopener noreferrer">made our progress public</a> and released a working draft of the <ahref="http://facebook.github.io/graphql/" target="_blank" rel="nofollow noopener noreferrer">GraphQL spec</a> and a reference implementation: <ahref="https://github.com/graphql/graphql-js" target="_blank" rel="nofollow noopener noreferrer">GraphQL.js</a>. Since then, a community has started to form around GraphQL, and versions of the GraphQL runtime are being <ahref="https://github.com/chentsulin/awesome-graphql" target="_blank" rel="nofollow noopener noreferrer">built in many languages</a>, including Go, Ruby, Scala, Java, .Net, and Python. We've also begun to share some of the tools we use internally, like <ahref="https://github.com/graphql/graphiql" target="_blank" rel="nofollow noopener noreferrer">GraphiQL</a>, an in-browser IDE, documentation browser, and query runner. GraphQL has also seen production usage outside Facebook, in a project for the <ahref="https://www.youtube.com/watch?v=S0s935RKKB4" target="_blank" rel="nofollow noopener noreferrer"><em>Financial Times</em></a> by consultancy <ahref="http://red-badger.com/" target="_blank" rel="nofollow noopener noreferrer">Red Badger</a>.</p><p>“GraphQL makes orchestrating data fetching so much simpler and it pretty much functions as a perfect isolation point between the front end and the back end”
0 commit comments