KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > objectstyle > cayenne > dba > hsqldb > HSQLDBAdapter


1 /* ====================================================================
2  *
3  * The ObjectStyle Group Software License, version 1.1
4  * ObjectStyle Group - http://objectstyle.org/
5  *
6  * Copyright (c) 2002-2005, Andrei (Andrus) Adamchik and individual authors
7  * of the software. All rights reserved.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  *
13  * 1. Redistributions of source code must retain the above copyright
14  * notice, this list of conditions and the following disclaimer.
15  *
16  * 2. Redistributions in binary form must reproduce the above copyright
17  * notice, this list of conditions and the following disclaimer in
18  * the documentation and/or other materials provided with the
19  * distribution.
20  *
21  * 3. The end-user documentation included with the redistribution, if any,
22  * must include the following acknowlegement:
23  * "This product includes software developed by independent contributors
24  * and hosted on ObjectStyle Group web site (http://objectstyle.org/)."
25  * Alternately, this acknowlegement may appear in the software itself,
26  * if and wherever such third-party acknowlegements normally appear.
27  *
28  * 4. The names "ObjectStyle Group" and "Cayenne" must not be used to endorse
29  * or promote products derived from this software without prior written
30  * permission. For written permission, email
31  * "andrus at objectstyle dot org".
32  *
33  * 5. Products derived from this software may not be called "ObjectStyle"
34  * or "Cayenne", nor may "ObjectStyle" or "Cayenne" appear in their
35  * names without prior written permission.
36  *
37  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
38  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
39  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
40  * DISCLAIMED. IN NO EVENT SHALL THE OBJECTSTYLE GROUP OR
41  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
42  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
43  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
44  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
45  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
46  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
47  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
48  * SUCH DAMAGE.
49  * ====================================================================
50  *
51  * This software consists of voluntary contributions made by many
52  * individuals and hosted on ObjectStyle Group web site. For more
53  * information on the ObjectStyle Group, please see
54  * <http://objectstyle.org/>.
55  */

56
57 package org.objectstyle.cayenne.dba.hsqldb;
58
59 import java.util.Collection JavaDoc;
60 import java.util.Iterator JavaDoc;
61
62 import org.objectstyle.cayenne.CayenneRuntimeException;
63 import org.objectstyle.cayenne.dba.JdbcAdapter;
64 import org.objectstyle.cayenne.map.DbAttribute;
65 import org.objectstyle.cayenne.map.DbEntity;
66 import org.objectstyle.cayenne.map.DbJoin;
67 import org.objectstyle.cayenne.map.DbRelationship;
68
69 /**
70  * DbAdapter implementation for the <a HREF="http://hsqldb.sourceforge.net/"> HSQLDB RDBMS
71  * </a>. Sample <a target="_top"
72  * HREF="../../../../../../../developerguide/unit-tests.html">connection settings </a> to
73  * use with HSQLDB are shown below:
74  *
75  * <pre>
76  *
77  * test-hsqldb.cayenne.adapter = org.objectstyle.cayenne.dba.hsqldb.HSQLDBAdapter
78  * test-hsqldb.jdbc.username = test
79  * test-hsqldb.jdbc.password = secret
80  * test-hsqldb.jdbc.url = jdbc:hsqldb:hsql://serverhostname
81  * test-hsqldb.jdbc.driver = org.hsqldb.jdbcDriver
82  *
83  * </pre>
84  *
85  * @author Holger Hoffstaette
86  */

