Vorheriges Thema: Erstellen Sie einen neuen anwenderspezifischen Adapter mithilfe der SDK-SchnittstelleNächstes Thema: Konfigurieren Sie den neuen anwenderspezifischen Suchadapter mit der Komponente "CAFedSearch"


Kompilieren der JAR-Dateien des neuen anwenderspezifischen Adapters

Kompilieren Sie die JAR-Dateien des anwenderspezifischen Adapters erfolgreich.

Gehen Sie wie folgt vor:

  1. Kompilieren Sie die neuen anwenderspezifischen Suchadapter. Stellen Sie sicher, dass Sie folgende jar-Dateien in Ihrem Java-Klassenpfad haben:
    jsr311-api-1.0.jar

    Diese jar-Datei ist im CA SDM-Verzeichnis verfügbar:

    %NX_ROOT%\java\lib\CXF\
    
    cafedsearch-core.jar

    Diese Datei ist im Verzeichnis verfügbar:

    %NX_ROOT%\bopcfg\www\CATALINA_BASE_FS\webapps\cafedsearch\WEB-INF\lib
    
    cafedsearch-adapter-sdk-1.0.0.jar

    Diese Datei ist im Verzeichnis verfügbar:

    %NX_ROOT%\bopcfg\www\CATALINA_BASE_FS\webapps\cafedsearch\WEB-INF\lib
    
    log4j-1.2.15.jar (optional)

    Diese Datei ist im Verzeichnis verfügbar:

    %NX_ROOT%\java\lib
    
  2. Schreiben Sie eine neue Java-Klasse, die die Klasse "SearchAdapter" erweitert und eine Implementierung für die abstrakte Methode angibt.
    Suche
    

    Die Komponente "CAFedSearch" ruft die Suchmethodenparameter auf und gibt sie weiter. Diese Parameter werden im Parameter "SearchOptions" für jede Suchanfrage vom Client eingebettet.

    Hinweis: Stellen Sie sicher, dass Ihre Implementierung Thread-sicher ist, da die Komponente "CAFedSearch" nur eine Instanz der Java-Klasse verwaltet. Für jeden Suchvorgang wird das Suchverfahren auf der gleichen Instanz aufgerufen

  3. Der Parameter "SearchOptions" für das Suchverfahren hat folgende Methoden:
    getSearchTerms()

    Gibt die Methode für das Abrufen der Suchzeichenfolge an.

    getStartIndex()

    Gibt die Startindexmethode an, d. h. die Zahl, ab der der Client Elemente suchen möchte. Der Index beginnt mit 1.

    getItemsPerPage()

    Gibt die Höchstanzahl der Suchergebnisse an, die der Client erwartet.

    Hinweis: Sie können auch andere Java-Klassen-Methoden verwenden. Zum Beispiel: getUserId()

  4. Senden Sie die erfassten Informationen an die externe Suchmaschinen-API für das Abrufen der Suchergebnisse.

    Hinweis: Weitere Informationen über Java-Klassen-Methoden finden Sie in der Java-Dokumentation.

  5. Die Suchmethode gibt eine Instanz der ResultCollection-Klasse zurück. Erstellen Sie eine Instanz der ResultCollection, und stellen Sie Werte mithilfe der folgenden Methoden bereit:
    setSources(String name)

    Gibt den Namen des Suchadapters an. Namen unterscheiden zwischen Groß- und Kleinschreibung und müssen genau mit dem Namen übereinstimmen, der in der Konfigurationsdatei des Hilfsprogramms angegeben wird. Aus Zweckmäßigkeitsgründen stellt SearchAdapter die Methode "getName()" bereit, die verwendet werden sollte.

    Beispiel:

    results.setSources(getName());
    
    setTotalResults (int total)

    Gibt die Gesamtanzahl der Suchergebnisse an.

    setStartIndex(int Startindex)

    Gibt einen Startindex von Ergebnissen an. Geben Sie diesen Wert gemäß den Ergebnissen von Ihrer Suchmaschine ein.

    results.setStartIndex(startIndex);
    
  6. Eine Sammlung von "ResultItems" muss in das Objekt "ResultCollection" durch Aufruf der Methode "setSearchResultItems" übergeben werden. Um gleichzeitig eine Instanz von "ResultItem" hinzuzufügen, verwenden Sie die Methode "addSearchResultItem()".

    Hinweis: Weitere Informationen zur Java-Klasse "ResultCollection" finden Sie in der Java-Dokumentation.

  7. Die ResultItem-Klasse hat die folgenden wichtigen Methoden, die für jedes Suchergebniselement (Zeile) gefüllt werden müssen.
    setContentText(String txt)

    Gibt eine Methode für das Festlegen des tatsächlichen Inhalts der Suchergebnisse an.

    setContentHTML(String txt)

    Gibt eine Methode zur Festlegung des HTML-Inhalts an (kann HTML-Tags enthalten). Wenn die Suchmaschine HTML hervorhebt, dann legen Sie den hervorgehobenen Text mithilfe dieser Methode fest.

    Hinweis: Verfügt Ihre Suchmaschine nicht über diese Funktion, können Sie zur Hervorhebung des Texts eine einfache Java-Klassenmethode schreiben. Der CA Open Space-Adapter hat eine einfache Methode, um Bedingungen in den Suchergebnissen in Fettschrift zu setzen.

    setTitleHTML(String titleHTML)

    Methode zur Festlegung des HTML-Titels (kann die HTML-Tags enthalten).

    setTitleText(String titleText)

    Methode zur Festlegung eines einfachen Titels (kann keine HTML-Tags enthalten).

    setSource(String source)

    Methode zur Festlegung des Quellenattributs. Ein typischer Aufruf wäre "item setSource(getName());"

    Hinweis: Wenn der Suchadapter mehr JAR-Dateien benötigt, passen Sie build.xml an, um eine JAR-Datei des Adapters zu kompilieren und vorzubereiten. Ant-Binärdateien sind erforderlich, um build.xml zu verwenden. Verwenden Sie "Ant", um die Ziele in build.xml auszuführen, um die JAR-Dateien zu kompilieren und zu erstellen. Halten Sie build.xml mit Ihrem Quellordner (src) zusammen. Die build.properties-Datei ist optional. Weitere Informationen über Ant-Binärdateien finden Sie in der Ant-Hilfe.

    Die JAT-Datei ist erfolgreich kompiliert.