<sources>
								<source>
									<location>${project.build.directory}/tomcat-lib</location>
								</source>
							</sources>
						</mapping>
						<mapping>
							<directory>${packaging.fess.lib.dir}/classes/org/codelibs/fess</directory>
							<sources>
								<source>
									<location>${project.build.directory}/fess/WEB-INF/classes/org/codelibs/fess</location>
									<includes>

## Key Patterns

### Actions (Controllers)
- Located in `app.web.*` or `app.web.admin.*`
- Methods with `@Execute` are web endpoints
- DI via `@Resource` annotation
- `HtmlResponse` for JSP, `JsonResponse` for APIs

### Services
- Business logic in `app.service.*`
- Injected into Actions
- Use behavior classes to access OpenSearch

### Helpers

		<delete dir="${thumbnail.dir}/lib" />
		<mkdir dir="${thumbnail.dir}/lib" />
		<!-- annotation-api -->
		<antcall target="install.env.jar">
			<param name="repo.url" value="${maven.release.repo.url}" />
			<param name="jar.groupId" value="jakarta/annotation" />
			<param name="jar.artifactId" value="jakarta.annotation-api" />
			<param name="jar.version" value="2.1.1" />
			<param name="file.version" value="2.1.1" />

import org.apache.pdfbox.pdmodel.common.filespecification.PDEmbeddedFile;
import org.apache.pdfbox.pdmodel.common.filespecification.PDFileSpecification;
import org.apache.pdfbox.pdmodel.interactive.annotation.PDAnnotation;
import org.apache.pdfbox.pdmodel.interactive.annotation.PDAnnotationFileAttachment;
import org.apache.pdfbox.text.PDFTextStripper;
import org.codelibs.core.lang.ThreadUtil;
import org.codelibs.fess.crawler.entity.ExtractData;

    }

    /**
     * Constructs the redirect location from a base URL and location header.
     *
     * @param url The base URL
     * @param location The location header value
     * @return The constructed redirect location
     */
    protected static String constructRedirectLocation(final String url, final String location) {
        try {
            URI uri = new URI(url);

import org.codelibs.fess.util.ComponentUtil;
import org.lastaflute.di.core.SingletonLaContainer;
import org.lastaflute.di.core.exception.ComponentNotFoundException;

import jakarta.annotation.PostConstruct;

/**
 * Helper class for document processing and manipulation in the Fess search system.
 * This class provides utilities for processing document content, titles, and digests,

---

## Key Components

### Suggester (Main Entry Point)
Location: `src/main/java/org/codelibs/fess/suggest/Suggester.java`

Main operations: `suggest()`, `popularWords()`, `indexer()`, `createIndexIfNothing()`, `createNextIndex()`, `switchIndex()`, `removeDisableIndices()`

### SuggestIndexer (Indexing Engine)
Location: `src/main/java/org/codelibs/fess/suggest/index/SuggestIndexer.java`

import org.codelibs.core.lang.StringUtil;
import org.codelibs.fess.crawler.container.CrawlerContainer;
import org.codelibs.fess.crawler.exception.CrawlerSystemException;

import jakarta.annotation.PostConstruct;
import jakarta.annotation.Resource;

/**
 * A factory class for managing and creating crawler clients based on URL patterns.
 * This class implements AutoCloseable to properly handle resource cleanup.
 *

import org.codelibs.fess.crawler.helper.MemoryDataHelper;
import org.codelibs.fess.crawler.service.DataService;
import org.codelibs.fess.crawler.util.AccessResultCallback;

import jakarta.annotation.Resource;

/**
 * Implementation of the {@link DataService} interface for managing access result data.
 * This class provides methods to store, retrieve, update, and delete access results,

import org.apache.logging.log4j.Logger;
import org.codelibs.fess.dict.DictionaryCreator;
import org.codelibs.fess.dict.DictionaryFile;
import org.codelibs.fess.dict.DictionaryItem;

import jakarta.annotation.PostConstruct;

/**
 * Creator for character mapping dictionary files.
 * Handles the creation and management of character mapping dictionaries used for text normalization.
 */