- **JUnit 4**: Testing framework
- **Maven**: Build and dependency management

## Quick Start

### Prerequisites

- Java 21 or higher
- OpenSearch/Elasticsearch cluster (2.x+ recommended)
- Maven 3.8+ for building from source

### Installation

Add the dependency to your `pom.xml`:

```xml
<dependency>
    <groupId>org.codelibs.fess</groupId>
    <artifactId>fess-suggest</artifactId>

    /**
     * Sets up the query conditions for retrieving job logs based on the pager configuration.
     * Configures filtering and ordering for the database query.
     *
     * @param cb the condition bean for building the query
     * @param jobLogPager the pager containing filter and search criteria
     */
    protected void setupListCondition(final JobLogCB cb, final JobLogPager jobLogPager) {
        if (jobLogPager.id != null) {

     * This method configures wildcard searches for term and queries fields, and sets up ordering.
     *
     * @param cb the condition bean for building the query
     * @param relatedQueryPager the pager containing search parameters
     */
    protected void setupListCondition(final RelatedQueryCB cb, final RelatedQueryPager relatedQueryPager) {

    }

    @Test
    @DisplayName("sendrecv with null buffers throws relevant exceptions")
    void testSendRecvInvalidInputs() throws CIFSException {
        // Null out buffer for SMB2 path -> expect NPE when building request
        when(pipe.ensureTreeConnected()).thenReturn(tree);
        when(tree.acquire()).thenReturn(tree);
        when(tree.isSMB2()).thenReturn(true);

import org.codelibs.fess.Constants;
import org.codelibs.fess.entity.SearchRequestParams;
import org.codelibs.fess.helper.RelatedQueryHelper;
import org.codelibs.fess.mylasta.direction.FessConfig;

/**
 * A utility class for building query strings with proper escaping and parameters.
 * This class provides methods to construct search queries from various parameters,
 * handle special characters, and format the final query string for search operations.
 */

        // Return just the base; caller is responsible for placing ctx at the correct absolute offset.
        // We will return a composite buffer from the test when building the full packet.
        // To keep this helper simple, return base and let the caller append/pad and inject ctx.
        return base;
    }

    /**

 *   <li>Adding tags, roles, fields, kinds, and languages to the request.</li>
 *   <li>Configuring suggestion details, reading converter, normalizer, prefix match weight, match word first, and skip duplicate words options.</li>
 *   <li>Building the query and filter query for the suggestion request.</li>
 *   <li>Processing the request and handling the response or failure.</li>
 *   <li>Creating the response from the search results.</li>
 * </ul>
 *

- **Memory efficient** - Specialized collections like `LruHashMap` and `ArrayMap` for memory-conscious applications
- **Java 21 features** - Switch expressions and pattern matching for reduced overhead

## 🧪 Building and Testing

### Development Setup
```bash
# Clone the repository
git clone https://github.com/codelibs/corelib.git
cd corelib

# Compile the project
mvn clean compile

# Run all tests

 *   <li>{@link #removeDisableIndices()}: Removes disabled indices.</li>
 *   <li>{@link #indexer()}: Creates a new SuggestIndexer for indexing suggestions.</li>
 *   <li>{@link #builder()}: Creates a new SuggesterBuilder for building Suggester instances.</li>
 *   <li>{@link #settings()}: Returns the SuggestSettings instance.</li>
 *   <li>{@link #getReadingConverter()}: Returns the ReadingConverter instance.</li>

- **Extractors**: Content extraction from various formats
- **Transformers**: Data transformation and enrichment
- **Filters**: URL filtering with regex patterns
- **Rules**: Content processing rules and validation

## Building and Testing

### Build Commands

```bash
# Build all modules
mvn clean install

# Build without tests
mvn clean install -DskipTests

# Build specific module