org.teiid.runtime

Class EmbeddedServer

java.lang.Object

org.teiid.runtime.AbstractVDBDeployer

org.teiid.runtime.EmbeddedServer

All Implemented Interfaces:

org.teiid.dqp.internal.datamgr.ConnectorManagerRepository.ExecutionFactoryProvider, org.teiid.events.EventDistributorFactory

public class EmbeddedServer
extends AbstractVDBDeployer
implements org.teiid.events.EventDistributorFactory, org.teiid.dqp.internal.datamgr.ConnectorManagerRepository.ExecutionFactoryProvider

A simplified server environment for embedded use. Needs to be started prior to use with a call to start(EmbeddedConfiguration)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	EmbeddedServer.ConnectionFactoryProvider<T>
protected class	EmbeddedServer.ProviderAwareConnectorManagerRepository
static class	EmbeddedServer.SimpleConnectionFactoryProvider<T>

Field Summary

Fields

Modifier and Type	Field and Description
protected BufferServiceImpl	bufferService
protected org.teiid.dqp.internal.datamgr.ConnectorManagerRepository	cmr
protected org.teiid.dqp.internal.process.DQPCore	dqp
protected AbstractEventDistributorFactoryService	eventDistributorFactoryService
protected LogonImpl	logon
protected org.teiid.query.ObjectReplicator	replicator
protected VDBRepository	repo Custom vdb repository that will immediately throw exceptions for metadata validation errors
protected ClientServiceRegistryImpl	services
protected SessionServiceImpl	sessionService
protected boolean	throwMetadataErrors
protected org.teiid.dqp.internal.process.TransactionServerImpl	transactionService
protected ArrayList<SocketListener>	transports
protected boolean	useCallingThread
protected boolean	waitForLoad

Fields inherited from class org.teiid.runtime.AbstractVDBDeployer

repositories

Constructor Summary

Constructors

Constructor and Description
EmbeddedServer()

Method Summary

Modifier and Type	Method and Description
void	addConnectionFactory(String name, Object connectionFactory) Adds the object as the named connection factory to replace the default JNDI lookup strategy.
void	addConnectionFactoryProvider(String name, EmbeddedServer.ConnectionFactoryProvider<?> connectionFactoryProvider) Adds the EmbeddedServer.ConnectionFactoryProvider with the given connection name to replace the default JNDI lookup strategy.
void	addTranslator(Class<? extends org.teiid.translator.ExecutionFactory> clazz) Adds a definition of the ExecutionFactory using the default name either from the Translator annotation or the class name.
void	addTranslator(String name, org.teiid.translator.ExecutionFactory<?,?> ef) Add a named ExecutionFactory.
void	addTranslator(String name, String type, Map<String,String> properties) Add an override translator
protected boolean	allowOverrideTranslators()
static void	createPreParser(org.teiid.adminapi.impl.VDBMetaData deployment)
void	deployVDB(InputStream is) Deploy a vdb.xml file.
void	deployVDB(InputStream is, boolean ddl) Deploy a vdb.xml file.
void	deployVDB(String name, org.teiid.adminapi.impl.ModelMetaData... models) Deploy the given set of models as vdb name.1
protected void	deployVDB(org.teiid.adminapi.impl.VDBMetaData vdb, org.teiid.query.metadata.VDBResources resources)
void	deployVDBZip(URL url) Deploy a vdb zip file.
org.teiid.adminapi.Admin	getAdmin()
protected org.teiid.dqp.service.BufferService	getBufferService()
org.teiid.jdbc.TeiidDriver	getDriver()
org.teiid.events.EventDistributor	getEventDistributor()
org.teiid.translator.ExecutionFactory<Object,Object>	getExecutionFactory(String name)
protected MaterializationManager	getMaterializationManager()
protected org.teiid.metadata.MetadataRepository<?,?>	getMetadataRepository(String repoType)
int	getPort(int transport) Return the bound port for the transport number
protected org.teiid.dqp.internal.process.SessionAwareCache<org.teiid.dqp.internal.process.PreparedPlan>	getPpcCache()
protected org.teiid.dqp.internal.process.SessionAwareCache<org.teiid.dqp.internal.process.CachedResults>	getRsCache()
String	getSchemaDdl(String vdbName, String schemaName) Get the effective ddl text for the given schema
protected VDBRepository	getVDBRepository()
protected void	loadMetadata(org.teiid.adminapi.impl.VDBMetaData vdb, org.teiid.adminapi.impl.ModelMetaData model, org.teiid.dqp.internal.datamgr.ConnectorManagerRepository cmr, org.teiid.metadata.MetadataRepository metadataRepository, org.teiid.metadata.MetadataStore store, AtomicInteger loadCount, org.teiid.query.metadata.VDBResources vdbResources) TODO: consolidate this logic more into the abstract deployer
void	start(EmbeddedConfiguration config)
void	stop() Stops the server.
void	undeployVDB(String vdbName)
void	undeployVDB(String vdbName, String version)

