| Methods Summary |
|---|
| public synchronized void | actualDeployResource(java.lang.Object resource)Deploy the resource into the server's runtime naming context
_logger.fine(" JdbcConnectionPoolDeployer - actualDeployResource : " + resource );
com.sun.enterprise.config.serverbeans.JdbcConnectionPool adminPool =
(com.sun.enterprise.config.serverbeans.JdbcConnectionPool) resource;
ConnectorConnectionPool connConnPool = createConnectorConnectionPool(
adminPool);
//now do internal book keeping
try {
ConnectorRuntime.getRuntime().createConnectorConnectionPool(
connConnPool);
} catch( ConnectorRuntimeException cre ) {
cre.printStackTrace();
}
|
| public synchronized void | actualUndeployResource(java.lang.Object resource)Undeploy the resource from the server's runtime naming context
_logger.fine(" JdbcConnectionPoolDeployer - unDeployResource : " + resource);
com.sun.enterprise.config.serverbeans.JdbcConnectionPool jdbcConnPool =
(com.sun.enterprise.config.serverbeans.JdbcConnectionPool) resource;
String poolName = jdbcConnPool.getName();
ConnectorRuntime runtime = ConnectorRuntime.getRuntime();
runtime.deleteConnectorConnectionPool( poolName );
if ( _logger.isLoggable( Level.FINEST ) ) {
_logger.finest("Pool Undeployed");
}
|
| public com.sun.enterprise.connectors.ConnectorConnectionPool | createConnectorConnectionPool(com.sun.enterprise.config.serverbeans.JdbcConnectionPool adminPool)
String moduleName = getModuleName( adminPool );
String moduleDir = getSystemModuleLocation( moduleName );
int txSupport = getTxSupport( moduleName );
ConnectorDescriptor connDesc = createConnectorDescriptor( moduleDir );
//Create the connector Connection Pool object from the configbean object
ConnectorConnectionPool conConnPool = new ConnectorConnectionPool(
adminPool.getName() );
conConnPool.setTransactionSupport( txSupport );
setConnectorConnectionPoolAttributes( conConnPool, adminPool );
//Initially create the ConnectorDescriptor
ConnectorDescriptorInfo connDescInfo =
createConnectorDescriptorInfo( connDesc, moduleName );
connDescInfo.setMCFConfigProperties(
getMCFConfigProperties( adminPool, conConnPool, connDesc ) );
//since we are deploying a 1.0 RAR, this is null
connDescInfo.setResourceAdapterConfigProperties((Set) null );
conConnPool.setConnectorDescriptorInfo( connDescInfo );
return conConnPool;
|
| private com.sun.enterprise.deployment.ConnectorDescriptor | createConnectorDescriptor(java.lang.String moduleDir)Load the default RA descriptor from the installed system RAR
ConnectorDescriptor connectorDescriptor = null ;
FileArchive fa = new FileArchive();
try {
fa.open( moduleDir ); // directory where rar is exploded
ConnectorArchivist archivist = new ConnectorArchivist();
connectorDescriptor = (ConnectorDescriptor)
archivist.open(fa);
} catch( Exception ioe ) {
ioe.printStackTrace();
}
return connectorDescriptor;
|
| private com.sun.enterprise.connectors.ConnectorDescriptorInfo | createConnectorDescriptorInfo(com.sun.enterprise.deployment.ConnectorDescriptor connDesc, java.lang.String moduleName)
ConnectorDescriptorInfo connDescInfo = new ConnectorDescriptorInfo();
connDescInfo.setManagedConnectionFactoryClass(
connDesc.getOutboundResourceAdapter().
getManagedConnectionFactoryImpl() );
connDescInfo.setRarName( moduleName );
connDescInfo.setResourceAdapterClassName( connDesc.
getResourceAdapterClass() );
connDescInfo.setConnectionDefinitionName(
connDesc.getOutboundResourceAdapter().
getConnectionFactoryIntf() );
connDescInfo.setConnectionFactoryClass(
connDesc.getOutboundResourceAdapter().
getConnectionFactoryImpl() );
connDescInfo.setConnectionFactoryInterface(
connDesc.getOutboundResourceAdapter().
getConnectionFactoryIntf() );
connDescInfo.setConnectionClass(
connDesc.getOutboundResourceAdapter().
getConnectionImpl() );
connDescInfo.setConnectionInterface(
connDesc.getOutboundResourceAdapter().
getConnectionIntf() );
return connDescInfo;
|
| public synchronized void | deployResource(java.lang.Object resource)
//intentional no-op
//From 8.1 PE/SE/EE, JDBC connection pools are no more resources and
//they would be available only to server instances that have a resoruce-ref
//that maps to a pool. So deploy resource would not be called during
//JDBC connection pool creation. The actualDeployResource method
//below is invoked by JdbcResourceDeployer when a resource-ref for a
//resource that is pointed to this pool is added to a server instance
_logger.fine(" JdbcConnectionPoolDeployer - deployResource : " + resource + " calling actualDeploy");
actualDeployResource(resource);
|
| public synchronized void | disableResource(java.lang.Object resource)Disable the resource in the server's runtime naming context
throw new UnsupportedOperationException(msg);
|
| public synchronized void | enableResource(java.lang.Object resource)Enable the resource in the server's runtime naming context
throw new UnsupportedOperationException(msg);
|
| private com.sun.enterprise.deployment.EnvironmentProperty[] | getMCFConfigProperties(com.sun.enterprise.config.serverbeans.JdbcConnectionPool adminPool, com.sun.enterprise.connectors.ConnectorConnectionPool conConnPool, com.sun.enterprise.deployment.ConnectorDescriptor connDesc)Pull out the MCF configuration properties and return them as an array
of EnvironmentProperty
ArrayList propList = new ArrayList();
propList.add(new EnvironmentProperty("ClassName",
adminPool.getDatasourceClassname() == null ? "" :
adminPool.getDatasourceClassname(),
"The datasource class name",
"java.lang.String"));
propList.add(new EnvironmentProperty("ConnectionValidationRequired",
adminPool.isIsConnectionValidationRequired() + "",
"Is connection validation required",
"java.lang.String"));
propList.add(new EnvironmentProperty("ValidationMethod",
adminPool.getConnectionValidationMethod() == null ? "" :
adminPool.getConnectionValidationMethod(),
"How the connection is validated",
"java.lang.String"));
propList.add(new EnvironmentProperty("ValidationTableName",
adminPool.getValidationTableName() == null ?
"" : adminPool.getValidationTableName(),
"Validation Table name",
"java.lang.String"));
propList.add(new EnvironmentProperty("TransactionIsolation",
adminPool.getTransactionIsolationLevel() == null ? "" :
adminPool.getTransactionIsolationLevel(),
"Transaction Isolatin Level",
"java.lang.String"));
propList.add(new EnvironmentProperty("GuaranteeIsolationLevel",
adminPool.isIsIsolationLevelGuaranteed() + "",
"Transaction Isolation Guarantee",
"java.lang.String"));
propList.add(new EnvironmentProperty("StatementWrapping",
adminPool.isWrapJdbcObjects() + "",
"Statement Wrapping",
"java.lang.String"));
propList.add(new EnvironmentProperty("StatementTimeout",
adminPool.getStatementTimeoutInSeconds() + "",
"Statement Timeout",
"java.lang.String"));
//dump user defined poperties into the list
Set connDefDescSet = connDesc.getOutboundResourceAdapter().
getConnectionDefs();
//since this a 1.0 RAR, we will have only 1 connDefDesc
if (connDefDescSet.size() != 1) {
throw new MissingResourceException("Only one connDefDesc present",
null, null);
}
Iterator iter = connDefDescSet.iterator();
//Now get the set of MCF config properties associated with each
//connection-definition . Each element here is an EnviromnentProperty
Set mcfConfigProps = null;
while (iter.hasNext()) {
mcfConfigProps = ((ConnectionDefDescriptor) iter.next()).
getConfigProperties();
}
if (mcfConfigProps != null) {
Map mcfConPropKeys = new HashMap();
Iterator mcfConfigPropsIter = mcfConfigProps.iterator();
while (mcfConfigPropsIter.hasNext()) {
String key = ((EnvironmentProperty) mcfConfigPropsIter.next()).
getName();
mcfConPropKeys.put(key.toUpperCase(), key);
}
String driverProperties = "";
for (ElementProperty rp : adminPool.getElementProperty()) {
if (rp == null) {
continue;
}
String name = rp.getName();
//The idea here is to convert the Environment Properties coming from
//the admin connection pool to standard pool properties thereby
//making it easy to compare in the event of a reconfig
if ("MATCHCONNECTIONS".equals(name.toUpperCase())) {
//JDBC - matchConnections if not set is decided by the ConnectionManager
//so default is false
conConnPool.setMatchConnections(toBoolean(rp.getValue(), false));
logFine("MATCHCONNECTIONS");
} else if ("LAZYCONNECTIONASSOCIATION".equals(name.toUpperCase())) {
ConnectionPoolObjectsUtils.setLazyEnlistAndLazyAssocProperties(rp.getValue(), adminPool, conConnPool);
logFine("LAZYCONNECTIONASSOCIATION");
} else if ("LAZYCONNECTIONENLISTMENT".equals(name.toUpperCase())) {
conConnPool.setLazyConnectionEnlist(toBoolean(rp.getValue(), false));
logFine("LAZYCONNECTIONENLISTMENT");
} else if ("ASSOCIATEWITHTHREAD".equals(name.toUpperCase())) {
conConnPool.setAssociateWithThread(toBoolean(rp.getValue(), false));
logFine("ASSOCIATEWITHTHREAD");
} else if ("USERNAME".equals(name.toUpperCase()) ||
"USER".equals(name.toUpperCase())) {
propList.add(new EnvironmentProperty("User",
rp.getValue(), "user name", "java.lang.String"));
} else if ("PASSWORD".equals(name.toUpperCase())) {
propList.add(new EnvironmentProperty("Password",
rp.getValue(), "Password", "java.lang.String"));
} else if ("JDBC30DATASOURCE".equals(name.toUpperCase())) {
propList.add(new EnvironmentProperty("JDBC30DataSource",
rp.getValue(), "JDBC30DataSource", "java.lang.String"));
} else if (mcfConPropKeys.containsKey(name.toUpperCase())) {
propList.add(new EnvironmentProperty(
(String) mcfConPropKeys.get(name.toUpperCase()),
rp.getValue() == null ? "" : rp.getValue(),
"Some property",
"java.lang.String"));
} else {
driverProperties = driverProperties + "set" + name
+ "#" + rp.getValue() + "##";
}
}
if (!driverProperties.equals("")) {
propList.add(new EnvironmentProperty("DriverProperties",
driverProperties,
"some proprietarty properties",
"java.lang.String"));
}
}
propList.add(new EnvironmentProperty("Delimiter",
"#", "delim", "java.lang.String"));
//create an array of EnvironmentProperties from above list
EnvironmentProperty[] eProps = new EnvironmentProperty[propList.size()];
ListIterator propListIter = propList.listIterator();
for (int i = 0; propListIter.hasNext(); i++) {
eProps[i] = (EnvironmentProperty) propListIter.next();
}
return eProps;
|
| private java.lang.String | getModuleName(com.sun.enterprise.config.serverbeans.JdbcConnectionPool jcp)
String resType = jcp.getResType();
String dsClassName = jcp.getDatasourceClassname();
String moduleName = ConnectorConstants.JDBCDATASOURCE_RA_NAME;
if (resType == null) {
// default to non-xa
return moduleName;
}
if ("javax.sql.XADataSource".equals(resType) && dsClassName != null) {
try {
Class dsClass = Utility.loadClass( dsClassName );
if (javax.sql.XADataSource.class.isAssignableFrom(dsClass)) {
return ConnectorConstants.JDBCXA_RA_NAME;
}
} catch (ClassNotFoundException e) {
//ignore
}
}
if ("javax.sql.ConnectionPoolDataSource".equals(resType) &&
dsClassName != null) {
try {
Class dsClass = Utility.loadClass( dsClassName );
if (javax.sql.ConnectionPoolDataSource.class.isAssignableFrom(dsClass)) {
return ConnectorConstants.JDBCCONNECTIONPOOLDATASOURCE_RA_NAME;
}
} catch (ClassNotFoundException e) {
//ignore
}
}
return moduleName;
|
| public java.lang.Object | getResource(java.lang.String name, com.sun.enterprise.config.serverbeans.Resources rbeans)Utility method to find a resource from Resources beans and convert
it to a resource object to be used by the implemented ResourceDeployer
Object res = rbeans.getJdbcConnectionPoolByName(name);
if (res == null) {
String msg = sm.getString("resource.no_resource",name);
throw new Exception(msg);
}
return res;
|
| private java.lang.String | getSystemModuleLocation(java.lang.String moduleName)
String j2eeModuleDirName = System.getProperty(Constants.INSTALL_ROOT) +
File.separator + "lib" + File.separator + "install" +
File.separator + "applications" + File.separator + moduleName;
return j2eeModuleDirName;
|
| private int | getTxSupport(java.lang.String moduleName)
if ( ConnectorConstants.JDBCXA_RA_NAME.equals(moduleName)) {
return ConnectionPoolObjectsUtils.parseTransactionSupportString(
ConnectorConstants.XA_TRANSACTION_TX_SUPPORT_STRING );
}
return ConnectionPoolObjectsUtils.parseTransactionSupportString(
ConnectorConstants.LOCAL_TRANSACTION_TX_SUPPORT_STRING );
|
| private void | logFine(java.lang.String msg)Use this method if the string being passed does not
involve multiple concatenations
Avoid using this method in exception-catch blocks as they
are not frequently executed
if (_logger.isLoggable(Level.FINE) && msg != null) {
_logger.fine(msg);
}
|
| public synchronized void | redeployResource(java.lang.Object resource)Redeploy the resource into the server's runtime naming context
com.sun.enterprise.config.serverbeans.JdbcConnectionPool adminPool
= (com.sun.enterprise.config.serverbeans.JdbcConnectionPool)
resource;
//Only if pool has already been deployed in this server-instance
//reconfig this pool
if (!ConnectorRuntime.getRuntime().
isConnectorConnectionPoolDeployed(adminPool.getName())) {
_logger.fine("The JDBC connection pool " + adminPool.getName()
+ " is not referred or not yet created in this server "
+ "instance and hence pool redeployment is ignored");
return;
}
ConnectorConnectionPool connConnPool = createConnectorConnectionPool(
adminPool);
if (connConnPool == null) {
throw new ConnectorRuntimeException("Unable to create ConnectorConnectionPool"+
"from JDBC connection pool");
}
//now do internal book keeping
ConnectorRuntime runtime = ConnectorRuntime.getRuntime();
HashSet excludes = new HashSet();
//add MCF config props to the set that need to be excluded
//in checking for the equality of the props with old pool
excludes.add( "TransactionIsolation");
excludes.add( "GuaranteeIsolationLevel");
excludes.add( "ValidationTableName");
excludes.add( "ConnectionValidationRequired");
excludes.add( "ValidationMethod");
excludes.add( "StatementWrapping");
excludes.add( "StatementTimeout");
try {
_logger.finest("Calling reconfigure pool");
boolean poolRecreateRequired =
runtime.reconfigureConnectorConnectionPool(connConnPool,
excludes);
if ( poolRecreateRequired ) {
_logger.finest("Pool recreation required");
runtime.recreateConnectorConnectionPool( connConnPool );
_logger.finest("Pool recreation done");
}
} catch( ConnectorRuntimeException cre ) {
cre.printStackTrace();
throw cre;
}
|
| private void | setConnectorConnectionPoolAttributes(com.sun.enterprise.connectors.ConnectorConnectionPool ccp, com.sun.enterprise.config.serverbeans.JdbcConnectionPool adminPool)
ccp.setMaxPoolSize(adminPool.getMaxPoolSize() != null ?
adminPool.getMaxPoolSize() :
JdbcConnectionPool.getDefaultMaxPoolSize());
ccp.setSteadyPoolSize(adminPool.getSteadyPoolSize() != null ?
adminPool.getSteadyPoolSize() :
JdbcConnectionPool.getDefaultSteadyPoolSize());
ccp.setMaxWaitTimeInMillis(
adminPool.getMaxWaitTimeInMillis() != null ?
adminPool.getMaxWaitTimeInMillis() :
JdbcConnectionPool.getDefaultMaxWaitTimeInMillis());
ccp.setPoolResizeQuantity(
adminPool.getPoolResizeQuantity() != null ?
adminPool.getPoolResizeQuantity() :
JdbcConnectionPool.getDefaultPoolResizeQuantity());
ccp.setIdleTimeoutInSeconds(
adminPool.getIdleTimeoutInSeconds() != null ?
adminPool.getIdleTimeoutInSeconds() :
JdbcConnectionPool.getDefaultIdleTimeoutInSeconds());
ccp.setFailAllConnections(adminPool.isFailAllConnections());
ccp.setConnectionValidationRequired(
adminPool.isIsConnectionValidationRequired());
ccp.setNonTransactional(
adminPool.isNonTransactionalConnections());
ccp.setNonComponent(adminPool.isAllowNonComponentCallers());
//These are default properties of all Jdbc pools
//So set them here first and then figure out from the parsing routine
//if they need to be reset
ccp.setMatchConnections(adminPool.isMatchConnections());
ccp.setAssociateWithThread(adminPool.isAssociateWithThread());
ccp.setConnectionLeakTracingTimeout(adminPool.getConnectionLeakTimeoutInSeconds());
ccp.setConnectionReclaim(adminPool.isConnectionLeakReclaim());
boolean lazyConnectionEnlistment = adminPool.isLazyConnectionEnlistment();
boolean lazyConnectionAssociation = adminPool.isLazyConnectionAssociation();
//lazy-connection-enlistment need to be ON for lazy-connection-association to work.
if (lazyConnectionAssociation) {
if (lazyConnectionEnlistment) {
ccp.setLazyConnectionAssoc(true);
ccp.setLazyConnectionEnlist(true);
} else {
_logger.log(Level.SEVERE, "conn_pool_obj_utils.lazy_enlist-lazy_assoc-invalid-combination",
adminPool.getName());
String i18nMsg = sm.getString(
"cpou.lazy_enlist-lazy_assoc-invalid-combination", adminPool.getName());
throw new RuntimeException(i18nMsg);
}
} else {
ccp.setLazyConnectionAssoc(lazyConnectionAssociation);
ccp.setLazyConnectionEnlist(lazyConnectionEnlistment);
}
ccp.setMaxConnectionUsage(adminPool.getMaxConnectionUsageCount());
ccp.setConCreationRetryAttempts(adminPool.getConnectionCreationRetryAttempts());
ccp.setConCreationRetryInterval(
adminPool.getConnectionCreationRetryIntervalInSeconds());
ccp.setValidateAtmostOncePeriod(adminPool.getValidateAtmostOncePeriodInSeconds());
|
| private boolean | toBoolean(java.lang.Object prop, boolean defaultVal)
if ( prop == null ) {
return defaultVal;
}
return Boolean.valueOf(((String) prop).toLowerCase());
|
| public synchronized void | undeployResource(java.lang.Object resource)
_logger.fine(" JdbcConnectionPoolDeployer - unDeployResource : " +
"calling actualUndeploy of " + resource);
actualUndeployResource(resource);
|
