queryBuilder.must(QueryBuilders.rangeQuery(FieldNames.QUERY_FREQ).gte(queryFreqThreshold));
        if (!tags.isEmpty()) {
            queryBuilder.must(QueryBuilders.termsQuery(FieldNames.TAGS, tags));
        }
        if (!roles.isEmpty()) {
            queryBuilder.must(QueryBuilders.termsQuery(FieldNames.ROLES, roles));
        } else {

     *
     * @param words the array of search words
     * @param readings the array of readings corresponding to the search words
     * @param fields the array of fields associated with the search words
     * @param tags the array of tags associated with the search words
     * @param roles the array of roles associated with the search words
     * @param score the score associated with the search words

     * @param reading     The reading of the word.
     * @param tags        The tags associated with the word.
     * @param permissions The permissions for the word.
     * @param boost       The boost value for the word.
     * @param apply       true to apply the changes immediately.
     */
    public void addElevateWord(final String word, final String reading, final String[] tags, final String[] permissions, final Float boost,

servers:
  - url: http://localhost:8080/api/v1
tags:
  - name: search
    description: Search operations
  - name: popularword
    description: Popular word operations
  - name: monitor
    description: Monitoring operations
  - name: suggest
    description: Suggest operations
  - name: favorite
    description: Favorite operations
paths:
  /documents:
    get:
      tags:
        - search

    /** Pattern for extracting charset from meta tags. */
    protected Pattern metaCharsetPattern = Pattern.compile("<meta.*content\\s*=\\s*['\"].*;\\s*charset=([\\w\\d\\-_]*)['\"]\\s*/?>",
            Pattern.MULTILINE | Pattern.CASE_INSENSITIVE);

    /**
     * Pattern for HTML tags.
     */
    protected Pattern htmlTagPattern = Pattern.compile("<[^>]+>");

        try {
            final Blob blob = storage.get(BlobId.of(bucket, objectName));
            if (blob != null) {
                // GCS uses metadata instead of tags
                blob.toBuilder().setMetadata(tags).build().update();
            } else {
                throw new StorageException("Object not found: " + objectName);
            }

    public static final String ELEVATE_WORD_READING = "reading";
    /** Key for elevate word fields. */
    public static final String ELEVATE_WORD_FIELDS = "fields";
    /** Key for elevate word tags. */
    public static final String ELEVATE_WORD_TAGS = "tags";
    /** Key for elevate word roles. */
    public static final String ELEVATE_WORD_ROLES = "roles";

    /** Array settings for elevate words. */
    protected ArraySettings arraySettings;

        return null;
    }

    /**
     * Retrieves tags associated with an object in the specified bucket.
     * @param bucketName the name of the bucket containing the object
     * @param path the path to the object within the bucket
     * @return the tags associated with the object, or null if no tags exist or object not found
     */
    protected Tags getObjectTags(final String bucketName, final String path) {

    /** XPath expression for extracting thumbnail content from meta tags */
    private static final String META_NAME_THUMBNAIL_CONTENT = "//META[@name=\"thumbnail\" or @name=\"THUMBNAIL\"]/@content";

    /** XPath expression for extracting Open Graph image content from meta tags */
    private static final String META_PROPERTY_OGIMAGE_CONTENT = "//META[@property=\"og:image\"]/@content";

 *
 * <p>Usage example:</p>
 * <pre>
 * {@code
 * DefaultContentsParser parser = new DefaultContentsParser();
 * SuggestItem item = parser.parseSearchWords(words, readings, fields, tags, roles, score, readingConverter, normalizer, analyzer, langs);
 * }
 * </pre>
 *
 * @see ContentsParser
 * @see SuggestItem
 * @see ReadingConverter
 * @see Normalizer
 * @see SuggestAnalyzer
 */