在GlassFish中创建JDBC连接池和资源的方式

JDBC Connection Pool & Resource can be created in multiple ways.

• Admin Console
• CLI
• Using sun-resources.xml templates
• Creating Connection Pool & Resource programmatically

 

• 管理控制台
• 批处理命令行
• 使用sun-resources.xml
• 使用AMX（应用程序管理扩展）API在程序中创建

  1) Admin Console

  Admin console provides user intuitive interface to create a connection pool & resource for database access.
  a) Copy the jdbc driver that will be used for database connectivity, to GLASSFISH_INSTALL/domains/<domainname>/lib/ext or
  add the jdbc-driver path to "classpath-prefix" and restart application server.
  
  b) Using Admin console, Common Tasks > create jdbc connection pool
  
  
  
  c) Provide a name for the connection pool, select the resource type, select the database vendor and press Next
  
  
  
  d) Console will list the the default pool settings and also the properties of datasource class provided by the vendor.
  
  
  
  
  e) Fill the values for datasource properties, eg: servername, user, password, URL, databasename etc., and press Finish
     
  f) Pool will be created
  
  
  
  g) To check whether the values provided for datasource for database connectivity are valid and works fine, press Ping.
  Ping will use these properties and try to establish a connection.
  
  
  
  This connection pool need to be associated with a jdbc-resource.
  
  h) To create a jdbc-resource that will be used by the application :
  Resources > Jdbc Resources
  
  
  i) Press New
  
  j) provide the jndi name for the resource and the pool with which the resource need to be associated.
  
  
  
  
  k) Press OK, jdbc-resource will be created.
  
  

  2) Using CLI

  jdbc-connection-pool can be created as
  
  

  AS_INSTALL_ROOT/bin/asadmin create-jdbc-connection-pool --datasourceclassname oracle.jdbc.pool.OracleDataSource --restype javax.sql.DataSource --property user=dbuser:password=dbpassword:url="jdbc/:oracle/:thin/:@localhost/:1521/:ORCL" oracle-pool Command create-jdbc-connection-pool executed successfully.

  
  jdbc-resource can be created as
  

  AS_INSTALL_ROOT/bin/asadmin create-jdbc-resource --connectionpoolid oracle-pool jdbc/oracle-resource Command create-jdbc-resource executed successfully.

  
  To test whether the connection settings are correct, ping connection pool
  

  AS_INSTALL_ROOT/bin/asadmin ping-connection-pool oracle-pool Command ping-connection-pool executed successfully.

  
  Properties of connection pool can be read/changed as follows.
  

  AS_INSTALL_ROOT/bin/asadmin list *oracle-pool* domain.resources.jdbc-connection-pool.oracle-pool

  
  List the properties of connection pool
  

  AS_INSTALL_ROOT/bin/asadmin get domain.resources.jdbc-connection-pool.oracle-pool.* domain.resources.jdbc-connection-pool.oracle-pool.allow-non-component-callers = false domain.resources.jdbc-connection-pool.oracle-pool.associate-with-thread = false domain.resources.jdbc-connection-pool.oracle-pool.connection-creation-retry-attempts = 0 domain.resources.jdbc-connection-pool.oracle-pool.connection-creation-retry-interval-in-seconds = 10 domain.resources.jdbc-connection-pool.oracle-pool.connection-leak-reclaim = false domain.resources.jdbc-connection-pool.oracle-pool.connection-leak-timeout-in-seconds = 0 domain.resources.jdbc-connection-pool.oracle-pool.connection-validation-method = auto-commit domain.resources.jdbc-connection-pool.oracle-pool.datasource-classname = oracle.jdbc.pool.OracleDataSource domain.resources.jdbc-connection-pool.oracle-pool.description = domain.resources.jdbc-connection-pool.oracle-pool.fail-all-connections = false domain.resources.jdbc-connection-pool.oracle-pool.idle-timeout-in-seconds = 300 domain.resources.jdbc-connection-pool.oracle-pool.is-connection-validation-required = false domain.resources.jdbc-connection-pool.oracle-pool.is-isolation-level-guaranteed = true domain.resources.jdbc-connection-pool.oracle-pool.lazy-connection-association = false domain.resources.jdbc-connection-pool.oracle-pool.lazy-connection-enlistment = false domain.resources.jdbc-connection-pool.oracle-pool.match-connections = false domain.resources.jdbc-connection-pool.oracle-pool.max-connection-usage-count = 0 domain.resources.jdbc-connection-pool.oracle-pool.max-pool-size = 32 domain.resources.jdbc-connection-pool.oracle-pool.max-wait-time-in-millis = 60000 domain.resources.jdbc-connection-pool.oracle-pool.name = oracle-pool domain.resources.jdbc-connection-pool.oracle-pool.non-transactional-connections = false domain.resources.jdbc-connection-pool.oracle-pool.pool-resize-quantity = 2 domain.resources.jdbc-connection-pool.oracle-pool.property.password = dbpassword domain.resources.jdbc-connection-pool.oracle-pool.property.url = jdbc:oracle:thin:@localhost:1521:ORCL domain.resources.jdbc-connection-pool.oracle-pool.property.user = dbuser domain.resources.jdbc-connection-pool.oracle-pool.res-type = javax.sql.DataSource domain.resources.jdbc-connection-pool.oracle-pool.statement-timeout-in-seconds = -1 domain.resources.jdbc-connection-pool.oracle-pool.steady-pool-size = 8 domain.resources.jdbc-connection-pool.oracle-pool.transaction-isolation-level = domain.resources.jdbc-connection-pool.oracle-pool.validate-atmost-once-period-in-seconds = 0 domain.resources.jdbc-connection-pool.oracle-pool.validation-table-name = domain.resources.jdbc-connection-pool.oracle-pool.wrap-jdbc-objects = false

  
  Changing a property
  

  AS_INSTALL_ROOT/bin/asadmin set domain.resources.jdbc-connection-pool.oracle-pool.steady-pool-size=20 domain.resources.jdbc-connection-pool.oracle-pool.steady-pool-size = 20

  
  
  

  AS_INSTALL_ROOT/bin/asadmin get domain.resources.jdbc-connection-pool.oracle-pool.steady-pool-size    domain.resources.jdbc-connection-pool.oracle-pool.steady-pool-size = 20

  
  
  

  3) Using sun-resources.xml templates

  sun-resources.xml can be used to create jdbc-connection-pool & resources.
  Templates for various databases will be available in GLASSFISH_INSTALL/lib/install/templates/resources/jdbc
  Copy and modify the templates with appropriate values.
  
  eg:
  copy "oracle_type4_datasource.xml"  as oracle-resource.xml and modify the URL, user, password values.
  

  GLASSFISH_INSTALL/bin/asadmin add-resources GLASSFISH_INSTALL/lib/install/templates/resources/jdbc/oracle-resource.xml  ========================= Added Resource Type: jdbc-connection-pool  ========================= Added Resource Type: jdbc-resource Command add-resources executed successfully.

  
  
  

  4) Creating Connection Pool & Resource programmatically

  Using AMX (Application Server Management Extenstions) resource/pool can be created. Following snippet
  will create a connection pool, resource and resource-ref for the "server" instance.
  [needs appserv-ext.jar in classpath]
  

  import java.util.Map; import java.util.HashMap; import com.sun.appserv.management.client.AppserverConnectionSource; import com.sun.appserv.management.DomainRoot; import com.sun.appserv.management.config.*; public class ResourceCreator {     public static final String hostName = "localhost";     public static final int JMX_PORT = 8686;     public static final String user = "admin";     public static final String password = "adminadmin";     public static void main(String[] args) throws Exception {         AppserverConnectionSource appserver =                 new AppserverConnectionSource(AppserverConnectionSource.PROTOCOL_RMI, hostName, JMX_PORT, user, password, null);         String connPoolName = "mysql-con-pool";         String resourceName = "jdbc/mysql-resource";         DomainRoot domainRoot = appserver.getDomainRoot();         //check whether the con.pool already exists, else, create one         Map<String, JDBCConnectionPoolConfig> conPoolMap = domainRoot.getDomainConfig().getJDBCConnectionPoolConfigMap();         if (conPoolMap.containsKey(connPoolName)) {             System.out.println("JDBC Connection pool : " + connPoolName + " already exists");         } else {             Map<String, String> map = new HashMap<String, String>();             map.put("property.user", "jagadish");             map.put("ResType", "javax.sql.ConnectionPoolDataSource");             map.put("property.password", "jagadish");             map.put("property.databaseName", "jagadish");             map.put("property.url", "jdbc:mysql://localhost:3306/jagadish");             domainRoot.getDomainConfig().createJDBCConnectionPoolConfig(connPoolName, "com.mysql.jdbc.jdbc2.optional.MysqlConnectionPoolDataSource", map);             System.out.println("JDBC Connection pool : " + connPoolName + " created ! ");         }         //check whether the jdbc resource already exists, else, create one         Map<String, JDBCResourceConfig> resMap = domainRoot.getDomainConfig().getJDBCResourceConfigMap();         if (resMap.containsKey(resourceName)) {             System.out.println("JDBC Resource : " + resourceName + " already exists");         } else {             domainRoot.getDomainConfig().createJDBCResourceConfig(resourceName, connPoolName, null);             System.out.println("JDBC Resource : " + resourceName + " created !");         }         //create a resource-ref for the instance "server"         Map<String, StandaloneServerConfig> map1 = domainRoot.getDomainConfig().getStandaloneServerConfigMap();         {             StandaloneServerConfig sc = map1.get("server");             Map<String, ResourceRefConfig> rm = sc.getResourceRefConfigMap();             if (rm.containsKey(resourceName)) {                 System.out.println(resourceName + " already referenced for the server instance");             } else {                 sc.createResourceRefConfig(resourceName, true);                 System.out.println(resourceName + " reference created for the server instance");             }         }     } }