Tópico anterior: Criar um novo adaptador personalizado usando a interface do SDKPróximo tópico: Configurar o novo adaptador de pesquisa personalizado com o componente CAFedSearch


Compilar os arquivos Jar do novo adaptador de pesquisa personalizado

Compile os arquivos jar do adaptador personalizado com êxito.

Siga estas etapas:

  1. Compile os novos adaptadores de pesquisa personalizados. Certifique-se de ter os seguintes arquivos jar em seu Java Classpath:
    jsr311-api-1.0.jar

    Este arquivo jar está disponível no diretório do CA SDM:

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

    Este arquivo está disponível no diretório:

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

    Este arquivo está disponível no diretório:

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

    Este arquivo está disponível no diretório:

    %NX_ROOT%\java\lib
    
  2. Grave uma nova classe Java que estende a classe SearchAdapter e fornece uma implementação do método abstrato.
    search
    

    O componente CAFedSearch chama e transmite os parâmetros do método de pesquisa. Esses parâmetros são incorporados dentro do parâmetro SearchOptions para cada solicitação de pesquisa do cliente.

    Observação: certifique-se de que a implementação seja um segmento seguro, já que o componente CAFedSearch mantém apenas uma instância da classe Java. Para cada operação de pesquisa, o método de pesquisa é chamado na mesma instância.

  3. O parâmetro SearchOptions para o método de pesquisa tem os seguintes métodos:
    getSearchTerms()

    Especifica o método para recuperar a cadeia de caracteres da pesquisa.

    getStartIndex()

    Especifica o método de índice inicial, o número do qual o cliente deseja pesquisar itens. O índice é iniciado em 1.

    getItemsPerPage()

    Especifica o número máximo de resultados da pesquisa que o cliente espera.

    Observação: também é possível usar outros métodos de classe Java. Por exemplo: getUserId()

  4. Envie as informações coletadas para a API do mecanismo de pesquisa externa para recuperar os resultados da pesquisa.

    Observação: para obter mais informações sobre os métodos de classe Java, consulte a documentação do Java.

  5. O método de pesquisa retorna uma instância de classe ResultCollection. Crie uma instância de ResultCollection e preencha os valores usando os seguintes métodos:
    setSources (nome de sequência de caracteres)

    Especifica o nome do adaptador de pesquisa. Os nomes diferenciam maiúsculas de minúsculas e devem corresponder exatamente ao nome do arquivo fornecido no arquivo de configuração do utilitário. Por motivos de conveniência, Searchadapter fornece um método getName() que deve ser usado.

    Por exemplo:

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

    Especifica a contagem total de resultados de pesquisa.

    setStartIndex(int startIndex)

    Especifica um índice de resultados inicial. Esse valor é de acordo com os resultados do mecanismo de pesquisa.

    results.setStartIndex(startIndex);
    
  6. Uma coleção de ResultItems deve ser passada para o objeto ResultCollection chamando o método setSearchResultItems. Para adicionar uma instância ResultItem de cada vez, use o método addSearchResultItem().

    Observação: para obter mais informações sobre a classe Java do ResultCollection, consulte a documentação do Java.

  7. A classe ResultItem possui os importantes métodos a seguir, que devem ser preenchidos para cada item de resultado da pesquisa (linha).
    setContentText(String txt)

    Especifica um método para definir o conteúdo real do resultado da pesquisa.

    setContentHTML(String txt)

    Especifica um método para definir o conteúdo HTML (pode conter as marcas HTML). Se o mecanismo de pesquisa fornecer HTML em destaque, defina o texto destacado usando esse método.

    Observação: se o mecanismo de pesquisa não tiver esse recurso, você pode gravar um método de classe Java simples para realçar o texto. O adaptador do CA Open Space tem um método simples para adicionar negrito aos termos nos resultados da pesquisa.

    setTitleHTML(String titleHTML)

    Um método para definir um título em HTML (pode conter as marcas HTML).

    setTitleText(String titleText)

    Um método para definir um título simples (não podem conter as marcas HTML).

    setSource(String source)

    Um método para definir o atributo de origem. Uma invocação típica seria um item setSource(getName());

    Observação: se o adaptador de pesquisa necessitar de mais arquivos jar, personalize o build.xml para compilar e preparar um arquivo jar do adaptador. Antibinários são obrigatórios para usar o build.xml. Use Ant para executar os destinos em build.xml para compilar e fazer os arquivos JAR manterem o build.xml juntamente com sua pasta de origem (src). O arquivo build.properties é opcional. Para obter mais informações sobre binários do Ant, consulte a ajuda do Ant.

    O arquivo jar é compilado com êxito.