Methods inherited from class org.teiid.runtime.AbstractVDBDeployer

addMetadataRepository, assignMetadataRepositories, createMetadataFactory, getConnectorManagers, loadMetadata, metadataLoaded

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

dqp

protected org.teiid.dqp.internal.process.DQPCore dqp

repo

protected VDBRepository repo

Custom vdb repository that will immediately throw exceptions for metadata validation errors

throwMetadataErrors

protected boolean throwMetadataErrors

sessionService

protected SessionServiceImpl sessionService

replicator

protected org.teiid.query.ObjectReplicator replicator

bufferService

protected BufferServiceImpl bufferService

transactionService

protected org.teiid.dqp.internal.process.TransactionServerImpl transactionService

waitForLoad

protected boolean waitForLoad

services

protected ClientServiceRegistryImpl services

logon

protected LogonImpl logon

cmr

protected org.teiid.dqp.internal.datamgr.ConnectorManagerRepository cmr

eventDistributorFactoryService

protected AbstractEventDistributorFactoryService eventDistributorFactoryService

useCallingThread

protected boolean useCallingThread

transports

protected ArrayList<SocketListener> transports

Constructor Detail

EmbeddedServer

public EmbeddedServer()

Method Detail

addConnectionFactoryProvider

public void addConnectionFactoryProvider(String name,
                                         EmbeddedServer.ConnectionFactoryProvider<?> connectionFactoryProvider)

Adds the EmbeddedServer.ConnectionFactoryProvider with the given connection name to replace the default JNDI lookup strategy.

Parameters:

name -

connectionFactoryProvider -

See Also:

for a basic wrapper

addConnectionFactory

public void addConnectionFactory(String name,
                                 Object connectionFactory)

Adds the object as the named connection factory to replace the default JNDI lookup strategy.

Parameters:

name -

connectionFactory -

start

public void start(EmbeddedConfiguration config)

getBufferService

protected org.teiid.dqp.service.BufferService getBufferService()

getMaterializationManager

protected MaterializationManager getMaterializationManager()

addTranslator

public void addTranslator(Class<? extends org.teiid.translator.ExecutionFactory> clazz)
                   throws org.teiid.translator.TranslatorException

Adds a definition of the ExecutionFactory using the default name either from the Translator annotation or the class name. Only ExecutionFactory classes with a Translator annotation can be referenced by addTranslator(String, String, Map)

Parameters:

ef -

Throws:

org.teiid.translator.TranslatorException

addTranslator

public void addTranslator(String name,
                          String type,
                          Map<String,String> properties)
                   throws org.teiid.translator.TranslatorException

Add an override translator

Parameters:

name -

type - the name of an existing translator to override

properties -

Throws:

org.teiid.translator.TranslatorException

addTranslator

public void addTranslator(String name,
                          org.teiid.translator.ExecutionFactory<?,?> ef)

Add a named ExecutionFactory. NOTE: Only this single instance will be shared for all usage.

Parameters:

name -

ef - the already started ExecutionFactory

See Also:

#addTranslator(String, String, Map)} or {@link #addTranslator(Class)}

deployVDB

public void deployVDB(String name,
                      org.teiid.adminapi.impl.ModelMetaData... models)
               throws org.teiid.dqp.internal.datamgr.ConnectorManagerRepository.ConnectorManagerException,
                      VirtualDatabaseException,
                      org.teiid.translator.TranslatorException

Deploy the given set of models as vdb name.1

Parameters:

name -

models -

Throws:

org.teiid.dqp.internal.datamgr.ConnectorManagerRepository.ConnectorManagerException

VirtualDatabaseException

org.teiid.translator.TranslatorException

deployVDB

public void deployVDB(InputStream is)
               throws VirtualDatabaseException,
                      org.teiid.dqp.internal.datamgr.ConnectorManagerRepository.ConnectorManagerException,
                      org.teiid.translator.TranslatorException,
                      IOException

Deploy a vdb.xml file. The name and version will be derived from the xml.

Parameters:

is, - which will be closed by this deployment

Throws:

org.teiid.translator.TranslatorException

org.teiid.dqp.internal.datamgr.ConnectorManagerRepository.ConnectorManagerException

VirtualDatabaseException

IOException

deployVDB

