Absinthe este setul complet de instrumente GraphQL pentru aplicatii Elixir si Phoenix.
Concepte fundamentale (Core Concepts)
- Schema: Definitia radacina a interogarilor, mutatiilor si tipurilor.
- Resolver: Functia Elixir responsabila pentru preluarea sau modificarea datelor.
- Type: Defineste structura si campurile entitatilor de date.
Integrare Plug în Phoenix
# web/router.ex
defmodule Blog.Web.Router do
use Phoenix.Router
forward "/api", Absinthe.Plug,
schema: Blog.Schema
end
Absinthe functioneaza ca un Plug acceptand configuratia schemei radacina.
Definirea schemei (Schema Definition)
# web/schema.ex
defmodule Blog.Schema do
use Absinthe.Schema
import_types Blog.Schema.Types
query do
@desc "Get a list of blog posts"
field :posts, list_of(:post) do
resolve &Blog.PostResolver.all/2
end
end
end
Raspunde la { posts { ... } } si delega executia catre resolver.
Resolvere (Resolvers)
# web/resolvers/post_resolver.ex
defmodule Blog.PostResolver do
def all(_args, _info) do
{:ok, Blog.Repo.all(Blog.Post)}
end
end
Resolverii returneaza {:ok, result} sau {:error, reason}.
Tipuri personalizate (Custom Types)
# web/schema/types.ex
defmodule Blog.Schema.Types do
use Absinthe.Schema.Notation
@desc "A blog post entity"
object :post do
field :id, :id
field :title, :string
field :body, :string
end
end
Interogări și mutații (Queries & Mutations)
Argumente de interogare
{
user(id: "1") {
name
email
}
}
# web/schema.ex
query do
field :user, type: :user do
arg :id, non_null(:id)
resolve &Blog.UserResolver.find/2
end
end
def find(%{id: id} = _args, _info) do
case Blog.Accounts.get_user(id) do
nil -> {:error, "User not found"}
user -> {:ok, user}
end
end
Mutații (Mutations)
mutation CreatePost {
post(title: "Hello World") {
id
title
}
}
# web/schema.ex
mutation do
@desc "Create a new post"
field :post, type: :post do
arg :title, non_null(:string)
resolve &Blog.PostResolver.create/2
end
end