2020-08-14 09:39:59 +12:00
|
|
|
defmodule AshGraphql.Resource.Query do
|
2020-08-15 02:20:47 +12:00
|
|
|
@moduledoc "Represents a configured query on a resource"
|
2021-06-30 04:17:33 +12:00
|
|
|
defstruct [
|
|
|
|
:name,
|
|
|
|
:action,
|
|
|
|
:type,
|
|
|
|
:identity,
|
|
|
|
:allow_nil?,
|
|
|
|
:modify_resolution,
|
|
|
|
as_mutation?: false
|
|
|
|
]
|
2020-08-14 09:39:59 +12:00
|
|
|
|
|
|
|
@get_schema [
|
|
|
|
name: [
|
|
|
|
type: :atom,
|
|
|
|
doc: "The name to use for the query.",
|
|
|
|
default: :get
|
|
|
|
],
|
|
|
|
action: [
|
|
|
|
type: :atom,
|
|
|
|
doc: "The action to use for the query.",
|
|
|
|
required: true
|
2020-11-18 20:14:33 +13:00
|
|
|
],
|
|
|
|
identity: [
|
|
|
|
type: :atom,
|
2021-05-23 15:49:31 +12:00
|
|
|
doc: "The identity to use for looking up the record. Pass `false` to not use an identity.",
|
2020-11-18 20:14:33 +13:00
|
|
|
required: false
|
2021-04-06 02:36:52 +12:00
|
|
|
],
|
|
|
|
allow_nil?: [
|
|
|
|
type: :boolean,
|
|
|
|
default: true,
|
|
|
|
doc: "Whether or not the action can return nil."
|
2021-06-30 04:17:33 +12:00
|
|
|
],
|
|
|
|
modify_resolution: [
|
|
|
|
type: :mfa,
|
|
|
|
doc: """
|
|
|
|
An MFA that will be called with the resolution, the query, and the result of the action as the first three arguments (followed by the arguments in the mfa).
|
|
|
|
Must return a new absinthe resolution. This can be used to implement things like setting cookies based on resource actions. A method of using resolution context
|
|
|
|
for that is documented here: https://hexdocs.pm/absinthe_plug/Absinthe.Plug.html#module-before-send
|
|
|
|
|
|
|
|
*Important* if you are modifying the context, then you should also set `as_mutation?` to true and represent
|
|
|
|
this in your graphql as a mutation. See `as_mutation?` for more.
|
|
|
|
"""
|
|
|
|
],
|
|
|
|
as_mutation?: [
|
|
|
|
type: :boolean,
|
|
|
|
default: false,
|
|
|
|
doc: """
|
|
|
|
Places the query in the `mutations` key instead. The use cases for this are likely very minimal.
|
|
|
|
|
|
|
|
If you have a query that needs to modify the graphql context using `modify_resolution`, then you
|
|
|
|
should likely set this as well. A simple example might be a `log_in`, which could be a read
|
|
|
|
action on the user that accepts an email/password, and should then set some context in the graphql
|
|
|
|
inside of `modify_resolution`. Once in the context, you can see the guide referenced in `modify_resolution`
|
|
|
|
for more on setting the session or a cookie with an auth token.
|
|
|
|
"""
|
2020-08-14 09:39:59 +12:00
|
|
|
]
|
|
|
|
]
|
|
|
|
|
2021-04-04 19:10:50 +12:00
|
|
|
@read_one_schema [
|
|
|
|
name: [
|
|
|
|
type: :atom,
|
|
|
|
doc: "The name to use for the query.",
|
|
|
|
default: :read_one
|
|
|
|
],
|
|
|
|
action: [
|
|
|
|
type: :atom,
|
|
|
|
doc: "The action to use for the query.",
|
|
|
|
required: true
|
2021-04-06 02:36:52 +12:00
|
|
|
],
|
|
|
|
allow_nil?: [
|
|
|
|
type: :boolean,
|
|
|
|
default: true,
|
|
|
|
doc: "Whether or not the action can return nil."
|
2021-04-04 19:10:50 +12:00
|
|
|
]
|
|
|
|
]
|
|
|
|
|
2020-08-14 09:39:59 +12:00
|
|
|
@list_schema [
|
|
|
|
name: [
|
|
|
|
type: :atom,
|
|
|
|
doc: "The name to use for the query.",
|
|
|
|
default: :list
|
|
|
|
],
|
|
|
|
action: [
|
|
|
|
type: :atom,
|
|
|
|
doc: "The action to use for the query.",
|
|
|
|
required: true
|
|
|
|
]
|
|
|
|
]
|
|
|
|
|
|
|
|
def get_schema, do: @get_schema
|
2021-04-04 19:10:50 +12:00
|
|
|
def read_one_schema, do: @read_one_schema
|
2020-08-14 09:39:59 +12:00
|
|
|
def list_schema, do: @list_schema
|
|
|
|
end
|