Class ClearCase
java.lang.Object
org.apache.tools.ant.ProjectComponent
org.apache.tools.ant.Task
org.apache.tools.ant.taskdefs.optional.clearcase.ClearCase
- All Implemented Interfaces:
java.lang.Cloneable
- Direct Known Subclasses:
CCCheckin
,CCCheckout
,CCLock
,CCMkattr
,CCMkbl
,CCMkdir
,CCMkelem
,CCMklabel
,CCMklbtype
,CCRmtype
,CCUnCheckout
,CCUnlock
,CCUpdate
public abstract class ClearCase extends Task
A base class for creating tasks for executing commands on ClearCase.
By default the task expects the cleartool executable to be in the path, you can override this be specifying the cleartooldir attribute.
This class provides set and get methods for the 'viewpath' and 'objselect' attribute. It also contains constants for the flags that can be passed to cleartool.
-
Field Summary
Fields Modifier and Type Field Description static java.lang.String
COMMAND_CHECKIN
The 'Checkin' commandstatic java.lang.String
COMMAND_CHECKOUT
The 'Checkout' commandstatic java.lang.String
COMMAND_LOCK
The 'Lock' commandstatic java.lang.String
COMMAND_LSCO
The 'LsCheckout' commandstatic java.lang.String
COMMAND_MKATTR
The 'Mkattr' commandstatic java.lang.String
COMMAND_MKBL
The 'Mkbl' commandstatic java.lang.String
COMMAND_MKDIR
The 'Mkdir' commandstatic java.lang.String
COMMAND_MKELEM
The 'Mkelem' commandstatic java.lang.String
COMMAND_MKLABEL
The 'Mklabel' commandstatic java.lang.String
COMMAND_MKLBTYPE
The 'Mklbtype' commandstatic java.lang.String
COMMAND_RMTYPE
The 'Rmtype' commandstatic java.lang.String
COMMAND_UNCHECKOUT
The 'UndoCheckout' commandstatic java.lang.String
COMMAND_UNLOCK
The 'Unlock' commandstatic java.lang.String
COMMAND_UPDATE
The 'Update' command -
Constructor Summary
Constructors Constructor Description ClearCase()
-
Method Summary
Modifier and Type Method Description protected java.lang.String
getClearToolCommand()
Builds and returns the command string to execute cleartoolboolean
getFailOnErr()
Get failonerr flag statusjava.lang.String
getObjSelect()
Get the object to operate onjava.lang.String
getViewPath()
Get the path to the item in a clearcase viewjava.lang.String
getViewPathBasename()
Get the basename path of the item in a clearcase viewprotected int
run(Commandline cmd)
Execute the given command are return success or failureprotected java.lang.String
runS(Commandline cmdline)
Deprecated.use the two arg version insteadprotected java.lang.String
runS(Commandline cmdline, boolean failOnError)
Execute the given command, and return it's outputvoid
setClearToolDir(java.lang.String dir)
Set the directory where the cleartool executable is located.void
setFailOnErr(boolean failonerr)
If true, command will throw an exception on failure.void
setObjSelect(java.lang.String objSelect)
Set the object to operate on.void
setViewPath(java.lang.String viewPath)
Set the path to the item in a ClearCase view to operate on.Methods inherited from class org.apache.tools.ant.Task
bindToOwner, execute, 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
-
Field Details
-
COMMAND_UPDATE
public static final java.lang.String COMMAND_UPDATEThe 'Update' command- See Also:
- Constant Field Values
-
COMMAND_CHECKOUT
public static final java.lang.String COMMAND_CHECKOUTThe 'Checkout' command- See Also:
- Constant Field Values
-
COMMAND_CHECKIN
public static final java.lang.String COMMAND_CHECKINThe 'Checkin' command- See Also:
- Constant Field Values
-
COMMAND_UNCHECKOUT
public static final java.lang.String COMMAND_UNCHECKOUTThe 'UndoCheckout' command- See Also:
- Constant Field Values
-
COMMAND_LOCK
public static final java.lang.String COMMAND_LOCKThe 'Lock' command- See Also:
- Constant Field Values
-
COMMAND_UNLOCK
public static final java.lang.String COMMAND_UNLOCKThe 'Unlock' command- See Also:
- Constant Field Values
-
COMMAND_MKBL
public static final java.lang.String COMMAND_MKBLThe 'Mkbl' command- See Also:
- Constant Field Values
-
COMMAND_MKLABEL
public static final java.lang.String COMMAND_MKLABELThe 'Mklabel' command- See Also:
- Constant Field Values
-
COMMAND_MKLBTYPE
public static final java.lang.String COMMAND_MKLBTYPEThe 'Mklbtype' command- See Also:
- Constant Field Values
-
COMMAND_RMTYPE
public static final java.lang.String COMMAND_RMTYPEThe 'Rmtype' command- See Also:
- Constant Field Values
-
COMMAND_LSCO
public static final java.lang.String COMMAND_LSCOThe 'LsCheckout' command- See Also:
- Constant Field Values
-
COMMAND_MKELEM
public static final java.lang.String COMMAND_MKELEMThe 'Mkelem' command- See Also:
- Constant Field Values
-
COMMAND_MKATTR
public static final java.lang.String COMMAND_MKATTRThe 'Mkattr' command- See Also:
- Constant Field Values
-
COMMAND_MKDIR
public static final java.lang.String COMMAND_MKDIRThe 'Mkdir' command- See Also:
- Constant Field Values
-
-
Constructor Details
-
ClearCase
public ClearCase()
-
-
Method Details
-
setClearToolDir
public final void setClearToolDir(java.lang.String dir)Set the directory where the cleartool executable is located.- Parameters:
dir
- the directory containing the cleartool executable
-
getClearToolCommand
protected final java.lang.String getClearToolCommand()Builds and returns the command string to execute cleartool- Returns:
- String containing path to the executable
-
setViewPath
public final void setViewPath(java.lang.String viewPath)Set the path to the item in a ClearCase view to operate on.- Parameters:
viewPath
- Path to the view directory or file
-
getViewPath
public java.lang.String getViewPath()Get the path to the item in a clearcase view- Returns:
- mviewPath
-
getViewPathBasename
public java.lang.String getViewPathBasename()Get the basename path of the item in a clearcase view- Returns:
- basename
-
setObjSelect
public final void setObjSelect(java.lang.String objSelect)Set the object to operate on.- Parameters:
objSelect
- object to operate on
-
getObjSelect
public java.lang.String getObjSelect()Get the object to operate on- Returns:
- mobjSelect
-
run
Execute the given command are return success or failure- Parameters:
cmd
- command line to execute- Returns:
- the exit status of the subprocess or
INVALID
-
runS
Deprecated.use the two arg version insteadExecute the given command, and return it's output- Parameters:
cmdline
- command line to execute- Returns:
- output of the command line
-
runS
Execute the given command, and return it's output- Parameters:
cmdline
- command line to executefailOnError
- whether to fail the build if the command fails- Returns:
- output of the command line
- Since:
- Ant 1.10.6
-
setFailOnErr
public void setFailOnErr(boolean failonerr)If true, command will throw an exception on failure.- Parameters:
failonerr
- the status to set the flag to- Since:
- ant 1.6.1
-
getFailOnErr
public boolean getFailOnErr()Get failonerr flag status- Returns:
- boolean containing status of failonerr flag
- Since:
- ant 1.6.1
-