aQute.remote.util

Class JMXBundleDeployer

java.lang.Object

aQute.remote.util.JMXBundleDeployer

public class JMXBundleDeployer
extends java.lang.Object

This class will try to connect to a remote OSGi framework using JMX and will deploy a bundle for you, by deploy, that means install the bundle if it doesn't existing in the remote runtime or update the bundle if it already exists. For the actual JMX connection it will use a port if you tell it to, or if not, it will try to use the JDK's attach API and search for the OSGi framework JMX beans. For the JDK attach API, beware, assumptions about the Oracle JDK directory layout have been made.

Constructor Summary

Constructors

Constructor and Description
JMXBundleDeployer()
JMXBundleDeployer(int port)
JMXBundleDeployer(java.lang.String serviceURL)

Method Summary

Modifier and Type	Method and Description
long	deploy(java.lang.String bsn, java.io.File bundle) Gets the current list of installed bsns, compares it to the bsn provided.
org.osgi.framework.dto.BundleDTO[]	listBundles() Calls osgi.core bundleState MBean listBundles operation
void	uninstall(long id) Calls through directly to the OSGi frameworks MBean uninstallBundle operation
void	uninstall(java.lang.String bsn) Uninstall a bundle by passing in its Bundle-SymbolicName.

Methods inherited from class java.lang.Object

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

Constructor Detail

JMXBundleDeployer

public JMXBundleDeployer()

JMXBundleDeployer

public JMXBundleDeployer(int port)

JMXBundleDeployer

public JMXBundleDeployer(java.lang.String serviceURL)

Method Detail

deploy

public long deploy(java.lang.String bsn,
                   java.io.File bundle)
            throws java.lang.Exception

Gets the current list of installed bsns, compares it to the bsn provided. If bsn doesn't exist, then install it. If it does exist then update it.

Parameters:

bsn - Bundle-SymbolicName of bundle you are wanting to deploy

bundle - the bundle

Returns:

the id of the updated or installed bundle

Throws:

java.lang.Exception

listBundles

public org.osgi.framework.dto.BundleDTO[] listBundles()

Calls osgi.core bundleState MBean listBundles operation

Returns:

array of bundles in framework

uninstall

public void uninstall(java.lang.String bsn)
               throws java.lang.Exception

Uninstall a bundle by passing in its Bundle-SymbolicName. If bundle doesn't exist, this is a NOP.

Parameters:

bsn - bundle symbolic name

Throws:

java.lang.Exception

uninstall

public void uninstall(long id)
               throws java.lang.Exception

Calls through directly to the OSGi frameworks MBean uninstallBundle operation

Parameters:

id - id of bundle to uninstall

Throws:

java.lang.Exception