Struct apollo_encoder::InterfaceDef

pub struct InterfaceDef { /* fields omitted */ }

InterfaceDefs are an abstract type where there are common fields declared.

Any type that implements an interface must define all the fields with names and types exactly matching. The implementations of this interface are explicitly listed out in possibleTypes.

InterfaceDefTypeDefinition: Description? interface Name ImplementsInterfaceDefs? Directives?

Detailed documentation can be found in GraphQL spec.

Example

use apollo_encoder::{Type_, Field, InterfaceDef};
use indoc::indoc;

let ty_1 = Type_::NamedType {
    name: "String".to_string(),
};

let ty_2 = Type_::NamedType {
    name: "String".to_string(),
};

let ty_3 = Type_::NonNull { ty: Box::new(ty_2) };
let ty_4 = Type_::List { ty: Box::new(ty_3) };
let ty_5 = Type_::NonNull { ty: Box::new(ty_4) };

let ty_6 = Type_::NamedType {
    name: "Boolean".to_string(),
};

let mut field_1 = Field::new("main".to_string(), ty_1);
field_1.description(Some("Cat's main dish of a meal.".to_string()));

let mut field_2 = Field::new("snack".to_string(), ty_5);
field_2.description(Some("Cat's post meal snack.".to_string()));

let mut field_3 = Field::new("pats".to_string(), ty_6);
field_3.description(Some("Does cat get a pat after meal?".to_string()));

// a schema definition
let mut interface = InterfaceDef::new("Meal".to_string());
interface.description(Some(
    "Meal interface for various\nmeals during the day.".to_string(),
));
interface.field(field_1);
interface.field(field_2);
interface.field(field_3);

assert_eq!(
    interface.to_string(),
    indoc! { r#"
    """
    Meal interface for various
    meals during the day.
    """
    interface Meal {
      "Cat's main dish of a meal."
      main: String
      "Cat's post meal snack."
      snack: [String!]!
      "Does cat get a pat after meal?"
      pats: Boolean
    }
    "# }
);

Implementations

impl InterfaceDef

pub fn new(name: String) -> Self

Create a new instance of InterfaceDef.

pub fn description(&mut self, description: Option<String>)

Set the schema def’s description.

pub fn interface(&mut self, interface: String)

Set the interfaces ObjectDef implements.

pub fn field(&mut self, field: Field)

Push a Field to schema def’s fields vector.

Trait Implementations

impl Clone for InterfaceDef

fn clone(&self) -> InterfaceDef

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for InterfaceDef

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for InterfaceDef

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.