org.glassfish.jdbc.deployer

Class JdbcResourceDeployer

java.lang.Object

org.glassfish.jdbc.deployer.JdbcResourceDeployer

All Implemented Interfaces:

ResourceDeployer

@Service
 @Singleton
public class JdbcResourceDeployer
extends Object
implements ResourceDeployer

Handles Jdbc resource events in the server instance. When user adds a jdbc resource, the admin instance emits resource event. The jdbc resource events are propagated to this object.

The methods can potentially be called concurrently, therefore implementation need to be synchronized.

Since:

JDK1.4

Author:

Nazrul Islam

Constructor Summary

Constructors

Constructor and Description
JdbcResourceDeployer()

Method Summary

Modifier and Type	Method and Description
boolean	canDeploy(boolean postApplicationDeployment, Collection<Resource> allResources, Resource resource) A deployer can indicate whether a particular resource can be deployed before application deployment Used in case of application-scoped-resources eg: Embedded RAR resources are created after application (that has embedded .rar) deployment.
void	deployResource(Object resource) Deploy the resource into the server's runtime naming context
void	deployResource(Object resource, String applicationName, String moduleName) Deploy the resource into the server's runtime naming context This API is used in cases where the "config" bean is not yet persisted in domain.xml and is part of the "config" transaction.
void	disableResource(Object resource) Disable the resource in the server's runtime naming context
void	enableResource(Object resource) Enable the resource in the server's runtime naming context
Class[]	getProxyClassesForDynamicReconfiguration() List of classes which need to be proxied for dynamic-reconfiguration
boolean	handles(Object resource) Indicates whether a particular resource deployer can handle the resource in question
void	redeployResource(Object resource) Redeploy the resource into the server's runtime naming context
boolean	supportsDynamicReconfiguration() Indicates whether the resource deployer can handle transparent-dynamic-reconfiguration of resource
void	undeployResource(Object resource) Undeploy the resource from the server's runtime naming context
void	undeployResource(Object resource, String applicationName, String moduleName) Undeploy the resource from the server's runtime naming context
void	validatePreservedResource(Application oldApp, Application newApp, Resource resource, Resources allResources)

Methods inherited from class java.lang.Object

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

Constructor Detail

JdbcResourceDeployer

public JdbcResourceDeployer()

Method Detail

deployResource

public void deployResource(Object resource,
                           String applicationName,
                           String moduleName)
                    throws Exception

Deploy the resource into the server's runtime naming context This API is used in cases where the "config" bean is not yet persisted in domain.xml and is part of the "config" transaction.

Specified by:

deployResource in interface ResourceDeployer

Parameters:

resource - a resource object (eg. JmsResource)

applicationName - application-name

moduleName - module-name

Throws:

Exception - thrown if fail

deployResource

public void deployResource(Object resource)
                    throws Exception

Deploy the resource into the server's runtime naming context

Specified by:

deployResource in interface ResourceDeployer

Parameters:

resource - a resource object (eg. JmsResource)

Throws:

Exception - thrown if fail

canDeploy

public boolean canDeploy(boolean postApplicationDeployment,
                         Collection<Resource> allResources,
                         Resource resource)

A deployer can indicate whether a particular resource can be deployed before application deployment
Used in case of application-scoped-resources
eg: Embedded RAR resources are created after application (that has embedded .rar) deployment.

Specified by:

canDeploy in interface ResourceDeployer

Parameters:

postApplicationDeployment - post-application-deployment

allResources - resources collection in which the resource being validated is present.

resource - resource to be validated

Returns:

boolean

undeployResource

public void undeployResource(Object resource,
                             String applicationName,
                             String moduleName)
                      throws Exception

Undeploy the resource from the server's runtime naming context

Specified by:

undeployResource in interface ResourceDeployer

Parameters:

resource - a resource object (eg. JmsResource)

applicationName - application-name

moduleName - module-name

Throws:

Exception - thrown if fail

undeployResource

public void undeployResource(Object resource)
                      throws Exception

Undeploy the resource from the server's runtime naming context

Specified by:

undeployResource in interface ResourceDeployer

Parameters:

resource - a resource object (eg. JmsResource)

Throws:

Exception - thrown if fail

redeployResource

public void redeployResource(Object resource)
                      throws Exception

Redeploy the resource into the server's runtime naming context

Specified by:

redeployResource in interface ResourceDeployer

Parameters:

resource - a resource object

Throws:

Exception - thrown if fail

handles

public boolean handles(Object resource)

Indicates whether a particular resource deployer can handle the resource in question

Specified by:

handles in interface ResourceDeployer

Parameters:

resource - resource that need to be handled

Returns:

boolean

getProxyClassesForDynamicReconfiguration

public Class[] getProxyClassesForDynamicReconfiguration()

Description copied from interface: ResourceDeployer

List of classes which need to be proxied for dynamic-reconfiguration

Specified by:

getProxyClassesForDynamicReconfiguration in interface ResourceDeployer

Returns:

list of classes

supportsDynamicReconfiguration

public boolean supportsDynamicReconfiguration()

Description copied from interface: ResourceDeployer

Indicates whether the resource deployer can handle transparent-dynamic-reconfiguration of resource

Specified by:

supportsDynamicReconfiguration in interface ResourceDeployer

Returns:

boolean indicating whether transparent-dynamic-reconfiguration is supported.

enableResource

public void enableResource(Object resource)
                    throws Exception

Enable the resource in the server's runtime naming context

Specified by:

enableResource in interface ResourceDeployer

Parameters:

resource - a resource object (eg. JmsResource)

Throws:

Exception - thrown if fail

disableResource

public void disableResource(Object resource)
                     throws Exception

Disable the resource in the server's runtime naming context

Specified by:

disableResource in interface ResourceDeployer

Parameters:

resource - a resource object (eg. JmsResource)

Throws:

Exception - thrown if fail

validatePreservedResource

public void validatePreservedResource(Application oldApp,
                                      Application newApp,
                                      Resource resource,
                                      Resources allResources)
                               throws ResourceConflictException

Specified by:

validatePreservedResource in interface ResourceDeployer

Throws:

ResourceConflictException