org.apache.tools.ant.taskdefs.optional.clearcase
Class CCUpdate

java.lang.Object
  |
  +--org.apache.tools.ant.ProjectComponent
        |
        +--org.apache.tools.ant.Task
              |
              +--org.apache.tools.ant.taskdefs.optional.clearcase.ClearCase
                    |
                    +--org.apache.tools.ant.taskdefs.optional.clearcase.CCUpdate

public class CCUpdate

extends ClearCase

Performs a ClearCase Update command.

The following attributes are interpreted:

Attribute	Values	Required
viewpath	Path to the ClearCase view file or directory that the command will operate on	No
graphical	Displays a graphical dialog during the update	No
log	Specifies a log file for ClearCase to write to	No
overwrite	Specifies whether to overwrite hijacked files or not	No
rename	Specifies that hijacked files should be renamed with a .keep extension	No
currenttime	Specifies that modification time should be written as the current time. Either currenttime or preservetime can be specified.	No
preservetime	Specifies that modification time should preserved from the VOB time. Either currenttime or preservetime can be specified.	No
failonerr	Throw an exception if the command fails. Default is true	No

Author:

Curtis White

Field Summary

static java.lang.String	FLAG_CURRENTTIME -ctime flag -- modified time is written as the current time
static java.lang.String	FLAG_GRAPHICAL -graphical flag -- display graphical dialog during update operation
static java.lang.String	FLAG_LOG -log flag -- file to log status to
static java.lang.String	FLAG_NOVERWRITE -noverwrite flag -- do not overwrite hijacked files
static java.lang.String	FLAG_OVERWRITE -overwrite flag -- overwrite hijacked files
static java.lang.String	FLAG_PRESERVETIME -ptime flag -- modified time is written as the VOB time
static java.lang.String	FLAG_RENAME -rename flag -- rename hijacked files with .keep extension

Fields inherited from class org.apache.tools.ant.taskdefs.optional.clearcase.ClearCase

COMMAND_CHECKIN, COMMAND_CHECKOUT, COMMAND_LOCK, COMMAND_LSCO, COMMAND_MKATTR, COMMAND_MKBL, COMMAND_MKDIR, COMMAND_MKELEM, COMMAND_MKLABEL, COMMAND_MKLBTYPE, COMMAND_RMTYPE, COMMAND_UNCHECKOUT, COMMAND_UNLOCK, COMMAND_UPDATE

Fields inherited from class org.apache.tools.ant.Task

description, location, target, taskName, taskType, wrapper

Fields inherited from class org.apache.tools.ant.ProjectComponent

project

Constructor Summary

CCUpdate()

Method Summary

void	execute() Executes the task.
boolean	getCurrentTime() Get current time status
boolean	getGraphical() Get graphical flag status
java.lang.String	getLog() Get log file
boolean	getOverwrite() Get overwrite hijacked files status
boolean	getPreserveTime() Get preserve time status
boolean	getRename() Get rename hijacked files status
void	setCurrentTime(boolean ct) If true, modification time should be written as the current time.
void	setGraphical(boolean graphical) If true, displays a graphical dialog during the update.
void	setLog(java.lang.String log) Sets the log file where cleartool records the status of the command.
void	setOverwrite(boolean ow) If true, overwrite hijacked files.
void	setPreserveTime(boolean pt) If true, modification time should be preserved from the VOB time.
void	setRename(boolean ren) If true, hijacked files are renamed with a .keep extension.

Methods inherited from class org.apache.tools.ant.taskdefs.optional.clearcase.ClearCase

getClearToolCommand, getFailOnErr, getObjSelect, getViewPath, getViewPathBasename, run, runS, setClearToolDir, setFailOnErr, setObjSelect, setViewPath

Methods inherited from class org.apache.tools.ant.Task

getDescription, getLocation, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, init, isInvalid, log, log, maybeConfigure, perform, reconfigure, setDescription, setLocation, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType

Methods inherited from class org.apache.tools.ant.ProjectComponent

getProject, setProject

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

FLAG_GRAPHICAL

public static final java.lang.String FLAG_GRAPHICAL

-graphical flag -- display graphical dialog during update operation

See Also:

Constant Field Values

FLAG_LOG

public static final java.lang.String FLAG_LOG

-log flag -- file to log status to

See Also:

Constant Field Values

FLAG_OVERWRITE

public static final java.lang.String FLAG_OVERWRITE

-overwrite flag -- overwrite hijacked files

See Also:

Constant Field Values

FLAG_NOVERWRITE

public static final java.lang.String FLAG_NOVERWRITE

-noverwrite flag -- do not overwrite hijacked files

See Also:

Constant Field Values

FLAG_RENAME

public static final java.lang.String FLAG_RENAME

-rename flag -- rename hijacked files with .keep extension

See Also:

Constant Field Values

FLAG_CURRENTTIME

public static final java.lang.String FLAG_CURRENTTIME

-ctime flag -- modified time is written as the current time

See Also:

Constant Field Values

FLAG_PRESERVETIME

public static final java.lang.String FLAG_PRESERVETIME

-ptime flag -- modified time is written as the VOB time

See Also:

Constant Field Values

Constructor Detail

CCUpdate

public CCUpdate()

Method Detail

execute

public void execute()
             throws BuildException

Executes the task.

Builds a command line to execute cleartool and then calls Exec's run method to execute the command line.

Overrides:

execute in class Task

Throws:

BuildException - if the command fails and failonerr is set to true

setGraphical

public void setGraphical(boolean graphical)

If true, displays a graphical dialog during the update.

Parameters:

graphical - the status to set the flag to

getGraphical

public boolean getGraphical()

Get graphical flag status

Returns:

boolean containing status of graphical flag

setOverwrite

public void setOverwrite(boolean ow)

If true, overwrite hijacked files.

Parameters:

ow - the status to set the flag to

getOverwrite

public boolean getOverwrite()

Get overwrite hijacked files status

Returns:

boolean containing status of overwrite flag

setRename

public void setRename(boolean ren)

If true, hijacked files are renamed with a .keep extension.

Parameters:

ren - the status to set the flag to

getRename

public boolean getRename()

Get rename hijacked files status

Returns:

boolean containing status of rename flag

setCurrentTime

public void setCurrentTime(boolean ct)

If true, modification time should be written as the current time. Either currenttime or preservetime can be specified.

Parameters:

ct - the status to set the flag to

getCurrentTime

public boolean getCurrentTime()

Get current time status

Returns:

boolean containing status of current time flag

setPreserveTime

public void setPreserveTime(boolean pt)

If true, modification time should be preserved from the VOB time. Either currenttime or preservetime can be specified.

Parameters:

pt - the status to set the flag to

getPreserveTime

public boolean getPreserveTime()

Get preserve time status

Returns:

boolean containing status of preserve time flag

setLog

public void setLog(java.lang.String log)

Sets the log file where cleartool records the status of the command.

Parameters:

log - the path to the log file

getLog

public java.lang.String getLog()

Get log file

Returns:

String containing the path to the log file