Java Doc for BaseBugReport.java in  » Database-JDBC-Connection-Pool » mysql-connector-java-5.1.3 » com » mysql » jdbc » util » 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 JDBC Connection Pool » mysql connector java 5.1.3 » com.mysql.jdbc.util 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   com.mysql.jdbc.util.BaseBugReport

BaseBugReport
abstract public class BaseBugReport (Code)
Base class to help file bug reports for Connector/J.

MySQL AB

    really
appreciates repeatable testcases when reporting bugs, so we're giving you this class to make that job a bit easier (and standarized).

To create a testcase, create a class that inherits from this class (com.mysql.jdbc.util.BaseBugReport), and override the methods 'setUp', 'tearDown' and 'runTest'.

In the 'setUp' method, create code that creates your tables, and populates them with any data needed to demonstrate the bug.

In the 'runTest' method, create code that demonstrates the bug using the tables and data you created in the 'setUp' method.

In the 'tearDown' method, drop any tables you created in the 'setUp' method.

In any of the above three methods, you should use one of the variants of the 'getConnection' method to create a JDBC connection to MySQL, which will use the default JDBC URL of 'jdbc:mysql:///test'.

If you need to use a JDBC URL that is different than 'jdbc:mysql:///test', then override the method 'getUrl' as well.

Use the 'assertTrue' methods to create conditions that must be met in your testcase demonstrating the behavior you are expecting (vs. the behavior you are observing, which is why you are most likely filing a bug report).

Finally, create a 'main' method that creates a new instance of your testcase, and calls the 'run' method:

 public static void main(String[] args) throws Exception {
 new MyBugReport().run();
 }
 

When filing a potential bug with MySQL Connector/J at http://bugs.mysql.com/ or on the bugs mailing list, please include the code that you have just written using this class.
author:
   Mark Matthews
version:
   $Id: BaseBugReport.java 3726 2005-05-19 15:52:24Z mmatthews $




Constructor Summary
public  BaseBugReport()
     Constructor for this BugReport, sets up JDBC driver used to create connections.

Method Summary
final protected  voidassertTrue(String message, boolean condition)
     Throws an exception with the given message if condition evalutates to 'false'.
final protected  voidassertTrue(boolean condition)
     Throws an exception if condition evalutates to 'false'.
final public synchronized  ConnectiongetConnection()
     Provides a connection to the JDBC URL specified in getUrl(). If a connection already exists, that connection is returned.
final public synchronized  ConnectiongetConnection(String url)
     Returns a connection using the given URL.
final public synchronized  ConnectiongetConnection(String url, Properties props)
     Returns a connection using the given URL and properties.
final public synchronized  ConnectiongetNewConnection()
     Use this if you need to get a new connection for your bug report (i.e.
public  StringgetUrl()
     Provides the JDBC URL to use to demonstrate the bug.
final public  voidrun()
     Runs the testcase by calling the setUp(), runTest() and tearDown() methods.
abstract public  voidrunTest()
     Override this method with code that demonstrates the bug.
abstract public  voidsetUp()
     Override this method with code that sets up the testcase for demonstrating your bug (creating tables, populating data, etc).
abstract public  voidtearDown()
     Override this method with code that cleans up anything created in the setUp() method.


Constructor Detail
BaseBugReport
public BaseBugReport()(Code)
Constructor for this BugReport, sets up JDBC driver used to create connections.




Method Detail
assertTrue
final protected void assertTrue(String message, boolean condition) throws Exception(Code)
Throws an exception with the given message if condition evalutates to 'false'.
Parameters:
  message - the message to use in the exception
Parameters:
  condition - the condition to test for
throws:
  Exception - if !condition



assertTrue
final protected void assertTrue(boolean condition) throws Exception(Code)
Throws an exception if condition evalutates to 'false'.
Parameters:
  condition - the condition to test for
throws:
  Exception - if !condition



getConnection
final public synchronized Connection getConnection() throws SQLException(Code)
Provides a connection to the JDBC URL specified in getUrl(). If a connection already exists, that connection is returned. Otherwise a new connection is created. a connection to the JDBC URL specified in getUrl().
throws:
  SQLException - if an error is caused while creating the connection.



getConnection
final public synchronized Connection getConnection(String url) throws SQLException(Code)
Returns a connection using the given URL.
Parameters:
  url - the JDBC URL to use a new java.sql.Connection to the JDBC URL.
throws:
  SQLException - if an error occurs getting the connection.



getConnection
final public synchronized Connection getConnection(String url, Properties props) throws SQLException(Code)
Returns a connection using the given URL and properties.
Parameters:
  url - the JDBC URL to use
Parameters:
  props - the JDBC properties to use a new java.sql.Connection to the JDBC URL.
throws:
  SQLException - if an error occurs getting the connection.



getNewConnection
final public synchronized Connection getNewConnection() throws SQLException(Code)
Use this if you need to get a new connection for your bug report (i.e. there's more than one connection involved). a new connection to the JDBC URL specified in getUrl().
throws:
  SQLException - if an error is caused while creating the connection.



getUrl
public String getUrl()(Code)
Provides the JDBC URL to use to demonstrate the bug. The java.sql.Connection that you use to demonstrate this bug will be provided by the getConnection() method using this URL. The default value is 'jdbc:mysql:///test'



run
final public void run() throws Exception(Code)
Runs the testcase by calling the setUp(), runTest() and tearDown() methods. The tearDown() method is run regardless of any errors occuring in the other methods.
throws:
  Exception - if an error occurs in any of the aforementioned methods.



runTest
abstract public void runTest() throws Exception(Code)
Override this method with code that demonstrates the bug. This method will be called after setUp(), and before tearDown().
throws:
  Exception - if an error occurs during your test run.



setUp
abstract public void setUp() throws Exception(Code)
Override this method with code that sets up the testcase for demonstrating your bug (creating tables, populating data, etc).
throws:
  Exception - if an error occurs during the 'setUp' phase.



tearDown
abstract public void tearDown() throws Exception(Code)
Override this method with code that cleans up anything created in the setUp() method.
throws:
  Exception - if an error occurs during the 'tearDown' phase.



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.