Fess Fess 15.3
Support

Menu

Allgemein

Einstieg

Dokumentation

Tutorial

Entwicklung

Sonstiges

Archiv

Support

Architektur und Codestruktur

Diese Seite erklärt die Architektur, Codestruktur und Hauptkomponenten von Fess. Durch das Verständnis der internen Struktur von Fess können Sie effizient entwickeln.

Gesamtarchitektur

Fess besteht aus folgenden Hauptkomponenten:

┌─────────────────────────────────────────────────┐
│          Benutzerschnittstelle                  │
│  ┌──────────────┐      ┌──────────────┐        │
│  │  Suchseite    │      │ Verwaltung   │        │
│  │  (JSP/HTML)   │      │   (JSP/HTML) │        │
│  └──────────────┘      └──────────────┘        │
└─────────────────────────────────────────────────┘
                    ↓
┌─────────────────────────────────────────────────┐
│           Webanwendungsschicht                   │
│  ┌──────────────────────────────────────────┐  │
│  │           LastaFlute                       │  │
│  │  ┌────────┐  ┌─────────┐  ┌──────────┐  │  │
│  │  │ Action │  │  Form   │  │  Service │  │  │
│  │  └────────┘  └─────────┘  └──────────┘  │  │
│  └──────────────────────────────────────────┘  │
└─────────────────────────────────────────────────┘
                    ↓
┌─────────────────────────────────────────────────┐
│           Geschäftslogikschicht                  │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐    │
│  │ Crawler  │  │  Job     │  │  Helper  │    │
│  └──────────┘  └──────────┘  └──────────┘    │
└─────────────────────────────────────────────────┘
                    ↓
┌─────────────────────────────────────────────────┐
│           Datenzugriffsschicht                   │
│  ┌──────────────────────────────────────────┐  │
│  │          DBFlute / OpenSearch             │  │
│  │  ┌────────┐  ┌─────────┐  ┌──────────┐  │  │
│  │  │Behavior│  │ Entity  │  │  Query   │  │  │
│  │  └────────┘  └─────────┘  └──────────┘  │  │
│  └──────────────────────────────────────────┘  │
└─────────────────────────────────────────────────┘
                    ↓
┌─────────────────────────────────────────────────┐
│               Datenspeicher                      │
│              OpenSearch 3.3.0                   │
└─────────────────────────────────────────────────┘

Beschreibung der Schichten

Benutzerschnittstellenschicht

Dies ist die Oberfläche, die Benutzer direkt bedienen. Sie ist mit JSP, HTML und JavaScript implementiert.

  • Suchseite: Suchoberfläche für Endbenutzer

  • Verwaltungsseite: Konfigurations- und Verwaltungsoberfläche für Systemadministratoren

Webanwendungsschicht

Dies ist die Webanwendungsschicht, die das LastaFlute-Framework verwendet.

  • Action: Verarbeitet HTTP-Anfragen und ruft Geschäftslogik auf

  • Form: Empfang von Anfrageparametern und Validierung

  • Service: Implementierung der Geschäftslogik

Geschäftslogikschicht

Dies ist die Schicht, die die Hauptfunktionen von Fess implementiert.

  • Crawler: Sammelt Daten von Websites und Dateisystemen

  • Job: Geplant ausgeführte Aufgaben

  • Helper: In der gesamten Anwendung verwendete Hilfsklassen

Datenzugriffsschicht

Dies ist die Zugriffsschicht auf OpenSearch mit DBFlute.

  • Behavior: Schnittstelle für Datenoperationen

  • Entity: Datenentität

  • Query: Aufbau von Suchabfragen

Datenspeicherschicht

Verwendet OpenSearch 3.3.0 als Suchmaschine.

Projektstruktur

Verzeichnisstruktur

