/*******************************************************************************
* PSHDL is a library and (trans-)compiler for PSHDL input. It generates
* output suitable for implementation or simulation of it.
*
* Copyright (C) 2014 Karsten Becker (feedback (at) pshdl (dot) org)
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* This License does not grant permission to use the trade names, trademarks,
* service marks, or product names of the Licensor, except as required for
* reasonable and customary use in describing the origin of the Work.
*
* Contributors:
* Karsten Becker - initial API and implementation
******************************************************************************/
package org.pshdl.model.impl;
import java.util.EnumSet;
import java.util.Iterator;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import org.pshdl.model.HDLArgument;
import org.pshdl.model.HDLClass;
import org.pshdl.model.HDLExpression;
import org.pshdl.model.HDLObject;
import org.pshdl.model.IHDLObject;
import org.pshdl.model.utils.CopyFilter;
import com.google.common.collect.Iterators;
@SuppressWarnings("all")
public abstract class AbstractHDLArgument extends HDLObject {
/**
* Constructs a new instance of {@link AbstractHDLArgument}
*
* @param container
* the value for container. Can be <code>null</code>.
* @param name
* the value for name. Can <b>not</b> be <code>null</code>.
* @param expression
* the value for expression. Can <b>not</b> be <code>null</code>.
* @param validate
* if <code>true</code> the parameters will be validated.
*/
public AbstractHDLArgument(int id, @Nullable IHDLObject container, @Nonnull String name, @Nonnull HDLExpression expression, boolean validate) {
super(id, container, validate);
if (validate) {
name = validateName(name);
}
this.name = name;
if (validate) {
expression = validateExpression(expression);
}
if (expression != null) {
this.expression = expression;
} else {
this.expression = null;
}
}
public AbstractHDLArgument() {
super();
this.name = null;
this.expression = null;
}
protected final String name;
/**
* Get the name field. Can <b>not</b> be <code>null</code>.
*
* @return the field
*/
@Nonnull
public String getName() {
return name;
}
protected String validateName(String name) {
if (name == null)
throw new IllegalArgumentException("The field name can not be null!");
return name;
}
protected final HDLExpression expression;
/**
* Get the expression field. Can <b>not</b> be <code>null</code>.
*
* @return the field
*/
@Nonnull
public HDLExpression getExpression() {
return expression;
}
protected HDLExpression validateExpression(HDLExpression expression) {
if (expression == null)
throw new IllegalArgumentException("The field expression can not be null!");
return expression;
}
/**
* Creates a copy of this class with the same fields.
*
* @return a new instance of this class.
*/
@Override
@Nonnull
public HDLArgument copy() {
final HDLArgument newObject = new HDLArgument(id, null, name, expression, false);
copyMetaData(this, newObject, false);
return newObject;
}
/**
* Creates a copy of this class with the same fields.
*
* @return a new instance of this class.
*/
@Override
@Nonnull
public HDLArgument copyFiltered(CopyFilter filter) {
final String filteredname = filter.copyObject("name", this, name);
final HDLExpression filteredexpression = filter.copyObject("expression", this, expression);
return filter.postFilter((HDLArgument) this, new HDLArgument(id, null, filteredname, filteredexpression, false));
}
/**
* Creates a deep copy of this class with the same fields and freezes it.
*
* @return a new instance of this class.
*/
@Override
@Nonnull
public HDLArgument copyDeepFrozen(IHDLObject container) {
final HDLArgument copy = copyFiltered(CopyFilter.DEEP_META);
copy.freeze(container);
return copy;
}
/**
* Setter for the field {@link #getContainer()}.
*
* @param container
* sets the new container of this object. Can be
* <code>null</code>.
* @return the same instance of {@link HDLArgument} with the updated
* container field.
*/
@Override
@Nonnull
public HDLArgument setContainer(@Nullable IHDLObject container) {
return (HDLArgument) super.setContainer(container);
}
/**
* Setter for the field {@link #getName()}.
*
* @param name
* sets the new name of this object. Can <b>not</b> be
* <code>null</code>.
* @return a new instance of {@link HDLArgument} with the updated name
* field.
*/
@Nonnull
public HDLArgument setName(@Nonnull String name) {
name = validateName(name);
final HDLArgument res = new HDLArgument(id, container, name, expression, false);
return res;
}
/**
* Setter for the field {@link #getExpression()}.
*
* @param expression
* sets the new expression of this object. Can <b>not</b> be
* <code>null</code>.
* @return a new instance of {@link HDLArgument} with the updated expression
* field.
*/
@Nonnull
public HDLArgument setExpression(@Nonnull HDLExpression expression) {
expression = validateExpression(expression);
final HDLArgument res = new HDLArgument(id, container, name, expression, false);
return res;
}
@Override
public boolean equals(Object obj) {
if (this == obj)
return true;
if (obj == null)
return false;
if (!(obj instanceof AbstractHDLArgument))
return false;
if (!super.equals(obj))
return false;
final AbstractHDLArgument other = (AbstractHDLArgument) obj;
if (name == null) {
if (other.name != null)
return false;
} else if (!name.equals(other.name))
return false;
if (expression == null) {
if (other.expression != null)
return false;
} else if (!expression.equals(other.expression))
return false;
return true;
}
private Integer hashCache;
@Override
public int hashCode() {
if (hashCache != null)
return hashCache;
int result = super.hashCode();
final int prime = 31;
result = (prime * result) + ((name == null) ? 0 : name.hashCode());
result = (prime * result) + ((expression == null) ? 0 : expression.hashCode());
hashCache = result;
return result;
}
@Override
public String toConstructionString(String spacing) {
final boolean first = true;
final StringBuilder sb = new StringBuilder();
sb.append('\n').append(spacing).append("new HDLArgument()");
if (name != null) {
sb.append(".setName(").append('"' + name + '"').append(")");
}
if (expression != null) {
sb.append(".setExpression(").append(expression.toConstructionString(spacing + "\t")).append(")");
}
return sb.toString();
}
@Override
public void validateAllFields(IHDLObject expectedParent, boolean checkResolve) {
super.validateAllFields(expectedParent, checkResolve);
validateName(getName());
validateExpression(getExpression());
if (getExpression() != null) {
getExpression().validateAllFields(this, checkResolve);
}
}
@Override
public EnumSet<HDLClass> getClassSet() {
return EnumSet.of(HDLClass.HDLArgument, HDLClass.HDLObject);
}
@Override
public Iterator<IHDLObject> deepIterator() {
return new Iterator<IHDLObject>() {
private int pos = 0;
private Iterator<? extends IHDLObject> current;
@Override
public boolean hasNext() {
if ((current != null) && !current.hasNext()) {
current = null;
}
while (current == null) {
switch (pos++) {
case 0:
if (expression != null) {
current = Iterators.concat(Iterators.forArray(expression), expression.deepIterator());
}
break;
default:
return false;
}
}
return (current != null) && current.hasNext();
}
@Override
public IHDLObject next() {
return current.next();
}
@Override
public void remove() {
throw new IllegalArgumentException("Not supported");
}
};
}
@Override
public Iterator<IHDLObject> iterator() {
return new Iterator<IHDLObject>() {
private int pos = 0;
private Iterator<? extends IHDLObject> current;
@Override
public boolean hasNext() {
if ((current != null) && !current.hasNext()) {
current = null;
}
while (current == null) {
switch (pos++) {
case 0:
if (expression != null) {
current = Iterators.singletonIterator(expression);
}
break;
default:
return false;
}
}
return (current != null) && current.hasNext();
}
@Override
public IHDLObject next() {
return current.next();
}
@Override
public void remove() {
throw new IllegalArgumentException("Not supported");
}
};
}
}