com.nflabs.zeppelin.driver.ZeppelinDriver Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of zeppelin-zengine Show documentation

Zengine is java framework for data analysis on Hadoop. see http://nflabs.github.io/zeppelin/#/zengine

There is a newer version: 0.3.3

package com.nflabs.zeppelin.driver;

/**
 * Zeppelin driver is physical layer abstraction.
 * 
 * Driver creates ZeppelinConnections. Each connections maps to each physical connection. i.e Socket for JDBC to Hive or Spark or PrestoDB.
 * connection will used when executing logical plan(s).
 * 
 */
public abstract class ZeppelinDriver {    
	private ClassLoader classLoader;	

	
	/**
	 * Constructor of Driver. all subclass should implement this.
	 */
	public ZeppelinDriver(){
		
	}
	
	/**
	 * Driver comes with it's own classloader.
	 * Classloader is set by DriverFactory, right after it is created. 
	 * @param cl
	 */
	public void setClassLoader(ClassLoader cl){
		this.classLoader = cl;
	}
	
	/**
	 * Initialize driver. automatically called after setClassLoader when driver created.
	 */
	protected abstract void init();

	
	
	/**
	 * Check if the driver can handle provided connection url or not.
	 * @param url
	 * @return
	 */
	public abstract boolean acceptsURL(String url);
	
	/**
	 * Creates actual connection to the backed system
	 * 
	 * @return
	 * @throws ZeppelinDriverException
	 */
	protected abstract ZeppelinConnection createConnection(String url) throws ZeppelinDriverException;

	/**
	 * Create connection with given classloader
	 * @param url
	 * @return
	 */
	public ZeppelinConnection getConnection(String url){
		ClassLoader cl = classLoader;
		if (classLoader == null ) {
			cl = Thread.currentThread().getContextClassLoader();
		}
	   	ClassLoader oldcl = Thread.currentThread().getContextClassLoader();
		Thread.currentThread().setContextClassLoader(cl);
		try {
			return new ClassLoaderConnection(createConnection(url), cl);
		} catch(ZeppelinDriverException e){
			throw e;
		} catch(Exception e) {
			throw new ZeppelinDriverException(e);
		} finally {
			Thread.currentThread().setContextClassLoader(oldcl);
		}
	}
}