摘要：入門(mén)本節(jié)描述從獲取工件到在應(yīng)用程序中使用它如何開(kāi)始使用低級(jí)別客戶端。倉(cāng)庫(kù)低級(jí)別客戶端托管在上，所需的最低版本是。請(qǐng)注意，對(duì)進(jìn)行也會(huì)產(chǎn)生影響，例如，對(duì)圖層進(jìn)行意味著第三方日志記錄后端也需要。

本節(jié)描述從獲取工件到在應(yīng)用程序中使用它如何開(kāi)始使用低級(jí)別REST客戶端。

可以在https://artifacts.elastic.co/javadoc/org/elasticsearch/client/elasticsearch-rest-client/6.4.2/index.html找到低級(jí)別REST客戶端的javadoc。

低級(jí)別Java REST客戶端托管在Maven Central上，所需的最低Java版本是1.7。

低級(jí)別REST客戶端與Elasticsearch具有相同的發(fā)布周期，將版本替換為想要的客戶端版本，首先使用5.0.0-alpha4發(fā)布版，客戶端版本與客戶端可以與之通信的Elasticsearch版本之間沒(méi)有任何關(guān)系，低級(jí)別REST客戶端與所有Elasticsearch版本兼容。

如果你正在尋找SNAPSHOT版本，可以通過(guò)https://snapshots.elastic.co/maven/獲取Elastic Maven Snapshot存儲(chǔ)庫(kù)。

以下是如何使用maven作為依賴關(guān)系管理器來(lái)配置依賴關(guān)系，將以下內(nèi)容添加到pom.xml文件中：

    org.elasticsearch.client
    elasticsearch-rest-client
    6.4.2

以下是使用gradle作為依賴關(guān)系管理器配置依賴關(guān)系的方法，將以下內(nèi)容添加到build.gradle文件中：

dependencies {
    compile "org.elasticsearch.client:elasticsearch-rest-client:6.4.2"
}

低級(jí)別的Java REST客戶端內(nèi)部使用Apache Http Async Client發(fā)送Http請(qǐng)求，它依賴于以下構(gòu)件，即異步http客戶端及其自身傳遞依賴關(guān)系：

org.apache.httpcomponents:httpasyncclient

org.apache.httpcomponents:httpcore-nio

org.apache.httpcomponents:httpclient

org.apache.httpcomponents:httpcore

commons-codec:commons-codec

ommons-logging:commons-logging

為了避免版本沖突，可以在單個(gè)JAR文件（有時(shí)稱為“uber JAR”或“fat JAR”）中對(duì)依賴關(guān)系進(jìn)行shaded并打包在客戶端中，Shading依賴項(xiàng)包括獲取其內(nèi)容（資源文件和Java類文件）并重命名其某些包，然后將它們放入與低級(jí)別Java REST客戶端相同的JAR文件中，可以通過(guò)Gradle和Maven的第三方插件來(lái)完成對(duì)JAR的Shading。

請(qǐng)注意，對(duì)JAR進(jìn)行shading也會(huì)產(chǎn)生影響，例如，對(duì)Commons Logging圖層進(jìn)行Shading意味著第三方日志記錄后端也需要shaded。

這是使用Maven Shade插件的配置，將以下內(nèi)容添加到pom.xml文件中：

    
        
            org.apache.maven.plugins
            maven-shade-plugin
            3.1.0
            
                
                    package
                    shade
                    
                        
                            
                                org.apache.http
                                hidden.org.apache.http
                            
                            
                                org.apache.logging
                                hidden.org.apache.logging
                            
                            
                                org.apache.commons.codec
                                hidden.org.apache.commons.codec
                            
                            
                                org.apache.commons.logging
                                hidden.org.apache.commons.logging
                            
                        
                    
                
            
        
    

這是使用Gradle ShadowJar插件的配置，將以下內(nèi)容添加到build.gradle文件中：

shadowJar {
    relocate "org.apache.http", "hidden.org.apache.http"
    relocate "org.apache.logging", "hidden.org.apache.logging"
    relocate "org.apache.commons.codec", "hidden.org.apache.commons.codec"
    relocate "org.apache.commons.logging", "hidden.org.apache.commons.logging"
}