├── normalizer/                 # Text normalizers
├── converter/                  # Reading converters (katakana, romaji)
├── concurrent/                 # Async patterns (Deferred/Promise)
└── util/                      # Utilities
```

### Key Design Patterns

- **Builder**: SuggesterBuilder, SuggestRequestBuilder
- **Facade**: Suggester (main entry point)
- **Composite**: NormalizerChain, ReadingConverterChain

        assertFalse(validator.isValid("* * * *", context));
    }

    // Test common valid cron patterns that are likely to work
    @Test
    public void test_basicValidCronExpressions() {
        final ConstraintValidatorContext context = null;

        // Test basic patterns that should be valid
        String[] potentiallyValidCrons = { "0 0 * * * ?", // Every hour

            return false;
        }

        Pattern pattern = (Pattern) propMap.get(USER_CODE_PATTERN);
        if (pattern == null) {
            pattern = Pattern.compile(getUserCodePattern());
            propMap.put(USER_CODE_PATTERN, pattern);
        }
        return pattern.matcher(userCode).matches();
    }

    String getQueryCollapseInnerHitsSorts();

└── fess_indices/              # OpenSearch index mappings

src/main/webapp/WEB-INF/view/  # JSP templates
src/test/java/.../it/          # Integration tests (*Tests.java)
```

## Architecture Patterns

### Action (Controller)
- Hierarchy: `TypicalAction` → `FessBaseAction` → `FessAdminAction`/`FessSearchAction`
- `@Execute` marks web endpoints
- `@Resource` for DI

1. Always run `mvn test` after changes
2. Run `mvn formatter:format` before committing
3. Add license headers to new files with `mvn license:format`
4. Maintain backwards compatibility - deprecate before removing

---
name: fastapi
description: FastAPI best practices and conventions. Use when working with FastAPI APIs and Pydantic models for them. Keeps FastAPI code clean and up to date with the latest features and patterns, updated with new versions. Write new code or refactor and update old code.
---

# FastAPI

Official FastAPI skill to write code with best practices, keeping up to date with new versions and features.

## Use the `fastapi` CLI

    /** Pattern for detecting reserved characters in Lucene range field queries. */
    public static final Pattern LUCENE_RANGE_FIELD_RESERVED_PATTERN = Pattern.compile("([!\\(\\){}\\[\\]\"~\\\\:\\p{Zs}]|(&&)|(\\|\\|))");

    // ============================================================
    // Query and Search Constants

crawler.document.html.default.lang=
# Patterns to include for HTML index processing.
crawler.document.html.default.include.index.patterns=
# Patterns to exclude for HTML index processing.
crawler.document.html.default.exclude.index.patterns=(?i).*(css|js|jpeg|jpg|gif|png|bmp|wmv|xml|ico|exe)
# Patterns to include for HTML search processing.
crawler.document.html.default.include.search.patterns=
# Patterns to exclude for HTML search processing.

* Java compilation of Gradle code suffers from small performance penalty (up to 10%).
* Time has to be allocated to clean up existing projects.
* One has to write NullAway-conformant code even when hacking.
* Some patterns used to satisfy NullAway can be slightly more verbose.

```
fess-crawler-parent/
├── fess-crawler/              # Core framework
├── fess-crawler-lasta/        # LastaFlute DI integration
└── fess-crawler-opensearch/   # OpenSearch backend
```

### Key Design Patterns

- **Factory**: `CrawlerClientFactory`, `ExtractorFactory` - protocol/format-specific component selection
- **Strategy**: `CrawlerClient`, `Extractor`, `Transformer` - pluggable implementations