Java Doc for ClientDataSource.java in  » Database-DBMS » db-derby-10.2 » org » apache » derby » jdbc » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Java Source Code / Java Documentation
1. 6.0 JDK Core
2. 6.0 JDK Modules
3. 6.0 JDK Modules com.sun
4. 6.0 JDK Modules com.sun.java
5. 6.0 JDK Modules sun
6. 6.0 JDK Platform
7. Ajax
8. Apache Harmony Java SE
9. Aspect oriented
10. Authentication Authorization
11. Blogger System
12. Build
13. Byte Code
14. Cache
15. Chart
16. Chat
17. Code Analyzer
18. Collaboration
19. Content Management System
20. Database Client
21. Database DBMS
22. Database JDBC Connection Pool
23. Database ORM
24. Development
25. EJB Server geronimo
26. EJB Server GlassFish
27. EJB Server JBoss 4.2.1
28. EJB Server resin 3.1.5
29. ERP CRM Financial
30. ESB
31. Forum
32. GIS
33. Graphic Library
34. Groupware
35. HTML Parser
36. IDE
37. IDE Eclipse
38. IDE Netbeans
39. Installer
40. Internationalization Localization
41. Inversion of Control
42. Issue Tracking
43. J2EE
44. JBoss
45. JMS
46. JMX
47. Library
48. Mail Clients
49. Net
50. Parser
51. PDF
52. Portal
53. Profiler
54. Project Management
55. Report
56. RSS RDF
57. Rule Engine
58. Science
59. Scripting
60. Search Engine
61. Security
62. Sevlet Container
63. Source Control
64. Swing Library
65. Template Engine
66. Test Coverage
67. Testing
68. UML
69. Web Crawler
70. Web Framework
71. Web Mail
72. Web Server
73. Web Services
74. Web Services apache cxf 2.0.1
75. Web Services AXIS2
76. Wiki Engine
77. Workflow Engines
78. XML
79. XML UI
Java
Java Tutorial
Java Open Source
Jar File Download
Java Articles
Java Products
Java by API
Photoshop Tutorials
Maya Tutorials
Flash Tutorials
3ds-Max Tutorials
Illustrator Tutorials
GIMP Tutorials
C# / C Sharp
C# / CSharp Tutorial
C# / CSharp Open Source
ASP.Net
ASP.NET Tutorial
JavaScript DHTML
JavaScript Tutorial
JavaScript Reference
HTML / CSS
HTML CSS Reference
C / ANSI-C
C Tutorial
C++
C++ Tutorial
Ruby
PHP
Python
Python Tutorial
Python Open Source
SQL Server / T-SQL
SQL Server / T-SQL Tutorial
Oracle PL / SQL
Oracle PL/SQL Tutorial
PostgreSQL
SQL / MySQL
MySQL Tutorial
VB.Net
VB.Net Tutorial
Flash / Flex / ActionScript
VBA / Excel / Access / Word
XML
XML Tutorial
Microsoft Office PowerPoint 2007 Tutorial
Microsoft Office Excel 2007 Tutorial
Microsoft Office Word 2007 Tutorial
Java Source Code / Java Documentation » Database DBMS » db derby 10.2 » org.apache.derby.jdbc 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   org.apache.derby.jdbc.ClientBaseDataSource
      org.apache.derby.jdbc.ClientDataSource

All known Subclasses:   org.apache.derby.jdbc.ClientConnectionPoolDataSource,  org.apache.derby.jdbc.ClientXADataSource,  org.apache.derby.jdbc.ClientDataSource40,
ClientDataSource
public class ClientDataSource extends ClientBaseDataSource implements DataSource(Code)
ClientDataSource is a simple data source implementation that can be used for establishing connections in a non-pooling, non-distributed environment. The class ClientConnectionPoolDataSource can be used in a connection pooling environment, and the class ClientXADataSource can be used in a distributed, and pooling environment. Use these DataSources if your application runs under JDBC3.0 or JDBC2.0, that is, on the following Java Virtual Machines:

  • JDBC 3.0 - Java 2 - JDK 1.4, J2SE 5.0
  • JDBC 2.0 - Java 2 - JDK 1.2,1.3

The example below registers a DNC data source object with a JNDI naming service.

 org.apache.derby.client.ClientDataSource dataSource = new org.apache.derby.client.ClientDataSource ();
 dataSource.setServerName ("my_derby_database_server");
 dataSource.setDatabaseName ("my_derby_database_name");
 javax.naming.Context context = new javax.naming.InitialContext();
 context.bind ("jdbc/my_datasource_name", dataSource);
 
