Java-friendly APIs for MockWebServer

[ibrhmyzc]

I imported these in my spring boot project.
testImplementation project(":testing:unit-testing")
testImplementation("com.apollographql.apollo3:apollo-mockserver:3.3.0")
api "com.apollographql.apollo:apollo-runtime"

For example, when I want to create a MockResponse, there are no builder or set methods. I can only call get methods for these objects. Or when I want to set URL for MockServer, it gives this error
Required type: Continuation <? super java.lang.String>
Provided: String

I hope its not an obvious question. Am i importing something wrong? or I cannot those in Java anymore?
Thank you in advance!

[martinbonnin]

Hi 👋 Indeed, using MockServer in Java is technically doable but it's a bit awkward. For some background there, we mostly designed MockServer for the Apollo integration tests and published them in hope that it could benefit the community but a lot of the APIs are pretty experimental. And as you found out, it's mainly designed for Kotlin.

If you really want to, you can get mockServer.url with this trick:

    /**
     * Because url doesn't suspend on the JVM, we can just use the return value
     */
    String url = (String) mockServer.url(new Continuation<String>() {
      @NotNull @Override public CoroutineContext getContext() {
        return EmptyCoroutineContext.INSTANCE;
      }

      @Override public void resumeWith(@NotNull Object o) {
      }
    });

Or write a little bit of Kotlin code to bridge the suspend function (see this stackoverflow answer).

All in all, for Java use cases, I would recommend using OkHttp MockWebServer. The main thing that the Apollo MockServer supports is multiplatform but if you're not using that, OkHttp MockWebServer should provide most of the API (and actually Apollo MockServer uses OkHttp MockWebServer under the hood) using a much more Java-friendly API.

Hope this helps!

[martinbonnin]

@ibrhmyzc I just updated the doc to be more explicit about MockServer being mostly Kotlin so far.

I'll keep this is issue around to keep track of improvements to the MockServer APIs and renamed it accordingly, I hope you don't mind.