Project

General

Profile

Download (20.9 KB) Statistics
| Branch: | Tag: | Revision:
1
/**
2
* Copyright (C) 2009 EDIT
3
* European Distributed Institute of Taxonomy
4
* http://www.e-taxonomy.eu
5
*
6
* The contents of this file are subject to the Mozilla Public License Version 1.1
7
* See LICENSE.TXT at the top of this package for the full license terms.
8
*/
9
package eu.etaxonomy.cdm.database.update;
10

    
11
import java.util.ArrayList;
12
import java.util.Arrays;
13
import java.util.List;
14

    
15
import org.apache.commons.lang.StringUtils;
16
import org.apache.log4j.Logger;
17

    
18
import eu.etaxonomy.cdm.common.CdmUtils;
19
import eu.etaxonomy.cdm.common.monitor.IProgressMonitor;
20
import eu.etaxonomy.cdm.database.DatabaseTypeEnum;
21
import eu.etaxonomy.cdm.database.ICdmDataSource;
22

    
23
/**
24
 * @author a.mueller
25
 * @since 16.09.2010
26
 *
27
 */
28
public class TableCreator extends AuditedSchemaUpdaterStepBase {
29
	private static final Logger logger = Logger.getLogger(TableCreator.class);
30

    
31
	private static final boolean IS_LIST = true;
32
	private static final boolean IS_1_TO_M = true;
33
	private static final boolean IS_M_TO_M = false;
34

    
35

    
36
	private final List<String> columnNames;
37
	private final List<String> columnTypes;
38
	private final List<Object> defaultValues;
39
	private final List<Boolean> isNotNull;
40
	private final List<String> referencedTables;
41
	private final boolean includeCdmBaseAttributes;
42
	private final boolean includeIdentifiableEntity;
43
	private final boolean includeAnnotatableEntity;
44
	private boolean includeEventBase;
45
	private final boolean excludeVersionableAttributes;
46
	protected List<ColumnAdder> columnAdders = new ArrayList<>();
47
	protected List<ISchemaUpdaterStep> mnTablesStepList = new ArrayList<>();
48
	private String primaryKeyParams;
49
	private String primaryKeyParams_AUD;
50
	private String uniqueParams;
51
	private String uniqueParams_AUD;
52

    
53

    
54
	public static final TableCreator NewInstance(String stepName, String tableName, List<String> columnNames, List<String> columnTypes, boolean includeAudTable, boolean includeCdmBaseAttributes){
55
		return new TableCreator(stepName, tableName, columnNames, columnTypes, null, null, null, includeAudTable, includeCdmBaseAttributes, false, false, false);
56
	}
57

    
58
	public static final TableCreator NewInstance(String stepName, String tableName, String[] columnNames, String[] columnTypes, String[] referencedTables, boolean includeAudTable, boolean includeCdmBaseAttributes){
59
		return new TableCreator(stepName, tableName, Arrays.asList(columnNames), Arrays.asList(columnTypes), null, null, Arrays.asList(referencedTables), includeAudTable, includeCdmBaseAttributes, false, false, false);
60
	}
61

    
62
	public static final TableCreator NewNonVersionableInstance(String stepName, String tableName, String[] columnNames, String[] columnTypes, String[] referencedTables){
63
		return new TableCreator(stepName, tableName, Arrays.asList(columnNames), Arrays.asList(columnTypes), null, null, Arrays.asList(referencedTables), false, true, false, false, true);
64
	}
65

    
66
	public static final TableCreator NewVersionableInstance(String stepName, String tableName, String[] columnNames, String[] columnTypes, String[] referencedTables, boolean includeAudTable){
67
		return new TableCreator(stepName, tableName, Arrays.asList(columnNames), Arrays.asList(columnTypes), null, null, Arrays.asList(referencedTables), includeAudTable, true, false, false, false);
68
	}
69

    
70
	public static final TableCreator NewAnnotatableInstance(String stepName, String tableName, String[] columnNames, String[] columnTypes, String[] referencedTables, boolean includeAudTable){
71
		return new TableCreator(stepName, tableName, Arrays.asList(columnNames), Arrays.asList(columnTypes), null, null, Arrays.asList(referencedTables), includeAudTable, true, true, false, false);
72
	}
73

    
74
	public static final TableCreator NewEventInstance(String stepName, String tableName, String[] columnNames, String[] columnTypes, String[] referencedTables, boolean includeAudTable){
75
		TableCreator result = new TableCreator(stepName, tableName, Arrays.asList(columnNames), Arrays.asList(columnTypes), null, null, Arrays.asList(referencedTables), includeAudTable, true, true, false, false);
76
		result.includeEventBase = true;
77
		return result;
78
	}
79

    
80
	public static final TableCreator NewIdentifiableInstance(String stepName, String tableName, String[] columnNames, String[] columnTypes, String[] referencedTables, boolean includeAudTable){
81
		return new TableCreator(stepName, tableName, Arrays.asList(columnNames), Arrays.asList(columnTypes), null, null, Arrays.asList(referencedTables), includeAudTable, true, true, true, false);
82
	}
83

    
84
	protected TableCreator(String stepName, String tableName, List<String> columnNames, List<String> columnTypes, List<Object> defaultValues, List<Boolean> isNotNull, List<String> referencedTables,
85
			boolean includeAudTable, boolean includeCdmBaseAttributes, boolean includeAnnotatableEntity, boolean includeIdentifiableEntity, boolean excludeVersionableAttributes) {
86
		super(stepName, tableName, includeAudTable);
87
		this.columnNames = columnNames;
88
		this.columnTypes = columnTypes;
89
		this.defaultValues = defaultValues;
90
		this.isNotNull = isNotNull;
91
		this.referencedTables = referencedTables;
92
		this.includeCdmBaseAttributes = includeCdmBaseAttributes;
93
		this.includeAnnotatableEntity = includeAnnotatableEntity;
94
		this.includeIdentifiableEntity = includeIdentifiableEntity;
95
		this.excludeVersionableAttributes = excludeVersionableAttributes;
96
		makeColumnAdders();
97
		makeMnTables(mnTablesStepList, this.tableName, this.includeAnnotatableEntity, this.includeIdentifiableEntity);
98
	}
99

    
100

    
101
	@Override
102
	public List<ISchemaUpdaterStep> getInnerSteps() {
103
		return mnTablesStepList;
104
	}
105

    
106
	/**
107
	 * Fills the {@link #columnAdders} list.
108
	 */
109
	private void makeColumnAdders() {
110
		if (columnNames.size() != columnTypes.size()){
111
			throw new RuntimeException ("ColumnNames and columnTypes must be of same size. Step: " + getStepName());
112
		}
113

    
114
		try {
115
			for (int i = 0; i < columnNames.size(); i++){
116
				boolean isNotNull = this.isNotNull == null ? false : this.isNotNull.get(i);
117
				if ("integer".equals(columnTypes.get(i)) || "int".equals(columnTypes.get(i))){
118
					String referencedTable = (this.referencedTables == null) ?  null : this.referencedTables.get(i);
119
					ColumnAdder adder = ColumnAdder.NewIntegerInstance(this.getStepName(), this.tableName, this.columnNames.get(i), includeAudTable, isNotNull, referencedTable);
120
					this.columnAdders.add(adder);
121
				}else if ("boolean".equals(columnTypes.get(i)) || "bit".equals(columnTypes.get(i))){
122
					String defaultValue = this.defaultValues == null ? null : this.defaultValues.get(i).toString();
123
					ColumnAdder adder = ColumnAdder.NewBooleanInstance(getStepName(), this.tableName,  this.columnNames.get(i), includeAudTable, Boolean.valueOf(defaultValue));
124
					this.columnAdders.add(adder);
125
				}else if (columnTypes.get(i).startsWith("string")){
126
					Integer length = Integer.valueOf(columnTypes.get(i).substring("string_".length()));
127
					ColumnAdder adder = ColumnAdder.NewStringInstance(this.getStepName(), this.tableName, this.columnNames.get(i), length, includeAudTable);
128
					this.columnAdders.add(adder);
129
				}else if (columnTypes.get(i).startsWith("clob")){
130
					ColumnAdder adder = ColumnAdder.NewClobInstance(this.getStepName(), this.tableName, this.columnNames.get(i), includeAudTable);
131
					this.columnAdders.add(adder);
132
				}else if ("tinyint".equals(columnTypes.get(i)) ){
133
					ColumnAdder adder = ColumnAdder.NewTinyIntegerInstance(this.getStepName(), this.tableName, this.columnNames.get(i), includeAudTable, isNotNull);
134
					this.columnAdders.add(adder);
135
				}else if ("datetime".equals(columnTypes.get(i)) ){
136
					ColumnAdder adder = ColumnAdder.NewDateTimeInstance(this.getStepName(), this.tableName, this.columnNames.get(i), includeAudTable, isNotNull);
137
					this.columnAdders.add(adder);
138
				}else if ("double".equals(columnTypes.get(i)) ){
139
					ColumnAdder adder = ColumnAdder.NewDoubleInstance(this.getStepName(), this.tableName, this.columnNames.get(i), includeAudTable, isNotNull);
140
					this.columnAdders.add(adder);
141
				}else{
142
					throw new RuntimeException("Column type " + columnTypes.get(i) + " not yet supported");
143
				}
144
			}
145
		} catch (Exception e) {
146
			throw new RuntimeException(e);
147
		}
148
	}
149

    
150
	/**
151
	 * fills the mnTablesStepList
152
	 * @param mnTablesStepList, String tableName
153
	 */
154
	public static void makeMnTables(List<ISchemaUpdaterStep> mnTablesStepList, String tableName, boolean includeAnnotatable, boolean includeIdentifiable) {
155
		TableCreator tableCreator;
156
		String stepName;
157

    
158
		if (includeAnnotatable){
159
			//annotations
160
			stepName= "Add @tableName annotations";
161
			stepName = stepName.replace("@tableName", tableName);
162
			tableCreator = MnTableCreator.NewMnInstance(stepName, tableName, "Annotation", SchemaUpdaterBase.INCLUDE_AUDIT, !IS_LIST, IS_1_TO_M);
163
			mnTablesStepList.add(tableCreator);
164

    
165
			//marker
166
			stepName= "Add @tableName marker";
167
			stepName = stepName.replace("@tableName", tableName);
168
			tableCreator = MnTableCreator.NewMnInstance(stepName, tableName, "Marker", SchemaUpdaterBase.INCLUDE_AUDIT, !IS_LIST, IS_1_TO_M);
169
			mnTablesStepList.add(tableCreator);
170
		}
171

    
172
		if (includeIdentifiable){
173

    
174
			//credits
175
			stepName= "Add @tableName credits";
176
			stepName = stepName.replace("@tableName", tableName);
177
			tableCreator = MnTableCreator.NewMnInstance(stepName, tableName, null, "Credit", null, null, SchemaUpdaterBase.INCLUDE_AUDIT, IS_LIST, IS_1_TO_M);
178
			mnTablesStepList.add(tableCreator);
179

    
180
			//identifier
181
			stepName= "Add @tableName identifiers";
182
			stepName = stepName.replace("@tableName", tableName);
183
			tableCreator = MnTableCreator.NewMnInstance(stepName, tableName, null, "Identifier", null, null, SchemaUpdaterBase.INCLUDE_AUDIT, IS_LIST, IS_1_TO_M);
184
			mnTablesStepList.add(tableCreator);
185

    
186
			//extensions
187
			stepName= "Add @tableName extensions";
188
			stepName = stepName.replace("@tableName", tableName);
189
			tableCreator = MnTableCreator.NewMnInstance(stepName, tableName, "Extension", SchemaUpdaterBase.INCLUDE_AUDIT, !IS_LIST, IS_1_TO_M);
190
			mnTablesStepList.add(tableCreator);
191

    
192
			//OriginalSourceBase
193
			stepName= "Add @tableName sources";
194
			stepName = stepName.replace("@tableName", tableName);
195
			tableCreator = MnTableCreator.NewMnInstance(stepName, tableName, null, "OriginalSourceBase", null, "sources", SchemaUpdaterBase.INCLUDE_AUDIT, ! IS_LIST, IS_1_TO_M);
196
			mnTablesStepList.add(tableCreator);
197

    
198
			//Rights
199
			stepName= "Add @tableName rights";
200
			stepName = stepName.replace("@tableName", tableName);
201
			tableCreator = MnTableCreator.NewMnInstance(stepName, tableName, null, "RightsInfo", null, "rights", SchemaUpdaterBase.INCLUDE_AUDIT, !IS_LIST, IS_M_TO_M);
202
            mnTablesStepList.add(tableCreator);
203
		}
204
	}
205

    
206

    
207
	@Override
208
	protected void invokeOnTable(String tableName, ICdmDataSource datasource,
209
	        IProgressMonitor monitor, CaseType caseType, SchemaUpdateResult result)  {
210
		try {
211
			//CREATE
212
			String updateQuery = "CREATE TABLE @tableName (";
213
			//AUDIT
214
			if (isAuditing){
215
				updateQuery += " REV integer not null, revtype " + ColumnAdder.getDatabaseColumnType(datasource, "tinyint") + ", ";
216
			}
217
			//CdmBase
218
			if (includeCdmBaseAttributes){
219
					String uuidNull = isAuditing? "": "NOT NULL";
220
			        updateQuery += " id integer NOT NULL,"
221
						+ " created " + ColumnAdder.getDatabaseColumnType(datasource, "datetime") + ", "
222
						+ " uuid varchar(36) "+uuidNull+","
223
						+ (excludeVersionableAttributes? "" : " updated " + ColumnAdder.getDatabaseColumnType(datasource, "datetime") + ", ")
224
						+ " createdby_id integer,"
225
						+ (excludeVersionableAttributes ? "" : " updatedby_id integer, ");
226
			}
227
			//EventBase
228
			if (this.includeEventBase){
229
				updateQuery += "timeperiod_start varchar(255), timeperiod_end varchar(255), timeperiod_freetext varchar(255), actor_id int, description varchar(255),";
230
			}
231
			//Identifiable
232
			if (this.includeIdentifiableEntity){
233
				updateQuery += "lsid_authority varchar(255), lsid_lsid varchar(255), lsid_namespace varchar(255), lsid_object varchar(255), lsid_revision varchar(255), protectedtitlecache bit not null, titleCache varchar(255),";
234
			}
235
			//specific columns
236
			updateQuery += 	getColumnsSql(tableName, datasource, monitor);
237

    
238
			//primary and unique keys
239
			String primaryKeySql = primaryKey(isAuditing)==null ? "" : "primary key (" + primaryKey(isAuditing) + "),";
240
			String uniqueSql = unique(isAuditing)== null ? "" : "unique(" + unique(isAuditing) + "),";
241
			updateQuery += primaryKeySql + uniqueSql;
242

    
243
			//finalize
244
			updateQuery = StringUtils.chomp(updateQuery.trim(), ",") + ")";
245

    
246
			//replace
247
			updateQuery = updateQuery.replace("@tableName", tableName);
248

    
249
			//append datasource specific string
250
			updateQuery += datasource.getDatabaseType().getHibernateDialect().getTableTypeString();
251
			logger.debug("UPDATE Query: " + updateQuery);
252

    
253
			//execute
254
			datasource.executeUpdate(updateQuery);
255

    
256
			//Foreign Keys
257
			createForeignKeys(tableName, isAuditing, datasource, monitor, caseType, result);
258

    
259
			return;
260
		} catch (Exception e) {
261
			monitor.warning(e.getMessage(), e);
262
			logger.error(e);
263
			result.addException(e, e.getMessage(), "TableCreator.invokeOnTable");
264
			return;
265
		}
266
	}
267

    
268

    
269
	/**
270
	 * Returns the sql part for the {@link #columnAdders} columns.
271
	 * This is done by reusing the same method in the ColumnAdder class and removing all the prefixes like 'ADD COLUMN'
272
	 */
273
	private String getColumnsSql(String tableName, ICdmDataSource datasource, IProgressMonitor monitor) throws DatabaseTypeNotSupportedException {
274
		String result = "";
275
		for (ColumnAdder adder : this.columnAdders){
276
			String singleAdderSQL = adder.getUpdateQueryString(tableName, datasource, monitor) + ", ";
277

    
278
			String[] split = singleAdderSQL.split(ColumnAdder.getAddColumnSeperator(datasource));
279
			result += split[1];
280
		}
281
		return result;
282
	}
283

    
284

    
285
	private void createForeignKeys(String tableName, boolean isAudit, ICdmDataSource datasource,
286
	        IProgressMonitor monitor, CaseType caseType, SchemaUpdateResult result) {
287
		if (includeCdmBaseAttributes){
288
			//updatedBy
289
		    if (! this.excludeVersionableAttributes){
290
				String attribute = "updatedby";
291
				String referencedTable = "UserAccount";
292
				makeForeignKey(tableName, datasource, monitor, attribute,
293
				        referencedTable, caseType, result);
294
			}
295

    
296
		    //createdBy
297
			String attribute = "createdby";
298
			String referencedTable = "UserAccount";
299
			makeForeignKey(tableName, datasource, monitor, attribute,
300
			        referencedTable, caseType, result);
301

    
302
		}
303
		if (isAudit){
304
		    //REV
305
			String attribute = "REV";
306
			String referencedTable = "AuditEvent";
307
			makeForeignKey(tableName, datasource, monitor, attribute,
308
			        referencedTable, caseType, result);
309
		}
310
		if (this.includeEventBase){
311
			//actor
312
		    String attribute = "actor_id";
313
			String referencedTable = "AgentBase";
314
			makeForeignKey(tableName, datasource, monitor, attribute,
315
			        referencedTable, caseType, result);
316
		}
317
		for (ColumnAdder adder : this.columnAdders){
318
			if (adder.getReferencedTable() != null){
319
				makeForeignKey(tableName, datasource, monitor, adder.getNewColumnName(),
320
				        adder.getReferencedTable(), caseType, result);
321
			}
322
		}
323
		return;
324
	}
325

    
326

    
327
    public static void makeForeignKey(String tableName, ICdmDataSource datasource,
328
            IProgressMonitor monitor, String attribute, String referencedTable, CaseType caseType,
329
            SchemaUpdateResult result) {
330

    
331
		referencedTable = caseType.transformTo(referencedTable);
332

    
333
        String idSuffix = "_id";
334
        if (isRevAttribute(attribute) || attribute.endsWith(idSuffix)){
335
            idSuffix = "";
336
        }
337
        String columnName =  attribute + idSuffix;
338

    
339
		if (supportsForeignKeys(datasource, monitor, tableName, referencedTable)){
340
			String index = "FK@tableName_@attribute";
341
			index = index.replace("@tableName", tableName);
342
			index = index.replace("@attribute", attribute);
343

    
344

    
345
			//OLD - don't remember why we used ADD INDEX here
346
//			String updateQuery = "ALTER TABLE @tableName ADD INDEX @index (@attribute), ADD FOREIGN KEY (@attribute) REFERENCES @referencedTable (@id)";
347
			String updateQuery = "ALTER TABLE @tableName ADD @constraintName FOREIGN KEY (@attribute) REFERENCES @referencedTable (@id)";
348
			updateQuery = updateQuery.replace("@tableName", tableName);
349
//			updateQuery = updateQuery.replace("@index", index);
350
			updateQuery = updateQuery.replace("@attribute", columnName);
351
			updateQuery = updateQuery.replace("@referencedTable", referencedTable);
352
			if (datasource.getDatabaseType().equals(DatabaseTypeEnum.MySQL)){
353
				updateQuery = updateQuery.replace("@constraintName", "CONSTRAINT " + index);
354
			}else{
355
				updateQuery = updateQuery.replace("@constraintName", "");  //H2 does not support "CONSTRAINT", didn't check for others
356
			}
357

    
358
			if (isRevAttribute(attribute)){
359
				updateQuery = updateQuery.replace("@id", "revisionnumber");
360
			}else{
361
				updateQuery = updateQuery.replace("@id", "id");
362
			}
363
			logger.debug(updateQuery);
364
			try {
365
				datasource.executeUpdate(updateQuery);
366
			} catch (Exception e) {
367
				String message = "Problem when creating Foreign Key for " + tableName +"." + attribute +": " + e.getMessage();
368
				monitor.warning(message);
369
				logger.warn(message, e);
370
				result.addWarning(message);
371
				return;   //we do not interrupt update if only foreign key generation did not work
372
			}
373
			return;
374
		}else{
375
		    //create only index
376
			IndexAdder indexAdder = IndexAdder.NewIntegerInstance("Add index instead of Foreign Key", tableName, columnName);
377
			try {
378
                indexAdder.invoke(datasource, monitor, caseType, result);
379
            } catch (Exception e) {
380
                String message = "Problem when creating index instead of Foreign Key for " + tableName +"." + columnName +": " + e.getMessage();
381
                monitor.warning(message);
382
                logger.warn(message, e);
383
                result.addWarning(message);
384
                return;   //we do not interrupt update if only index generation did not work
385
            }
386
		    return;
387
		}
388
	}
389

    
390
	/**
391
	 * Determines if the tables and the database support foreign keys. If determination is not possible true is returned as default.
392
	 * @param datasource
393
	 * @param monitor
394
	 * @param tableName
395
	 * @param referencedTable
396
	 * @return
397
	 */
398
	private static boolean supportsForeignKeys(ICdmDataSource datasource, IProgressMonitor monitor, String tableName, String referencedTable) {
399
		boolean result = true;
400
		if (! datasource.getDatabaseType().equals(DatabaseTypeEnum.MySQL)){
401
			return true;
402
		}else{
403
			try {
404
				String myIsamTables = "";
405
				String format = "SELECT ENGINE FROM information_schema.TABLES where TABLE_SCHEMA = '%s' AND TABLE_NAME = '%s'";
406
				String sql = String.format(format, datasource.getDatabase(), tableName);
407
				String engine = (String)datasource.getSingleValue(sql);
408
				if (engine.equals("MyISAM")){
409
					result = false;
410
					myIsamTables = CdmUtils.concat(",", myIsamTables, tableName);
411
				}
412
				sql = String.format(format,  datasource.getDatabase(), referencedTable);
413
				engine = (String)datasource.getSingleValue(sql);
414
				if (engine.equals("MyISAM")){
415
					result = false;
416
					myIsamTables = CdmUtils.concat(",", myIsamTables, referencedTable);
417
				}
418
				if (result == false){
419
					String message = "Tables (%s) use MyISAM engine. MyISAM does not support foreign keys.";
420
					message = String.format(message, myIsamTables);
421
					monitor.warning(message);
422
				}
423
				return result;
424
			} catch (Exception e) {
425
				String message = "Problems to determine table engine for MySQL.";
426
				monitor.warning(message);
427
				return true;  //default
428
			}
429
		}
430
	}
431

    
432
	private static boolean isRevAttribute(String attribute) {
433
		return "REV".equalsIgnoreCase(attribute);
434
	}
435

    
436

    
437
	/**
438
	 * Constructs the primary key creation string
439
	 * @param isAudit
440
	 * @return
441
	 */
442
	protected String primaryKey(boolean isAudit){
443
		String result = null;
444
		if (! isAudit && this.primaryKeyParams != null){
445
			return this.primaryKeyParams;
446
		}else if (isAudit && this.primaryKeyParams_AUD != null){
447
			return this.primaryKeyParams_AUD;
448
		}
449

    
450
		if (includeCdmBaseAttributes || ! includeCdmBaseAttributes){ //TODO how to handle not CDMBase includes
451
			if (! isAudit){
452
				result = "id";
453
			}else{
454
				result = "id, REV";
455
			}
456
		}
457
		return result;
458
	}
459

    
460
	/**
461
	 * Constructs the unique key creation string
462
	 * @param isAudit
463
	 * @return
464
	 */
465
	protected String unique(boolean isAudit){
466
		if (! isAudit){
467
			if (this.uniqueParams != null){
468
				return this.uniqueParams;
469
			}
470
			if (includeCdmBaseAttributes){
471
				return "uuid"; //TODO how to handle not CDMBase includes
472
			}
473
			return null;
474
		}else{
475
			if (this.uniqueParams_AUD != null){
476
				return this.uniqueParams_AUD;
477
			}
478
			return null;
479
		}
480
	}
481

    
482
	public void setPrimaryKeyParams(String primaryKeyParams, String primaryKeyParams_AUD) {
483
		this.primaryKeyParams = primaryKeyParams;
484
		this.primaryKeyParams_AUD = primaryKeyParams_AUD;
485
	}
486

    
487
	public void setUniqueParams(String uniqueParams, String uniqueParams_AUD) {
488
		this.uniqueParams = uniqueParams;
489
		this.uniqueParams_AUD = uniqueParams_AUD;
490
	}
491
}
(27-27/36)