не могу понять какие кейсы применения этого инструмента. Он для генерации SDL из каких-то других метаданных, например, хранящихся или предоставляемых в другой структуре?
https://github.com/graphql-compose/graphql-compose
Для своих редакторов?
это единственное применение или есть какие то еще кейсы?
Читай что это билдер схемы как и многие другие, только чуть более низкоуровневый
Но зачем? Можно это сделать удобнее расширением uml и трансформацией модели по шаблону.
Не знаю что такое uml и не очень понял про какую модель речь, модель БД?
Uml-модель (диаграмму классов)
graphql-compose это обертка над graphql-js. graphql-js строит схему из конфига GraphQLObjectType и ежие с ними вложенными объектами. graphql-compose позволяет этот конфиг собрать программным путем при запуске сервера. Т.е. он предоставляет регистр типов, SDL сахар создания этих самых типов и кучу методов для проверки наличия/создания/удаления полей, аргументов. Один из кейсов, есть большая graphql-схема и надо сгенерировать из нее публичную урезанную схему и админскую. Другой кейс, есть mongoose модели или typeorm или elasticserch маппинги - так вот из них моно на автомате генерить графкуэль типы, удалять “секурные поля” и уже потом конструировать схему. Т.е. исчезает прописывание одних и тех же полей по два раза (в схеме модели и в графкуэль типе). — Все популярные js инструменты, типа graphql-tools, typegraphql, graphql-compose, nexus, gqtx, graphql mesh - занимаются тем, что тем или иным способом строят инстанс GraphQLSchema чтобы ее передать в пакет graphql-js, который будет выполняет в рантайме запросы на вашей схеме. Т.е. пакет graphql-js фокусируется на рантайме и предоставляет классы типов, чтоб вы ему собрали схему в виде древовидного “конфига”. И кто собирал это дело руками, знает насколько муторно все это дело и пытаются тем или иным способом все это дело упростить, построив поверх свой абстрактный уровень с методами помогайками. Отличие graphql-compose от всех остальных конструкторов схем в том, что можно схему строить на базе стандартных логических операторов. Например, если схема не админская, то в типе юзер удали поле email: if (process.env.APP_ROLE !== ‘admin’) { if (UserTC.hasField(‘email’) { UserTC.removeField(‘email’); } }
@nodkz , Павел, а если необходимо далее по собранной таким или другим образом схеме нагенерировать реализации резолверов под произвольный язык (C# к примеру), какие наиболее удобные есть способы обходить gql-схему? Может ли здесь чем то помочь compose?
Нее graphql-compose тут не поможет, он только под JS заточен. Возможно стоить посмотреть в сторону graphql-codegen и под него писать свои плагины. Но для его работы в начале должна уже должна быть GraphQL схема.
ну генерить то все равно что - это же просто текст (шаблонизатор какой-либо на дерево или объектное представление его). Тот же Gatsby генерит же текст по сути получая данные через gql.
Обсуждают сегодня