Package com.ibm.di.api.jmx.mbeans

Interface TDIPropertiesMBean

All Superinterfaces:

BaseAdminMBean, BaseMBean

All Known Implementing Classes:

TDIProperties

public interface TDIPropertiesMBean
extends BaseAdminMBean

JMX interface to TDIProperties. Wrapper API to expose the functionality available from com.ibm.di.config.interfaces.TDIProperties.

See Also:

TDIProperties

Method Summary

Modifier and Type	Method	Description
void	addPropertyStore(PropertyStoreConfig config)	Adds a property store to the end of the list of TDI-P's list of property stores.
void	commit()	Does a commit on all property stores.
TDIPropertyStore	getDefaultStore()	Gets the default property store.
TDIPropertyStore	getPasswordStore()	Returns the password store.
java.lang.Object	getProperty(java.lang.String key)	Gets the property value from the property store chosen by TDIProperties.
java.lang.Object	getProperty(java.lang.String propertyStoreName, java.lang.String key)	Returns the property value from the named property store.
TDIPropertyStore	getPropertyStore(java.lang.String name)	Returns the named property store.
java.lang.String[]	getPropertyStoreKeys(java.lang.String propertyStoreName)	Returns an array containing all the property keys in the named property store.
java.util.List	getPropertyStoreNames()	Returns a list of property store names in use by TDI-P.
void	insertPropertyStore(PropertyStoreConfig config, int atIndex)	Inserts a connector interface at the given index.
void	removeProperty(java.lang.String propertyStoreName, java.lang.String key)	Removes a property in the named property store.
void	removePropertyStore(java.lang.String propertyStoreName)	Removes a property store from TDI-P.
void	setDefaultStore(TDIPropertyStore defaultStore)	Sets the default property store.
void	setPasswordStore(TDIPropertyStore passwordStore)	Sets the password store.
TDIPropertyStore	setProperty(java.lang.String key, java.lang.Object value)	Sets the property in the property store chosen by TDIProperties.
TDIPropertyStore	setProperty(java.lang.String key, java.lang.Object value, boolean protect)	Sets the property in the property store chosen by TDIProperties.
void	setProperty(java.lang.String propertyStoreName, java.lang.String key, java.lang.Object value)	Sets the property in the named property store.
java.lang.String	trimKey(java.lang.String key)	Trims the key from a given string.

Methods inherited from interface com.ibm.di.api.jmx.mbeans.BaseMBean

getId, getType

Method Detail

commit

void commit()
     throws java.rmi.RemoteException,
            java.lang.Exception

Does a commit on all property stores.

Throws:

java.rmi.RemoteException

java.lang.Exception - if Runtime or Security exception occurs

getProperty

java.lang.Object getProperty(java.lang.String key)
                      throws java.rmi.RemoteException,
                             java.lang.Exception

Gets the property value from the property store chosen by TDIProperties.

Parameters:

key - The property name

Returns:

The property value

Throws:

java.lang.Exception - if Runtime or Security exception occurs

java.rmi.RemoteException - if a communication-related exception occurs.

setProperty

TDIPropertyStore setProperty(java.lang.String key,
                             java.lang.Object value)
                      throws java.rmi.RemoteException,
                             java.lang.Exception

Sets the property in the property store chosen by TDIProperties.

Parameters:

key - The property name

value - The new property value

Returns:

the TDIPropertyStore to which the key/value pair was written

Throws:

java.lang.Exception - if Runtime or Security exception occurs

java.rmi.RemoteException - if a communication-related exception occurs.

setProperty

TDIPropertyStore setProperty(java.lang.String key,
                             java.lang.Object value,
                             boolean protect)
                      throws java.rmi.RemoteException,
                             java.lang.Exception

Sets the property in the property store chosen by TDIProperties.

Parameters:

key - The property name

value - The new property value

protect - True if value should be protected (driver dependent)

Returns:

the TDIPropertyStore to which the key/value pair was written

Throws:

java.lang.Exception - if Runtime or Security exception occurs

java.rmi.RemoteException - if a communication-related exception occurs.

removeProperty

void removeProperty(java.lang.String propertyStoreName,
                    java.lang.String key)
             throws java.rmi.RemoteException,
                    java.lang.Exception

Removes a property in the named property store.

Parameters:

propertyStoreName - The name of the property store

key - The property to delete

Throws:

java.lang.Exception - if Runtime or Security exception occurs

java.rmi.RemoteException - if a communication-related exception occurs.

getProperty

java.lang.Object getProperty(java.lang.String propertyStoreName,
                             java.lang.String key)
                      throws java.rmi.RemoteException,
                             java.lang.Exception

Returns the property value from the named property store.

Parameters:

propertyStoreName - The name of the property store

key - The property value

Returns:

The property value

Throws:

java.lang.Exception - if Runtime or Security exception occurs

