* An extension of {@code DataInput} for reading from in-memory byte arrays; its methods offer
 * identical functionality but do not throw {@link IOException}.
 *
 * <p><b>Warning:</b> The caller is responsible for not attempting to read past the end of the
 * array. If any method encounters the end of the array prematurely, it throws {@link
 * IllegalStateException} to signify <i>programmer error</i>. This behavior is a technical violation

            case EXPIRED:
              stats[0]++;
              break;
            case EXPLICIT:
              stats[1]++;
              break;
            case REPLACED:
              stats[2]++;
              break;
            case SIZE:
              stats[3]++;
              break;
            default:

                final SearchHit[] hits = searchHits.getHits();
                if (hits.length == 0) {
                    break;
                }

                if (!handler.apply(searchHits)) {
                    break;
                }

                response = client.prepareSearchScroll(scrollId).setScroll(scrollForDelete).execute().actionGet(scrollSearchTimeout);

 *
 * @author taedium
 */
public interface ResourceHandler {

    /**
     * Processes a resource.
     *
     * @param path the path
     * @param is the {@link InputStream} to read the resource
     */
    void processResource(String path, InputStream is);

 * time while the device is asleep. Instead, create one like this:
 *
 * {@snippet :
 * Stopwatch.createStarted(
 *      new Ticker() {
 *        public long read() {
 *          return android.os.SystemClock.elapsedRealtimeNanos();
 *        }
 *      });
 * }
 *
 * @author Kevin Bourrillion
 * @since 10.0
 */
@GwtCompatible

   */
  void remove(Range<K> range);

  /**
   * Returns a view of this range map as an unmodifiable {@code Map<Range<K>, V>}. Modifications to
   * this range map are guaranteed to read through to the returned {@code Map}.
   *
   * <p>The returned {@code Map} iterates over entries in ascending order of the bounds of the
   * {@code Range} entries.
   *

 * values may be removed from the map on each map modification or on occasional map accesses; such
 * entries may be counted by {@link Map#size}, but will never be visible to read or write
 * operations. A partially-reclaimed entry is never exposed to the user. Any {@link Map.Entry}
 * instance retrieved from the map's {@linkplain Map#entrySet entry set} is a snapshot of that

- **Security:**
Java serialization poses security risks, especially related to deserialization vulnerabilities.

- **Version Compatibility:**
With Java serialization, even minor changes to a class (like adding a field) can break compatibility.

- **Cross-Language Compatibility:**
Java serialization is inherently Java-centric and does not support cross-language scenarios well.

- **Type Safety:**

     */
    fun withConnectTimeout(
      timeout: Int,
      unit: TimeUnit,
    ): Chain

    /**
     * Returns the read timeout in milliseconds.
     */
    fun readTimeoutMillis(): Int

    /**
     * Returns a new chain with the specified read timeout.
     */
    fun withReadTimeout(
      timeout: Int,
      unit: TimeUnit,
    ): Chain

    /**

            case EXPIRED:
              stats[0]++;
              break;
            case EXPLICIT:
              stats[1]++;
              break;
            case REPLACED:
              stats[2]++;
              break;
            case SIZE:
              stats[3]++;
              break;
            default: