| /******************************************************************************* |
| * Copyright (c) 2007, 2015 Oracle. All rights reserved. |
| * This program and the accompanying materials are made available under the |
| * terms of the Eclipse Public License 2.0, which accompanies this distribution |
| * and is available at https://www.eclipse.org/legal/epl-2.0/. |
| * |
| * Contributors: |
| * Oracle - initial API and implementation |
| ******************************************************************************/ |
| package org.eclipse.jpt.jpa.core.internal.context.java; |
| |
| import java.util.List; |
| import org.eclipse.core.runtime.IProgressMonitor; |
| import org.eclipse.jpt.common.core.resource.java.Annotation; |
| import org.eclipse.jpt.common.core.resource.java.JavaResourceAttribute; |
| import org.eclipse.jpt.common.utility.Association; |
| import org.eclipse.jpt.common.utility.internal.ArrayTools; |
| import org.eclipse.jpt.common.utility.internal.SimpleAssociation; |
| import org.eclipse.jpt.common.utility.internal.iterable.IterableTools; |
| import org.eclipse.jpt.jpa.core.JpaFactory; |
| import org.eclipse.jpt.jpa.core.MappingKeys; |
| import org.eclipse.jpt.jpa.core.context.Converter; |
| import org.eclipse.jpt.jpa.core.context.BaseColumn; |
| import org.eclipse.jpt.jpa.core.context.JpaContextModel; |
| import org.eclipse.jpt.jpa.core.context.NamedColumn; |
| import org.eclipse.jpt.jpa.core.context.java.JavaBaseTemporalConverter; |
| import org.eclipse.jpt.jpa.core.context.java.JavaSpecifiedColumn; |
| import org.eclipse.jpt.jpa.core.context.java.JavaConverter; |
| import org.eclipse.jpt.jpa.core.context.java.JavaSpecifiedPersistentAttribute; |
| import org.eclipse.jpt.jpa.core.context.java.JavaVersionMapping; |
| import org.eclipse.jpt.jpa.core.internal.context.JpaValidator; |
| import org.eclipse.jpt.jpa.core.internal.jpa1.context.EntityTableDescriptionProvider; |
| import org.eclipse.jpt.jpa.core.internal.jpa1.context.NamedColumnValidator; |
| import org.eclipse.jpt.jpa.core.internal.jpa1.context.java.NullJavaConverter; |
| import org.eclipse.jpt.jpa.core.resource.java.ColumnAnnotation; |
| import org.eclipse.jpt.jpa.core.resource.java.VersionAnnotation; |
| import org.eclipse.jpt.jpa.core.validation.JptJpaCoreValidationMessages; |
| import org.eclipse.wst.validation.internal.provisional.core.IMessage; |
| import org.eclipse.wst.validation.internal.provisional.core.IReporter; |
| |
| /** |
| * Java version mapping |
| */ |
| public abstract class AbstractJavaVersionMapping |
| extends AbstractJavaAttributeMapping<VersionAnnotation> |
| implements JavaVersionMapping |
| { |
| protected final JavaSpecifiedColumn column; |
| |
| protected JavaConverter converter; // never null |
| |
| |
| // the spec does not list Temporal explicitly, |
| // but it is included in the orm.xml schema... |
| protected static final JavaConverter.Adapter[] CONVERTER_ADAPTER_ARRAY = new JavaConverter.Adapter[] { |
| JavaBaseTemporalConverter.BasicAdapter.instance(), |
| }; |
| protected static final Iterable<JavaConverter.Adapter> CONVERTER_ADAPTERS = IterableTools.iterable(CONVERTER_ADAPTER_ARRAY); |
| |
| |
| protected AbstractJavaVersionMapping(JavaSpecifiedPersistentAttribute parent) { |
| super(parent); |
| this.column = this.buildColumn(); |
| this.converter = this.buildConverter(); |
| } |
| |
| |
| // ********** synchronize/update ********** |
| |
| @Override |
| public void synchronizeWithResourceModel(IProgressMonitor monitor) { |
| super.synchronizeWithResourceModel(monitor); |
| this.column.synchronizeWithResourceModel(monitor); |
| this.syncConverter(monitor); |
| } |
| |
| @Override |
| public void update(IProgressMonitor monitor) { |
| super.update(monitor); |
| this.column.update(monitor); |
| this.converter.update(monitor); |
| } |
| |
| |
| // ********** column ********** |
| |
| public JavaSpecifiedColumn getColumn() { |
| return this.column; |
| } |
| |
| protected JavaSpecifiedColumn buildColumn() { |
| return this.getJpaFactory().buildJavaColumn(this); |
| } |
| |
| |
| // ********** converter ********** |
| |
| public JavaConverter getConverter() { |
| return this.converter; |
| } |
| |
| public void setConverter(Class<? extends Converter> converterType) { |
| if (this.converter.getConverterType() != converterType) { |
| JavaConverter.Adapter converterAdapter = this.getConverterAdapter(converterType); |
| this.retainConverterAnnotation(converterAdapter); |
| this.setConverter_(this.buildConverter(converterAdapter)); |
| } |
| } |
| |
| protected JavaConverter buildConverter(JavaConverter.Adapter converterAdapter) { |
| return (converterAdapter != null) ? |
| converterAdapter.buildNewConverter(this, this.getJpaFactory()) : |
| this.buildNullConverter(); |
| } |
| |
| protected void setConverter_(JavaConverter converter) { |
| Converter old = this.converter; |
| this.converter = converter; |
| this.firePropertyChanged(CONVERTER_PROPERTY, old, converter); |
| } |
| |
| /** |
| * Clear all the converter annotations <em>except</em> for the annotation |
| * corresponding to the specified adapter. If the specified adapter is |
| * <code>null</code>, remove <em>all</em> the converter annotations. |
| */ |
| protected void retainConverterAnnotation(JavaConverter.Adapter converterAdapter) { |
| JavaResourceAttribute resourceAttribute = this.getResourceAttribute(); |
| for (JavaConverter.Adapter adapter : this.getConverterAdapters()) { |
| if (adapter != converterAdapter) { |
| adapter.removeConverterAnnotation(resourceAttribute); |
| } |
| } |
| } |
| |
| protected JavaConverter buildConverter() { |
| JpaFactory jpaFactory = this.getJpaFactory(); |
| for (JavaConverter.Adapter adapter : this.getConverterAdapters()) { |
| JavaConverter javaConverter = adapter.buildConverter(this, jpaFactory); |
| if (javaConverter != null) { |
| return javaConverter; |
| } |
| } |
| return this.buildNullConverter(); |
| } |
| |
| protected void syncConverter(IProgressMonitor monitor) { |
| Association<JavaConverter.Adapter, Annotation> assoc = this.getConverterAnnotation(); |
| if (assoc == null) { |
| if (this.converter.getConverterType() != null) { |
| this.setConverter_(this.buildNullConverter()); |
| } |
| } else { |
| JavaConverter.Adapter adapter = assoc.getKey(); |
| Annotation annotation = assoc.getValue(); |
| if ((this.converter.getConverterType() == adapter.getConverterType()) && |
| (this.converter.getConverterAnnotation() == annotation)) { |
| this.converter.synchronizeWithResourceModel(monitor); |
| } else { |
| this.setConverter_(adapter.buildConverter(annotation, this, this.getJpaFactory())); |
| } |
| } |
| } |
| |
| /** |
| * Return the first converter annotation we find along with its corresponding |
| * adapter. Return <code>null</code> if there are no converter annotations. |
| */ |
| protected Association<JavaConverter.Adapter, Annotation> getConverterAnnotation() { |
| JavaResourceAttribute resourceAttribute = this.getResourceAttribute(); |
| for (JavaConverter.Adapter adapter : this.getConverterAdapters()) { |
| Annotation annotation = adapter.getConverterAnnotation(resourceAttribute); |
| if (annotation != null) { |
| return new SimpleAssociation<JavaConverter.Adapter, Annotation>(adapter, annotation); |
| } |
| } |
| return null; |
| } |
| |
| protected JavaConverter buildNullConverter() { |
| return new NullJavaConverter(this); |
| } |
| |
| |
| // ********** converter adapters ********** |
| |
| /** |
| * Return the converter adapter for the specified converter type. |
| */ |
| protected JavaConverter.Adapter getConverterAdapter(Class<? extends Converter> converterType) { |
| for (JavaConverter.Adapter adapter : this.getConverterAdapters()) { |
| if (adapter.getConverterType() == converterType) { |
| return adapter; |
| } |
| } |
| return null; |
| } |
| |
| protected Iterable<JavaConverter.Adapter> getConverterAdapters() { |
| return CONVERTER_ADAPTERS; |
| } |
| |
| |
| // ********** misc ********** |
| |
| public String getKey() { |
| return MappingKeys.VERSION_ATTRIBUTE_MAPPING_KEY; |
| } |
| |
| @Override |
| protected String getAnnotationName() { |
| return VersionAnnotation.ANNOTATION_NAME; |
| } |
| |
| @Override |
| public boolean isOverridableAttributeMapping() { |
| return true; |
| } |
| |
| |
| // ********** column parent adapter ********** |
| |
| public JpaContextModel getColumnParent() { |
| return this; // no adapter |
| } |
| |
| public ColumnAnnotation getColumnAnnotation() { |
| return (ColumnAnnotation) this.getResourceAttribute().getNonNullAnnotation(ColumnAnnotation.ANNOTATION_NAME); |
| } |
| |
| public void removeColumnAnnotation() { |
| this.getResourceAttribute().removeAnnotation(ColumnAnnotation.ANNOTATION_NAME); |
| } |
| |
| public String getDefaultColumnName(NamedColumn col) { |
| return this.getName(); |
| } |
| |
| public String getDefaultTableName() { |
| return this.getTypeMapping().getPrimaryTableName(); |
| } |
| |
| public boolean tableNameIsInvalid(String tableName) { |
| return this.getTypeMapping().tableNameIsInvalid(tableName); |
| } |
| |
| public Iterable<String> getCandidateTableNames() { |
| return this.getTypeMapping().getAllAssociatedTableNames(); |
| } |
| |
| public JpaValidator buildColumnValidator(NamedColumn col) { |
| return new NamedColumnValidator(this.getPersistentAttribute(), (BaseColumn) col, new EntityTableDescriptionProvider()); |
| } |
| |
| |
| // ********** Java completion proposals ********** |
| |
| @Override |
| public Iterable<String> getCompletionProposals(int pos) { |
| Iterable<String> result = super.getCompletionProposals(pos); |
| if (result != null) { |
| return result; |
| } |
| result = this.column.getCompletionProposals(pos); |
| if (result != null) { |
| return result; |
| } |
| result = this.converter.getCompletionProposals(pos); |
| if (result != null) { |
| return result; |
| } |
| return null; |
| } |
| |
| // ********** validation ********** |
| |
| @Override |
| public void validate(List<IMessage> messages, IReporter reporter) { |
| super.validate(messages, reporter); |
| this.column.validate(messages, reporter); |
| this.converter.validate(messages, reporter); |
| this.validateAttributeType(messages); |
| } |
| |
| protected void validateAttributeType(List<IMessage> messages) { |
| if (!ArrayTools.contains(SUPPORTED_TYPE_NAMES, this.getPersistentAttribute().getTypeName())) { |
| if (this.getPersistentAttribute().isVirtual()) { |
| messages.add( |
| this.buildValidationMessage( |
| this.getVirtualPersistentAttributeTextRange(), |
| JptJpaCoreValidationMessages.PERSISTENT_ATTRIBUTE_INVALID_VERSION_MAPPING_TYPE, //TODO KFB - different message for virtual attribute |
| this.getName() |
| ) |
| ); |
| } |
| else { |
| messages.add( |
| this.buildValidationMessage( |
| this.getValidationTextRange(), |
| JptJpaCoreValidationMessages.PERSISTENT_ATTRIBUTE_INVALID_VERSION_MAPPING_TYPE, |
| this.getName() |
| ) |
| ); |
| } |
| } |
| } |
| } |