fess/
├── src/
│   ├── main/
│   │   ├── java/org/codelibs/fess/
│   │   │   ├── app/              # Webanwendung
│   │   │   │   ├── web/          # Suchseite
│   │   │   │   │   ├── admin/    # Verwaltungsseite
│   │   │   │   │   │   ├── ...Action.java
│   │   │   │   │   │   └── ...Form.java
│   │   │   │   │   └── ...Action.java
│   │   │   │   └── service/      # Service-Schicht
│   │   │   ├── crawler/          # Crawler
│   │   │   │   ├── client/       # Crawler-Client
│   │   │   │   ├── extractor/    # Inhaltsextraktion
│   │   │   │   ├── filter/       # Filter
│   │   │   │   └── transformer/  # Datentransformation
│   │   │   ├── es/               # OpenSearch-bezogen
│   │   │   │   ├── client/       # OpenSearch-Client
│   │   │   │   ├── query/        # Abfrage-Builder
│   │   │   │   └── config/       # Konfigurationsverwaltung
│   │   │   ├── helper/           # Hilfsklassen
│   │   │   │   ├── ...Helper.java
│   │   │   ├── job/              # Jobs
│   │   │   │   ├── ...Job.java
│   │   │   ├── util/             # Utilities
│   │   │   ├── entity/           # Entitäten (automatisch generiert)
│   │   │   ├── mylasta/          # LastaFlute-Konfiguration
│   │   │   │   ├── action/       # Action-Basisklassen
│   │   │   │   ├── direction/    # Anwendungskonfiguration
│   │   │   │   └── mail/         # Mail-Konfiguration
│   │   │   ├── Constants.java    # Konstantendefinitionen
│   │   │   └── FessBoot.java     # Startklasse
│   │   ├── resources/
│   │   │   ├── fess_config.properties  # Konfigurationsdatei
│   │   │   ├── fess_config.xml         # Zusätzliche Konfiguration
│   │   │   ├── fess_message_ja.properties  # Nachrichten (Japanisch)
│   │   │   ├── fess_message_en.properties  # Nachrichten (Englisch)
│   │   │   ├── log4j2.xml              # Log-Konfiguration
│   │   │   └── ...
│   │   └── webapp/
│   │       ├── WEB-INF/
│   │       │   ├── view/          # JSP-Dateien
│   │       │   │   ├── admin/     # Verwaltungs-JSPs
│   │       │   │   └── ...
│   │       │   └── web.xml
│   │       ├── css/               # CSS-Dateien
│   │       ├── js/                # JavaScript-Dateien
│   │       └── images/            # Bilddateien
│   └── test/
│       └── java/org/codelibs/fess/
│           ├── ...Test.java       # Testklassen
│           └── it/                # Integrationstests
├── pom.xml                        # Maven-Konfiguration
├── dbflute_fess/                  # DBFlute-Konfiguration
│   ├── dfprop/                    # DBFlute-Eigenschaften
│   └── freegen/                   # FreeGen-Konfiguration
└── README.md

Details zu Hauptpaketen

app-Paket

Code der Webanwendungsschicht.

app.web-Paket

Implementiert Suchseite und Endbenutzerfunktionen.

Hauptklassen:

  • SearchAction.java: Suchverarbeitung

  • LoginAction.java: Login-Verarbeitung

Beispiel:

@Execute
public HtmlResponse index(SearchForm form) {
    // Implementierung der Suchverarbeitung
    return asHtml(path_IndexJsp);
}

app.web.admin-Paket

Implementiert Funktionen der Verwaltungsseite.

Hauptklassen:

  • BwCrawlingConfigAction.java: Web-Crawl-Konfiguration

  • BwSchedulerAction.java: Scheduler-Verwaltung

  • BwUserAction.java: Benutzerverwaltung

Namenskonventionen:

  • Bw-Präfix: Admin-Action

  • Action-Suffix: Action-Klasse

  • Form-Suffix: Form-Klasse

app.service-Paket

Service-Schicht, die Geschäftslogik implementiert.

