---
title: Recipes
description: A collection of common/useful code examples for Kotlin and Java
---


# Recipes

We've written some recipes that demonstrate how to solve common problems with OkHttp. Read through them to learn about how everything works together. Cut-and-paste these examples freely; that's what they're for.

### Synchronous Get ([.kt][SynchronousGetKotlin], [.java][SynchronousGetJava])

    val sanUrl =
      url.newBuilder()
        .host("san.com")
        .build()
    execute(sanUrl).use { response ->
      assertThat(response.code).isEqualTo(200)
      assertThat(response.priorResponse!!.code).isEqualTo(421)
      assertThat(response.body.string()).isEqualTo("after misdirect")
    }
    assertThat(server.takeRequest().sequenceNumber).isEqualTo(0)

        }
      },
    )
  }

  @Test fun readSettingsFrame() {
    val reducedTableSizeBytes = 16
    writeMedium(frame, 12) // 2 settings * 6 bytes (2 for the code and 4 for the value).
    frame.writeByte(Http2.TYPE_SETTINGS)
    frame.writeByte(FLAG_NONE)
    frame.writeInt(0) // Settings are always on the connection stream 0.
    frame.writeShort(1) // SETTINGS_HEADER_TABLE_SIZE

  }

  private fun getCacheOnlyResponse(request: Request): Response? {
    if (client.cache != null) {
      try {
        // Use the cache without hitting the network first
        // 504 code indicates that the Cache is stale
        val onlyIfCached =
          CacheControl.Builder()
            .onlyIfCached()
            .build()

        var cacheUrl = request.url

        val cacheRequest =

    client =
      client.newBuilder()
        .connectionPool(ConnectionPool(0, 5, TimeUnit.SECONDS))
        .build()
    server.enqueue(
      MockResponse(
        code = 301,
        headers = headersOf("Location", "/b"),
        body = "a",
      ),
    )
    server.enqueue(MockResponse(body = "b"))
    val request = Request(server.url("/"))

      including but not limited to software source code, documentation
      source, and configuration files.

      "Object" form shall mean any form resulting from mechanical
      transformation or translation of a Source form, including but
      not limited to compiled object code, generated documentation,
      and conversions to other media types.

   * malformed.
   */
  @Throws(IOException::class)
  fun checkLowercase(name: ByteString): ByteString {
    for (i in 0 until name.size) {
      if (name[i] in 'A'.code.toByte()..'Z'.code.toByte()) {
        throw IOException("PROTOCOL_ERROR response malformed: mixed case name: ${name.utf8()}")
      }
    }
    return name
  }

import org.junit.jupiter.api.AfterEach
import org.junit.jupiter.api.Test

/**
 * Unit test for [FastFallbackExchangeFinder] implementation details.
 *
 * This test uses [TaskFaker] to deterministically test racy code. Each function in this test has
 * the same structure:
 *
 *  * prepare a set of plans, each with a predictable connect delay
 *  * attempt to find a connection

*.awdev.ca *.azurecontainer.io *.backyards.banzaicloud.io *.banzai.cloud *.bd *.beget.app *.build.run *.builder.code.com *.bzz.dapps.earth *.ck *.cloud.metacentrum.cz *.cloudera.site *.cns.joyent.com *.code.run *.compute-1.amazonaws.com *.compute.amazonaws.com *.compute.amazonaws.com.cn *.compute.estate *.cryptonomic.net *.customer-oci.com *.dapps.earth *.database.run *.dev-builder.code.com *.dev.adobeaemcloud.com *.devcdnaccesso.com *.developer.app *.digitaloceanspaces.com *.diher.solutions *.dweb.link...