/**
* Copyright (C) 2014-2016 LinkedIn Corp. (pinot-core@linkedin.com)
*
* 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 com.linkedin.pinot.client;
import java.util.Arrays;
import java.util.List;
import java.util.Properties;
import org.I0Itec.zkclient.ZkClient;
import org.I0Itec.zkclient.serialize.BytesPushThroughSerializer;
/**
* Creates connections to Pinot, given various initialization methods.
*/
public class ConnectionFactory {
static PinotClientTransportFactory _transportFactory = new JsonAsyncHttpPinotClientTransportFactory();
private ConnectionFactory() {
}
/**
* Creates a connection to a Pinot cluster, given its Zookeeper URL
*
* @param zkUrl The URL to the Zookeeper cluster, must include the cluster name e.g host:port/chroot/pinot-cluster
* @return A connection that connects to the brokers in the given Helix cluster
*/
public static Connection fromZookeeper(String zkUrl) {
try {
DynamicBrokerSelector dynamicBrokerSelector = new DynamicBrokerSelector(zkUrl);
return new Connection(dynamicBrokerSelector, _transportFactory.buildTransport());
} catch (Exception e) {
throw new PinotClientException(e);
}
}
/**
* Creates a connection from properties containing the connection parameters.
*
* @param properties The properties to use for the connection
* @return A connection that connects to the brokers specified in the properties
*/
public static Connection fromProperties(Properties properties) {
return new Connection(Arrays.asList(properties.getProperty("brokerList").split(",")), _transportFactory.buildTransport());
}
/**
* Creates a connection which sends queries randomly between the specified brokers.
*
* @param brokers The list of brokers to send queries to
* @return A connection to the set of brokers specified
*/
public static Connection fromHostList(String... brokers) {
return new Connection(Arrays.asList(brokers), _transportFactory.buildTransport());
}
}