Hauptklassen:

  • SearchService.java: Suchdienst

  • UserService.java: Benutzerverwaltungsdienst

  • ScheduledJobService.java: Job-Verwaltungsdienst

Beispiel:

public class SearchService {
    public SearchResponse search(SearchRequestParams params) {
        // Implementierung der Suchlogik
    }
}

crawler-Paket

Implementiert Datensammlungsfunktionen.

crawler.client-Paket

Implementiert Zugriff auf verschiedene Datenquellen.

Hauptklassen:

  • FessClient.java: Basisklasse für Crawler-Client

  • WebClient.java: Crawlen von Websites

  • FileSystemClient.java: Crawlen von Dateisystemen

  • DataStoreClient.java: Crawlen von Datenbanken usw.

crawler.extractor-Paket

Extrahiert Text aus Dokumenten.

Hauptklassen:

  • ExtractorFactory.java: Extractor-Factory

  • TikaExtractor.java: Extraktion mit Apache Tika

crawler.transformer-Paket

Transformiert gecrawlte Daten in Suchformat.

Hauptklassen:

  • Transformer.java: Schnittstelle für Transformationsverarbeitung

  • BasicTransformer.java: Grundlegende Transformationsverarbeitung

es-Paket

Implementiert Integration mit OpenSearch.

es.client-Paket

Implementierung des OpenSearch-Clients.

Hauptklassen:

  • FessEsClient.java: OpenSearch-Client

  • SearchEngineClient.java: Schnittstelle des Suchmaschinen-Clients

es.query-Paket

Implementiert Aufbau von Suchabfragen.

Hauptklassen:

  • QueryHelper.java: Hilfsprogramm für Abfrage-Aufbau

  • FunctionScoreQueryBuilder.java: Score-Anpassung

helper-Paket

In der gesamten Anwendung verwendete Hilfsklassen.

Hauptklassen:

  • SystemHelper.java: Systemweites Hilfsprogramm

  • CrawlingConfigHelper.java: Hilfsprogramm für Crawl-Konfiguration

  • SearchLogHelper.java: Hilfsprogramm für Suchprotokolle

  • UserInfoHelper.java: Hilfsprogramm für Benutzerinformationen

  • ViewHelper.java: Hilfsprogramm für Ansichten

Beispiel:

public class SystemHelper {
    public void initializeSystem() {
        // Systeminitialisierungsverarbeitung
    }
}

job-Paket

Implementiert geplant ausgeführte Jobs.

Hauptklassen:

  • CrawlJob.java: Crawl-Job

  • SuggestJob.java: Suggest-Job

  • ScriptExecutorJob.java: Skriptausführungs-Job

Beispiel:

public class CrawlJob extends LaJob {
    @Override
    public void run() {
        // Implementierung der Crawl-Verarbeitung
    }
}

entity-Paket

Entitätsklassen, die OpenSearch-Dokumenten entsprechen. Dieses Paket wird automatisch von DBFlute generiert.

Hauptklassen:

  • SearchLog.java: Suchprotokoll

  • ClickLog.java: Klickprotokoll

  • FavoriteLog.java: Favoritenprotokoll

  • User.java: Benutzerinformationen

  • Role.java: Rolleninformationen

Bemerkung

Der Code im entity-Paket wird automatisch generiert, bearbeiten Sie ihn daher nicht direkt. Aktualisieren Sie durch Ändern des Schemas und Neugenerierung.

mylasta-Paket

Führt Konfiguration und Anpassung von LastaFlute durch.

mylasta.action-Paket

Definiert Basisklassen für Actions.

  • FessUserBean.java: Benutzerinformationen

  • FessHtmlPath.java: HTML-Pfaddefinition

mylasta.direction-Paket

Führt anwendungsweite Konfiguration durch.

  • FessConfig.java: Laden der Konfiguration

  • FessFwAssistantDirector.java: Framework-Konfiguration

Entwurfsmuster und Implementierungsmuster

In Fess werden folgende Entwurfsmuster verwendet.