The first line of code in the example creates a data source object. The next two lines initialize the data source's properties. Then a Java object that references the initial JNDI naming context is created by calling the InitialContext() constructor, which is provided by JNDI. System properties (not shown) are used to tell JNDI the service provider to use. The JNDI name space is hierarchical, similar to the directory structure of many file systems. The data source object is bound to a logical JNDI name by calling Context.bind(). In this case the JNDI name identifies a subcontext, "jdbc", of the root naming context and a logical name, "my_datasource_name", within the jdbc subcontext. This is all of the code required to deploy a data source object within JNDI. This example is provided mainly for illustrative purposes. We expect that developers or system administrators will normally use a GUI tool to deploy a data source object.

Once a data source has been registered with JNDI, it can then be used by a JDBC application, as is shown in the following example.

 javax.naming.Context context = new javax.naming.InitialContext ();
 javax.sql.DataSource dataSource = (javax.sql.DataSource) context.lookup ("jdbc/my_datasource_name");
 java.sql.Connection connection = dataSource.getConnection ("user", "password");
 
The first line in the example creates a Java object that references the initial JNDI naming context. Next, the initial naming context is used to do a lookup operation using the logical name of the data source. The Context.lookup() method returns a reference to a Java Object, which is narrowed to a javax.sql.DataSource object. In the last line, the DataSource.getConnection() method is called to produce a database connection.

This simple data source subclass of ClientBaseDataSource maintains it's own private password property.

The specified password, along with the user, is validated by DERBY. This property can be overwritten by specifing the password parameter on the DataSource.getConnection() method call.

This password property is not declared transient, and therefore may be serialized to a file in clear-text, or stored to a JNDI server in clear-text when the data source is saved. Care must taken by the user to prevent security breaches.



Field Summary
final public static  StringclassName__
    

Constructor Summary
public  ClientDataSource()
     Creates a simple DERBY data source with default property values for a non-pooling, non-distributed environment.

Method Summary
public  ConnectiongetConnection()
     Attempt to establish a database connection in a non-pooling, non-distributed environment.
public  ConnectiongetConnection(String user, String password)
     Attempt to establish a database connection in a non-pooling, non-distributed environment.

Field Detail
className__
final public static String className__(Code)




Constructor Detail
ClientDataSource
public ClientDataSource()(Code)
Creates a simple DERBY data source with default property values for a non-pooling, non-distributed environment. No particular DatabaseName or other properties are associated with the data source.

Every Java Bean should provide a constructor with no arguments since many beanboxes attempt to instantiate a bean by invoking its no-argument constructor.





Method Detail
getConnection
public Connection getConnection() throws SQLException(Code)
Attempt to establish a database connection in a non-pooling, non-distributed environment. a Connection to the database
throws:
  java.sql.SQLException - if a database-access error occurs.



getConnection
public Connection getConnection(String user, String password) throws SQLException(Code)
Attempt to establish a database connection in a non-pooling, non-distributed environment.
Parameters:
  user - the database user on whose behalf the Connection is being made
Parameters:
  password - the user's password a Connection to the database
throws:
  java.sql.SQLException - if a database-access error occurs.



Fields inherited from org.apache.derby.jdbc.ClientBaseDataSource
final public static short CLEAR_TEXT_PASSWORD_SECURITY(Code)(Java Doc)
final public static short ENCRYPTED_PASSWORD_SECURITY(Code)(Java Doc)
final public static short ENCRYPTED_USER_AND_PASSWORD_SECURITY(Code)(Java Doc)
final public static short STRONG_PASSWORD_SUBSTITUTE_SECURITY(Code)(Java Doc)
static boolean SUPPORTS_EUSRIDPWD(Code)(Java Doc)
final public static int TRACE_ALL(Code)(Java Doc)
final public static int TRACE_CONNECTION_CALLS(Code)(Java Doc)
final public static int TRACE_CONNECTS(Code)(Java Doc)
final public static int TRACE_DIAGNOSTICS(Code)(Java Doc)
final public static int TRACE_DRIVER_CONFIGURATION(Code)(Java Doc)
final public static int TRACE_NONE(Code)(Java Doc)
final public static int TRACE_PARAMETER_META_DATA(Code)(Java Doc)
final public static int TRACE_PROTOCOL_FLOWS(Code)(Java Doc)
final public static int TRACE_RESULT_SET_CALLS(Code)(Java Doc)
final public static int TRACE_RESULT_SET_META_DATA(Code)(Java Doc)
final public static int TRACE_STATEMENT_CALLS(Code)(Java Doc)
final public static int TRACE_XA_CALLS(Code)(Java Doc)
final public static short USER_ONLY_SECURITY(Code)(Java Doc)
protected String connectionAttributes(Code)(Java Doc)
final public static int propertyDefault_portNumber(Code)(Java Doc)
final public static boolean propertyDefault_retrieveMessageText(Code)(Java Doc)
final public static short propertyDefault_securityMechanism(Code)(Java Doc)
final public static String propertyDefault_serverName(Code)(Java Doc)
final public static boolean propertyDefault_traceFileAppend(Code)(Java Doc)
final public static int propertyDefault_traceLevel(Code)(Java Doc)
final public static String propertyDefault_user(Code)(Java Doc)
protected short securityMechanism(Code)(Java Doc)
protected int traceLevel(Code)(Java Doc)

