org.dashbuilder.dataset.def.ElasticSearchDataSetDefBuilder Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of dashbuilder-dataset-api
Dashbuilder Dataset API shared between client and server.
There is a newer version: 1.0.0.Final
/*
 * Copyright 2014 Red Hat, Inc. and/or its affiliates.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *       http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.dashbuilder.dataset.def;

/**
 * A builder for defining ElasticSearch data sets
 *
 *  *    DataSetDef dataSetDef = DataSetDefFactory.newElasticSearchDataSetDef()
 *     .uuid("all_employees")
 *     .serverURL("localhost:9300")
 *     .index("index1")
 *     .type("type1")
 *     .query("DSL query here")
 *     .relevance("10")
 *     .buildDef();
 * 
 */
public interface ElasticSearchDataSetDefBuilder extends DataSetDefBuilder {

    /**
     * Set the ElasticSearch server instance URL.
     *
     * @param serverURL The URL for the ElasticSearch server instance.
     * @return The DataSetDefBuilder instance that is being used to configure a DataSetDef.
     */
    T serverURL(String serverURL);

    /**
     * Set the ElasticSearch cluster name.
     *
     * @param clusterName The cluster name.
     * @return The DataSetDefBuilder instance that is being used to configure a DataSetDef.
     */
    T clusterName(String clusterName);

    /**
     * Set the name of the index that this dataset will handle.
     * This DataSet definition supports working with multiple indexes, so this method can be invoked several times.
     * 
     * @param index The index name
     * @return The DataSetDefBuilder instance that is being used to configure a DataSetDef.
     */
    T index(String index);

    /**
     * Set the type of the given index/es that this dataset will handle.
     * This DataSet definition supports working with multiple types, so this method can be invoked several times.
     * If there is no index configured, the type is skipped.
     * 
     * @param type The type of the given index/es
     * @return The DataSetDefBuilder instance that is being used to configure a DataSetDef.
     */
    T type(String type);

    /**
     * Set a custom query to extract the data from ElasticSearch server, instead of manually setting index and type parameters.
     * This parameter is only used if there are no index and type parameters already configured.
     *
     * @param query The DSL query to perform for data extraction.
     * @return The DataSetDefBuilder instance that is being used to configure a DataSetDef.
     */
    T query(String query);

    /**
     * Set the minimum relevance value for resulting search documents.
     * If a document relevance value is less than the configured using this method, the document will be present in the dataset.
     *
     * @param relevance The minimum relevance value
     * @return The DataSetDefBuilder instance that is being used to configure a DataSetDef.
     */
    T relevance(String relevance);
    
    /**
     * Enables the static cache
     *
     * @param synced For keeping the cache synced with the remote database content. If false, the cached content will get never updated once read.
     * @param maxRowsInCache Max. rows the cache is able to handle. For higher values the cache is automatically disabled.
     * @return The DataSetDefBuilder instance that is being used to configure a DataSetDef.
     */
    T cacheOn(boolean synced, int maxRowsInCache);
}