{"id":471246,"date":"2025-08-19T15:01:02","date_gmt":"2025-08-19T15:01:02","guid":{"rendered":"http:\/\/savepearlharbor.com\/?p=471246"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=471246","title":{"rendered":"\u0413\u0430\u0439\u0434 \u043f\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044e Spring GraphQL. \u0427\u0430\u0441\u0442\u044c 3<\/span>"},"content":{"rendered":"
<\/div>\n
\n
\n
\n
\n

\u041f\u0440\u0438\u0432\u0435\u0442, \u0425\u0430\u0431\u0440!<\/p>\n

\u041c\u0435\u043d\u044f \u0437\u043e\u0432\u0443\u0442 \u0414\u043c\u0438\u0442\u0440\u0438\u0439, \u044f \u0431\u044d\u043a\u0435\u043d\u0434-\u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a \u0432 SENSE<\/a> \u0438 \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u0438\u0435 10 \u043b\u0435\u0442 \u043f\u0438\u0448\u0443 \u0441\u0435\u0440\u0432\u0435\u0440\u043d\u0443\u044e \u0447\u0430\u0441\u0442\u044c \u043d\u0430 Java. \u042d\u0442\u0430 \u0441\u0442\u0430\u0442\u044c\u044f\u00a0\u2014 \u043f\u0440\u043e\u0434\u043e\u043b\u0436\u0435\u043d\u0438\u0435 \u0441\u0435\u0440\u0438\u0438 \u0433\u0430\u0439\u0434\u043e\u0432 \u043f\u043e Spring GraphQL, \u0433\u0434\u0435 \u0432 \u043f\u0435\u0440\u0432\u043e\u0439 \u0447\u0430\u0441\u0442\u0438<\/a> \u043c\u044b \u0441 \u043d\u0443\u043b\u044f \u043f\u043e\u0434\u043d\u044f\u043b\u0438 \u043f\u0440\u043e\u0435\u043a\u0442 \u0438 \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0438\u043b\u0438 GraphQL \u043a Spring Boot, \u0430 \u0432\u043e \u0432\u0442\u043e\u0440\u043e\u0439<\/a> \u0440\u0430\u0437\u043e\u0431\u0440\u0430\u043b\u0438\u0441\u044c \u0441 SchemaMapping, DataLoader \u0438 \u0440\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u0435\u0439 \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432 \u043f\u043e\u0441\u043b\u043e\u0436\u043d\u0435\u0435.<\/p>\n

\u0421\u0435\u0433\u043e\u0434\u043d\u044f \u0434\u0432\u0438\u0433\u0430\u0435\u043c\u0441\u044f \u0434\u0430\u043b\u044c\u0448\u0435: \u0440\u0430\u0437\u0431\u0435\u0440\u0451\u043c \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044e \u0434\u0430\u043d\u043d\u044b\u0445, \u0440\u0430\u0431\u043e\u0442\u0443 \u0441 \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043a\u0430\u043c\u0438 (headers), \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0443 \u043e\u0448\u0438\u0431\u043e\u043a, \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0435 \u043a\u0430\u0441\u0442\u043e\u043c\u043d\u044b\u0445 \u0441\u043a\u0430\u043b\u044f\u0440\u043e\u0432 \u0438 \u0434\u0438\u0440\u0435\u043a\u0442\u0438\u0432. \u0410 \u0435\u0449\u0451 \u043f\u043e\u0441\u043c\u043e\u0442\u0440\u0438\u043c, \u043a\u0430\u043a \u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u0441 \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441\u0430\u043c\u0438 \u0438 union-\u0442\u0438\u043f\u0430\u043c\u0438 \u0438 \u043d\u0430\u043f\u0438\u0448\u0435\u043c \u043a\u043b\u0438\u0435\u043d\u0442 \u0434\u043b\u044f GraphQL-\u0441\u0435\u0440\u0432\u0438\u0441\u0430.<\/p>\n

\u041f\u043e\u0435\u0445\u0430\u043b\u0438!<\/p>\n

\u0412\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044f \u0434\u0430\u043d\u043d\u044b\u0445<\/h2>\n

\u0412\u044b \u0443\u0436\u0435 \u0447\u0430\u0441\u0442\u0438\u0447\u043d\u043e \u043a\u043e\u0441\u043d\u0443\u043b\u0438\u0441\u044c \u044d\u0442\u043e\u0439 \u0442\u0435\u043c\u044b \u043f\u0440\u0438 \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u0438 \u0441\u0445\u0435\u043c\u044b \u0438 \u0434\u043e\u0431\u0430\u0432\u043b\u0435\u043d\u0438\u0438 \u00ab!\u00bb \u0432 \u0441\u0445\u0435\u043c\u0443 graphQL. \u041d\u043e \u0447\u0442\u043e, \u0435\u0441\u043b\u0438 \u043d\u0443\u0436\u043d\u0430 \u0431\u043e\u043b\u0435\u0435 \u0441\u043b\u043e\u0436\u043d\u0430\u044f \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044f?\u00a0<\/p>\n

\u0414\u043b\u044f \u044d\u0442\u043e\u0433\u043e \u0443 \u043d\u0430\u0441 \u0435\u0441\u0442\u044c \u0434\u0432\u0430 \u043e\u0441\u043d\u043e\u0432\u043d\u044b\u0445 \u0441\u043f\u043e\u0441\u043e\u0431\u0430:<\/p>\n

    \n
  1. \n

    \u0421\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u0430\u044f \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044f \u0447\u0435\u0440\u0435\u0437 jakarta.validation;<\/p>\n<\/li>\n

  2. \n

    \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435 graphQL directive.<\/p>\n<\/li>\n<\/ol>\n

    \u0420\u0430\u0441\u0441\u043c\u043e\u0442\u0440\u0438\u043c \u043f\u043b\u044e\u0441\u044b \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u043f\u043e\u0434\u0445\u043e\u0434\u0430:<\/p>\n

    \n
    \n\n\n\n\n\n
    \n

    Jakarta Validation<\/strong><\/p>\n<\/td>\n

    		\n

    GraphQL-\u0434\u0438\u0440\u0435\u043a\u0442\u0438\u0432\u0430<\/strong><\/p>\n<\/td>\n<\/tr>\n

    \n

    1. \u0421\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u0430\u044f \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044f<\/strong>: Jakarta Validation \u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u043c API \u0434\u043b\u044f \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u0438 \u0434\u0430\u043d\u043d\u044b\u0445 \u0432 Java, \u044d\u0442\u043e \u043e\u0437\u043d\u0430\u0447\u0430\u0435\u0442, \u0447\u0442\u043e \u0432\u044b \u043c\u043e\u0436\u0435\u0442\u0435 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0435\u0433\u043e \u0434\u043b\u044f \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u0438 \u0434\u0430\u043d\u043d\u044b\u0445 \u0432 \u043b\u044e\u0431\u043e\u043c \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0438, \u043d\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u0432 GraphQL.<\/p>\n<\/td>\n

    		\n

    1. \u041f\u0440\u044f\u043c\u0430\u044f \u0438\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u044f \u0441 GraphQL<\/strong>: GraphQL-\u0434\u0438\u0440\u0435\u043a\u0442\u0438\u0432\u0430 \u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0447\u0430\u0441\u0442\u044c\u044e GraphQL-\u0441\u0445\u0435\u043c\u044b, \u044d\u0442\u043e \u043e\u0437\u043d\u0430\u0447\u0430\u0435\u0442, \u0447\u0442\u043e \u0432\u044b \u043c\u043e\u0436\u0435\u0442\u0435 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0435\u0435 \u043d\u0430\u043f\u0440\u044f\u043c\u0443\u044e \u0432 \u0432\u0430\u0448\u0438\u0445 GraphQL-\u0437\u0430\u043f\u0440\u043e\u0441\u0430\u0445.<\/p>\n<\/td>\n<\/tr>\n

    \n

    2. \u041b\u0435\u0433\u043a\u0430\u044f \u0438\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u044f<\/strong>: Jakarta Validation \u043b\u0435\u0433\u043a\u043e \u0438\u043d\u0442\u0435\u0433\u0440\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u0441 \u0431\u043e\u043b\u044c\u0448\u0438\u043d\u0441\u0442\u0432\u043e\u043c \u0444\u0440\u0435\u0439\u043c\u0432\u043e\u0440\u043a\u043e\u0432 \u0438 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a, \u0432\u043a\u043b\u044e\u0447\u0430\u044f GraphQL.<\/p>\n<\/td>\n

    		\n

    2. \u041b\u0435\u0433\u043a\u0430\u044f \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044f<\/strong>: GraphQL-\u0434\u0438\u0440\u0435\u043a\u0442\u0438\u0432\u0430 \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u043b\u0435\u0433\u043a\u043e \u0432\u0430\u043b\u0438\u0434\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0434\u0430\u043d\u043d\u044b\u0435 \u0432 GraphQL-\u0437\u0430\u043f\u0440\u043e\u0441\u0430\u0445, \u0431\u0435\u0437 \u043d\u0435\u043e\u0431\u0445\u043e\u0434\u0438\u043c\u043e\u0441\u0442\u0438 \u0434\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u043e\u0439 \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u0438.<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n

    \u0414\u043b\u044f \u043f\u0440\u0438\u043c\u0435\u0440\u0430: \u0440\u0435\u0430\u043b\u0438\u0437\u0443\u0435\u043c \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044e \u043d\u0430 \u043f\u0440\u0435\u0432\u044b\u0448\u0435\u043d\u0438\u0435 \u043c\u0430\u043a\u0441\u0438\u043c\u0430\u043b\u044c\u043d\u043e\u0433\u043e \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f Integer.<\/p>\n

    \u0420\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f \u0447\u0435\u0440\u0435\u0437 Jakarta Validation<\/h2>\n

    \u041f\u043e\u0434\u043a\u043b\u044e\u0447\u0438\u0442\u0435 \u0441\u0442\u0430\u0440\u0442\u0435\u0440:<\/p>\n

    <dependency>    <groupId>org.springframework.boot<\/groupId>    <artifactId>spring-boot-starter-validation<\/artifactId> <\/dependency><\/code><\/pre>\n
    \u0420\u0435\u0430\u043b\u0438\u0437\u0443\u0439\u0442\u0435 \u0430\u043d\u043d\u043e\u0442\u0430\u0446\u0438\u044e:<\/p>\n
    @Target(ElementType.PARAMETER) @Retention(RetentionPolicy.RUNTIME) @Constraint(validatedBy = MaxIntValidator.class) public @interface MaxInt {    int value();    String message() default \"\u041f\u0440\u0435\u0432\u044b\u0448\u0435\u043d\u043e \u043c\u0430\u043a\u0441\u0438\u043c\u0430\u043b\u044c\u043d\u043e\u0435 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0435\";    Class<?>[] groups() default {};    Class<? extends Payload>[] payload() default {}; }<\/code><\/pre>\n
    public class MaxIntValidator implements ConstraintValidator<MaxInt, Integer> {     private int max;     @Override    public void initialize(MaxInt maxInt) {        max = maxInt.value();    }     @Override    public boolean isValid(Integer value, ConstraintValidatorContext context) {        return value <= max;    } }<\/code><\/pre>\n
    \u0414\u043e\u0431\u0430\u0432\u044c\u0442\u0435 \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044e \u0437\u0430\u043f\u0440\u043e\u0441\u0443:<\/p>\n
    @QueryMapping public List<Author> getAuthors(@Argument @MaxInt(1) Integer filter) {    return dataBaseService.getAuthors(filter); }<\/code><\/pre>\n
    \u0420\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f \u0447\u0435\u0440\u0435\u0437 \u0434\u0438\u0440\u0435\u043a\u0442\u0438\u0432\u0443<\/h2>\n
    \u0421\u043e\u0437\u0434\u0430\u0439\u0442\u0435 \u043d\u0435\u043f\u043e\u0441\u0440\u0435\u0434\u0441\u0442\u0432\u0435\u043d\u043d\u043e \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a:<\/p>\n
    public class MaxIntDirective implements SchemaDirectiveWiring {     @Override    public GraphQLArgument onArgument(SchemaDirectiveWiringEnvironment<GraphQLArgument> env) {        GraphQLArgument argument = env.getElement();        DataFetcher<?> originalDataFetcher = env.getFieldDataFetcher();         \/\/ \u041f\u043e\u043b\u0443\u0447\u0430\u0435\u043c \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u0434\u0438\u0440\u0435\u043a\u0442\u0438\u0432\u044b        GraphQLAppliedDirective directive = env.getAppliedDirective();        Integer maxLength = directive.getArgument(\"value\").getValue();         \/\/ \u041e\u0431\u043e\u0440\u0430\u0447\u0438\u0432\u0430\u0435\u043c \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b\u044c\u043d\u044b\u0439 DataFetcher        DataFetcher<?> wrappedDataFetcher = dataFetchingEnvironment -> {            Integer argumentValue = dataFetchingEnvironment.getArgument(argument.getName());             \/\/ \u0412\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044f            if (argumentValue > maxLength) {                throw new IllegalArgumentException(                        \"\u041f\u0440\u0435\u0432\u044b\u0448\u0435\u043d\u0438\u0435 \u0434\u043b\u0438\u043d\u044b \" + maxLength);            }             return originalDataFetcher.get(dataFetchingEnvironment);        };         \/\/ \u0417\u0430\u043c\u0435\u043d\u044f\u0435\u043c DataFetcher        env.setFieldDataFetcher(wrappedDataFetcher);         return argument;    } }<\/code><\/pre>\n
    \u0417\u0430\u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u0443\u0439\u0442\u0435 \u0435\u0433\u043e \u0432 \u0441\u0445\u0435\u043c\u0435:<\/p>\n
    @Configuration public class GraphqlExtendedConfig {     @Bean    public RuntimeWiringConfigurer runtimeWiringConfigurer() {        return wiringBuilder -> wiringBuilder                .directive(\"MaxInt\", new MaxIntDirective());    }  }<\/code><\/pre>\n
    \u0421\u043e\u0437\u0434\u0430\u0439\u0442\u0435 \u0444\u0430\u0439\u043b directives.graphqls<\/code> \u0441 \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u043c\u044b\u043c:<\/p>\n
    directive @MaxInt(value: Int!) on ARGUMENT_DEFINITION<\/code><\/pre>\n
    \u0414\u043e\u0431\u0430\u0432\u044c\u0442\u0435 \u0434\u0438\u0440\u0435\u043a\u0442\u0438\u0432\u0443 \u043a \u0437\u0430\u043f\u0440\u043e\u0441\u0443:<\/p>\n
    \"\u041f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u0432\u0441\u0435\u0445 \u0430\u0432\u0442\u043e\u0440\u043e\u0432\" getAuthors(filter: Int @MaxInt(value: 4)): [Author!]!<\/code><\/pre>\n
    \u0422\u0430\u043a\u0436\u0435 \u0435\u0441\u0442\u044c \u0434\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u0430\u044f \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430 \u0434\u043b\u044f \u0440\u0430\u0431\u043e\u0442\u044b \u0441 \u0434\u0438\u0440\u0435\u043a\u0442\u0438\u0432\u0430\u043c\u0438 \u0438 \u0440\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u0435\u0439 \u0447\u0435\u0440\u0435\u0437 AbstractDirectiveConstraint<\/code>:<\/p>\n
    <dependency>    <groupId>com.graphql-java<\/groupId>    <artifactId>graphql-java-extended-validation<\/artifactId>    <version>${graphql-java.version}<\/version> <\/dependency><\/code><\/pre>\n
    \u041e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0430 \u043e\u0448\u0438\u0431\u043e\u043a<\/h2>\n
    \u0420\u0430\u043d\u0435\u0435 \u0432\u044b \u0440\u0435\u0430\u043b\u0438\u0437\u043e\u0432\u0430\u043b\u0438 \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044e, \u043d\u043e \u043d\u0435 \u0440\u0435\u0430\u043b\u0438\u0437\u043e\u0432\u0430\u043b\u0438 \u043a\u043e\u0440\u0440\u0435\u043a\u0442\u043d\u0443\u044e \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0443 \u043e\u0448\u0438\u0431\u043e\u043a.<\/p>\n
    \u0421\u0435\u0439\u0447\u0430\u0441, \u043f\u0440\u0438 \u043f\u0440\u0435\u0432\u044b\u0448\u0435\u043d\u0438\u0438 MaxInt, \u0432\u044b \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u0435 \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0443\u044e \u043e\u0448\u0438\u0431\u043a\u0443:<\/p>\n
    {  \"errors\": [    {      \"message\": \"INTERNAL_ERROR for 7e3b7163-20da-2136-545a-38e1eef5f90e\",      \"locations\": [        {          \"line\": 2,          \"column\": 3        }      ],      \"path\": [        \"getAuthors\"      ],      \"extensions\": {        \"classification\": \"INTERNAL_ERROR\"      }    }  ],  \"data\": null }<\/code><\/pre>\n
    \u0414\u043b\u044f \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0438 \u043e\u0448\u0438\u0431\u043e\u043a \u0432\u044b \u043c\u043e\u0436\u0435\u0442\u0435 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c DataFetcherExceptionResolverAdapter<\/code> \u0438 \u0432\u044b\u0431\u0440\u0430\u0441\u044b\u0432\u0430\u0442\u044c GraphQLError<\/code> (\u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441 \u0438\u0437 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438 graphql-java):<\/p>\n
    @Component @Slf4j public class CustomExceptionResolver extends DataFetcherExceptionResolverAdapter {     @Override    @SuppressWarnings(value = \"checkstyle:CyclomaticComplexity\")    protected GraphQLError resolveToSingleError(Throwable ex, DataFetchingEnvironment env) {       if (ex instanceof ConstraintViolationException                || ex instanceof MyError) {            return createError(ex, env, ValidationError);        } else {            return null;        }    }     private GraphQLError createError(            Throwable ex,            DataFetchingEnvironment env,            ErrorClassification classification) {        log.warn(ex.getMessage());        return GraphqlErrorBuilder.newError()                .errorType(classification)                .extensions(Map.of(\"myField\", \"my text\"))                .message(ex.getMessage())                .path(env.getExecutionStepInfo().getPath())                .location(env.getField().getSourceLocation())                .build();    }  }<\/code><\/pre>\n
    \u0412 errorType \u0432\u044b \u043c\u043e\u0436\u0435\u0442\u0435 \u043f\u0435\u0440\u0435\u0434\u0430\u0432\u0430\u0442\u044c \u0433\u043e\u0442\u043e\u0432\u044b\u0435 \u0442\u0438\u043f\u044b:<\/p>\n