Methods inherited from org.apache.derby.jdbc.ClientBaseDataSource
static LogWriter computeDncLogWriter(PrintWriter logWriter, String traceDirectory, String traceFile, boolean traceFileAppend, String logWriterInUseSuffix, int traceFileSuffixIndex, int traceLevel) throws SqlException(Code)(Java Doc)
public static LogWriter computeDncLogWriter(Connection connection, PrintWriter logWriter, String traceDirectory, String traceFile, boolean traceFileAppend, String logWriterInUseSuffix, int traceFileSuffixIndex, int traceLevel) throws SqlException(Code)(Java Doc)
LogWriter computeDncLogWriterForNewConnection(String logWriterInUseSuffix) throws SqlException(Code)(Java Doc)
static LogWriter computeDncLogWriterForNewConnection(PrintWriter logWriter, String traceDirectory, String traceFile, boolean traceFileAppend, int traceLevel, String logWriterInUseSuffix, int traceFileSuffixIndex) throws SqlException(Code)(Java Doc)
static PrintWriter computePrintWriter(PrintWriter logWriter, String traceDirectory, String traceFile, boolean traceFileAppend, String logWriterInUseSuffix, int traceFileSuffixIndex) throws SqlException(Code)(Java Doc)
final public String getConnectionAttributes()(Code)(Java Doc)
public String getDataSourceName()(Code)(Java Doc)
public String getDatabaseName()(Code)(Java Doc)
public String getDescription()(Code)(Java Doc)
public PrintWriter getLogWriter()(Code)(Java Doc)
public int getLoginTimeout()(Code)(Java Doc)
public static String getPassword(Properties properties)(Code)(Java Doc)
final public String getPassword()(Code)(Java Doc)
public int getPortNumber()(Code)(Java Doc)
public Reference getReference() throws NamingException(Code)(Java Doc)
public static boolean getRetrieveMessageText(Properties properties)(Code)(Java Doc)
public boolean getRetrieveMessageText()(Code)(Java Doc)
public static short getSecurityMechanism(Properties properties)(Code)(Java Doc)
public short getSecurityMechanism()(Code)(Java Doc)
public short getSecurityMechanism(String password)(Code)(Java Doc)
public String getServerName()(Code)(Java Doc)
public static String getTraceDirectory(Properties properties)(Code)(Java Doc)
public String getTraceDirectory()(Code)(Java Doc)
public static String getTraceFile(Properties properties)(Code)(Java Doc)
public String getTraceFile()(Code)(Java Doc)
public static boolean getTraceFileAppend(Properties properties)(Code)(Java Doc)
public boolean getTraceFileAppend()(Code)(Java Doc)
public static int getTraceLevel(Properties properties)(Code)(Java Doc)
public int getTraceLevel()(Code)(Java Doc)
public static short getUpgradedSecurityMechanism(String password)(Code)(Java Doc)
public static String getUser(Properties properties)(Code)(Java Doc)
public String getUser()(Code)(Java Doc)
final public void setConnectionAttributes(String prop)(Code)(Java Doc)
public synchronized void setDataSourceName(String dataSourceName)(Code)(Java Doc)
public synchronized void setDatabaseName(String databaseName)(Code)(Java Doc)
public synchronized void setDescription(String description)(Code)(Java Doc)
public synchronized void setLogWriter(PrintWriter logWriter)(Code)(Java Doc)
public synchronized void setLoginTimeout(int seconds)(Code)(Java Doc)
final public synchronized void setPassword(String password)(Code)(Java Doc)
public synchronized void setPortNumber(int portNumber)(Code)(Java Doc)
public synchronized void setRetrieveMessageText(boolean retrieveMessageText)(Code)(Java Doc)
public synchronized void setSecurityMechanism(short securityMechanism)(Code)(Java Doc)
public synchronized void setServerName(String serverName)(Code)(Java Doc)
public synchronized void setTraceDirectory(String traceDirectory)(Code)(Java Doc)
public synchronized void setTraceFile(String traceFile)(Code)(Java Doc)
public synchronized void setTraceFileAppend(boolean traceFileAppend)(Code)(Java Doc)
public synchronized void setTraceLevel(int traceLevel)(Code)(Java Doc)
public synchronized void setUser(String user)(Code)(Java Doc)
static Properties tokenizeAttributes(String attributeString, Properties properties) throws SqlException(Code)(Java Doc)
void updateDataSourceValues(Properties prop)(Code)(Java Doc)

Methods inherited from java.lang.Object
native protected Object clone() throws CloneNotSupportedException(Code)(Java Doc)
public boolean equals(Object obj)(Code)(Java Doc)
protected void finalize() throws Throwable(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.