String[] languages = { "en" };
        long docFreq = 10L;
        long queryFreq = 5L;
        float userBoost = 1.5f;

        SuggestItem item =
                new SuggestItem(text, readings, fields, docFreq, queryFreq, userBoost, tags, roles, languages, SuggestItem.Kind.DOCUMENT);

        Map<String, Object> source = SuggestItemSerializer.toSource(item);

        assertNotNull(source);

        words.add("test");

        List<SuggestItem> items = new ArrayList<>();
        String[][] readings = new String[1][];
        readings[0] = new String[] { "test" };
        items.add(new SuggestItem(new String[] { "test" }, readings, new String[] { "content" }, 1, 0, -1, new String[] { "tag1" },
                new String[] { SuggestConstants.DEFAULT_ROLE }, null, SuggestItem.Kind.DOCUMENT));

        SuggestItem[] items = new SuggestItem[1];
        String[][] readings = new String[1][];
        readings[0] = new String[] { "test" };
        items[0] = new SuggestItem(new String[] { "test" }, readings, new String[] { "content" }, 0, 15, -1, new String[] { "tag1" },
                new String[] { SuggestConstants.DEFAULT_ROLE }, new String[] { "en" }, SuggestItem.Kind.QUERY);

     * @return The SuggestIndexResponse
     */
    public SuggestIndexResponse index(final String index, final SuggestItem[] items, final String[] badWords) {
        final SuggestItem[] filteredItems = Stream.of(items).filter(item -> !item.isBadWord(badWords)).toArray(SuggestItem[]::new);

        if (logger.isDebugEnabled()) {

    }

    private SuggestItem createItemWithRoles(String text, String... roles) {
        String[] texts = { text };
        String[][] readings = { { "reading" } };
        String[] fields = { "field" };

        return new SuggestItem(texts, readings, fields, 1L, 1L, 1.0f, new String[0], roles, new String[0], SuggestItem.Kind.DOCUMENT);

import org.codelibs.fess.suggest.entity.SuggestItem;
import org.codelibs.fess.suggest.index.contents.querylog.QueryLog;
import org.codelibs.fess.suggest.normalizer.Normalizer;

/**
 * Interface for parsing content and creating suggest items.
 */
public interface ContentsParser {
    /**
     * Parses the given search words and creates a SuggestItem.
     *
     * @param words the array of search words

 * governing permissions and limitations under the License.
 */
package org.codelibs.fess.suggest.request.popularwords;

import java.util.List;

import org.codelibs.fess.suggest.entity.SuggestItem;
import org.codelibs.fess.suggest.request.Response;

/**
 * Represents the response for popular words request.
 */
public class PopularWordsResponse implements Response {

    /**

     * </ul>
     *
     * @param item1 The first SuggestItem (base item)
     * @param item2 The second SuggestItem (item to merge in)
     * @return A new merged SuggestItem
     * @throws IllegalArgumentException if item IDs don't match
     */
    public static SuggestItem merge(final SuggestItem item1, final SuggestItem item2) {
        if (!item1.getId().equals(item2.getId())) {

     */
    default SuggestItem[] mergeItems(final SuggestItem[] items) {
        final Set<String> mergedIdSet = new HashSet<>();
        final List<SuggestItem> mergedList = new ArrayList<>(items.length);

        for (final SuggestItem item1 : items) {
            final String item1Id = item1.getId();
            if (mergedIdSet.contains(item1Id)) {
                continue;
            }

            SuggestItem mergedItem = item1;

        final List<String> firstWords = new ArrayList<>();
        final List<String> secondWords = new ArrayList<>();
        final List<SuggestItem> firstItems = new ArrayList<>();
        final List<SuggestItem> secondItems = new ArrayList<>();

        final String index;
        if (hits.length > 0) {
            index = hits[0].getIndex();
        } else {