* Provides functionality to retrieve popular words based on search parameters
 * and manages caching for improved performance.
 */
public class PopularWordHelper {
    /** Logger instance for this class */
    private static final Logger logger = LogManager.getLogger(PopularWordHelper.class);

    /** Character used to separate cache key components */
    protected static final char CACHE_KEY_SPLITTER = '\n';

import com.google.common.cache.CacheBuilder;

public class PopularWordHelperTest extends UnitFessTestCase {

    public PopularWordHelper popularWordHelper;

    @Override
    protected void setUp(TestInfo testInfo) throws Exception {
        super.setUp(testInfo);
        popularWordHelper = new PopularWordHelper() {
            @Override
            public void init() {
                fessConfig = new FessConfig.SimpleImpl() {

		<property name="encoding">"UTF-8"</property>
	</component>
	<component name="pluginHelper" class="org.codelibs.fess.helper.PluginHelper">
	</component>
	<component name="popularWordHelper" class="org.codelibs.fess.helper.PopularWordHelper">
	</component>
	<component name="queryHelper" class="org.codelibs.fess.helper.QueryHelper">
		<property name="defaultFacetInfo">facetInfo</property>
		<postConstruct name="addQueryRescorer">

    @Resource
    protected OsddHelper osddHelper;

    /** Helper for managing popular search words and suggestions. */
    @Resource
    protected PopularWordHelper popularWordHelper;

    /** Client for RAG chat functionality. */
    @Resource
    protected ChatClient chatClient;

    /** The HTTP servlet request object for the current request. */
    @Resource

    /** The list of content field names. */
    protected List<String> contentFieldList;

    /** The popular word helper for handling popular words. */
    protected PopularWordHelper popularWordHelper = null;

    /** The interval for storing search logs. */
    protected long searchStoreInterval = 1; // min

    /**
     * Initializes the SuggestHelper.

        ComponentUtil.register(new MockBadWordBhv(), "badWordBhv");
        ComponentUtil.register(new MockSystemHelper(), "systemHelper");
        ComponentUtil.register(new MockPopularWordHelper(), "popularWordHelper");
    }

    @Test
    public void test_init() {
        SuggestHelper helper = new SuggestHelper();
        try {
            helper.init();
            assertNotNull(helper.suggester());

            } catch (IOException e) {
                throw new RuntimeException(e);
            }
        }
    }

    // Mock PopularWordHelper implementation
    private class MockPopularWordHelper extends PopularWordHelper {
        private boolean cacheCleared = false;

        @Override
        public void clearCache() {
            cacheCleared = true;
        }

    }

    @Test
    public void test_hasPopularWordHelper() {
        assertFalse(ComponentUtil.hasPopularWordHelper());

        ComponentUtil.register(new Object(), "popularWordHelper");
        assertTrue(ComponentUtil.hasPopularWordHelper());
    }

    @Test
    public void test_hasRelatedQueryHelper() {
        assertFalse(ComponentUtil.hasRelatedQueryHelper());

import org.codelibs.fess.helper.NotificationHelper;
import org.codelibs.fess.helper.PathMappingHelper;
import org.codelibs.fess.helper.PermissionHelper;
import org.codelibs.fess.helper.PluginHelper;
import org.codelibs.fess.helper.PopularWordHelper;
import org.codelibs.fess.helper.ProcessHelper;
import org.codelibs.fess.helper.ProtocolHelper;
import org.codelibs.fess.helper.QueryHelper;
import org.codelibs.fess.helper.RateLimitHelper;

        }
        final String[] fields = request.getParameterValues("field");

        final PopularWordHelper popularWordHelper = ComponentUtil.getPopularWordHelper();

        final StringBuilder buf = new StringBuilder(255);
        try {
            final List<String> popularWordList =
                    popularWordHelper.getWordList(SearchRequestType.JSON, seed, tags, null, fields, StringUtil.EMPTY_STRINGS);