}

	// END Protected Constructors

	// END Constructors

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.general.IOneToOneRelation#getSourceEntity()
	 */
	@Override
	public IEntity getSourceEntity() {
		return this.getSourceEntities().iterator().next();
	}

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.general.IOneToOneRelation
	 *      #setSourceEntity(pl.edu.agh.cast.data.model.general.IEntity)
	 */
	@Override
	public void setSourceEntity(IEntity entity) {
		setSourceEntities(Collections.singletonList(entity));
	}

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.general.IOneToOneRelation#getTargetEntity()
	 */
	@Override
	public IEntity getTargetEntity() {
		return this.getTargetEntities().iterator().next();
	}

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.general.IOneToOneRelation
	 *      #setTargetEntity(pl.edu.agh.cast.data.model.general.IEntity)
	 */
	@Override
	public void setTargetEntity(IEntity entity) {
		setTargetEntities(Collections.singletonList(entity));
	}

	// BEGIN Replication Methods

	/**
	 * {@inheritDoc}
	 *
	 * <p>
	 * Replicates relation direction, the lists of source and target entities are empty.
	 *
	 * @see ManyToManyRelation#replicateTo(java.lang.Object)
	 */
	@Override
	public TimedOneToOneRelation replicateTo(Object replica) throws IllegalArgumentException, ReplicationException {

	public TransientProperty(MetaTransientProperty metaProperty, Object element) {
		super(metaProperty);
		if (element == null) {
			throw new IllegalArgumentException("Element cannot be null"); //$NON-NLS-1$
		}
		this.element = element;
	}

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.property.Property#getValue()
	 */
	@Override
	public Object getValue() {
		try {
			return this.getMetaProperty().getGetter().invoke(this.element);
		} catch (Exception e) {
			throw new PropertyException("Failed to access property value", e); //$NON-NLS-1$
		}
	}

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.property.Property#setValue(java.lang.Object)
	 */
	@Override
	public void setValue(Object value) {

	}

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.property.Property#setValue(java.lang.Object)
	 */
	@Override
	public void setValue(Object value) {
		if (!this.getMetaProperty().isWritable()) {
			throw new PropertyException("The property is not writable"); //$NON-NLS-1$
		}
		if (!this.isValidValue(value)) {
			throw new PropertyException(String.format("Invalid value for property of type '%1$s': %2$s", //$NON-NLS-1$
			        this.getMetaProperty().getType(), (value != null) ? value.getClass() : null));
		}

		return String[].class;
	}

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.model.attributes.validation.AttributeValidator#convertToStringFormat(java.lang.Object)
	 */
	@SuppressWarnings("nls")
	public String convertToStringFormat(Object value) {
		if (value == null) {
			return null;
		}

		if (!isValidClass(value)) {
			throw new IllegalArgumentException("Wrong value type tried to be converted. Actual value type: "
			        + value.getClass() + ". Expected value type: " + getTypeClass());
		}

		StringBuilder result = new StringBuilder();

				PropertySetter annotation = entry.getValue().get(0);
				String name = annotation.name().trim();

				MetaPermanentPropertyDescription prop = properties.get(name);
				if (prop == null) {
					prop = new MetaPermanentPropertyDescription(name);
					properties.put(name, prop);
				}
				if (prop.setter != null) {

		super(name, type, false, matchable);
		if (getter == null) {
			throw new IllegalArgumentException("Getter method cannot be null"); //$NON-NLS-1$
		}

		if (!PropertyHelper.verifyGetterSignature(getter, type.getValidator().getTypeClass())) {
			throw new IllegalArgumentException(String.format(
			        "Getter method has invalid signature for value type '%1$s': %2$s", type, getter)); //$NON-NLS-1$
		}

	}

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.model.attributes.validation.AttributeValidator#convertToStringFormat(java.lang.Object)
	 */
	@SuppressWarnings("nls")
	public String convertToStringFormat(Object value) {
		if (value == null) {
			return null;
		}

		if (!isValidClass(value)) {
			throw new IllegalArgumentException("Wrong value type tried to be converted. Actual value type: "
			        + value.getClass() + ". Expected value type: " + getTypeClass());
		}

			getVisualElement().removePropertyChangeListener(listener);
		}
	}

	/**
	 * Fires the property change event.
	 *
	 * @param property
	 *            the name of the property
	 * @param oldValue
	 *            the old value of the property
	 * @param newValue
	 *            the new value of the property
	 *
	 * @see pl.edu.agh.cast.data.model.property.PropertyChangeProviderHelper#firePropertyChange(java.lang.String,
	 *      java.lang.Object, java.lang.Object)
	 */
	protected final void firePropertyChange(String property, Object oldValue, Object newValue) {
		pcpHelper.firePropertyChange(property, oldValue, newValue);
	}

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.presentation.IPresentationDataSet#setSuppressAllEvents(boolean)
	 */
	@Override
	public void setSuppressAllEvents(boolean flag) {
		pcpHelper.setSuppressAllEvents(flag);
	}

	public final <E extends T> Collection<E> removeElements(E... elements) {
		List<E> removedElements = new LinkedList<E>();
		for (E element : elements) {
			if (getElement(element.getId()) != null) {
				removedElements.add(removeElement(element));
			}
		}
		// TODO [kpietak] add here template method <code>afterRemoveElements</code>
		return removedElements;
	}

	private SupportedTimeFormat(String format) {
		this.sdp = new SimpleDateFormat(format);
		this.sdp.setLenient(false);
	}

	/**
	 * Parsed given text according to all supported formats. The first matching format is chosen, however the formats
	 * order is not defined.
	 *
	 * @param text
	 *            text to parse.
	 * @return parsed date object or null if text is null
	 * @throws ParseException
	 *             if text does not match to any format. exception generated by the last format is thrown
	 */
	public static Date parse(String text) throws ParseException {
		if (text == null) {
			return null;
		}
		ParseException ex = null;

		for (SupportedTimeFormat format : SupportedTimeFormat.values()) {

	}

	/**
	 * Fires the property change event.
	 *
	 * @param property
	 *            the name of the property
	 * @param oldValue
	 *            the old value of the property
	 * @param newValue
	 *            the new value of the property
	 *
	 * @see pl.edu.agh.cast.data.model.property.PropertyChangeProviderHelper#firePropertyChange(java.lang.String,
	 *      java.lang.Object, java.lang.Object)
	 */
	protected final void firePropertyChange(String property, Object oldValue, Object newValue) {
		pcpHelper.firePropertyChange(property, oldValue, newValue);
	}

	/**
	 *
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.visual.IVisualDataSet#setSuppressAllEvents(boolean)
	 */
	@Override
	public void setSuppressAllEvents(boolean flag) {
		pcpHelper.setSuppressAllEvents(flag);

	}

		        entity4), false);

		cal.set(2009, 1, 2, 12, 0);
		dateStart = cal.getTime();
		cal.set(2009, 1, 2, 13, 30);
		dateEnd = cal.getTime();

	public final void removePropertyChangeListener(PropertyChangeListener l) {
		pcpHelper.removePropertyChangeListener(l);
	}

	/**
	 * Fires the property change event.
	 *
	 * @param property
	 *            the name of the property
	 * @param oldValue
	 *            the old value of the property
	 * @param newValue
	 *            the new value of the property
	 *
	 * @see pl.edu.agh.cast.data.model.property.PropertyChangeProviderHelper#firePropertyChange(java.lang.String,
	 *      java.lang.Object, java.lang.Object)
	 */
	protected final void firePropertyChange(String property, Object oldValue, Object newValue) {
		pcpHelper.firePropertyChange(property, oldValue, newValue);
	}

	// END Property Change Support

	// BEGIN Replication Methods

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.AbstractElement#replicateTo(java.lang.Object)
	 */
	@SuppressWarnings("unchecked")

	public TimedManyToManyRelation(UUID id, IGeneralDataSet<? extends IGeneralElement> dataSet,
	        List<? extends IEntity> sources, List<? extends IEntity> targets, boolean directed, Date startDate,
	        Date endDate) {
		this(ITimedManyToManyRelation.TYPE, id, sources, targets, directed, startDate, endDate);

		for (SupportedTimeFormat format : SupportedTimeFormat.values()) {
			try {
				return format.sdp.parse(text);
			} catch (ParseException e) {
				ex = e;
			}
		}
		// here, ex is never null
		throw ex;
	}

	/**
	 * Formats time using the default format: HH:mm:ss.
	 *
	 * @param time
	 *            time to format
	 * @return formated time as string
	 */
	public static String formatDefault(Date time) {

		if (element.getType().isSubtypeOf(IManyToManyRelation.TYPE)) {
			IManyToManyRelation relation = (IManyToManyRelation)element;

			for (IEntity source : relation.getSourceEntities()) {
				source.removeOutgoingRelation(relation);

		return type;
	}

	/**
	 * Sets the type of the data set. This method may be called only once, if the type is not set yet.
	 *
	 * @param type
	 *            the data set type
	 *
	 * @throws ModelException
	 *             if the type is already set
	 * @throws IllegalArgumentException
	 *             if the given type is <code>null</code> or is not a type of data set
	 */
	public final void setType(Type type) {
		if (this.type != null && !this.type.equals(type)) {
			throw new ModelException("Type cannot be modified");
		}

		return id;
	}

	/**
	 * Sets the ID of the data set. The ID cannot be changed.
	 *
	 * @param id
	 *            the data set ID
	 *
	 * @throws ModelException
	 *             if the ID is already set and it is not equal to given one
	 * @throws IllegalArgumentException
	 *             if the given ID is <code>null</code>
	 */
	public final void setId(UUID id) {
		if (this.id != null && !this.id.equals(id)) {
			throw new ModelException("ID cannot be modified");
		}

		        TransientProperty.class).getMap().entrySet()) {

			Method method = entry.getKey();

			if (entry.getValue().size() == 1) {

	public ManyToManyRelation(UUID id, IGeneralDataSet<? extends IGeneralElement> dataSet,
	        List<? extends IEntity> sources, List<? extends IEntity> targets, boolean directed) {
		this(IManyToManyRelation.TYPE, id, dataSet, sources, targets, directed);

	}

	/**
	 * Returns the hash code of the element.
	 *
	 * <p>
	 * This method will throw {@link NullPointerException} if the ID is not set.
	 *
	 * <p>
	 * {@inheritDoc}
	 *
	 * @see #getId()
	 * @see java.lang.Object#hashCode()
	 */
	@Override
	public final int hashCode() {
		return getId().hashCode();
	}

	/**
	 * {@inheritDoc}
	 *
	 * @see java.lang.Object#toString()
	 */
	@Override
	public final String toString() {
		return String.format("E [%1$s] %2$s (%3$s)", getType(), getId(), getDescString()); //$NON-NLS-1$

	public static Type fromClass(Class<? extends Identifiable> klass) {
		Type type = typeCache.get(klass.getName());
		if (type == null) {
			type = instantiateType(klass);

	protected ManyToManyRelation(Type type, UUID id, IGeneralDataSet<? extends IGeneralElement> dataSet,
	        List<? extends IEntity> sources, List<? extends IEntity> targets, boolean directed) {

		if (type == null) {
			throw new IllegalArgumentException("Type cannot be null");
		}
		if (!type.isSubtypeOf(IDataSet.TYPE)) {
			throw new IllegalArgumentException("The type must be a subtype of IDataSet");

public abstract class VisualDataSet<T extends IVisualElement<? extends IPresentationElement<? extends IElement>>, M extends IPresentationDataSet<? extends IPresentationElement<? extends IElement>>>
        extends AbstractDataSet<T> implements IVisualDataSet<T, M> {

	public TimedManyToManyRelation(UUID id, IGeneralDataSet<? extends IGeneralElement> dataSet,
	        List<? extends IEntity> sources, List<? extends IEntity> targets, boolean directed, Date startDate,

	public <T extends IDataSet<? extends IElement>> T convert(
	        MultiMap<ConverterInputEntry, ? extends IDataSet<? extends IElement>> dataSets) throws ConverterException;

	public ManyToManyRelation(UUID id, IGeneralDataSet<? extends IGeneralElement> dataSet,
	        List<? extends IEntity> sources, List<? extends IEntity> targets, boolean directed) {
		this(IManyToManyRelation.TYPE, id, dataSet, sources, targets, directed);

	public <T extends IDataSet<? extends IElement>> T convert(List<? extends IDataSet<? extends IElement>> dataSets)
	        throws ConverterException;

		if (inputArray.length > 0) {
			result.delete(result.length() - 2, result.length());
		}
		return result.toString();
	}

	}

	/**
	 * Fires the property change event.
	 *
	 * @param property
	 *            the name of the property
	 * @param oldValue
	 *            the old value of the property
	 * @param newValue
	 *            the new value of the property
	 *
	 * @see pl.edu.agh.cast.data.model.property.PropertyChangeProviderHelper#firePropertyChange(java.lang.String,
	 *      java.lang.Object, java.lang.Object)
	 */
	protected final void firePropertyChange(String property, Object oldValue, Object newValue) {
		pcpHelper.firePropertyChange(property, oldValue, newValue);
	}

	// END Property Change Support

	// BEGIN Replication Methods

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.AbstractElement#replicateTo(java.lang.Object)
	 */
	@SuppressWarnings("unchecked")

			getVisualElement().addPropertyChangeListener(listener);
		}
	}

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.property.IPropertyChangeProvider
	 *      #removePropertyChangeListener(java.beans.PropertyChangeListener)
	 */
	@Override
	public final void removePropertyChangeListener(PropertyChangeListener listener) {
		pcpHelper.removePropertyChangeListener(listener);
		if (visualElement != null) {

	public MetaProperty removeMetaProperty(String name) {

		if (!PropertyHelper.isValidPropertyName(name)) {
			throw new IllegalArgumentException(String.format("Name '%s' is not a valid property name", //$NON-NLS-1$
			        name));
		}

	protected TimedManyToManyRelation(Type type, UUID id, List<? extends IEntity> sources,
	        List<? extends IEntity> targets, boolean directed, Date startDate, Date endDate) {

	public TimedManyToManyRelation(IGeneralDataSet<? extends IGeneralElement> dataSet, List<? extends IEntity> sources,
	        List<? extends IEntity> targets, boolean directed, Date startDate, Date endDate) {

	public ManyToManyRelation(IGeneralDataSet<? extends IGeneralElement> dataSet, List<? extends IEntity> sources,
	        List<? extends IEntity> targets, boolean directed) {
		this(IManyToManyRelation.TYPE, UUID.randomUUID(), dataSet, sources, targets, directed);

		setOriginalDataSets(originalDataSets);
	}

	// END Constructors

	// BEGIN Descriptor Handling

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.AbstractDataSet#isDescriptorValid(pl.edu.agh.cast.data.model.DataSetDescriptor)
	 */
	@Override
	protected final boolean isDescriptorValid(DataSetDescriptor descriptor) {
		return super.isDescriptorValid(descriptor) && descriptor.getClass() == PresentationDataSetDescriptor.class;

		this(dataSet, type, UUID.randomUUID(), presentationElement);
	}

	/**
	 * Constructor.
	 *
	 * @param dataSet
	 *            data set which this element belongs to
	 * @param type
	 *            element type
	 * @param id
	 *            the ID of the element
	 * @param presentationElement
	 *            a presentation element which is described by this visual element.
	 */
	protected VisualElement(IVisualDataSet<? extends IVisualElement<?>, ? extends IPresentationDataSet<?>> dataSet,
	        Type type, UUID id, M presentationElement) {

				metaProperties.put(name, new MetaTransientProperty(name, displayName, type, matchable, method));
			} else if (entry.getValue().size() > 1) {
				throw new PropertyAnnotationException(String.format(

	}

	// END Constructors

	// BEGIN Descriptor Handling

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.AbstractDataSet#isDescriptorValid(pl.edu.agh.cast.data.model.DataSetDescriptor)
	 */
	@Override
	protected final boolean isDescriptorValid(DataSetDescriptor descriptor) {
		return super.isDescriptorValid(descriptor) && descriptor.getClass() == VisualDataSetDescriptor.class;

		for (IEntity entity : getTargetEntities()) {
			sb.append(entity.getName()).append(Constants.STRING_SPACE);
		}
		sb.append("]");

	public TimedManyToManyRelation(IGeneralDataSet<? extends IGeneralElement> dataSet, List<? extends IEntity> sources,
	        List<? extends IEntity> targets, boolean directed, Date startDate, Date endDate) {

	protected ManyToManyRelation(Type type, UUID id, IGeneralDataSet<? extends IGeneralElement> dataSet,
	        List<? extends IEntity> sources, List<? extends IEntity> targets, boolean directed) {
		super(type, id, dataSet);

	public TimedManyToManyRelation(IGeneralDataSet<? extends IGeneralElement> dataSet, List<? extends IEntity> sources,
	        List<? extends IEntity> targets, boolean directed, Date startDate, Date endDate) {

	}

	// END Constructors

	// BEGIN Descriptor Handling

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.AbstractDataSet#isDescriptorValid(pl.edu.agh.cast.data.model.DataSetDescriptor)
	 */
	@Override
	protected final boolean isDescriptorValid(DataSetDescriptor descriptor) {
		return super.isDescriptorValid(descriptor) && descriptor.getClass() == VisualDataSetDescriptor.class;

			} else if (entry.getValue().size() > 1) {
				throw new PropertyAnnotationException(String.format(

			this.metaTransientProperties.remove((MetaTransientProperty)metaProperty);
		} else if (metaProperty.getClass() == MetaProperty.class) {
			this.metaCustomProperties.remove(metaProperty);

			this.metaPermanentProperties.remove((MetaPermanentProperty)metaProperty);
		} else if (metaProperty.getClass() == MetaTransientProperty.class) {
			this.metaTransientProperties.remove((MetaTransientProperty)metaProperty);

		this(dataSet, ReferenceUtil.getInstance().createReferenceList(source), ReferenceUtil.getInstance()
		        .createReferenceList(target), directed, date);

	        IReferenceList<IEntity> targets, boolean directed, Date startDate, Date endDate) {
		super(type, id, sources, targets, directed, startDate, endDate);

		this(ITimedOneToOneRelation.TYPE, id, ReferenceUtil.getInstance().createReferenceList(source), ReferenceUtil
		        .getInstance().createReferenceList(target), directed, startDate, endDate);

	protected TimedManyToManyRelation(Type type, UUID id, List<? extends IEntity> sources,
	        List<? extends IEntity> targets, boolean directed, Date startDate, Date endDate) {

		return String.format("E [%1$s] %2$s (%3$s)", getType(), getId(), getDescString()); //$NON-NLS-1$
	}

	/**
	 * Returns a string with short description of element. This method is used by {@link #toString()} and may be
	 * overridden in order to customize its results.
	 *
	 * @return a description string
	 */
	protected String getDescString() {
		return "";
	}

	// END Object Methods

	// BEGIN Helper Methods

	/**
	 * Verifies constructor arguments (<em>dataSet</em> and <em>type</em>) and, if successful, returns a meta-property
	 * manager from given data set based on given type.
	 *
	 * @param dataSet
	 *            the data set to verify
	 * @param type
	 *            the type to verify
	 * @return instance of {@link MetaPropertyManager} from <em>dataSet</em> based on <em>type</em>
	 *
	 * @see IDataSet#getMetaPropertyManager(Type)
	 */
	private static MetaPropertyManager preprocessConstructorArguments(IDataSet<?> dataSet, Type type) {

				TransientProperty annotation = entry.getValue().get(0);
				String name = annotation.name().trim();

	public final <V extends IVisualDataSet<? extends IVisualElement<T>, ? extends IPresentationDataSet<T>>> V getVisualDataSet() {

		this(dataSet, ReferenceUtil.getInstance().createReferenceList(source), ReferenceUtil.getInstance()
		        .createReferenceList(target), directed, date);

	public OneToOneRelation(IGeneralDataSet<? extends IGeneralElement> dataSet, IEntity source, IEntity target,
	        boolean directed) {
		this(UUID.randomUUID(), source, target, directed);

		if (entities instanceof IReferenceList) {
			this.targets = (IReferenceList<IEntity>)entities;
		} else {
			this.targets.setReferences(entities);

		if (entities instanceof IReferenceList) {
			this.sources = (IReferenceList<IEntity>)entities;
		} else {
			this.sources.setReferences(entities);

		if (relations instanceof IReferenceList) {
			this.outgoingRelations = (IReferenceList<IManyToManyRelation>)relations;
		} else {
			this.outgoingRelations.setReferences(relations);

		if (relations instanceof IReferenceList) {
			this.incomingRelations = (IReferenceList<IManyToManyRelation>)relations;
		} else {
			this.incomingRelations.setReferences(relations);

	@Override
	protected boolean checkFormat(String value) {
		return true;
	}

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.property.validator.PropertyValidator#convert(java.lang.String)
	 */
	@Override
	protected Object convert(String value) {

			if (prop.setter != null && !verifySetterSignature(prop.setter, prop.type.getValidator().getTypeClass())) {
				throw new PropertyAnnotationException(String.format(

	protected ManyToManyRelation(Type type, UUID id, List<? extends IEntity> sources, List<? extends IEntity> targets,
	        boolean directed) {

		if (element.getType().isSubtypeOf(IManyToManyRelation.TYPE)) {
			IManyToManyRelation relation = (IManyToManyRelation)element;

		return this.sdp.format(time);
	}

	/**
	 * Returns the time format.
	 *
	 * @return time format
	 */
	public String getFormat() {
		return sdp.toPattern();
	}

	/**
	 * Returns the default time format.
	 *
	 * @return default time format
	 */
	public static String getDefaultFormat() {
		return HH_MM_SS_COLON.getFormat();

		public <T extends Identifiable> IReferenceList<T> createReferenceList(Iterable<T> instances, Type type) {
			return new ReferenceList<T>(instances, type);

		this(name, displayName, type, matchable, getter, setter, true);
	}

	/**
	 * Creates new permanent meta property with the given writable flag.
	 *
	 * @param name
	 *            the name of the property
	 * @param displayName
	 *            the display name of the property
	 * @param type
	 *            the type of property value
	 * @param matchable
	 *            the matchable flag
	 * @param getter
	 *            value getter method
	 * @param setter
	 *            value setter method
	 * @param writable
	 *            flat which indicates if the property is writable
	 */
	public MetaPermanentProperty(String name, String displayName, PropertyType type, boolean matchable, Method getter,
	        Method setter, boolean writable) {

		ITimedManyToManyRelation tm2m = new TimedManyToManyRelation(this, Arrays.asList(entity1, entity2), Arrays
		        .asList(entity3, entity4), false, dateStart, dateEnd);

	private static void verifyType(Type type) throws IllegalArgumentException {
		if (type == null) {
			throw new IllegalArgumentException("Type cannot be null");
		}
		if (!type.isSubtypeOf(IElement.TYPE)) {

		public <T extends Identifiable> IReferenceList<T> createReferenceList(Iterable<T> instances, Type type) {

	}

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.property.MetaProperty#equals(java.lang.Object)
	 */
	@Override
	public boolean equals(Object obj) {
		if (obj == null || !(obj instanceof MetaTransientProperty)) {

		MetaTransientProperty that = (MetaTransientProperty)obj;

		return this.getter.get().equals(that.getter.get());

	}

	/**
	 * Returns <code>true</code> if given object is of type {@link MetaProperty} and has equal <em>name</em>,
	 * <em>type</em>, <em>writable</em> and <em>matchable</em> flags.
	 *
	 * {@inheritDoc}
	 *
	 * @see java.lang.Object#equals(java.lang.Object)
	 */
	@Override
	public boolean equals(Object obj) {
		if (obj == null || !(obj instanceof MetaProperty)) {

		if (setter != null && !PropertyHelper.verifySetterSignature(setter, type.getValidator().getTypeClass())) {
			throw new IllegalArgumentException(String.format(

	public int hashCode() {
		final int prime = 31;
		int result = prime;

		result = prime * result + this.getMetaProperty().hashCode();

			this.targets = ReferenceUtil.getInstance().createEmptyReferenceList((IEntity)null);
			if (entities != null) {

	protected ManyToManyRelation(Type type, UUID id, List<? extends IEntity> sources, List<? extends IEntity> targets,
	        boolean directed) {

	public final void setOutgoingRelations(List<? extends IManyToManyRelation> relations) {
		if (relations == null) {
			throw new IllegalArgumentException("Outgoing relations cannot be null");

			this.outgoingRelations = ReferenceUtil.getInstance().createEmptyReferenceList((IManyToManyRelation)null);
			if (relations != null) {

		if (type == null) {
			throw new IllegalArgumentException("Type cannot be null");
		}
		if (!type.isSubtypeOf(IDataSet.TYPE)) {

			throw new IllegalArgumentException("Element list cannot be null");
		}
		for (T element : elements) {
			addElement(element);
		}
	}

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.IDataSet#setElements(java.util.Collection)
	 */
	@Override
	public final void setElements(Collection<? extends T> elemnts) {

	public final <T extends Identifiable> IReferenceList<T> createReferenceList(Iterable<T> instances, Type type) {

		} catch (IllegalArgumentException e) {
			return false;
		}
	}

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.property.validator.PropertyValidator#convert(java.lang.String)
	 */
	@Override
	protected Object convert(String value) {
		try {
			return UUID.fromString(value.trim());

		return Integer.parseInt(value.trim());
	}

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.property.validator.PropertyValidator#getTypeClass()
	 */
	@Override
	public Class<?> getTypeClass() {
		return Integer.class;

				if (!verifyGetterSignature(method, type.getValidator().getTypeClass())) {
					throw new PropertyAnnotationException(String.format(

	public Property<? extends MetaProperty> removeProperty(String name) {
		if (!PropertyHelper.isValidPropertyName(name)) {
			throw new IllegalArgumentException("Invalid name of the property to remove");

			TransientProperty property = (TransientProperty)this.propertyMap.get(metaProperty.getName());

			if (property != null) {

	public Property<? extends MetaProperty> getProperty(String name) {
		if (!PropertyHelper.isValidPropertyName(name)) {
			throw new IllegalArgumentException("Invalid name of the property to retrieve");

		if (obj == null || !(obj instanceof MetaTransientProperty)) {
			return false;
		}

		if (!super.equals(obj)) {
			return false;
		}

	}

	/**
	 * The constructor for presentation elements created manually. The presentation element belongs to the presentation
	 * data set and ID given in the constructor. The type of the element might be schema node, etc. The given list of
	 * referenced elements is used.
	 *
	 * @param dataSet
	 *            the data set given element belongs to
	 * @param type
	 *            the type of the element
	 * @param id
	 *            the ID of the element
	 * @param originalElements
	 *            the list of originalElements to represented domain model elements - if <code>null</code>, then empty
	 *            {@link IReferenceList} instance is acquired from {@link ReferenceUtil}
	 */
	protected PresentationElement(IPresentationDataSet<? extends IPresentationElement<?>> dataSet, Type type, UUID id,

		this(dataSet, type, id, null);
	}

	/**
	 * The constructor for presentation elements created manually. The presentation element belongs to the presentation
	 * data set given in the constructor. The type of the element might be schema node, etc. The given list of
	 * referenced elements is used. The ID is randomly generated.
	 *
	 * @param dataSet
	 *            the data set given element belongs to
	 * @param type
	 *            the type of the element
	 * @param originalElements
	 *            the list of references to represented domain model elements - if <code>null</code>, then empty
	 *            {@link IReferenceList} instance is acquired from {@link ReferenceUtil}
	 */
	protected PresentationElement(IPresentationDataSet<? extends IPresentationElement<?>> dataSet, Type type,

	}

	// BEGIN Property Change Support

	/**
	 * {@inheritDoc}
	 *
	 * @see pl.edu.agh.cast.data.model.property.IPropertyChangeProvider
	 *      #addPropertyChangeListener(java.beans.PropertyChangeListener)
	 */
	@Override
	public final void addPropertyChangeListener(PropertyChangeListener listener) {
		pcpHelper.addPropertyChangeListener(listener);
		if (visualElement != null) {

	public static final Type TYPE = Type.fromClass(IVisualDataSet.class);

	/**
	 * Collection of element types accepted by this type of data set.
	 */
	public static final Collection<Type> ACCEPTED_TYPES = Collections.unmodifiableCollection(Arrays
	        .asList(IVisualElement.TYPE));

	public final void addTargetEntitiy(IEntity entity) throws ModelException {
		if (!verifyEntity(entity)) {
			throw new ModelException("Entity is not valid for addition to target list.");

	public static final Type TYPE = Type.fromClass(IPresentationDataSet.class);

	/**
	 * Collection of element types accepted by this type of data set.
	 */
	public static final Collection<Type> ACCEPTED_TYPES = Collections.unmodifiableCollection(Arrays
	        .asList(IPresentationElement.TYPE));

			if (entry == null) {
				throw new ConverterException(String.format("Data set of type '%s' is not legal for this converter", ds
				        .getType()));
			}