/**
 * Validation constraint to ensure that a string is a valid cron expression.
 */
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })
@Retention(RUNTIME)
@Documented
@Constraint(validatedBy = CronExpressionValidator.class)
public @interface CronExpression {

    /**
     * The error message when validation fails.
     * @return the error message
     */

 * This annotation validates URI strings based on specified protocol types.
 */
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })
@Retention(RUNTIME)
@Documented
@Constraint(validatedBy = UriTypeValidator.class)
public @interface UriType {

    /**
     * Specifies the protocol type to validate against.
     *
     * @return the protocol type
     */
    ProtocolType protocolType();

/**
 * Validation constraint for custom size limits based on configuration keys.
 */
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })
@Retention(RUNTIME)
@Documented
@Constraint(validatedBy = CustomSizeValidator.class)
public @interface CustomSize {

    /**
     * The error message when validation fails.
     * @return the error message
     */

        jakarta.validation.Constraint constraint = CronExpression.class.getAnnotation(jakarta.validation.Constraint.class);
        assertNotNull(constraint);
        Class<?>[] validators = constraint.validatedBy();
        assertEquals(1, validators.length);
        assertEquals(CronExpressionValidator.class, validators[0]);
    }

    // Test validation with valid cron expressions
    @Test

        assertNotNull(constraint, "Constraint annotation should be present");
        assertEquals("Validator class should be UriTypeValidator", UriTypeValidator.class, constraint.validatedBy()[0]);
        assertEquals("Should have exactly one validator", 1, constraint.validatedBy().length);
    }

    // Test default values
    @Test
    public void test_defaultValues() throws Exception {

        assertNotNull(constraint, "Constraint annotation should be present");
        assertEquals("Validator class should be CustomSizeValidator", CustomSizeValidator.class, constraint.validatedBy()[0]);
    }

    // Test default values
    @Test
    public void test_defaultValues() throws Exception {
        final Field field = CustomSizeTest.class.getDeclaredField("testField");

 * This class extends FessApiAction to provide admin-specific functionality
 * including enhanced access control for administrative operations.
 *
 * <p>Admin API actions require special permissions and access tokens
 * that are validated against the admin role configuration.</p>
 */
public abstract class FessApiAdminAction extends FessApiAction {

    /** Logger instance for this class. */

        }
        return redirect(getClass());
    }

    /**
     * Reloads the document index by closing and reopening it.
     *
     * @param form the action form (validated but not used for configuration)
     * @return HTML response redirecting to the maintenance page
     */
    @Execute
    @Secured({ ROLE })
    public HtmlResponse reloadDocIndex(final ActionForm form) {

     * Only configured label values are accepted to prevent query injection.
     *
     * @param request the HTTP request
     * @return a map of field names to their validated filter values
     */
    protected Map<String, String[]> parseFieldFilters(final HttpServletRequest request) {
        final Map<String, String[]> fields = new HashMap<>();

    }

    /**
     * Gets the page size for search log results with validation.
     * Returns the default page size if the current size is invalid.
     *
     * @return the validated page size
     */
    public int getPageSize() {
        if (StringUtil.isBlank(size)) {
            return SearchLogPager.DEFAULT_PAGE_SIZE;
        }
        try {