Package 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

All Implemented Interfaces:
  `Cloneable`

public class CCUpdate extends ClearCase
Performs a ClearCase Update command.

The following attributes are interpreted:

Task attributes
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

## Field Summary

Fields
Modifier and Type
Field
Description
`static final String`
`FLAG_CURRENTTIME`
-ctime flag -- modified time is written as the current time
`static final String`
`FLAG_GRAPHICAL`
-graphical flag -- display graphical dialog during update operation
`static final String`
`FLAG_LOG`
-log flag -- file to log status to
`static final String`
`FLAG_NOVERWRITE`
-noverwrite flag -- do not overwrite hijacked files
`static final String`
`FLAG_OVERWRITE`
-overwrite flag -- overwrite hijacked files
`static final String`
`FLAG_PRESERVETIME`
-ptime flag -- modified time is written as the VOB time
`static final 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

`target, taskName, taskType, wrapper`

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

`description, location, project`

## Constructor Summary

Constructors
Constructor
Description
`CCUpdate()`

## Method Summary

Modifier and Type
Method
Description
`void`
`execute()`
Executes the task.
`boolean`
`getCurrentTime()`
Get current time status
`boolean`
`getGraphical()`
Get graphical flag status
`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(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, runS, setClearToolDir, setFailOnErr, setObjSelect, setViewPath`

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

`bindToOwner, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, init, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType`

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

`clone, getDescription, getLocation, getProject, setDescription, setLocation, setProject`

### Methods inherited from class java.lang.Object

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

## Field Details

### FLAG_GRAPHICAL

public static final String FLAG_GRAPHICAL
-graphical flag -- display graphical dialog during update operation

See Also:
  - Constant Field Values

### FLAG_LOG

public static final String FLAG_LOG
-log flag -- file to log status to

See Also:
  - Constant Field Values

### FLAG_OVERWRITE

public static final String FLAG_OVERWRITE
-overwrite flag -- overwrite hijacked files

See Also:
  - Constant Field Values

### FLAG_NOVERWRITE

public static final String FLAG_NOVERWRITE
-noverwrite flag -- do not overwrite hijacked files

See Also:
  - Constant Field Values

### FLAG_RENAME

public static final String FLAG_RENAME
-rename flag -- rename hijacked files with .keep extension

See Also:
  - Constant Field Values

### FLAG_CURRENTTIME

public static final String FLAG_CURRENTTIME
-ctime flag -- modified time is written as the current time

See Also:
  - Constant Field Values

### FLAG_PRESERVETIME

public static final String FLAG_PRESERVETIME
-ptime flag -- modified time is written as the VOB time

See Also:
  - Constant Field Values

## Constructor Details

### CCUpdate

public CCUpdate()

## Method Details

### 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(String log)
Sets the log file where cleartool records the status of the command.

Parameters:
  `log` - the path to the log file

### getLog

public String getLog()
Get log file

Returns:
  String containing the path to the log file