if (value != null) {
      return value;
    }

    value = getWithoutCaching(key);
    if (value != null) {
      addToCache((K) key, value);
    }
    return value;
  }

  // Internal methods (package-visible, but treat as only subclass-visible)

  @Override
  @Nullable V getIfCached(@Nullable Object key) {
    V value = super.getIfCached(key);
    if (value != null) {
      return value;
    }

   *
   * @param target target to which to append output
   */
  AppendableWriter(Appendable target) {
    this.target = checkNotNull(target);
  }

  /*
   * Abstract methods from Writer
   */

  @Override
  public void write(char[] cbuf, int off, int len) throws IOException {
    checkNotClosed();
    // It turns out that creating a new String is usually as fast, or faster

import org.codelibs.fess.suggest.request.RequestBuilder;
import org.opensearch.transport.client.Client;

/**
 * Builder for creating a {@link PopularWordsRequest} to fetch popular words.
 * This builder provides methods to set various parameters for the request.
 */
public class PopularWordsRequestBuilder extends RequestBuilder<PopularWordsRequest, PopularWordsResponse> {
    /**
     * Constructor for PopularWordsRequestBuilder.

import org.codelibs.fess.crawler.rule.Rule;
import org.codelibs.fess.crawler.rule.RuleManager;

/**
 * Implementation of the {@link RuleManager} interface.
 * Manages a list of rules for the crawler.
 * Provides methods to add, remove, check, and retrieve rules.
 *
 */
public class RuleManagerImpl implements RuleManager {

    /** The list of rules managed by this rule manager. */

 */

package com.google.common.io;

import com.google.common.annotations.GwtIncompatible;
import com.google.common.annotations.J2ktIncompatible;
import java.nio.Buffer;

/**
 * Wrappers around {@link Buffer} methods that are covariantly overridden in Java 9+. See
 * https://github.com/google/guava/issues/3990
 */
@J2ktIncompatible
@GwtIncompatible
final class Java8Compatibility {
  static void clear(Buffer b) {
    b.clear();

 * the {@link Futures#catching(ListenableFuture, Class, com.google.common.base.Function,
 * java.util.concurrent.Executor) Futures.catching} family of methods. Those versions have slightly
 * different signatures.
 */
@GwtCompatible
@J2ktIncompatible // Super-sourced
abstract class GwtFuturesCatchingSpecialization {
  /*

 *   <li>Automatically reloads properties if the file is modified.</li>
 *   <li>Supports custom check intervals for file modification checks.</li>
 *   <li>Provides synchronized methods for loading and storing properties.</li>
 *   <li>Extends {@link Properties} and overrides its methods to work with dynamic properties.</li>
 * </ul>
 *
 * <p>Usage:
 * <pre>
 * DynamicProperties dynamicProperties = new DynamicProperties("path/to/properties/file");

 * Tests all string encoding/decoding operations and utility methods.
 */
@DisplayName("Strings Utility Tests")
class StringsTest {

    private static final String TEST_STRING = "Hello World";
    private static final String UNICODE_STRING = "Hello 世界 🌍";
    private static final String ASCII_STRING = "ASCII Test";

    @Nested
    @DisplayName("Basic Encoding Methods")
    class BasicEncodingTests {

        @Test

 * the exact versions of tools they wish to use.</p>
 *
 * <p>
 * Toolchains can be obtained through the {@link org.apache.maven.api.services.ToolchainManager ToolchainManager}
 * service. This service provides methods to retrieve and manage toolchains defined
 * in the Maven configuration.
 * </p>
 *
 * <p>
 * The following are key functionalities provided by the Toolchain interface:</p><ul>

import com.google.caliper.BeforeExperiment;
import com.google.caliper.Benchmark;
import org.jspecify.annotations.NullUnmarked;

/**
 * Benchmarks for the non-rounding methods of {@code LongMath}.
 *
 * @author Louis Wasserman
 */
@NullUnmarked
public class LongMathBenchmark {
  private static final int[] exponents = new int[ARRAY_SIZE];