solr的javaapi

### Solr Java API 使用教程

#### 高级接口概述
SolrJ 是一个用于简化 Java 应用程序与 Solr 服务器之间通信的库。该工具使得开发者无需关注底层网络协议的具体实现，而是能够专注于业务逻辑开发[^1]。

#### 主要功能特性
- 支持大部分标准 Solr 功能；
- 提供灵活配置选项适应不同应用场景需求；
- 实现了高效的数据传输机制优化性能表现；

#### 基本操作指南

##### 添加依赖项
为了能够在项目中使用 SolrJ ，首先需要引入相应的 Maven 或 Gradle 依赖：

对于 Maven 用户来说，在 `pom.xml` 文件内加入如下片段即可完成集成工作：

<dependency>
    <groupId>org.apache.solr</groupId>
    <artifactId>solr-solrj</artifactId>
    <version>8.11.1</version> <!-- 版本号需根据实际情况调整 -->
</dependency>

##### 创建客户端实例
初始化过程中指定目标 Solr Server 的地址信息以便后续发起请求时定位服务端点位置。

import org.apache.solr.client.solrj.SolrClient;
import org.apache.solr.client.solrj.impl.HttpSolrClient;

public class Example {
    
    private static final String SOLR_URL = "http://localhost:8983/solr";
    
    public void createClient() throws Exception{
        SolrClient client = new HttpSolrClient.Builder(SOLR_URL).build();
        
        // 进一步的操作...
    }
}

##### 执行查询命令
构建 Query 对象并设置参数来定义所需检索条件，最后调用 execute 方法获取结果集。

import org.apache.solr.client.solrj.response.QueryResponse;
import org.apache.solr.common.params.ModifiableSolrParams;
import org.apache.solr.common.util.NamedList;

// ... 继续上面的例子

public List<String> performQuery(String keyword) throws Exception{
    ModifiableSolrParams params = new ModifiableSolrParams();
    params.set("q", keyword);
    
    QueryResponse response = client.query(params);
    NamedList<?> result = response.getResponse();

    // 解析返回值...

    return parsedResults;
}

##### 更新索引记录
当涉及到向现有集合添加新条目或是更新已有实体属性时，则可通过 addDocument 和 commit 函数达成目的。

import org.apache.solr.common.SolrInputDocument;

// ... 

public boolean updateIndex(Map<String, Object> fields) throws Exception{
    SolrInputDocument doc = new SolrInputDocument();
    for (Map.Entry<String, Object> entry : fields.entrySet()) {
        doc.addField(entry.getKey(), entry.getValue());
    }

    client.add(doc);
    client.commit();  

    return true;
}

##### 删除特定文档
利用 deleteById 或者 deleteByQuery 来移除符合条件的对象。

// ...

public void removeDocuments(List<String> idsToDelete) throws Exception{
    for (String id : idsToDelete){
        client.deleteById(id);
    }
    client.commit();
}

public void clearAllMatchingDocs(String queryCondition) throws Exception{
    client.deleteByQuery(queryCondition);  
    client.commit();
}