* @param url the URL to encode
     * @return the encoded URL with non-URL-safe characters properly encoded
     */
    public static String encodeUrl(final String url) {
        final String enc = LaRequestUtil.getOptionalRequest()
                .filter(req -> req.getCharacterEncoding() != null)
                .map(HttpServletRequest::getCharacterEncoding)
                .orElse(Constants.UTF_8);

     * @return The HTML response.
     */
    @Execute
    public HtmlResponse search(final SearchForm form) {
        if (viewHelper.isUseSession()) {
            LaRequestUtil.getOptionalRequest().ifPresent(request -> {
                final HttpSession session = request.getSession(false);
                if (session != null && form.num != null) {

     */
    public Set<String> build(final SearchRequestType searchRequestType) {
        final Set<String> roleSet = new HashSet<>();
        final HttpServletRequest request = LaRequestUtil.getOptionalRequest().orElse(null);
        final FessConfig fessConfig = ComponentUtil.getFessConfig();
        final boolean isApiRequest =

     * @param status The status code.
     * @param body The body.
     */
    protected void writeJsonResponse(final int status, final String body) {
        final String callback = LaRequestUtil.getOptionalRequest().map(req -> req.getParameter("callback")).orElse(null);
        final boolean isJsonp = ComponentUtil.getFessConfig().isApiJsonpEnabled() && StringUtil.isNotBlank(callback);

                scheduledJobService.getScheduledJob(id).ifPresent(entity -> {
                    loadScheduledJob(form, entity);
                    form.crudMode = crudMode;
                    LaRequestUtil.getOptionalRequest().ifPresent(request -> {
                        request.setAttribute("running", entity.isRunning());
                        request.setAttribute("enabled", entity.isEnabled());
                    });

        logger.info(message);
    }

    /**
     * Get the client IP.
     * @return The client IP.
     */
    protected String getClientIp() {
        return LaRequestUtil.getOptionalRequest().map(req -> ComponentUtil.getViewHelper().getClientIp(req)).orElse("-");
    }

    /**
     * The action.
     */
    protected enum Action {
        /**
         * The login action.

     * @throws SsoLoginException if SPNEGO authentication fails
     */
    @Override
    public LoginCredential getLoginCredential() {
        return LaRequestUtil.getOptionalRequest().map(request -> {
            if (logger.isDebugEnabled()) {
                logger.debug("Logging in with SPNEGO Authenticator");
            }

     * Resolves the context path from the current request, or empty string if unavailable.
     *
     * @return the context path
     */
    protected String resolveContextPath() {
        return LaRequestUtil.getOptionalRequest().map(HttpServletRequest::getContextPath).orElse("");
    }

    /**
     * Builds a go URL for the given document.
     *
     * @param contextPath the application context path

        groupCache = CacheBuilder.newBuilder().expireAfterWrite(groupCacheExpiry, TimeUnit.SECONDS).build();
    }

    @Override
    public LoginCredential getLoginCredential() {
        return LaRequestUtil.getOptionalRequest().map(request -> {
            if (logger.isDebugEnabled()) {
                logger.debug("Logging in with Entra ID Authenticator");
            }
            final HttpSession session = request.getSession(false);