org.mc4j.ems.connection
Interface EmsConnection

All Superinterfaces:

Refreshable

public interface EmsConnection
extends Refreshable

TODO GH: Decide exception handling strategy (runtime?)

Version:

$Revision: 570 $($Author: ghinkl $ / $Date: 2006-04-12 15:14:16 -0400 (Wed, 12 Apr 2006) $)

Author:

Greg Hinkle (ghinkle@users.sourceforge.net), Apr 4, 2005

Method Summary

void	addRegistrationListener(MBeanRegistrationListener registrationListener)
java.lang.Object	buildObjectName(java.lang.String objectName)
void	close()
void	createMBean(java.lang.String className, java.lang.String objectName) This will register a new MBean, but that may not be immediately recognized
EmsBean	getBean(java.lang.String objectName)
java.util.SortedSet<EmsBean>	getBeans()
ConnectionProvider	getConnectionProvider()
long	getFailures()
long	getRoundTrips()
ConnectionTracker	getTracker()
void	loadSynchronous(boolean deep) Does a *:* load of all MBean names and caches them as EmsBeans.
java.util.List<EmsBean>	queryBeans(java.lang.String objectName)
EmsBean	registerBean(java.lang.String className, java.lang.String objectName)
EmsBean	registerBean(java.lang.String className, java.lang.String objectName, java.lang.Object[] params, java.lang.String[] signature)
void	removeMBean(java.lang.String objectName)
void	removeRegistrationListener(MBeanRegistrationListener registrationListener)
void	unload() Unloads all cached metadata associated with this connection - MBeanInfos, etc.

Methods inherited from interface org.mc4j.ems.connection.Refreshable

refresh

Method Detail

getTracker

ConnectionTracker getTracker()

close

void close()

loadSynchronous

void loadSynchronous(boolean deep)

Does a *:* load of all MBean names and caches them as EmsBeans.

Parameters:

deep - if true, also loads the MBeanInfo for each MBean and caches it in the corresponding EmsBean

unload

void unload()

Unloads all cached metadata associated with this connection - MBeanInfos, etc.

Since:

1.3

addRegistrationListener

void addRegistrationListener(MBeanRegistrationListener registrationListener)

removeRegistrationListener

void removeRegistrationListener(MBeanRegistrationListener registrationListener)

createMBean

void createMBean(java.lang.String className,
                 java.lang.String objectName)
                 throws EmsException

This will register a new MBean, but that may not be immediately recognized

Parameters:

className -

objectName -

Throws:

EmsException

removeMBean

void removeMBean(java.lang.String objectName)
                 throws EmsException

Throws:

EmsException

getBeans

java.util.SortedSet<EmsBean> getBeans()

getBean

EmsBean getBean(java.lang.String objectName)

queryBeans

java.util.List<EmsBean> queryBeans(java.lang.String objectName)

registerBean

EmsBean registerBean(java.lang.String className,
                     java.lang.String objectName)

registerBean

EmsBean registerBean(java.lang.String className,
                     java.lang.String objectName,
                     java.lang.Object[] params,
                     java.lang.String[] signature)

buildObjectName

java.lang.Object buildObjectName(java.lang.String objectName)
                                 throws EmsMalformedObjectNameException

Parameters:

objectName -

Returns:

Throws:

EmsMalformedObjectNameException - when an invalid object name is provided

getRoundTrips

long getRoundTrips()

Returns:

Since:

1.0.5

getFailures

long getFailures()

Returns:

Since:

1.0.5

getConnectionProvider

ConnectionProvider getConnectionProvider()

Returns:

Since:

1.0.6