graphql-clj
A Clojure library designed to provide GraphQL implementation.
Demo
What's new in version 0.2
- Simplified APIs
- Rewrite schema and query validator for simplicity and robostness.
- Separate parser and validator for schema and query.
- High performance java parser
Installation
Add the following dependency to your project.clj file:
[graphql-clj "0.2.9"]
Usage
Define schema
(def schema-str "type User {
name: String
age: Int
}
type QueryRoot {
user: User
}
schema {
query: QueryRoot
}")
Define resolver functions
(defn resolver-fn [type-name field-name]
(get-in {"QueryRoot" {"user" (fn [context parent args]
{:name "test user name"
:age 30})}}
[type-name field-name]))
Execute query
(require '[graphql-clj.executor :as executor])
(def query-str "query {user {name age}}")
(executor/execute nil schema-str resolver-fn query-str)
;; => {:data {"user" {"name" "test user name", "age" 30}}}
Caching validated schema and query for performance
(require '[graphql-clj.schema-validator :as schema-validator])
(require '[graphql-clj.query-validator :as query-validator])
;; Consider memoizing the result of parsing and validating the query before execution
(def validated-schema (schema-validator/validate-schema schema-str)) ; throw ex-info with ex-data {:errors errors}
(def validated-query (query-validator/validate-query validated-schema query-str)) ; return [errors validated-ast]
(executor/execute nil validated-schema resolver-fn validated-query)
;; => {:data {"user" {"name" "test user name", "age" 30}}}
Migrating from 0.1.x to 0.2 version
- Separated parser api for schema and query
parser/parse-schema for schema parsing
parser/parse-query-document for query parsing
- Simplified validator api, it can take query string and schema string now.
graphql-clj.schema-validator/validate-schema replaces validator/validate-schema
graphql-clj.query-validator/validate-query replaces validator/validate-statement
- executor/execute function can take string and validated result for both schema and query string.
Deploy to local for development
$ lein install
Release to Clojars
$ lein deploy clojars
Test
$ lein test
License
Copyright © 2016 Lei Wang
Distributed under the Eclipse Public License either version 1.0 or (atyour option) any later version.
-
快速开始 GraphQL 是一种用于 API 的查询语言。这是 GraphQL 和 REST 之间一个很好的比较 (译者注： GraphQL 替代 REST 是必然趋势)。在这组文章中, 我们不会解释什幺是 GraphQL, 而是演示如何使用 @nestjs/GraphQL 模块。 GraphQLModule 只不过是 Apollo 服务器的包装器。我们没有造轮子, 而是提供一个现成的模块, 这让
-
GraphQL 既是一种用于 API 的查询语言也是一个满足你数据查询的运行时。 GraphQL 对你的 API 中的数据提供了一套易于理解的完整描述，使得客户端能够准确地获得它需要的数据，而且没有任何冗余，也让 API 更容易地随着时间推移而演进，还能用于构建强大的开发者工具。 向你的 API 发出一个 GraphQL 请求就能准确获得你想要的数据，不多不少。 GraphQL 查询总是返回可预测
-
Graphql editor 是一款 Graphql 的可视化编辑器和 IDE，帮助用户更容易理解 GraphQL 模式，通过使用可视化块系统创建模式。GraphQL Editor 将把它们转化为代码。通过 GraphQL Editor，用户可以在不写任何代码的情况下创建可视化的图表，或者以一种很好的方式呈现其模式。 GraphQL View Code Editor View Hierarchy View
-
GraphQL CLI Help us to improve new GraphQL CLI. Check out the new structure and commands below!Feel free to contact us in Discord channel. We would love to hear your feedback. Features Helpful command
-
Fullstack GraphQL Simple Demo Application API built with Node + Express + GraphQL + Sequelize (supports MySQL, Postgres, Sqlite and MSSQL). WebApp built with React + Redux. Written in ES6 using Babel
-
Hasura GraphQL Engine Hasura is an open source product that accelerates API development by 10x by giving you GraphQL or REST APIs with built in authorization on your data, instantly. Read more at hasu