}
    if (expireAfterAccess != null) {
      builder.expireAfterAccess(expireAfterAccess.duration, expireAfterAccess.unit);
    }
    if (refresh != null) {
      builder.refreshAfterWrite(refresh.duration, refresh.unit);
    }
    if (keyStrength != null) {
      builder.setKeyStrength(keyStrength);
    }
    if (valueStrength != null) {
      builder.setValueStrength(valueStrength);

- **SuggestSettings**: NOT thread-safe for modifications

### Performance
- Use batch operations for indexing (100-500 items)
- Don't call `refresh()` too frequently
- Limit `maxReadingNum` to prevent memory issues
- OpenSearch auto-refreshes every 1 second by default

### Compatibility
- Designed for OpenSearch 2.x+
- All text processing uses UTF-8

        return designJspFileNameMap.entrySet().stream().map(e -> new Pair<>(e.getKey(), e.getValue())).toArray(n -> new Pair[n]);
    }

    /**
     * Refreshes the design JSP files for all virtual hosts.
     *
     * @return A list of paths to the refreshed files.
     */
    public List<Path> refreshDesignJspFiles() {
        final List<Path> fileList = new ArrayList<>();

     * Returns the newly refreshed value associated with {@code key} if it was refreshed inline, or
     * {@code null} if another thread is performing the refresh or if an error occurs during
     * refresh.
     */
    @CanIgnoreReturnValue
    @Nullable V refresh(K key, int hash, CacheLoader<? super K, V> loader, boolean checkTime) {
      LoadingValueReference<K, V> loadingValueReference =

     * Returns the newly refreshed value associated with {@code key} if it was refreshed inline, or
     * {@code null} if another thread is performing the refresh or if an error occurs during
     * refresh.
     */
    @CanIgnoreReturnValue
    @Nullable V refresh(K key, int hash, CacheLoader<? super K, V> loader, boolean checkTime) {
      LoadingValueReference<K, V> loadingValueReference =

        }
    }

    /**
     * Refreshes the specified indices to make recent changes visible for search.
     *
     * @param indices the indices to refresh
     */
    public void refresh(final String... indices) {
        client.admin().indices().prepareRefresh(indices).execute(new ActionListener<RefreshResponse>() {

    ConcurrentMap<String, String> map = cache.asMap();
    map.put(refreshKey, refreshKey);
    assertThat(map).hasSize(1);
    assertThat(map.containsKey(getKey)).isFalse();
    assertThat(map.get(refreshKey)).isSameInstanceAs(refreshKey);

    new Thread() {
      @Override
      public void run() {
        cache.getUnchecked(getKey);

    ConcurrentMap<String, String> map = cache.asMap();
    map.put(refreshKey, refreshKey);
    assertThat(map).hasSize(1);
    assertThat(map.containsKey(getKey)).isFalse();
    assertThat(map.get(refreshKey)).isSameInstanceAs(refreshKey);

    new Thread() {
      @Override
      public void run() {
        cache.getUnchecked(getKey);

            Assertions.assertEquals(firstTime, observedTimes[i], "All threads should see same time due to volatile");
        }
    }

    /**
     * Test cache refresh mechanism with concurrent access.
     * Verifies that cache is refreshed correctly even with concurrent readers.
     */
    @Test
    public void test_cacheRefresh_withConcurrentReads() throws Exception {
        final int[] loadCount = { 0 };

        }

        suggester.indexer().index(items);
        suggester.refresh();

        assertEquals(3, suggester.getAllWordsNum());

        SuggestDeleteResponse deleteResponse = suggester.indexer().deleteAll();

        assertNotNull(deleteResponse);
        assertFalse(deleteResponse.hasError());

        suggester.refresh();
        assertEquals(0, suggester.getAllWordsNum());
    }

    @Test