java.rmi.RemoteException - if a communication-related exception occurs.

setProperty

void setProperty(java.lang.String propertyStoreName,
                 java.lang.String key,
                 java.lang.Object value)
          throws java.rmi.RemoteException,
                 java.lang.Exception

Sets the property in the named property store.

Parameters:

propertyStoreName - The name of the property store

key - The property name

value - The new property value

Throws:

java.lang.Exception - if Runtime or Security exception occurs

java.rmi.RemoteException - if a communication-related exception occurs.

getPropertyStoreKeys

java.lang.String[] getPropertyStoreKeys(java.lang.String propertyStoreName)
                                 throws java.rmi.RemoteException,
                                        java.lang.Exception

Returns an array containing all the property keys in the named property store.

Parameters:

propertyStoreName - The name of the property store

Returns:

The propertyStoreKeys value

Throws:

java.lang.Exception - if Runtime or Security exception occurs

java.rmi.RemoteException - if a communication-related exception occurs.

addPropertyStore

void addPropertyStore(PropertyStoreConfig config)
               throws java.rmi.RemoteException,
                      java.lang.Exception

Adds a property store to the end of the list of TDI-P's list of property stores.

Parameters:

config - The property store configuration

Throws:

java.lang.Exception - if Runtime or Security exception occurs

java.rmi.RemoteException - if a communication-related exception occurs.

insertPropertyStore

void insertPropertyStore(PropertyStoreConfig config,
                         int atIndex)
                  throws java.rmi.RemoteException,
                         java.lang.Exception

Inserts a connector interface at the given index. See addPropertyStore() for a description of parameters.

Parameters:

config - The property store configuration

atIndex - The position where the new connector is placed (-1 = END, 0 = First)

Throws:

java.lang.Exception - if Runtime or Security exception occurs

java.rmi.RemoteException - if a communication-related exception occurs.

removePropertyStore

void removePropertyStore(java.lang.String propertyStoreName)
                  throws java.rmi.RemoteException,
                         java.lang.Exception

Removes a property store from TDI-P. The connector interface is closed and then removed.

Parameters:

propertyStoreName - The name of the property store

Throws:

java.lang.Exception - if Runtime or Security exception occurs

java.rmi.RemoteException - if a communication-related exception occurs.

getPropertyStoreNames

java.util.List getPropertyStoreNames()
                              throws java.lang.Exception,
                                     java.rmi.RemoteException

Returns a list of property store names in use by TDI-P.

Returns:

The propertyStoreNames value

Throws:

java.lang.Exception - if Runtime or Security exception occurs

java.rmi.RemoteException - if a communication-related exception occurs.

getDefaultStore

TDIPropertyStore getDefaultStore()
                          throws java.lang.Exception,
                                 java.rmi.RemoteException

Gets the default property store.

Returns:

the default property store

Throws:

java.lang.Exception - if Runtime or Security exception occurs

java.rmi.RemoteException - if a communication-related exception occurs.

setDefaultStore

void setDefaultStore(TDIPropertyStore defaultStore)
              throws java.lang.Exception,
                     java.rmi.RemoteException

Sets the default property store.

Parameters:

defaultStore - the new default property store

Throws:

java.lang.Exception - if Runtime or Security exception occurs

java.rmi.RemoteException - if a communication-related exception occurs.

getPasswordStore

TDIPropertyStore getPasswordStore()
                           throws java.lang.Exception,
                                  java.rmi.RemoteException

Returns the password store.

Returns:

the password store

Throws:

java.lang.Exception - if Runtime or Security exception occurs

java.rmi.RemoteException - if a communication-related exception occurs.

setPasswordStore

void setPasswordStore(TDIPropertyStore passwordStore)
               throws java.lang.Exception,
                      java.rmi.RemoteException

Sets the password store.

Parameters:

passwordStore - the new password store

Throws:

java.lang.Exception - if Runtime or Security exception occurs

java.rmi.RemoteException - if a communication-related exception occurs.

getPropertyStore

TDIPropertyStore getPropertyStore(java.lang.String name)
                           throws java.lang.Exception,
                                  java.rmi.RemoteException

Returns the named property store.

Parameters:

name - the name of the property store

Returns:

the TDIPropertyStore with specified name

Throws:

java.lang.Exception - if Runtime or Security exception occurs

java.rmi.RemoteException - if a communication-related exception occurs.

trimKey

java.lang.String trimKey(java.lang.String key)
                  throws java.lang.Exception,
                         java.rmi.RemoteException

Trims the key from a given string. For example trimKey("greeting:Hello, world!") will return the following string: "Hello, world!".

Parameters:

key - a string representing key:value pair

Returns:

string containing only the value

Throws:

java.lang.Exception - if Runtime or Security exception occurs

java.rmi.RemoteException - if a communication-related exception occurs.