-
Notifications
You must be signed in to change notification settings - Fork 301
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
User configured PreParsedDocumentProvider should be used for regular queries when APQ feature is enabled. #2128
Changes from 6 commits
af44d5d
05aa4cb
022d23b
4503d97
a1b1909
4b1afe2
b2dc0cc
70c84af
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -20,4 +20,8 @@ management: | |
exposure: | ||
include: | ||
- metrics | ||
debug: true | ||
debug: true | ||
dgs: | ||
graphql: | ||
apq: | ||
enabled: true |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,47 @@ | ||
/* | ||
* Copyright 2025 Netflix, Inc. | ||
* | ||
* Licensed under the Apache License, Version 2.0 (the "License"); | ||
* you may not use this file except in compliance with the License. | ||
* You may obtain a copy of the License at | ||
* | ||
* http://www.apache.org/licenses/LICENSE-2.0 | ||
* | ||
* Unless required by applicable law or agreed to in writing, software | ||
* distributed under the License is distributed on an "AS IS" BASIS, | ||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
* See the License for the specific language governing permissions and | ||
* limitations under the License. | ||
*/ | ||
|
||
package com.netflix.graphql.dgs.apq | ||
|
||
import graphql.ExecutionInput | ||
import graphql.execution.preparsed.PreparsedDocumentEntry | ||
import graphql.execution.preparsed.PreparsedDocumentProvider | ||
import graphql.execution.preparsed.persisted.ApolloPersistedQuerySupport | ||
import graphql.execution.preparsed.persisted.PersistedQueryCache | ||
import java.util.* | ||
import java.util.concurrent.CompletableFuture | ||
import java.util.function.Function | ||
|
||
class DgsAPQPreParsedDocumentProvider( | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Could be a more descriptive name, e.g. it should communicate that this is really a wrapper |
||
persistedQueryCache: PersistedQueryCache, | ||
private val preparsedDocumentProvider: Optional<PreparsedDocumentProvider>, | ||
) : ApolloPersistedQuerySupport(persistedQueryCache) { | ||
override fun getDocumentAsync( | ||
executionInput: ExecutionInput, | ||
parseAndValidateFunction: Function<ExecutionInput, PreparsedDocumentEntry>, | ||
): CompletableFuture<PreparsedDocumentEntry> { | ||
val queryId = getPersistedQueryId(executionInput) | ||
if (queryId.isPresent) { | ||
return super.getDocumentAsync(executionInput, parseAndValidateFunction) | ||
} | ||
|
||
if (preparsedDocumentProvider.isPresent) { | ||
return preparsedDocumentProvider.get().getDocumentAsync(executionInput, parseAndValidateFunction) | ||
} | ||
|
||
return CompletableFuture.completedFuture(parseAndValidateFunction.apply(executionInput)) | ||
} | ||
} |
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -491,12 +491,14 @@ open class DgsSpringGraphQLAutoConfiguration( | |
@Qualifier("query") providedQueryExecutionStrategy: Optional<ExecutionStrategy>, | ||
@Qualifier("mutation") providedMutationExecutionStrategy: Optional<ExecutionStrategy>, | ||
dataFetcherExceptionHandler: DataFetcherExceptionHandler, | ||
environment: Environment, | ||
): GraphQlSourceBuilderCustomizer = | ||
GraphQlSourceBuilderCustomizer { builder -> | ||
builder.configureGraphQl { graphQlBuilder -> | ||
if (preparsedDocumentProvider.isPresent) { | ||
graphQlBuilder | ||
.preparsedDocumentProvider(preparsedDocumentProvider.get()) | ||
val apqEnabled = environment.getProperty("dgs.graphql.apq.enabled", Boolean::class.java, false) | ||
// if apq is enabled use the APQPreparsedDocumentProvider instead | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Comment and if statement don't seem to match? The if statement checks for apq NOT being enabled? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Will clarify the comment - basically we don't want the code in the block to be used if apq is enabled. |
||
if (preparsedDocumentProvider.isPresent && !apqEnabled) { | ||
graphQlBuilder.preparsedDocumentProvider(preparsedDocumentProvider.get()) | ||
} | ||
|
||
if (providedQueryExecutionStrategy.isPresent) { | ||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,126 @@ | ||
/* | ||
* Copyright 2025 Netflix, Inc. | ||
* | ||
* Licensed under the Apache License, Version 2.0 (the "License"); | ||
* you may not use this file except in compliance with the License. | ||
* You may obtain a copy of the License at | ||
* | ||
* http://www.apache.org/licenses/LICENSE-2.0 | ||
* | ||
* Unless required by applicable law or agreed to in writing, software | ||
* distributed under the License is distributed on an "AS IS" BASIS, | ||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
* See the License for the specific language governing permissions and | ||
* limitations under the License. | ||
*/ | ||
|
||
package com.netflix.graphql.dgs.springgraphql.apq | ||
|
||
import com.netflix.graphql.dgs.apq.DgsAPQPreParsedDocumentProvider | ||
import graphql.ExecutionInput | ||
import graphql.execution.preparsed.PreparsedDocumentEntry | ||
import graphql.execution.preparsed.PreparsedDocumentProvider | ||
import graphql.execution.preparsed.persisted.PersistedQueryCache | ||
import graphql.execution.preparsed.persisted.PersistedQuerySupport.PERSISTED_QUERY_MARKER | ||
import graphql.language.Document | ||
import io.mockk.every | ||
import io.mockk.impl.annotations.MockK | ||
import io.mockk.junit5.MockKExtension | ||
import io.mockk.mockk | ||
import org.assertj.core.api.Assertions.assertThat | ||
import org.junit.jupiter.api.BeforeEach | ||
import org.junit.jupiter.api.Test | ||
import org.junit.jupiter.api.extension.ExtendWith | ||
import org.springframework.beans.factory.annotation.Autowired | ||
import java.util.* | ||
import java.util.concurrent.CompletableFuture | ||
|
||
@ExtendWith(MockKExtension::class) | ||
class DgsAPQPreParsedDocumentProviderTest { | ||
@Autowired | ||
private lateinit var dgsAPQPreParsedDocumentProvider: DgsAPQPreParsedDocumentProvider | ||
|
||
@MockK | ||
lateinit var preparsedDocumentProvider: PreparsedDocumentProvider | ||
|
||
@MockK | ||
lateinit var persistedQueryCache: PersistedQueryCache | ||
|
||
@BeforeEach | ||
fun setUp() { | ||
dgsAPQPreParsedDocumentProvider = DgsAPQPreParsedDocumentProvider(persistedQueryCache, Optional.of(preparsedDocumentProvider)) | ||
} | ||
|
||
@Test | ||
fun `APQ only queries with just the hash use the persisted query cache`() { | ||
var count = 0 | ||
val document = mockk<Document>() | ||
val computeFunction = { _: ExecutionInput -> | ||
count++ | ||
PreparsedDocumentEntry(document) | ||
} | ||
val extensions: MutableMap<String, Any> = HashMap() | ||
extensions["persistedQuery"] = | ||
mapOf("version" to "1", "sha256Hash" to "ecf4edb46db40b5132295c0291d62fb65d6759a9eedfa4d5d612dd5ec54a6b38") | ||
val executionInput = | ||
ExecutionInput | ||
.Builder() | ||
.query(PERSISTED_QUERY_MARKER) | ||
.extensions(extensions) | ||
.build() | ||
|
||
every { | ||
persistedQueryCache.getPersistedQueryDocumentAsync(any(), any(), any()) | ||
}.returns(CompletableFuture.completedFuture(computeFunction(executionInput))) | ||
|
||
dgsAPQPreParsedDocumentProvider.getDocumentAsync(executionInput, computeFunction) | ||
assertThat(count == 1) | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
|
||
} | ||
|
||
@Test | ||
fun `APQ queries with query and hash use the persisted query cache`() { | ||
var count = 0 | ||
val document = mockk<Document>() | ||
val computeFunction = { _: ExecutionInput -> | ||
count++ | ||
PreparsedDocumentEntry(document) | ||
} | ||
val extensions: MutableMap<String, Any> = HashMap() | ||
extensions["persistedQuery"] = | ||
mapOf("version" to "1", "sha256Hash" to "ecf4edb46db40b5132295c0291d62fb65d6759a9eedfa4d5d612dd5ec54a6b38") | ||
val executionInput = | ||
ExecutionInput | ||
.Builder() | ||
.query("{__typename}") | ||
.extensions(extensions) | ||
.build() | ||
|
||
every { | ||
persistedQueryCache.getPersistedQueryDocumentAsync(any(), any(), any()) | ||
}.returns(CompletableFuture.completedFuture(computeFunction(executionInput))) | ||
|
||
dgsAPQPreParsedDocumentProvider.getDocumentAsync(executionInput, computeFunction) | ||
assertThat(count == 1) | ||
} | ||
|
||
@Test | ||
fun `Plain queries (non-APQ) use the user specified preparsed document provider`() { | ||
var count = 0 | ||
val document = mockk<Document>() | ||
val computeFunction = { _: ExecutionInput -> | ||
count++ | ||
PreparsedDocumentEntry(document) | ||
} | ||
val extensions: MutableMap<String, Any> = HashMap() | ||
extensions["persistedQuery"] = | ||
mapOf("version" to "1", "sha256Hash" to "ecf4edb46db40b5132295c0291d62fb65d6759a9eedfa4d5d612dd5ec54a6b38") | ||
val executionInput = ExecutionInput.Builder().query("{__typename}").build() | ||
|
||
every { | ||
preparsedDocumentProvider.getDocumentAsync(executionInput, any()) | ||
}.returns(CompletableFuture.completedFuture(computeFunction(executionInput))) | ||
|
||
dgsAPQPreParsedDocumentProvider.getDocumentAsync(executionInput, computeFunction) | ||
assertThat(count == 1) | ||
} | ||
} |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,63 @@ | ||
/* | ||
* Copyright 2024 Netflix, Inc. | ||
* | ||
* Licensed under the Apache License, Version 2.0 (the "License"); | ||
* you may not use this file except in compliance with the License. | ||
* You may obtain a copy of the License at | ||
* | ||
* http://www.apache.org/licenses/LICENSE-2.0 | ||
* | ||
* Unless required by applicable law or agreed to in writing, software | ||
* distributed under the License is distributed on an "AS IS" BASIS, | ||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
* See the License for the specific language governing permissions and | ||
* limitations under the License. | ||
*/ | ||
|
||
package com.netflix.graphql.dgs.springgraphql.autoconfig | ||
|
||
import com.netflix.graphql.dgs.apq.DgsAPQSupportAutoConfiguration | ||
import graphql.execution.preparsed.persisted.PersistedQueryCache | ||
import org.assertj.core.api.Assertions.assertThat | ||
import org.junit.jupiter.api.Test | ||
import org.springframework.boot.autoconfigure.AutoConfigurations | ||
import org.springframework.boot.autoconfigure.graphql.GraphQlAutoConfiguration | ||
import org.springframework.boot.test.context.runner.ApplicationContextRunner | ||
|
||
class DgsAPQAutoConfigurationTest { | ||
private val autoConfigurations = | ||
AutoConfigurations.of( | ||
DgsSpringGraphQLAutoConfiguration::class.java, | ||
DgsAPQSupportAutoConfiguration::class.java, | ||
GraphQlAutoConfiguration::class.java, | ||
) | ||
|
||
@Test | ||
fun shouldContributeAPQBeans() { | ||
val contextRunner = | ||
ApplicationContextRunner() | ||
.withConfiguration(autoConfigurations) | ||
.withPropertyValues("dgs.graphql.apq.enabled=true") | ||
|
||
contextRunner.run { context -> | ||
assertThat(context) | ||
.hasBean("apqSourceBuilderCustomizer") | ||
.hasBean("sourceBuilderCustomizer") | ||
.hasSingleBean(PersistedQueryCache::class.java) | ||
} | ||
} | ||
|
||
@Test | ||
fun shouldNotContributeAPQBeans() { | ||
val contextRunner = | ||
ApplicationContextRunner() | ||
.withConfiguration(autoConfigurations) | ||
|
||
contextRunner.run { context -> | ||
assertThat(context) | ||
.doesNotHaveBean("apqSourceBuilderCustomizer") | ||
.hasBean("sourceBuilderCustomizer") | ||
.doesNotHaveBean(PersistedQueryCache::class.java) | ||
} | ||
} | ||
} |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Why did this change?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
explained in response to earlier comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The micrometer test started failing because the order in which the instrumentations run seems to have changed in my branch. If the
DgsGraphQlJavaErrorInstrumentation
runs before theMetricsInstrumentation
, the tag value is set properly (which is in this branch). However, if it's the other way around, the metrics add the tag for gql.error before theDgsGraphQlJavaErrorInstrumentation
runs and that's why it passes in master branch.The correct order should be
DgsGraphQlJavaErrorInstrumentation
first and thenDgsMetricsInstrumentation
so the metrics get the correct tag value as fixed in this PR.Basically need a way to ensure the MetricsInstrumentation runs last, but not sure what the best way to do that is, so looking into it.