Struct Object

Source

pub struct Object { /* private fields */ }

Available on crate feature dynamic-schema only.

Expand description

A GraphQL object type

§Examples

use async_graphql::{dynamic::*, value, Value};

let query = Object::new("Query").field(Field::new("value", TypeRef::named_nn(TypeRef::STRING), |ctx| {
    FieldFuture::new(async move { Ok(Some(Value::from("abc"))) })
}));


let schema = Schema::build(query.type_name(), None, None)
    .register(query)
    .finish()?;

assert_eq!(
   schema
       .execute("{ value }")
       .await
       .into_result()
       .unwrap()
       .data,
   value!({ "value": "abc" })
);

Implementations§

Source §

impl Object

Source

pub fn new(name: impl Into<String>) -> Self

Create a GraphQL object type

Source

pub fn description(self, description: impl Into<String>) -> Self

Set the description

Source

pub fn extends(self) -> Self

Indicates that an object or interface definition is an extension of another definition of that same type.

Source

pub fn shareable(self) -> Self

Indicate that an object type’s field is allowed to be resolved by multiple subgraphs

Source

pub fn inaccessible(self) -> Self

Indicate that an enum is not accessible from a supergraph when using Apollo Federation

Reference: https://www.apollographql.com/docs/federation/federated-types/federated-directives/#inaccessible

Source

pub fn interface_object(self) -> Self

During composition, the fields of every @interfaceObject are added both to their corresponding interface definition and to all entity types that implement that interface.

Reference: https://www.apollographql.com/docs/federation/federated-types/federated-directives/#interfaceobject

Source

pub fn tags<I: IntoIterator<Item = T>, T: Into<String>>(self, tags: I) -> Self

Arbitrary string metadata that will be propagated to the supergraph when using Apollo Federation. This attribute is repeatable

Reference: https://www.apollographql.com/docs/federation/federated-types/federated-directives/#applying-metadata

Source

pub fn directive(self, directive: Directive) -> Self

Attach directive to the entity

Source

pub fn field(self, field: Field) -> Self

Add an field to the object

Source

pub fn implement(self, interface: impl Into<String>) -> Self

Add an implement to the object

Source

pub fn key(self, fields: impl Into<String>) -> Self

Add an entity key

§Examples

use async_graphql::{Value, dynamic::*};

let obj = Object::new("MyObj")
    .field(Field::new("a", TypeRef::named(TypeRef::INT), |_| {
        FieldFuture::new(async move { Ok(Some(Value::from(10))) })
    }))
    .field(Field::new("b", TypeRef::named(TypeRef::INT), |_| {
        FieldFuture::new(async move { Ok(Some(Value::from(20))) })
    }))
    .field(Field::new("c", TypeRef::named(TypeRef::INT), |_| {
        FieldFuture::new(async move { Ok(Some(Value::from(30))) })
    }))
    .key("a b")
    .key("c");

Source

pub fn unresolvable(self, fields: impl Into<String>) -> Self

Make the entity unresolvable by the current subgraph

Most commonly used to reference an entity without contributing fields.

§Examples

use async_graphql::{Value, dynamic::*};

let obj = Object::new("MyObj")
    .field(Field::new("a", TypeRef::named(TypeRef::INT), |_| {
        FieldFuture::new(async move { Ok(Some(Value::from(10))) })
    }))
    .unresolvable("a");