MockWebServer for JUnit 4
=========================

This module integrates mockwebserver3.MockWebServer with JUnit 4.

To use, first add this library as a test dependency:

```
testImplementation("com.squareup.okhttp3:mockwebserver3-junit4:5.3.0")
```

Then in tests annotated `@org.junit.Test`, you may declare a field with the `@Rule` annotation:

```
@Rule public final MockWebServerRule serverRule = new MockWebServerRule();
```

    var requestCount: Int = mockWebServer.requestCount
    mockWebServer.enqueue(MockResponse())
    mockWebServer.start()
    mockWebServer.start(0)
    mockWebServer.start(InetAddress.getLocalHost(), 0)
    mockWebServer.shutdown()
    var dispatcher: Dispatcher = mockWebServer.dispatcher
    dispatcher = mockWebServer.dispatcher

 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package mockwebserver3.junit4

import java.io.IOException
import mockwebserver3.MockWebServer
import org.junit.rules.ExternalResource

/**
 * Runs MockWebServer for the duration of a single test method.
 *
 * In Java JUnit 4 tests (ie. tests annotated `@org.junit.Test`), use this by defining a field with

### Example

Use MockWebServer the same way that you use mocking frameworks like
[Mockito](https://github.com/mockito/mockito):

1. Script the mocks.
2. Run application code.
3. Verify that the expected requests were made.

Here's a complete example:

### Java
```java
public void test() throws Exception {
  // Create a MockWebServer. These are lean enough that you can create a new

import java.util.Collections;
import okhttp3.OkHttpClient;
import okhttp3.Protocol;
import okhttp3.Request;
import okhttp3.Response;
import okhttp3.mockwebserver.MockResponse;
import okhttp3.mockwebserver.MockWebServer;

/**
 * Create UNIX domain sockets for MockWebServer and OkHttp and connect 'em together. Note that we
 * cannot do TLS over domain sockets.
 */
public class ClientAndServer {
  public void run() throws Exception {

    }
  }

  @Test
  fun toStringIncludesLifecycleState() {
    val other = MockWebServer()
    assertThat(other.toString()).isEqualTo("MockWebServer{new}")
    other.use {
      other.start()
      assertThat(other.toString()).isEqualTo("MockWebServer{port=${other.port}}")
    }
    assertThat(other.toString()).isEqualTo("MockWebServer{closed}")
  }

  @Test
  fun closeWhileBlockedDispatching() {

 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package okhttp3.modules.test;

import mockwebserver3.MockResponse;
import mockwebserver3.MockWebServer;
import okhttp3.Call;
import okhttp3.Headers;
import okhttp3.HttpUrl;
import okhttp3.OkHttpClient;
import okhttp3.Response;
import okhttp3.logging.HttpLoggingInterceptor;

@Timeout(30)
class CustomDispatcherTest {
  @StartStop private val mockWebServer = MockWebServer()

  @Test
  fun simpleDispatch() {
    val requestsMade = mutableListOf<RecordedRequest>()
    val dispatcher: Dispatcher =
      object : Dispatcher() {
        override fun dispatch(request: RecordedRequest): MockResponse {
          requestsMade.add(request)
          return MockResponse()
        }
      }

 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package mockwebserver3.junit5.internal

import java.lang.reflect.Modifier
import mockwebserver3.MockWebServer
import mockwebserver3.junit5.StartStop
import okhttp3.internal.SuppressSignatureCheck
import org.junit.jupiter.api.extension.BeforeAllCallback

@SuppressWarnings("module")
module okhttp3.mockwebserver {
  requires okhttp3;
  exports okhttp3.mockwebserver;
  requires java.logging;