Skip navigation links

com.bea.wlcp.wlng.account.management
Interface ApplicationInstanceMBean

public interface ApplicationInstanceMBean

Method Summary

void	addApplicationInstance(String applicationInstanceName, String password, String applicationIdentifier, String serviceProviderIdentifier, String reference) Adds an application instance.
int	countApplicationInstances(String applicationIdentifier, String serviceProviderIdentifier, String state) Displays the number of registered application instances for a service provider/application account/application instance combinations.
ApplicationInstanceDescription	getApplicationInstance(String applicationInstanceName) Gets an application instance description.
String[]	listApplicationInstances(String applicationIdentifier, String serviceProviderIdentifier, String state, int offset, int size) Displays a list of registered application instances for a specific service provider/application account/application instance state combination.
void	removeApplicationInstance(String applicationInstanceName) Removes an application instance.
void	setApplicationInstancePassword(String applicationInstanceName, String password) Sets an application instance password.
void	setApplicationInstanceProperties(String applicationInstanceName, Set properties) Sets application instance properties.
void	setApplicationInstanceReference(String applicationInstanceName, String reference) Sets an application instance reference.
void	setApplicationInstanceState(String applicationInstanceName, String state) Sets application instance state.

Method Detail

addApplicationInstance

public void addApplicationInstance(String applicationInstanceName,
                                   String password,
                                   String applicationIdentifier,
                                   String serviceProviderIdentifier,
                                   String reference)
                            throws DuplicateKeyException,
                                   KeyNotFoundException

Adds an application instance. Each instance is always connected to a service provider/application account combination.

Scope: Domain

Parameters:

applicationInstanceName - The application instance name.

password - The password.

applicationIdentifier - The application account.

serviceProviderIdentifier - The service provider account.

reference - An alias reference ID for this application instance.

Throws:

com.bea.wlcp.wlng.api.management.DuplicateKeyException - If the account already exists.

com.bea.wlcp.wlng.api.management.KeyNotFoundException - If no such account exists.

DuplicateKeyException

KeyNotFoundException

countApplicationInstances

public int countApplicationInstances(String applicationIdentifier,
                                     String serviceProviderIdentifier,
                                     String state)
                              throws KeyNotFoundException

Displays the number of registered application instances for a service provider/application account/application instance combinations. Can be filtered by state.

Scope: Domain

Parameters:

applicationIdentifier - The application (optional).

serviceProviderIdentifier - The service provider (optional).

state - The state (ACTIVATED or DEACTIVATED) (optional).

Returns:

The count of application instances matching specified filter.

Throws:

com.bea.wlcp.wlng.api.management.KeyNotFoundException - If no such account exists.

KeyNotFoundException

getApplicationInstance

public ApplicationInstanceDescription getApplicationInstance(String applicationInstanceName)

Gets an application instance description. The information includes:

• ID of the application account to which the application instance belongs
• ID of the service provider account to which the application instance belongs
• State
• Reference
• <Properties

Scope: Domain

Parameters:

applicationInstanceName - The application instance name.

Returns:

The application instance description or null if the application instance doesn't exist.

listApplicationInstances

public String[] listApplicationInstances(String applicationIdentifier,
                                         String serviceProviderIdentifier,
                                         String state,
                                         int offset,
                                         int size)
                                  throws KeyNotFoundException

Displays a list of registered application instances for a specific service provider/application account/application instance state combination. The list contains application instance IDs.

Scope: Domain

Parameters:

applicationIdentifier - The application identifier (optional).

serviceProviderIdentifier - The service provider (optional).

state - The state (ACTIVATED or DEACTIVATED) (optional).

offset - Offset in complete resultset. Must be >= 0.

size - Number of entries to return. 0 means no limit.

Returns:

The application instances matching the specified filter.

Throws:

com.bea.wlcp.wlng.api.management.KeyNotFoundException - If no such account exists.

KeyNotFoundException

removeApplicationInstance

public void removeApplicationInstance(String applicationInstanceName)
                               throws ManagementException

Removes an application instance. The account must be in DEACTIVATED state.

Scope: Domain

Parameters:

applicationInstanceName - the application instance.

Throws:

com.bea.wlcp.wlng.api.management.ManagementException - If the application instance is not in deactivated state.

ManagementException

setApplicationInstancePassword

public void setApplicationInstancePassword(String applicationInstanceName,
                                           String password)
                                    throws KeyNotFoundException

Sets an application instance password.

Scope: Domain

Parameters:

applicationInstanceName - The application instance to update.

password - The new password.

Throws:

com.bea.wlcp.wlng.api.management.KeyNotFoundException - If the application instance does not exist.

KeyNotFoundException

setApplicationInstanceProperties

public void setApplicationInstanceProperties(String applicationInstanceName,
                                             Set properties)
                                      throws KeyNotFoundException

Sets application instance properties.

Note: Only applicable when the MBean is accessed directly.

Scope: Domain

Parameters:

applicationInstanceName - The application instance to update.

properties - The new properties. A set with Map.Entry<String, String>.

Throws:

com.bea.wlcp.wlng.api.management.KeyNotFoundException - If the application instance does not exist.

KeyNotFoundException

setApplicationInstanceReference

public void setApplicationInstanceReference(String applicationInstanceName,
                                            String reference)
                                     throws KeyNotFoundException

Sets an application instance reference.

Scope: Domain

Parameters:

applicationInstanceName - The application instance to update.

reference - The new reference.

Throws:

com.bea.wlcp.wlng.api.management.KeyNotFoundException - If the application instance does not exist.

KeyNotFoundException

setApplicationInstanceState

public void setApplicationInstanceState(String applicationInstanceName,
                                        String state)
                                 throws KeyNotFoundException,
                                        ManagementException

Sets application instance state.

Scope: Domain

Parameters:

applicationInstanceName - The application instance to update.

state - The new state (ACTIVATED or DEACTIVATED).

Throws:

com.bea.wlcp.wlng.api.management.KeyNotFoundException - If the application instance does not exist.

com.bea.wlcp.wlng.api.management.ManagementException - If a parameter was invalid.

KeyNotFoundException

ManagementException

Skip navigation links