// Copyright 2012 Georg-August-Universität Göttingen, Germany // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package de.ugoe.cs.autoquest.tasktrees.treeimpl; import de.ugoe.cs.autoquest.tasktrees.treeifc.ITask; import de.ugoe.cs.autoquest.tasktrees.treeifc.ITaskVisitor; /** *

* this is the default implementation of the interface {@link ITask}. It * does not do anything fancy except implementing the interface. *

* * @author Patrick Harms */ class Task implements ITask { /** *

* default serial version UID *

*/ private static final long serialVersionUID = 1L; /** *

* used as a counter to generate new ids for each newly created task. May overflow. *

*/ private static int temporalId = 0; /** *

* the id of the task (unique throughout the system as long as {@link #temporalId} does not * overflow. *

*/ private int id; /** *

* a human readable description of the task *

*/ private String description; /** *

* constructs a new task with a new id. The id is generated using the {@link #getNewId()} * methdod *

*/ Task() { id = getNewId(); } /** *

* creates a new id for a task using {@link #temporalId} by incrementing it an returning its * current value. Resets the counter if {@link Integer.MAX_VALUE} is reached. *

* * @return a new unique id for a task as long as {@link #temporalId} does not overflow */ private static synchronized int getNewId() { if (temporalId == Integer.MAX_VALUE) { temporalId = 0; } return temporalId++; } /* (non-Javadoc) * @see de.ugoe.cs.autoquest.tasktrees.treeifc.ITask#geId() */ @Override public int getId() { return id; } /* (non-Javadoc) * @see de.ugoe.cs.autoquest.tasktrees.treeifc.ITask#getDescription() */ @Override public String getDescription() { return description; } /* (non-Javadoc) * @see de.ugoe.cs.autoquest.tasktrees.treeifc.ITask#equals(ITask) */ @Override public final boolean equals(ITask task) { // tasks are only equal if they are identical or if they have the same id // (may happen, if they are cloned) return (this == task) || (this.hashCode() == task.hashCode()); } /* (non-Javadoc) * @see de.ugoe.cs.autoquest.tasktrees.treeifc.ITask#hashCode() */ @Override public synchronized int hashCode() { return id; } /* (non-Javadoc) * @see java.lang.Object#toString() */ @Override public synchronized String toString() { StringBuffer result = new StringBuffer(); result.append("task "); result.append(id); if (description != null) { result.append(" ("); result.append(description); result.append(')'); } return result.toString(); } /* (non-Javadoc) * @see de.ugoe.cs.autoquest.tasktrees.treeifc.ITask#clone() */ @Override public synchronized ITask clone() { Task clone = null; try { clone = (Task) super.clone(); } catch (CloneNotSupportedException e) { // this should never happen. Therefore simply dump the exception e.printStackTrace(); } return clone; } /** *

* internally used to set the human readable description of the task *

* * @param description the new human readable description of the task */ void setDescription(String description) { this.description = description; } /* (non-Javadoc) * @see de.ugoe.cs.autoquest.tasktrees.treeifc.ITask#accept(ITaskVisitor) */ @Override public void accept(ITaskVisitor visitor) { visitor.visit(this); } }