87 public class HSQLDBAdapter extends JdbcAdapter {
88
89     /**
90      * Returns a DDL string to create a unique constraint over a set of columns.
91      *
92      * @since 1.1
93      */

94     public String JavaDoc createUniqueConstraint(DbEntity source, Collection JavaDoc columns) {
95         if (columns == null || columns.isEmpty()) {
96             throw new CayenneRuntimeException(
97                     "Can't create UNIQUE constraint - no columns specified.");
98         }
99
100         // hsqldb doesn't support schema namespaces
101
String JavaDoc srcName = source.getName();
102
103         StringBuffer JavaDoc buf = new StringBuffer JavaDoc();
104
105         buf.append("ALTER TABLE ").append(srcName);
106         buf.append(" ADD CONSTRAINT ");
107         buf.append("U_");
108         buf.append(srcName);
109         buf.append("_");
110         buf.append((long) (System.currentTimeMillis() / (Math.random() * 100000)));
111         buf.append(" UNIQUE (");
112
113         Iterator JavaDoc it = columns.iterator();
114         DbAttribute first = (DbAttribute) it.next();
115         buf.append(first.getName());
116
117         while (it.hasNext()) {
118             DbAttribute next = (DbAttribute) it.next();
119             buf.append(", ");
120             buf.append(next.getName());
121         }
122
123         buf.append(")");
124
125         return buf.toString();
126     }
127
128     /**
129      * Adds an ADD CONSTRAINT clause to a relationship constraint.
130      *
131      * @see JdbcAdapter#createFkConstraint(DbRelationship)
132      */

133     public String JavaDoc createFkConstraint(DbRelationship rel) {
134         StringBuffer JavaDoc buf = new StringBuffer JavaDoc();
135         StringBuffer JavaDoc refBuf = new StringBuffer JavaDoc();
136
137         // hsqldb doesn't support schema namespaces
138
String JavaDoc srcName = ((DbEntity) rel.getSourceEntity()).getName();
139         String JavaDoc dstName = ((DbEntity) rel.getTargetEntity()).getName();
140
141         buf.append("ALTER TABLE ");
142         buf.append(srcName);
143
144         // hsqldb requires the ADD CONSTRAINT statement
145
buf.append(" ADD CONSTRAINT ");
146         buf.append("C_");
147         buf.append(srcName);
148         buf.append("_");
149         buf.append((long) (System.currentTimeMillis() / (Math.random() * 100000)));
150
151         buf.append(" FOREIGN KEY (");
152
153         Iterator JavaDoc jit = rel.getJoins().iterator();
154         boolean first = true;
155         while (jit.hasNext()) {
156             DbJoin join = (DbJoin) jit.next();
157             if (!first) {
158                 buf.append(", ");
159                 refBuf.append(", ");
160             }
161             else
162                 first = false;
163
164             buf.append(join.getSourceName());
165             refBuf.append(join.getTargetName());
166         }
167
168         buf.append(") REFERENCES ");
169         buf.append(dstName);
170         buf.append(" (");
171         buf.append(refBuf.toString());
172         buf.append(')');
173
174         // also make sure we delete dependent FKs
175
buf.append(" ON DELETE CASCADE");
176
177         return buf.toString();
178     }
179
180     /**
181      * Returns a SQL string to drop a table corresponding
182      * to <code>ent</code> DbEntity.
183      *
184      * @since 1.2
185      */

186     public String JavaDoc dropTable(DbEntity ent) {
187         // hsqldb doesn't support schema namespaces, so remove if found
188
return "DROP TABLE " + ent.getName();
189     }
190
191     /**
192      * Uses "CREATE CACHED TABLE" instead of "CREATE TABLE".
193      * Uses unqualified entity names.
194      *
195      * @since 1.2
196      */

197     public String JavaDoc createTable(DbEntity ent) {
198         String JavaDoc sql = super.createTable(ent);
199
200         if (sql != null && sql.toUpperCase().startsWith("CREATE TABLE ")) {
201             sql = "CREATE CACHED TABLE " + sql.substring("CREATE TABLE ".length());
202         }
203  
204         // hsqldb doesn't support schema namespaces, so remove if found
205
String JavaDoc fqnCreate = "CREATE CACHED TABLE " + ent.getFullyQualifiedName() + " (";
206         if (sql != null && sql.toUpperCase().startsWith(fqnCreate)) {
207             sql = "CREATE CACHED TABLE " + ent.getName() + " (" + sql.substring(fqnCreate.length());
208         }
209
210         return sql;
211     }
212 }
Popular Tags