org.nuxeo.runtime.test.runner

Interface RuntimeHarness

All Known Implementing Classes:

NXRuntimeTestCase

public interface RuntimeHarness

TODO: Move this to org.nuxeo.runtime package

Author:

Bogdan Stefanescu

Method Summary

Modifier and Type	Method and Description
void	addWorkingDirectoryConfigurator(WorkingDirectoryConfigurator config)
void	deployBundle(String bundle) Deploys a whole OSGI bundle.
void	deployContrib(String bundle, String contrib) Deploys a contribution from a given bundle.
void	deployFolder(File folder, ClassLoader loader)
RuntimeContext	deployPartial(String bundle, Set<TargetExtensions> targetExtensions) Deploys a subset of a Bundle defined per the targetExtensions parameter
RuntimeContext	deployTestContrib(String bundle, String contrib) Deploys an XML contribution from outside a bundle.
RuntimeContext	deployTestContrib(String bundle, URL contrib)
void	fireFrameworkStarted() Resume the runtime
List<String>	getClassLoaderFiles()
RuntimeContext	getContext() Runtime context for deployment
OSGiAdapter	getOSGiAdapter() OSGI bridge
Properties	getProperties() Framework properties for variable injections
File	getWorkingDir() Gets the framework working directory.
boolean	isRestart()
boolean	isStarted()
void	restart()
void	start()
void	stop()
void	undeployContrib(String bundle, String contrib) Undeploys a contribution from a given bundle.

Method Detail

getWorkingDir

File getWorkingDir()

Gets the framework working directory.

fireFrameworkStarted

void fireFrameworkStarted()
                   throws Exception

Resume the runtime

Throws:

Exception

deployBundle

void deployBundle(String bundle)
           throws Exception

Deploys a whole OSGI bundle.

The lookup is first done on symbolic name, as set in MANIFEST.MF and then falls back to the bundle url (e.g., nuxeo-platform-search-api) for backwards compatibility.

Parameters:

bundle - the symbolic name

Throws:

Exception

undeployContrib

void undeployContrib(String bundle,
                     String contrib)
              throws Exception

Undeploys a contribution from a given bundle.

The path will be relative to the bundle root. Example: undeployContrib("org.nuxeo.ecm.core", "OSGI-INF/CoreExtensions.xml")

Parameters:

bundle - the bundle

contrib - the contribution

Throws:

Exception

deployTestContrib

RuntimeContext deployTestContrib(String bundle,
                                 URL contrib)
                          throws Exception

Throws:

Exception

deployTestContrib

RuntimeContext deployTestContrib(String bundle,
                                 String contrib)
                          throws Exception

Deploys an XML contribution from outside a bundle.

This should be used by tests wiling to deploy test contribution as part of a real bundle.

The bundle owner is important since the contribution may depend on resources deployed in that bundle.

Note that the owner bundle MUST be an already deployed bundle.

Parameters:

bundle - the bundle that becomes the contribution owner

contrib - the contribution to deploy as part of the given bundle

Throws:

Exception

deployContrib

void deployContrib(String bundle,
                   String contrib)
            throws Exception

Deploys a contribution from a given bundle.

The path will be relative to the bundle root. Example: deployContrib("org.nuxeo.ecm.core", "OSGI-INF/CoreExtensions.xml")

For compatibility reasons the name of the bundle may be a jar name, but this use is discouraged and deprecated.

Parameters:

bundle - the name of the bundle to peek the contrib in

contrib - the path to contrib in the bundle.

Throws:

Exception

start

void start()
    throws Exception

Throws:

Exception

stop

void stop()
   throws Exception

Throws:

Exception

isStarted

boolean isStarted()

deployPartial

RuntimeContext deployPartial(String bundle,
                             Set<TargetExtensions> targetExtensions)
                      throws Exception

Deploys a subset of a Bundle defined per the targetExtensions parameter

Parameters:

bundle - the name of the component

targetExtensions - Set of allowed TargetExtensions in the final contribution

Throws:

Exception

Since:

9.1

deployFolder

void deployFolder(File folder,
                  ClassLoader loader)
           throws Exception

Throws:

Exception

addWorkingDirectoryConfigurator

void addWorkingDirectoryConfigurator(WorkingDirectoryConfigurator config)

getProperties

Properties getProperties()

Framework properties for variable injections

Since:

5.4.2

getContext

RuntimeContext getContext()

Runtime context for deployment

Since:

5.4.2

getOSGiAdapter

OSGiAdapter getOSGiAdapter()

OSGI bridge

Since:

5.4.2

isRestart

boolean isRestart()

Since:

5.5

restart

void restart()
      throws Exception

Throws:

Exception

Since:

5.5

getClassLoaderFiles

List<String> getClassLoaderFiles()
                          throws URISyntaxException

Throws:

URISyntaxException

Since:

5.7