Package org.nuxeo.runtime.reload

Class ReloadComponent

java.lang.Object

org.nuxeo.runtime.model.DefaultComponent

org.nuxeo.runtime.reload.ReloadComponent

All Implemented Interfaces:

Adaptable, Component, Extensible, ReloadService, TimestampedService

public class ReloadComponent
extends DefaultComponent
implements ReloadService

Author:

Bogdan Stefanescu

Field Summary

Fields

Modifier and Type	Field	Description
protected static org.osgi.framework.Bundle	bundle
protected Long	lastFlushed
static final String	RELOAD_STRATEGY_PARAMETER	The reload strategy to adopt for hot reload.
static final String	RELOAD_STRATEGY_VALUE_DEFAULT
static final String	RELOAD_STRATEGY_VALUE_RESTART
static final String	RELOAD_STRATEGY_VALUE_STANDBY

Fields inherited from class org.nuxeo.runtime.model.DefaultComponent

lastModified, name

Fields inherited from interface org.nuxeo.runtime.reload.ReloadService

AFTER_RELOAD_EVENT_ID, BEFORE_RELOAD_EVENT_ID, FLUSH_EVENT_ID, FLUSH_SEAM_EVENT_ID, RELOAD_EVENT_ID, RELOAD_SEAM_EVENT_ID, RELOAD_TOPIC

Constructor Summary

Constructors

Constructor	Description
ReloadComponent()

Method Summary