public void deployVDB(InputStream is,
                      boolean ddl)
               throws VirtualDatabaseException,
                      org.teiid.dqp.internal.datamgr.ConnectorManagerRepository.ConnectorManagerException,
                      org.teiid.translator.TranslatorException,
                      IOException

Deploy a vdb.xml file. The name and version will be derived from the xml.

Parameters:

is, - which will be closed by this deployment

ddl, - true if the file contents are DDL

Throws:

org.teiid.translator.TranslatorException

org.teiid.dqp.internal.datamgr.ConnectorManagerRepository.ConnectorManagerException

VirtualDatabaseException

IOException

deployVDBZip

public void deployVDBZip(URL url)
                  throws VirtualDatabaseException,
                         org.teiid.dqp.internal.datamgr.ConnectorManagerRepository.ConnectorManagerException,
                         org.teiid.translator.TranslatorException,
                         IOException,
                         URISyntaxException

Deploy a vdb zip file. The name and version will be derived from the xml.

Parameters:

url -

Throws:

org.teiid.translator.TranslatorException

org.teiid.dqp.internal.datamgr.ConnectorManagerRepository.ConnectorManagerException

VirtualDatabaseException

URISyntaxException

IOException

allowOverrideTranslators

protected boolean allowOverrideTranslators()

deployVDB

protected void deployVDB(org.teiid.adminapi.impl.VDBMetaData vdb,
                         org.teiid.query.metadata.VDBResources resources)
                  throws org.teiid.dqp.internal.datamgr.ConnectorManagerRepository.ConnectorManagerException,
                         VirtualDatabaseException,
                         org.teiid.translator.TranslatorException

Throws:

org.teiid.dqp.internal.datamgr.ConnectorManagerRepository.ConnectorManagerException

VirtualDatabaseException

org.teiid.translator.TranslatorException

getMetadataRepository

protected org.teiid.metadata.MetadataRepository<?,?> getMetadataRepository(String repoType)
                                                                    throws VirtualDatabaseException

Overrides:

getMetadataRepository in class AbstractVDBDeployer

Throws:

VirtualDatabaseException

loadMetadata

protected void loadMetadata(org.teiid.adminapi.impl.VDBMetaData vdb,
                            org.teiid.adminapi.impl.ModelMetaData model,
                            org.teiid.dqp.internal.datamgr.ConnectorManagerRepository cmr,
                            org.teiid.metadata.MetadataRepository metadataRepository,
                            org.teiid.metadata.MetadataStore store,
                            AtomicInteger loadCount,
                            org.teiid.query.metadata.VDBResources vdbResources)
                     throws org.teiid.translator.TranslatorException

TODO: consolidate this logic more into the abstract deployer

Specified by:

loadMetadata in class AbstractVDBDeployer

Throws:

org.teiid.translator.TranslatorException

undeployVDB

public void undeployVDB(String vdbName)

undeployVDB

public void undeployVDB(String vdbName,
                        String version)

stop

public void stop()

Stops the server. Once stopped it cannot be restarted.

getDriver

public org.teiid.jdbc.TeiidDriver getDriver()

getEventDistributor

public org.teiid.events.EventDistributor getEventDistributor()

Specified by:

getEventDistributor in interface org.teiid.events.EventDistributorFactory

getExecutionFactory

public org.teiid.translator.ExecutionFactory<Object,Object> getExecutionFactory(String name)
                                                                         throws org.teiid.dqp.internal.datamgr.ConnectorManagerRepository.ConnectorManagerException

Specified by:

getExecutionFactory in interface org.teiid.dqp.internal.datamgr.ConnectorManagerRepository.ExecutionFactoryProvider

Throws:

org.teiid.dqp.internal.datamgr.ConnectorManagerRepository.ConnectorManagerException

getVDBRepository

protected VDBRepository getVDBRepository()

Specified by:

getVDBRepository in class AbstractVDBDeployer

getSchemaDdl

public String getSchemaDdl(String vdbName,
                           String schemaName)

Get the effective ddl text for the given schema

Parameters:

vdbName -

schemaName -

Returns:

the ddl or null if the vdb/schema does not exist

getPort

public int getPort(int transport)

Return the bound port for the transport number

Parameters:

transport -

Returns:

getRsCache

protected org.teiid.dqp.internal.process.SessionAwareCache<org.teiid.dqp.internal.process.CachedResults> getRsCache()

getPpcCache

protected org.teiid.dqp.internal.process.SessionAwareCache<org.teiid.dqp.internal.process.PreparedPlan> getPpcCache()

getAdmin

public org.teiid.adminapi.Admin getAdmin()

createPreParser

public static void createPreParser(org.teiid.adminapi.impl.VDBMetaData deployment)
                            throws TeiidException

Throws:

TeiidException