import org.codelibs.fess.Constants;
import org.codelibs.fess.dict.DictionaryException;
import org.codelibs.fess.dict.DictionaryFile;
import org.codelibs.fess.util.ComponentUtil;
import org.dbflute.optional.OptionalEntity;

/**
 * Manages a dictionary file for stemmer overrides.
 * This class handles reading, parsing, and updating files that contain
 * stemmer override rules, where each rule maps an input word to an

And it can return anything you want.

In this case, this dependency expects:

* An optional query parameter `q` that is a `str`.
* An optional query parameter `skip` that is an `int`, and by default is `0`.
* An optional query parameter `limit` that is an `int`, and by default is `100`.

And then it just returns a `dict` containing those values.

/// info

import org.codelibs.fess.opensearch.config.exentity.LabelType;
import org.codelibs.fess.util.ComponentUtil;
import org.dbflute.cbean.result.PagingResultBean;
import org.dbflute.optional.OptionalEntity;

import jakarta.annotation.Resource;

/**
 * Service class for label types.
 */
public class LabelTypeService extends FessAppService {

    /** The LabelType behavior. */
    @Resource

import com.google.common.annotations.GwtCompatible;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.util.Set;

/**
 * Optional features of classes derived from {@code Set}.
 *
 * @author George van den Driessche
 */
@SuppressWarnings("rawtypes") // maybe avoidable if we rework the whole package?
@GwtCompatible

Having `str | None` will allow your editor to give you better support and detect errors.

///

## Additional validation { #additional-validation }

We are going to enforce that even though `q` is optional, whenever it is provided, **its length doesn't exceed 50 characters**.

### Import `Query` and `Annotated` { #import-query-and-annotated }

To achieve that, first import:

* `Query` from `fastapi`

    }

    @Test
    @DisplayName("createContext accepts null/empty optional parameters")
    void createContext_edge_parameters_ok() throws Exception {
        TestCredentials creds = new TestCredentials("D", false, false, new Subject(), false);
        // Intentionally pass null/empty values for optional parameters; expect no exception
        SSPContext ctx1 = creds.createContext(mockContext, null, "", null, false);

    assertThat(ArbitraryInstances.get(Object.class)).isNotNull();
    assertEquals(0, ArbitraryInstances.get(Number.class));
    assertEquals(UTF_8, ArbitraryInstances.get(Charset.class));
    assertEquals(Optional.empty(), ArbitraryInstances.get(Optional.class));
    assertEquals(OptionalInt.empty(), ArbitraryInstances.get(OptionalInt.class));
    assertEquals(OptionalLong.empty(), ArbitraryInstances.get(OptionalLong.class));

import org.codelibs.fess.opensearch.config.exentity.ElevateWord;
import org.codelibs.fess.util.ComponentUtil;
import org.codelibs.fess.util.RenderDataUtil;
import org.dbflute.optional.OptionalEntity;
import org.dbflute.optional.OptionalThing;
import org.lastaflute.web.Execute;
import org.lastaflute.web.response.ActionResponse;
import org.lastaflute.web.response.HtmlResponse;
import org.lastaflute.web.response.render.RenderData;

     * Required field with maximum length of 100 characters.
     */
    @Required
    @Size(max = 100)
    public String name;

    /**
     * The version of the plugin to delete.
     * Optional field with maximum length of 100 characters.
     */
    @Size(max = 100)
    public String version;

import com.google.common.annotations.GwtCompatible;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.util.Set;

/**
 * Optional features of classes derived from {@code Set}.
 *
 * @author George van den Driessche
 */
@SuppressWarnings("rawtypes") // maybe avoidable if we rework the whole package?
@GwtCompatible