Modifier and Type	Method	Description
void	activate(ComponentContext context)	Activates the component.
protected void	clearJarFileFactoryCache(ReloadResult result)	Gets the un-deployed bundle from given result and try to remove them from sun.net.www.protocol.jar.JarFileFactory otherwise we'll have resource conflict when opening stream from url.
protected List<File>	copyBundlesToDeploy(ReloadContext context)
protected void	copyFile(File srcFile, File destFile)	Method copied from commons-io:commons-io:2.6 to handle replace if exist on Windows.
void	deactivate(ComponentContext context)	Deactivates the component.
protected ReloadResult	deployBundles(List<File> bundlesToDeploy)
void	flush()	Sends a runtime event with id ReloadService.FLUSH_EVENT_ID so that listeners can be notified that a flush is needed (after a reload for instance).
void	flushJaasCache()	Sends an event that can trigger reset of JaasCache.
void	flushSeamComponents()	Sends a runtime event with id ReloadService.FLUSH_SEAM_EVENT_ID.
protected static File	getAppDir()
static org.osgi.framework.Bundle	getBundle()
static org.osgi.framework.BundleContext	getBundleContext()
String	getOSGIBundleName(File file)	Returns the OSGI bundle name if given file can be identified as an OSGI bundle, or null.
protected static File	getWarDir()
Long	lastFlushed()	Returns the last time one of the flush commands where called on this service instance (ReloadService.flush() or ReloadService.flushJaasCache() or ReloadService.flushSeamComponents(), or null if never called.
protected void	logComponentManagerStatus()	Logs the ComponentManager status.
void	reload()	Sends a runtime event with id ReloadService.RELOAD_EVENT_ID so that listeners can be notified that a reload has been done.
ReloadResult	reloadBundles(ReloadContext context)	Called by ReloadServiceInvoker#hotReloadBundles.
void	reloadProperties()	Reloads runtime framework properties
void	reloadSeamComponents()	Sends a runtime event with id ReloadService.RELOAD_SEAM_EVENT_ID
void	runDeploymentPreprocessor()	Runs the deployment preprocessor.
protected void	setFlushedNow()	Sets the last date date to current date timestamp
protected URL	toURL(File file)
protected URL	toURL(org.osgi.framework.Bundle bundle)	This method needs to be called before bundle uninstallation, otherwise Bundle.getLocation() throw a NPE.
protected void	triggerReload(String eventId)
protected void	triggerReloadWithNewTransaction(String eventId)
protected ReloadResult	undeployBundles(List<String> bundleNames)

Methods inherited from class org.nuxeo.runtime.model.DefaultComponent

addRuntimeMessage, addRuntimeMessage, getAdapter, getDescriptor, getDescriptors, getLastModified, getRegistry, register, registerContribution, registerExtension, setLastModified, setModifiedNow, setName, start, stop, unregister, unregisterContribution, unregisterExtension

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.nuxeo.runtime.model.Component

getApplicationStartedOrder

Methods inherited from interface org.nuxeo.runtime.service.TimestampedService

getLastModified, setLastModified

Field Details

RELOAD_STRATEGY_PARAMETER

public static final String RELOAD_STRATEGY_PARAMETER

The reload strategy to adopt for hot reload. Default value is RELOAD_STRATEGY_VALUE_DEFAULT.

Since:

9.3

See Also:

• Constant Field Values

RELOAD_STRATEGY_VALUE_STANDBY

public static final String RELOAD_STRATEGY_VALUE_STANDBY

See Also:

• Constant Field Values

RELOAD_STRATEGY_VALUE_RESTART

public static final String RELOAD_STRATEGY_VALUE_RESTART

See Also:

• Constant Field Values

RELOAD_STRATEGY_VALUE_DEFAULT

public static final String RELOAD_STRATEGY_VALUE_DEFAULT

See Also:

• Constant Field Values

bundle

protected static org.osgi.framework.Bundle bundle

lastFlushed

protected Long lastFlushed

Constructor Details

ReloadComponent

public ReloadComponent()

Method Details

getBundleContext

public static org.osgi.framework.BundleContext getBundleContext()

getBundle

public static org.osgi.framework.Bundle getBundle()

activate

public void activate(ComponentContext context)

Description copied from interface: Component

Activates the component.

This method is called by the runtime when a component is activated.

Specified by:

activate in interface Component

Overrides:

activate in class DefaultComponent

Parameters:

context - the runtime context

deactivate

public void deactivate(ComponentContext context)

Description copied from interface: Component

Deactivates the component.

This method is called by the runtime when a component is deactivated.

Specified by:

deactivate in interface Component

Overrides:

deactivate in class DefaultComponent

Parameters:

context - the runtime context

reload

public void reload()

Description copied from interface: ReloadService

Sends a runtime event with id ReloadService.RELOAD_EVENT_ID so that listeners can be notified that a reload has been done.

Also calls ReloadService.reloadProperties() by default, but not other reload methods as they could alter the running application behaviour.

Specified by:

reload in interface ReloadService

See Also:

• ReloadService.reloadProperties()

reloadProperties

public void reloadProperties()
                      throws IOException

Description copied from interface: ReloadService

Reloads runtime framework properties

Specified by:

reloadProperties in interface ReloadService

Throws:

IOException

reloadSeamComponents

public void reloadSeamComponents()

Description copied from interface: ReloadService

Sends a runtime event with id ReloadService.RELOAD_SEAM_EVENT_ID

Specified by:

reloadSeamComponents in interface ReloadService

flush

public void flush()

Description copied from interface: ReloadService

Sends a runtime event with id ReloadService.FLUSH_EVENT_ID so that listeners can be notified that a flush is needed (after a reload for instance).

Also calls ReloadService.flushJaasCache() by default, but not other flush methods as they could alter the running application behaviour.

Specified by:

flush in interface ReloadService

See Also:

• ReloadService.flushJaasCache()

flushJaasCache

public void flushJaasCache()

Description copied from interface: ReloadService

Sends an event that can trigger reset of JaasCache.

Specified by:

flushJaasCache in interface ReloadService

flushSeamComponents

public void flushSeamComponents()

Description copied from interface: ReloadService

Sends a runtime event with id ReloadService.FLUSH_SEAM_EVENT_ID.

Specified by:

flushSeamComponents in interface ReloadService

reloadBundles

public ReloadResult reloadBundles(ReloadContext context)
                           throws org.osgi.framework.BundleException

Description copied from interface: ReloadService

Called by ReloadServiceInvoker#hotReloadBundles.

Specified by:

reloadBundles in interface ReloadService

Returns:

the result of hot reload operation

Throws:

org.osgi.framework.BundleException

copyBundlesToDeploy

protected List<File> copyBundlesToDeploy(ReloadContext context)
                                  throws org.osgi.framework.BundleException

Throws:

org.osgi.framework.BundleException

copyFile

protected void copyFile(File srcFile,
 File destFile)
                 throws IOException

Method copied from commons-io:commons-io:2.6 to handle replace if exist on Windows.

Throws:

IOException

Since:

2021.19

deployBundles

protected ReloadResult deployBundles(List<File> bundlesToDeploy)
                              throws org.osgi.framework.BundleException

Throws:

org.osgi.framework.BundleException

undeployBundles

protected ReloadResult undeployBundles(List<String> bundleNames)
                                throws org.osgi.framework.BundleException

Throws:

org.osgi.framework.BundleException

clearJarFileFactoryCache

protected void clearJarFileFactoryCache(ReloadResult result)

Gets the un-deployed bundle from given result and try to remove them from sun.net.www.protocol.jar.JarFileFactory otherwise we'll have resource conflict when opening stream from url.

toURL

protected URL toURL(org.osgi.framework.Bundle bundle)

This method needs to be called before bundle uninstallation, otherwise Bundle.getLocation() throw a NPE.

toURL

protected URL toURL(File file)

logComponentManagerStatus

protected void logComponentManagerStatus()

Logs the ComponentManager status.

lastFlushed

public Long lastFlushed()

Description copied from interface: ReloadService

Returns the last time one of the flush commands where called on this service instance (ReloadService.flush() or ReloadService.flushJaasCache() or ReloadService.flushSeamComponents(), or null if never called.

Specified by:

lastFlushed in interface ReloadService

setFlushedNow

protected void setFlushedNow()

Sets the last date date to current date timestamp

Since:

5.6

runDeploymentPreprocessor

public void runDeploymentPreprocessor()
                               throws IOException

Description copied from interface: ReloadService

Runs the deployment preprocessor.

Specified by:

runDeploymentPreprocessor in interface ReloadService

Throws:

IOException

See Also:

• DeploymentPreprocessor

getAppDir

protected static File getAppDir()

getWarDir

protected static File getWarDir()

getOSGIBundleName

public String getOSGIBundleName(File file)

Description copied from interface: ReloadService

Returns the OSGI bundle name if given file can be identified as an OSGI bundle, or null. The OSGI bundle can be a jar or an exploded jar on file system.

Specified by:

getOSGIBundleName in interface ReloadService

triggerReloadWithNewTransaction

protected void triggerReloadWithNewTransaction(String eventId)

triggerReload

protected void triggerReload(String eventId)