xfstart07 (Leon Xu)

Ruby on Rails 使用 GraphQL 例子

xfstart07 — Thu, 01 Jun 2017 09:58:05 +0800

英语翻译的不好，我把基本的介绍和操作步骤整理了。项目中一共有 4 个例子。分别放在四个 Tags 中。有查询、修改、嵌套数据查询，N+1 问题的解决。

介绍

GraphQL 是一个接口搜索语言，由 Feacbook 在 2015 年开源的。

GraphQL 就是可以让客户端查询他们确切需要的数据，服务器并不会有过多的返回。

一个 GraphQL 请求分为查询 (读操作)，或变化 (mutation，写操作), 请求是一个简单的字符串 (类似 json 的格式)，GraphQL 服务能解析，执行，并返回指定的数据。

GraphQL 主要特点

在请求中，只返回客户端需要的数据
在一次请求中，返回更多资源。
用类型系统描述什么是可得的
可维护性 - 不需要考虑版本的迭代 API

GraphQL 查询例子

一个查询用户的例子

{
  user(id: 1) {
    firstName,
    lastName,
    email
  }
}

结果

{
  "data": {
    "user": {
      "firstName": "Shaiju",
      "lastName": "E",
      "email": "eshaiju@gmail.com"
     }
   }
}

在 Rails 中搭建 GraphQL 服务

添加 Gem

# Gemfile
gem "graphql"
gem 'graphiql-rails', group: :development

graphiql-rails 是一个 graphql 的 Web 请求页面，使用 graphiql 打包成一个 Gem.

然后执行 bundle install

生成 GraphQL 文件

rails g graphql:install

生成：

创建一个文件夹 app/graphql/
创建一个默认的 schema
添加一个查询类型定义
添加一个查询路由

运行查看

rails server
open localhost:3000/graphiql

增加一个文章查询 (article)

增加一个文章类型 ArticleType

ArticleType = GraphQL::ObjectType.define do
  name "Article"
  field :id, types.Int
  field :title, types.String
  field :body, types.String
  field :comments, types[CommentType]
end

然后建立一个查询模式

路径 app/graphql/types/query_type.rb

QueryType = GraphQL::ObjectType.define do
  name "Query"
  description "一个根查询的 schema"

  field :acticle do
    type ArticleType
    argument :id, !types.ID
    description "Find a Article by ID"
    resolve ->(obj, args, ctx) { Article.find_by_id(args["id"]) }
  end
end

schema 进入文件

路径 app/graphql/graphq_api_schema.rb

GraphqApiSchema = GraphQL::Schema.define do
  query(Types::QueryType)
end

在 application.rb 中加载 graphql 文件

config.autoload_paths << Rails.root.join('app/graphql')
config.autoload_paths << Rails.root.join('app/graphql/types')

下面启动 rails, 在 localhost:3000/graphiql 查询文章

query {
  acticle(id: 1){
    title
  }
}

结果

{
  "data": {
    "acticle": {
      "title": "A GraphQL Server"
    }
  }
}

也可以通过 execute 命令查询

query_string = "
{
  acticle(id: 1) {
    id
    title
  }
}"
result_hash = GraphqApiSchema.execute(query_string)

# output:
# {
#   "data" => {
#     "acticle" => {
#        "id" => 1,
#        "title" => "A GraphQL Server"
#     }
#   }
# }

Resource

http://graphql-ruby.org/

https://github.com/xfstart07/graphql-api

http://tech.eshaiju.in/blog/2017/05/06/a-graphql-server-implementation-ruby-on-rails/

请问一下 RubyGems 镜像服务出问题了吗？

xfstart07 — Wed, 23 Mar 2016 11:59:17 +0800

刚在阿里云的服务器上升级 ruby 版本，然后安装 gem 时出现错误

ERROR:  While executing gem ... (Gem::RemoteFetcher::FetchError)
    bad response Bad Gateway 502 (https://cdn.gems.ruby-china.org/quick/Marshal.4.8/bundler-1.11.2.gemspec.rz)

cdn 服务出现请求错误。

如果实现搜索城市

xfstart07 — Thu, 12 Mar 2015 23:39:41 +0800

最近在实现输入框自动补全搜索城市的功能，目前实现的方式是使用 Google Maps 服务。不过显示出来的数据列表并不理想，很多不需要的数据也显示出来了。

目前实现的效果：

希望显示的只是城市信息而已，想问一下有没有好的一些服务或者方法实现这方面的功能？

目前使用的 js

<script type="text/javascript" src="http://maps.google.com/maps/api/js?sensor=false"></script>

使用的 gem

gem 'gmaps-autocomplete-rails

更新

使用 Google Maps API V3， https://developers.google.com/maps/documentation/javascript/examples/places-searchbox

效果：

[上海][再招] 社区电商创业诚聘 Rails 研发工程师

xfstart07 — Thu, 10 Jul 2014 15:50:38 +0800

关于公司

我们是一家位于上海的创业公司，我们的创业项目是社区电商，我们的模式有一定的创新性，和目前市面上的社区电商有很大的不同，如果有兴趣非常欢迎来详聊。

目前项目处于筹备阶段，我们办公地址在浦东世博园地区，我们包下了整个意大利馆正在装修，目前办公在非洲馆，估计再等三四个月就会入住高大上的新办公室啦。

关于团队

团队成员来自各大电商公司和大型超市企业，有着非常丰富的行业背景。和优秀的人在一起工作可以让自己变的更优秀。

对你的要求

熟悉 Rails 开发
我们希望你是一个热爱并专注技术的人，而不仅仅只是把写代码当成一个谋生的手段
热爱开源，习惯于在 linux 或 mac 系统下工作和写代码
我们喜欢多面手，如果你对其他技术方面也感兴趣的话我们非常欢迎

上班制度

我们的上班时间很正常，不提倡过度加班，同时也希望在工作时间大家能够保证较高的效率顺利完成开发任务

福利

MacBook Pro + 22 寸显示器
社保 5 险一金
餐补
交通补助
通讯补助

无论你是应届毕业生还是大牛，只要你对我们的项目感兴趣，都可以联系我们更进一步的聊聊，我们一定会尽量满足你在薪资方面的要求，上不封顶。

热烈欢迎上海的同学们过来骚扰~~

请将您的简历 (有 blog，github 地址的请一定写上) 发送到该邮箱，谢谢 : xfstart07#gmail.com

补充：由于公司的扩大，目前还有再招一两个人，还有大家投简历。

teahour 聊台湾软体业失落的十年

xfstart07 — Wed, 18 Dec 2013 00:28:15 +0800

teahour 又出了，这次是@xdite主持 http://teahour.fm/2013/12/16/software-industry-in-taiwan.html

使用 Bundler 并行安装 gem

xfstart07 — Sun, 01 Sep 2013 11:38:10 +0800

http://robots.thoughtbot.com/post/59584648154/parallel-gem-installing-using-bundler