org.ow2.chameleon.core.activators

Class BundleDeployer

java.lang.Object

org.ow2.chameleon.core.services.AbstractDeployer

org.ow2.chameleon.core.activators.BundleDeployer

All Implemented Interfaces:

org.osgi.framework.BundleActivator, Deployer

public class BundleDeployer
extends AbstractDeployer
implements org.osgi.framework.BundleActivator

Deployer installing and starting bundles.

Version:

$Id: 1.0.4 $Id

Author:

The OW2 Chameleon Team

Field Summary

Fields

Modifier and Type	Field and Description
static String	REFERENCE_URL_PREFIX The URL prefix to enable 'reference'.

Constructor Summary

Constructors

Constructor and Description
BundleDeployer(boolean useReferences, boolean autoRefresh) Creates a bundle deployer.

Method Summary

Modifier and Type	Method and Description
boolean	accept(File file) Does the current deployer accept the given file.
void	onFileCreate(File file) Callback called when an accepted file is created.
void	onFileDelete(File file) Callback called when an accepted file is deleted.
void	open(Collection<File> files) Method called when the deployer is initialized.
void	refresh()
void	start(org.osgi.framework.BundleContext context)
void	stop(org.osgi.framework.BundleContext context)

Methods inherited from class org.ow2.chameleon.core.services.AbstractDeployer

close, onFileChange

Methods inherited from class java.lang.Object

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

Field Detail

REFERENCE_URL_PREFIX

public static final String REFERENCE_URL_PREFIX

The URL prefix to enable 'reference'.

See Also:

Constant Field Values

Constructor Detail

BundleDeployer

public BundleDeployer(boolean useReferences,
                      boolean autoRefresh)

Creates a bundle deployer.

Parameters:

useReferences - a boolean.

Method Detail

start

public void start(org.osgi.framework.BundleContext context)

Specified by:

start in interface org.osgi.framework.BundleActivator

stop

public void stop(org.osgi.framework.BundleContext context)

Specified by:

stop in interface org.osgi.framework.BundleActivator

accept

public boolean accept(File file)

Does the current deployer accept the given file. The accept method must not check file existence, as it may disable notification on file deletion.

Specified by:

accept in interface Deployer

Parameters:

file - the file

Returns:

true if the file is accepted by the current deployer, false otherwise

onFileCreate

public void onFileCreate(File file)

Callback called when an accepted file is created.

Specified by:

onFileCreate in interface Deployer

Overrides:

onFileCreate in class AbstractDeployer

Parameters:

file - the new file

open

public void open(Collection<File> files)

Method called when the deployer is initialized. This method is called once per monitored directory, with a potentially empty set of files (if there are no file or if the directory does not contain any accepted file)

It's a good practice to install all bundles and then start them. This method cannot be interrupted.

Specified by:

open in interface Deployer

Overrides:

open in class AbstractDeployer

Parameters:

files - the set of accepted file currently present is a monitored directory.

onFileDelete

public void onFileDelete(File file)

Callback called when an accepted file is deleted.

Specified by:

onFileDelete in interface Deployer

Overrides:

onFileDelete in class AbstractDeployer

Parameters:

file - the file

refresh

public void refresh()