org.apache.tools.ant.taskdefs.optional.vss
Class MSVSS

java.lang.Object
  extended byorg.apache.tools.ant.ProjectComponent
      extended byorg.apache.tools.ant.Task
          extended byorg.apache.tools.ant.taskdefs.optional.vss.MSVSS
Direct Known Subclasses:
MSVSSADD, MSVSSCHECKIN, MSVSSCHECKOUT, MSVSSCP, MSVSSCREATE, MSVSSGET, MSVSSHISTORY, MSVSSLABEL

public abstract class MSVSS
extends Task

A base class for creating tasks for executing commands on Visual SourceSafe.

The class extends the 'exec' task as it operates by executing the ss.exe program supplied with SourceSafe. By default the task expects ss.exe to be in the path, you can override this be specifying the ssdir attribute.

This class provides set and get methods for 'login' and 'vsspath' attributes. It also contains constants for the flags that can be passed to SS.

Author:
Craig Cottingham, Andrew Everitt

Field Summary
static java.lang.String COMMAND_ADD
          The 'Add' command
static java.lang.String COMMAND_CHECKIN
          The 'Checkin' command
static java.lang.String COMMAND_CHECKOUT
          The 'Checkout' command
static java.lang.String COMMAND_CP
          The 'CP' command
static java.lang.String COMMAND_CREATE
          The 'Create' command
static java.lang.String COMMAND_GET
          The 'Get' command
static java.lang.String COMMAND_HISTORY
          The 'History' command
static java.lang.String COMMAND_LABEL
          The 'Label' command
static java.lang.String FLAG_AUTORESPONSE_DEF
           
static java.lang.String FLAG_AUTORESPONSE_NO
           
static java.lang.String FLAG_AUTORESPONSE_YES
           
static java.lang.String FLAG_LOGIN
           
static java.lang.String FLAG_OVERRIDE_WORKING_DIR
           
static java.lang.String FLAG_QUIET
           
static java.lang.String FLAG_RECURSION
           
static java.lang.String FLAG_VERSION
           
static java.lang.String FLAG_VERSION_DATE
           
static java.lang.String FLAG_VERSION_LABEL
           
static java.lang.String FLAG_WRITABLE
           
static java.lang.String PROJECT_PREFIX
           
static java.lang.String VALUE_NO
           
static java.lang.String VALUE_YES
           
 
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
MSVSS()
           
 
Method Summary
 void getLoginCommand(Commandline cmd)
           
 java.lang.String getSSCommand()
          Builds and returns the command string to execute ss.exe
 java.lang.String getVsspath()
           
protected  int run(Commandline cmd)
           
 void setLogin(java.lang.String login)
          The login to use when accessing VSS, formatted as "username,password"; optional.
 void setServerpath(java.lang.String serverPath)
          Set the directory where srssafe.ini resides; optional.
 void setSsdir(java.lang.String dir)
          directory where ss.exe resides; optional.
 void setVsspath(java.lang.String vssPath)
          SourceSafe path which specifies the project/file(s) you wish to perform the action on; required.
 
Methods inherited from class org.apache.tools.ant.Task
execute, getDescription, getLocation, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, handleErrorFlush, handleErrorOutput, handleFlush, 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
 

Field Detail

PROJECT_PREFIX

public static final java.lang.String PROJECT_PREFIX
See Also:
Constant Field Values

COMMAND_CP

public static final java.lang.String COMMAND_CP
The 'CP' command

See Also:
Constant Field Values

COMMAND_ADD

public static final java.lang.String COMMAND_ADD
The 'Add' command

See Also:
Constant Field Values

COMMAND_GET

public static final java.lang.String COMMAND_GET
The 'Get' command

See Also:
Constant Field Values

COMMAND_CHECKOUT

public static final java.lang.String COMMAND_CHECKOUT
The 'Checkout' command

See Also:
Constant Field Values

COMMAND_CHECKIN

public static final java.lang.String COMMAND_CHECKIN
The 'Checkin' command

See Also:
Constant Field Values

COMMAND_LABEL

public static final java.lang.String COMMAND_LABEL
The 'Label' command

See Also:
Constant Field Values

COMMAND_HISTORY

public static final java.lang.String COMMAND_HISTORY
The 'History' command

See Also:
Constant Field Values

COMMAND_CREATE

public static final java.lang.String COMMAND_CREATE
The 'Create' command

See Also:
Constant Field Values

FLAG_LOGIN

public static final java.lang.String FLAG_LOGIN
See Also:
Constant Field Values

FLAG_OVERRIDE_WORKING_DIR

public static final java.lang.String FLAG_OVERRIDE_WORKING_DIR
See Also:
Constant Field Values

FLAG_AUTORESPONSE_DEF

public static final java.lang.String FLAG_AUTORESPONSE_DEF
See Also:
Constant Field Values

FLAG_AUTORESPONSE_YES

public static final java.lang.String FLAG_AUTORESPONSE_YES
See Also:
Constant Field Values

FLAG_AUTORESPONSE_NO

public static final java.lang.String FLAG_AUTORESPONSE_NO
See Also:
Constant Field Values

FLAG_RECURSION

public static final java.lang.String FLAG_RECURSION
See Also:
Constant Field Values

FLAG_VERSION

public static final java.lang.String FLAG_VERSION
See Also:
Constant Field Values

FLAG_VERSION_DATE

public static final java.lang.String FLAG_VERSION_DATE
See Also:
Constant Field Values

FLAG_VERSION_LABEL

public static final java.lang.String FLAG_VERSION_LABEL
See Also:
Constant Field Values

FLAG_WRITABLE

public static final java.lang.String FLAG_WRITABLE
See Also:
Constant Field Values

VALUE_NO

public static final java.lang.String VALUE_NO
See Also:
Constant Field Values

VALUE_YES

public static final java.lang.String VALUE_YES
See Also:
Constant Field Values

FLAG_QUIET

public static final java.lang.String FLAG_QUIET
See Also:
Constant Field Values
Constructor Detail

MSVSS

public MSVSS()
Method Detail

setSsdir

public final void setSsdir(java.lang.String dir)
directory where ss.exe resides; optional. By default the task expects it to be in the PATH.

Parameters:
dir - the directory containing ss.exe

getSSCommand

public final java.lang.String getSSCommand()
Builds and returns the command string to execute ss.exe


setLogin

public final void setLogin(java.lang.String login)
The login to use when accessing VSS, formatted as "username,password"; optional.

You can omit the password if your database is not password protected. if you have a password and omit it, Ant/VSS will hang.

Parameters:
login - the login string to use

getLoginCommand

public void getLoginCommand(Commandline cmd)
Returns:
the appropriate login command if the 'login' attribute was specified, otherwise an empty string

setVsspath

public final void setVsspath(java.lang.String vssPath)
SourceSafe path which specifies the project/file(s) you wish to perform the action on; required. You should not specify the leading dollar-sign - it is prepended by Ant automatically.

Ant can't cope with a '$' sign in an attribute so we have to add it here. Also we strip off any 'vss://' prefix which is an XMS special and should probably be removed!

Parameters:
vssPath -
To do:
dont add a $ prefix if it has one

getVsspath

public java.lang.String getVsspath()
Returns:
m_vssPath

setServerpath

public final void setServerpath(java.lang.String serverPath)
Set the directory where srssafe.ini resides; optional.

Parameters:
serverPath -

run

protected int run(Commandline cmd)


Copyright © 2000-2003 Apache Software Foundation. All Rights Reserved.