.
*/
require_once 'phing/Task.php';
/**
* Register a task for use within a buildfile.
*
* This is for registering your own tasks -- or any non-core Task -- for use within a buildfile.
* If you find that you are using a particular class frequently, you may want to edit the
* phing/tasks/defaults.properties file so that it is included by default. You may also
* want to submit it (if LGPL or compatible license) to be included in Phing distribution.
*
*
*
* .
* .
*
*
*
* TODO:
* -- possibly refactor since this is almost the same as TypeDefTask
* (right now these are just too simple to really justify creating an abstract class)
*
* @author Hans Lellelid
* @version $Revision: 1.11 $
* @package phing.tasks.system
*/
class TaskdefTask extends Task {
/** Tag name for task that will be used in XML */
private $name;
/**
* Classname of task to register.
* This can be a dot-path -- relative to a location on PHP include_path.
* E.g. path.to.MyClass -> path/to/MyClass.php
* @var string
*/
private $classname;
/**
* Path to add to PHP include_path to aid in finding specified class.
* @var Path
*/
private $classpath;
/**
* Refid to already defined classpath
*/
private $classpathId;
/**
* Set the classpath to be used when searching for component being defined
*
* @param Path $classpath An Path object containing the classpath.
*/
public function setClasspath(Path $classpath) {
if ($this->classpath === null) {
$this->classpath = $classpath;
} else {
$this->classpath->append($classpath);
}
}
/**
* Create the classpath to be used when searching for component being defined
*/
public function createClasspath() {
if ($this->classpath === null) {
$this->classpath = new Path($this->project);
}
return $this->classpath->createPath();
}
/**
* Reference to a classpath to use when loading the files.
*/
public function setClasspathRef(Reference $r) {
$this->classpathId = $r->getRefId();
$this->createClasspath()->setRefid($r);
}
/**
* Sets the name that will be used in XML buildfile.
* @param string $name
*/
public function setName($name) {
$this->name = $name;
}
/**
* Sets the class name / dotpath to use.
* @param string $class
*/
public function setClassname($class) {
$this->classname = $class;
}
/** Main entry point */
public function main() {
if ($this->name === null || $this->classname === null) {
throw new BuildException("You must specify name and class attributes for .");
}
$this->log("Task " . $this->name . " will be handled by class " . $this->classname, PROJECT_MSG_VERBOSE);
$this->project->addTaskDefinition($this->name, $this->classname, $this->classpath);
}
}