org.apache.tools.ant.taskdefs.optional.starteam
Class StarTeamCheckin

java.lang.Object
  |
  +--org.apache.tools.ant.ProjectComponent
        |
        +--org.apache.tools.ant.Task
              |
              +--org.apache.tools.ant.taskdefs.optional.starteam.StarTeamTask
                    |
                    +--org.apache.tools.ant.taskdefs.optional.starteam.TreeBasedTask
                          |
                          +--org.apache.tools.ant.taskdefs.optional.starteam.StarTeamCheckin

public class StarTeamCheckin
extends TreeBasedTask

Checks files into a StarTeam project. Optionally adds files and in the local tree that are not managed by the repository to its control. Created: Sat Dec 15 20:26:07 2001

Version:
1.0
Author:
Steve Cohen

Field Summary
 
Fields inherited from class org.apache.tools.ant.taskdefs.optional.starteam.TreeBasedTask
DEFAULT_EXCLUDESETTING, DEFAULT_INCLUDESETTING
 
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
StarTeamCheckin()
           
 
Method Summary
protected  com.starbase.starteam.View createSnapshotView(com.starbase.starteam.View raw)
          Override of base-class abstract function creates an appropriately configured view.
 java.lang.String getComment()
          Get the comment attribute for this operation
 boolean isAddUncontrolled()
          Get the value of addUncontrolled.
 void setAddUncontrolled(boolean addUncontrolled)
          if true, any files or folders NOT in StarTeam will be added to the repository.
 void setComment(java.lang.String comment)
          Optional checkin comment to be saved with the file.
 void setCreateFolders(boolean argCreateFolders)
          Sets the value of createFolders
 void setUnlocked(boolean v)
          Set to do an unlocked checkout; optional, default is false; If true, file will be unlocked so that other users may change it.
protected  void testPreconditions()
          Implements base-class abstract function to define tests for any preconditons required by the task
protected  void visit(com.starbase.starteam.Folder starteamFolder, java.io.File targetFolder)
          Implements base-class abstract function to perform the checkout operation on the files in each folder of the tree.
 
Methods inherited from class org.apache.tools.ant.taskdefs.optional.starteam.TreeBasedTask
_setLabel, delistLocalFile, execute, getExcludes, getIncludes, getLabelID, getRootLocalFolder, getRootStarteamFolder, isForced, isRecursive, listLocalFiles, matchPatterns, setExcludes, setForced, setIncludes, setRecursive, setRootLocalFolder, setRootStarteamFolder, shouldProcess
 
Methods inherited from class org.apache.tools.ant.taskdefs.optional.starteam.StarTeamTask
getPassword, getProjectname, getServer, getServername, getServerport, getURL, getUserName, getUserName, getViewname, openView, setPassword, setProjectname, setServername, setServerport, setURL, setUserName, setViewname
 
Methods inherited from class org.apache.tools.ant.Task
getDescription, getLocation, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, handleErrorOutput, handleOutput, init, isInvalid, log, log, maybeConfigure, perform, setDescription, setLocation, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName
 
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
 

Constructor Detail

StarTeamCheckin

public StarTeamCheckin()
Method Detail

setCreateFolders

public void setCreateFolders(boolean argCreateFolders)
Sets the value of createFolders

Parameters:
argCreateFolders - Value to assign to this.createFolders

getComment

public java.lang.String getComment()
Get the comment attribute for this operation

Returns:
value of comment.

setComment

public void setComment(java.lang.String comment)
Optional checkin comment to be saved with the file.

Parameters:
comment - Value to assign to comment.

isAddUncontrolled

public boolean isAddUncontrolled()
Get the value of addUncontrolled.

Returns:
value of addUncontrolled.

setAddUncontrolled

public void setAddUncontrolled(boolean addUncontrolled)
if true, any files or folders NOT in StarTeam will be added to the repository. Defaults to "false".

Parameters:
addUncontrolled - Value to assign to addUncontrolled.

setUnlocked

public void setUnlocked(boolean v)
Set to do an unlocked checkout; optional, default is false; If true, file will be unlocked so that other users may change it. If false, lock status will not change.

Parameters:
v - true means do an unlocked checkout false means leave status alone.

createSnapshotView

protected com.starbase.starteam.View createSnapshotView(com.starbase.starteam.View raw)
Override of base-class abstract function creates an appropriately configured view. For checkins this is always the current or "tip" view.

Specified by:
createSnapshotView in class StarTeamTask
Parameters:
raw - the unconfigured View
Returns:
the snapshot View appropriately configured.

testPreconditions

protected void testPreconditions()
                          throws BuildException
Implements base-class abstract function to define tests for any preconditons required by the task

Specified by:
testPreconditions in class TreeBasedTask
Throws:
BuildException - not thrown in this implementation
See Also:
execute()

visit

protected void visit(com.starbase.starteam.Folder starteamFolder,
                     java.io.File targetFolder)
              throws BuildException
Implements base-class abstract function to perform the checkout operation on the files in each folder of the tree.

Specified by:
visit in class TreeBasedTask
Parameters:
starteamFolder - the StarTeam folder to which files will be checked in
targetFolder - the local mapping of rootStarteamFolder
Throws:
BuildException - if any error occurs


Copyright 2000-2002 Apache Software Foundation. All Rights Reserved.