*/
public class SuggestRequestBuilder extends RequestBuilder<SuggestRequest, SuggestResponse> {
    /**
     * Constructor for SuggestRequestBuilder.
     * @param client The OpenSearch client.
     * @param readingConverter The reading converter.
     * @param normalizer The normalizer.
     */
    public SuggestRequestBuilder(final Client client, final ReadingConverter readingConverter, final Normalizer normalizer) {

    //                                               Details
    //                                               -------
    /**
     * Show the details page.
     * @param dictId The dictionary ID.
     * @param crudMode The CRUD mode.
     * @param id The ID of the kuromoji item.
     * @return The HTML response.
     */
    @Execute
    @Secured({ ROLE, ROLE + VIEW })

 */
public interface StorageClient extends AutoCloseable {

    /**
     * Uploads an object to storage.
     *
     * @param objectName the name/path for the object
     * @param inputStream the input stream of data to upload
     * @param size the size of the data in bytes
     * @param contentType the MIME type of the content
     */
    void uploadObject(String objectName, InputStream inputStream, long size, String contentType);

     * @param query The query string.
     */
    public void setQuery(final String query) {
        this.query = query;
    }

    /**
     * Adds a tag to filter by.
     * @param tag The tag.
     */
    public void addTag(final String tag) {
        tags.add(tag);
    }

    /**
     * Adds a role to filter by.
     * @param role The role.
     */

         *
         * @param client the fault-tolerant client
         * @param request the request data
         */
        void onRequestStart(FaultTolerantClient client, RequestData request);

        /**
         * Called before each request attempt.
         *
         * @param client the fault-tolerant client
         * @param request the request data
         * @param count the current retry count
         */

    }

    /**
     * Get a DFS referral for the specified target
     *
     * @param tf the CIFS context
     * @param trans the SMB transport
     * @param target the target path
     * @param targetDomain the target domain
     * @param targetHost the target host
     * @param root the DFS root
     * @param path the DFS path
     * @return the DFS referral data or null if not found

        RequestParameter param = new RequestParameter(name, values);

        assertEquals(name, param.getName());
        assertNotNull(param.getValues());
        assertEquals(4, param.getValues().length);
        assertEquals("value1", param.getValues()[0]);
        assertNull(param.getValues()[1]);
        assertEquals("value3", param.getValues()[2]);
        assertNull(param.getValues()[3]);
    }

    @Test

     * Constructor for SuggestItem.
     * @param text The text.
     * @param readings The readings.
     * @param fields The fields.
     * @param docFreq The document frequency.
     * @param queryFreq The query frequency.
     * @param userBoost The user boost.
     * @param tags The tags.
     * @param roles The roles.
     * @param languages The languages.
     * @param kind The kind.
     */

     *
     * @param sessionId the session ID (can be null for new sessions)
     * @param userMessage the user's message
     * @param userId the user ID (can be null for anonymous users)
     * @param fields the field filters (e.g., label)
     * @param extraQueries the extra query filters (e.g., filetype, timestamp)
     * @param callback the callback to receive phase notifications and streaming chunks

     * <p>
     * Returns <code>null</code> if the protocol of the URL is unknown.
     * </p>
     *
     * @param url
     *            The URL of the resource.
     * @param rootPackage
     *            The root package.
     * @param rootDir
     *            The root directory.
     * @return A {@link Traverser} for handling the specified URL.
     */