MVC-Muster

Mit LastaFlute im MVC-Muster implementiert.

  • Model: Service, Entity

  • View: JSP

  • Controller: Action

Beispiel:

// Controller (Action)
public class SearchAction extends FessBaseAction {
    @Resource
    private SearchService searchService;  // Model (Service)

    @Execute
    public HtmlResponse index(SearchForm form) {
        SearchResponse response = searchService.search(form);
        return asHtml(path_IndexJsp).renderWith(data -> {
            data.register("response", response);  // Datenweitergabe an View (JSP)
        });
    }
}

DI-Muster

Verwendet den DI-Container von LastaFlute.

public class SearchService {
    @Resource
    private SearchEngineClient searchEngineClient;

    @Resource
    private UserInfoHelper userInfoHelper;
}

Factory-Muster

Wird zur Erzeugung verschiedener Komponenten verwendet.

public class ExtractorFactory {
    public Extractor createExtractor(String mimeType) {
        // Erzeugt Extractor entsprechend dem MIME-Typ
    }
}

Strategy-Muster

Wird in Crawlern und Transformern verwendet.

public interface Transformer {
    Map<String, Object> transform(Map<String, Object> data);
}

public class HtmlTransformer implements Transformer {
    // Transformationsverarbeitung für HTML
}

Konfigurationsverwaltung

Die Konfiguration von Fess wird in mehreren Dateien verwaltet.

fess_config.properties

Definiert Hauptkonfiguration der Anwendung.

# Portnummer
server.port=8080

# OpenSearch-Verbindungskonfiguration
opensearch.http.url=http://localhost:9201

# Crawl-Konfiguration
crawler.document.max.size=10000000

fess_config.xml

Zusätzliche Konfiguration im XML-Format.

<component name="searchService" class="...SearchService">
    <property name="maxSearchResults">1000</property>
</component>

fess_message_*.properties

Nachrichtendateien für mehrsprachige Unterstützung.

  • fess_message_ja.properties: Japanisch

  • fess_message_en.properties: Englisch

Datenfluss

Suchablauf

1. Benutzer sucht auf der Suchseite
   ↓
2. SearchAction empfängt Suchanfrage
   ↓
3. SearchService führt Geschäftslogik aus
   ↓
4. SearchEngineClient sendet Suchabfrage an OpenSearch
   ↓
5. OpenSearch gibt Suchergebnisse zurück
   ↓
6. SearchService formatiert Ergebnisse
   ↓
7. SearchAction gibt Ergebnisse an JSP weiter und zeigt sie an

Crawl-Ablauf

1. CrawlJob wird geplant ausgeführt
   ↓
2. CrawlingConfigHelper ruft Crawl-Konfiguration ab
   ↓
3. FessClient greift auf Zielseite zu
   ↓
4. Extractor extrahiert Text aus Inhalt
   ↓
5. Transformer transformiert Daten in Suchformat
   ↓
6. SearchEngineClient registriert Dokument in OpenSearch

Erweiterungspunkte

Fess kann an folgenden Punkten erweitert werden.

Hinzufügen benutzerdefinierter Crawler

Durch Erben von FessClient können Sie benutzerdefinierte Datenquellen unterstützen.

Hinzufügen benutzerdefinierter Transformer

Durch Implementieren von Transformer können Sie benutzerdefinierte Datentransformationsverarbeitung hinzufügen.

Hinzufügen benutzerdefinierter Extractoren

Durch Implementieren von Extractor können Sie benutzerdefinierte Inhaltsextraktionsverarbeitung hinzufügen.

Hinzufügen benutzerdefinierter Plugins

Durch Implementieren der Plugin-Schnittstelle können Sie benutzerdefinierte Plugins erstellen.

Referenzmaterialien

Frameworks

Technische Dokumentation

Nächste Schritte

Nachdem Sie die Architektur verstanden haben, lesen Sie folgende Dokumentation: