/*
* RapidMiner
*
* Copyright (C) 2001-2011 by Rapid-I and the contributors
*
* Complete list of developers available at our web site:
*
* http://rapid-i.com
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero 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 Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see http://www.gnu.org/licenses/.
*/
package com.rapidminer.operator.ports.impl;
import java.util.Collection;
import java.util.Collections;
import java.util.LinkedList;
import java.util.logging.Level;
import com.rapidminer.operator.IOObject;
import com.rapidminer.operator.ProcessSetupError.Severity;
import com.rapidminer.operator.ports.InputPort;
import com.rapidminer.operator.ports.InputPorts;
import com.rapidminer.operator.ports.MetaDataChangeListener;
import com.rapidminer.operator.ports.OutputPort;
import com.rapidminer.operator.ports.Port;
import com.rapidminer.operator.ports.Ports;
import com.rapidminer.operator.ports.metadata.CompatibilityLevel;
import com.rapidminer.operator.ports.metadata.MetaData;
import com.rapidminer.operator.ports.metadata.Precondition;
import com.rapidminer.operator.ports.metadata.SimpleMetaDataError;
/**
* The default implmentation of an {@link InputPort}
*
* @author Simon Fischer, Sebastian Land
*
*/
public class InputPortImpl extends AbstractPort implements InputPort {
private final Collection<MetaDataChangeListener> metaDataChangeListeners = new LinkedList<MetaDataChangeListener>();
private final Collection<Precondition> preconditions = new LinkedList<Precondition>();
private MetaData metaData;
/** The port to which this port is connected. */
private OutputPort sourceOutputPort;
/** Use the factory method {@link InputPorts#createPort()} to create InputPorts. */
protected InputPortImpl(Ports<? extends Port> owner, String name, boolean simulatesStack) {
super(owner, name, simulatesStack);
}
@Override
public void clear(int clearFlags) {
super.clear(clearFlags);
if ((clearFlags & CLEAR_METADATA) > 0) {
this.metaData = null;
informListenersOfChange(null);
}
}
@Override
public void receive(IOObject object) {
setData(object);
}
@Override
public void receiveMD(MetaData metaData) {
assert(this.metaData != null);
this.metaData = metaData;
informListenersOfChange(metaData);
}
@Override
public MetaData getMetaData() {
return metaData;
}
void connect(OutputPort outputPort) {
this.sourceOutputPort = outputPort;
fireUpdate(this);
}
@Override
public OutputPort getSource() {
return sourceOutputPort;
}
@Override
public void addPrecondition(Precondition precondition) {
preconditions.add(precondition);
}
@Override
public void checkPreconditions() {
MetaData metaData = getMetaData();
for (Precondition precondition : preconditions) {
try {
precondition.check(metaData);
} catch (Exception e) {
getPorts().getOwner().getOperator().getLogger().log(Level.WARNING, "Error checking preconditions at "+getSpec()+": "+e, e);
this.addError(new SimpleMetaDataError(Severity.WARNING, this, "exception_checking_precondition", e.toString()));
}
}
}
@Override
public String getPreconditionDescription() {
StringBuilder buf = new StringBuilder();
buf.append(getName());
buf.append(": ");
for (Precondition precondition : preconditions) {
buf.append(precondition.getDescription());
}
return buf.toString();
}
@Override
public boolean isInputCompatible(MetaData input, CompatibilityLevel level) {
for (Precondition precondition : preconditions) {
if (!precondition.isCompatible(input, level)) {
return false;
}
}
return true;
}
@Override
public String getDescription() {
StringBuilder b = new StringBuilder();
boolean first = true;
for (Precondition precondition : preconditions) {
if (!first) {
b.append(", ");
} else {
first = false;
}
b.append(precondition.getDescription());
}
return b.toString();
}
@Override
public boolean isConnected() {
return (sourceOutputPort != null);
}
@Override
public Collection<Precondition> getAllPreconditions() {
return Collections.unmodifiableCollection(preconditions);
}
@Override
public void registerMetaDataChangeListener(MetaDataChangeListener listener) {
metaDataChangeListeners.add(listener);
}
@Override
public void removeMetaDataChangeListener(MetaDataChangeListener listener) {
metaDataChangeListeners.remove(listener);
}
private void informListenersOfChange(MetaData metaData) {
for (MetaDataChangeListener listener: metaDataChangeListeners) {
listener.informMetaDataChanged(metaData);
}
}
}