Prev Class | Next Class | Frames | No Frames |
Summary: Nested | Field | Method | Constr | Detail: Nested | Field | Method | Constr |
public interface SVNClientInterface
Method Summary | |
void |
|
void |
|
byte[] | |
void |
|
void |
|
void |
|
long | |
long | |
void |
|
long |
|
long |
|
void |
|
void | |
void | |
void | |
void | |
void |
|
long | |
long | |
void |
|
long | |
byte[] |
|
byte[] |
|
String | |
String |
|
String |
|
Version | |
String |
|
Info |
|
Info2[] | |
boolean |
|
DirEntry[] | |
DirEntry[] | |
void |
|
LogMessage[] |
|
LogMessage[] |
|
LogMessage[] |
|
LogMessage[] |
|
void | |
void | |
void | |
void |
|
void |
|
void | |
void |
|
void |
|
void |
|
PropertyData[] |
|
PropertyData[] |
|
PropertyData[] |
|
void |
|
void |
|
void |
|
void |
|
PropertyData |
|
PropertyData |
|
PropertyData |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
PropertyData[] |
|
PropertyData |
|
void |
|
void |
|
void |
|
void |
|
Status |
|
Status[] |
|
Status[] |
|
Status[] |
|
void |
|
void |
|
long | |
long[] | |
void |
|
public void add(String path, boolean recurse) throws ClientException
Adds a file to the repository.
- Parameters:
path
- path to be added.recurse
- recurse into subdirectories
- Throws:
ClientException
-
public void add(String path, boolean recurse, boolean force) throws ClientException
Adds a file to the repository.
- Parameters:
path
- path to be added.recurse
- recurse into subdirectoriesforce
- if adding a directory and recurse true and path is a directory, all not already managed files are added.
- Throws:
ClientException
-
- Since:
- 1.2
public byte[] blame(String path, Revision revisionStart, Revision revisionEnd) throws ClientException
Deprecated.
Return for each line of the file, the author and the revision of the last together with the content.
- Parameters:
path
- the pathrevisionStart
- the first revision to showrevisionEnd
- the last revision to show
- Returns:
- the content together with author and revision of last change
- Throws:
ClientException
-
public void blame(String path, Revision revisionStart, Revision revisionEnd, BlameCallback callback) throws ClientException
Retrieve the content together with the author, the revision and the date of the last change of each line
- Parameters:
path
- the pathrevisionStart
- the first revision to showrevisionEnd
- the last revision to showcallback
- callback to receive the file content and the other information
- Throws:
ClientException
-
public void blame(String path, Revision pegRevision, Revision revisionStart, Revision revisionEnd, BlameCallback callback) throws ClientException
Retrieve the content together with the author, the revision and the date of the last change of each line
- Parameters:
path
- the pathpegRevision
- the revision to interpret the pathrevisionStart
- the first revision to showrevisionEnd
- the last revision to showcallback
- callback to receive the file content and the other information
- Throws:
ClientException
-
- Since:
- 1.2
public void cancelOperation() throws ClientException
cancel the active operation
- Throws:
ClientException
-
public long checkout(String moduleName, String destPath, Revision revision, boolean recurse) throws ClientException
Executes a revision checkout.
- Parameters:
moduleName
- name of the module to checkout.destPath
- destination directory for checkout.revision
- the revision to checkout.recurse
- whether you want it to checkout files recursively.
- Throws:
ClientException
-
public long checkout(String moduleName, String destPath, Revision revision, Revision pegRevision, boolean recurse, boolean ignoreExternals) throws ClientException
Executes a revision checkout.
- Parameters:
moduleName
- name of the module to checkout.destPath
- destination directory for checkout.revision
- the revision to checkout.pegRevision
- the peg revision to interpret the pathrecurse
- whether you want it to checkout files recursively.ignoreExternals
- if externals are ignored during checkout
- Throws:
ClientException
-
- Since:
- 1.2
public void cleanup(String path) throws ClientException
Recursively cleans up a local directory, finishing any incomplete operations, removing lockfiles, etc.
- Parameters:
path
- a local directory.
- Throws:
ClientException
-
public long commit(String[] path, String message, boolean recurse) throws ClientException
Commits changes to the repository.
- Parameters:
path
- files to commit.message
- log message.recurse
- whether the operation should be done recursively.
- Returns:
- Returns a long representing the revision. It returns a -1 if the revision number is invalid.
- Throws:
ClientException
-
public long commit(String[] path, String message, boolean recurse, boolean noUnlock) throws ClientException
Commits changes to the repository.
- Parameters:
path
- files to commit.message
- log message.recurse
- whether the operation should be done recursively.noUnlock
- do remove any locks
- Returns:
- Returns a long representing the revision. It returns a -1 if the revision number is invalid.
- Throws:
ClientException
-
public void commitMessageHandler(CommitMessage messageHandler)
Sets the commit message handler. This allows more complex commit message with the list of the elements to be commited as input.
- Parameters:
messageHandler
- callback for entering commit messages if this is set the message parameter is ignored.
public void copy(String srcPath, String destPath, String message, Revision revision) throws ClientException
Copies a versioned file with the history preserved.
- Parameters:
srcPath
- source path or urldestPath
- destination path or urlmessage
- commit message if destPath is an urlrevision
- source revision
- Throws:
ClientException
-
public void diff(String target1, Revision revision1, String target2, Revision revision2, String outFileName, boolean recurse) throws ClientException
Display the differences between two paths
- Parameters:
target1
- first path or urlrevision1
- first revisiontarget2
- second path or urlrevision2
- second revisionoutFileName
- file name where difference are writtenrecurse
- traverse into subdirectories
- Throws:
ClientException
-
public void diff(String target1, Revision revision1, String target2, Revision revision2, String outFileName, boolean recurse, boolean ignoreAncestry, boolean noDiffDeleted, boolean force) throws ClientException
Display the differences between two paths
- Parameters:
target1
- first path or urlrevision1
- first revisiontarget2
- second path or urlrevision2
- second revisionoutFileName
- file name where difference are writtenrecurse
- traverse into subdirectoriesignoreAncestry
- ignore if files are not relatednoDiffDeleted
- no output on deleted filesforce
- diff even on binary files
- Throws:
ClientException
-
- Since:
- 1.2
public void diff(String target, Revision pegRevision, Revision startRevision, Revision endRevision, String outFileName, boolean recurse, boolean ignoreAncestry, boolean noDiffDeleted, boolean force) throws ClientException
Display the differences between two paths
- Parameters:
target
- path or urlpegRevision
- revision tointerpret targetstartRevision
- first Revision to compareendRevision
- second Revision to compareoutFileName
- file name where difference are writtenrecurse
- traverse into subdirectoriesignoreAncestry
- ignore if files are not relatednoDiffDeleted
- no output on deleted filesforce
- diff even on binary files
- Throws:
ClientException
-
- Since:
- 1.2
public void dispose()
release the native peer (should not depend on finalize)
public long doExport(String srcPath, String destPath, Revision revision, boolean force) throws ClientException
Exports the contents of either a subversion repository into a 'clean' directory (meaning a directory with no administrative directories).
- Parameters:
srcPath
- the url of the repository path to be exporteddestPath
- a destination path that must not already exist.revision
- the revsion to be exportedforce
- set if it is ok to overwrite local files
- Throws:
ClientException
-
public long doExport(String srcPath, String destPath, Revision revision, Revision pegRevision, boolean force, boolean ignoreExternals, boolean recurse, String nativeEOL) throws ClientException
Exports the contents of either a subversion repository into a 'clean' directory (meaning a directory with no administrative directories).
- Parameters:
srcPath
- the url of the repository path to be exporteddestPath
- a destination path that must not already exist.revision
- the revsion to be exportedpegRevision
- the revision to interpret srcPathforce
- set if it is ok to overwrite local filesignoreExternals
- ignore external during exportrecurse
- recurse to subdirectoriesnativeEOL
- which EOL characters to use during export
- Throws:
ClientException
-
- Since:
- 1.2
public void doImport(String path, String url, String message, boolean recurse) throws ClientException
Import a file or directory into a repository directory at head.
- Parameters:
path
- the local pathurl
- the target urlmessage
- the log message.recurse
- traverse into subdirectories
- Throws:
ClientException
-
public long doSwitch(String path, String url, Revision revision, boolean recurse) throws ClientException
Update local copy to mirror a new url.
- Parameters:
path
- the working copy pathurl
- the new url for the working copyrevision
- the new base revision of working copyrecurse
- traverse into subdirectories
- Throws:
ClientException
-
public byte[] fileContent(String path, Revision revision) throws ClientException
Retrieve the content of a file
- Parameters:
path
- the path of the filerevision
- the revision to retrieve
- Returns:
- the content as byte array
- Throws:
ClientException
-
public byte[] fileContent(String path, Revision revision, Revision pegRevision) throws ClientException
Retrieve the content of a file
- Parameters:
path
- the path of the filerevision
- the revision to retrievepegRevision
- the revision to interpret path
- Returns:
- the content as byte array
- Throws:
ClientException
-
- Since:
- 1.2
public String getAdminDirectoryName()
- Returns:
- The name of the working copy's administrative directory, which is usually
.svn
.
- Since:
- 1.3
- See Also:
Instructions on changing this as a work-around for the behavior of ASP.Net on Windows.
public String getConfigDirectory() throws ClientException
Get the configuration directory
- Returns:
- the directory
- Throws:
ClientException
-
public String getLastPath()
Deprecated.
Returns the last destination path submitted.
- Returns:
- path in Subversion format.
public Version getVersion()
- Returns:
- Version information about the underlying native libraries.
public String getVersionInfo(String path, String trailUrl, boolean lastChanged) throws ClientException
Produce a compact "version number" for a working copy
- Parameters:
path
- path of the working copytrailUrl
- to detect switches of the whole working copylastChanged
- last changed rather than current revisions
- Returns:
- the compact "version number"
- Throws:
ClientException
-
- Since:
- 1.2
public Info info(String path) throws ClientException
Retrieves the working copy information for an item
- Parameters:
path
- path of the item
- Returns:
- the information object
- Throws:
ClientException
-
public Info2[] info2(String pathOrUrl, Revision revision, Revision pegRevision, boolean recurse) throws ClientException
Retrieve information about repository or working copy items.
- Parameters:
pathOrUrl
- the path or the url of the itemrevision
- the revision of the item to returnpegRevision
- the revision to interpret pathOrUrlrecurse
- flag if to recurse, if the item is a directory
- Returns:
- the information objects
- Since:
- 1.2
public boolean isAdminDirectory(String name)
- Parameters:
name
- The name of the directory to compare.
- Returns:
- Whether
name
is that of a working copy administrative directory.
- Since:
- 1.3
public DirEntry[] list(String url, Revision revision, boolean recurse) throws ClientException
Lists the directory entries of an url on the server.
- Parameters:
url
- the url to listrevision
- the revision to listrecurse
- recurse into subdirectories
- Returns:
- Array of DirEntry objects.
public DirEntry[] list(String url, Revision revision, Revision pegRevision, boolean recurse) throws ClientException
Lists the directory entries of an url on the server.
- Parameters:
url
- the url to listrevision
- the revision to listpegRevision
- the revision to interpret urlrecurse
- recurse into subdirectories
- Returns:
- Array of DirEntry objects.
- Since:
- 1.2
public void lock(String[] path, String comment, boolean force) throws ClientException
Lock a working copy item
- Parameters:
path
- path of the itemcomment
-force
- break an existing lock
- Throws:
ClientException
-
- Since:
- 1.2
public LogMessage[] logMessages(String path, Revision revisionStart, Revision revisionEnd) throws ClientException
Retrieve the log messages for an item
- Parameters:
path
- path or url to get the log message for.revisionStart
- first revision to showrevisionEnd
- last revision to show
- Returns:
- array of LogMessages
public LogMessage[] logMessages(String path, Revision revisionStart, Revision revisionEnd, boolean stopOnCopy) throws ClientException
Retrieve the log messages for an item
- Parameters:
path
- path or url to get the log message for.revisionStart
- first revision to showrevisionEnd
- last revision to showstopOnCopy
- do not continue on copy operations
- Returns:
- array of LogMessages
public LogMessage[] logMessages(String path, Revision revisionStart, Revision revisionEnd, boolean stopOnCopy, boolean discoverPath) throws ClientException
Retrieve the log messages for an item
- Parameters:
path
- path or url to get the log message for.revisionStart
- first revision to showrevisionEnd
- last revision to showstopOnCopy
- do not continue on copy operationsdiscoverPath
- returns the paths of the changed items in the returned objects
- Returns:
- array of LogMessages
public LogMessage[] logMessages(String path, Revision revisionStart, Revision revisionEnd, boolean stopOnCopy, boolean discoverPath, long limit) throws ClientException
Retrieve the log messages for an item
- Parameters:
path
- path or url to get the log message for.revisionStart
- first revision to showrevisionEnd
- last revision to showstopOnCopy
- do not continue on copy operationsdiscoverPath
- returns the paths of the changed items in the returned objectslimit
- limit the number of log messages (if 0 or less no limit)
- Returns:
- array of LogMessages
- Since:
- 1.2
public void merge(String path1, Revision revision1, String path2, Revision revision2, String localPath, boolean force, boolean recurse) throws ClientException
Merge changes from two paths into a new local path.
- Parameters:
path1
- first path or urlrevision1
- first revisionpath2
- second path or urlrevision2
- second revisionlocalPath
- target local pathforce
- overwrite local changesrecurse
- traverse into subdirectories
- Throws:
ClientException
-
public void merge(String path1, Revision revision1, String path2, Revision revision2, String localPath, boolean force, boolean recurse, boolean ignoreAncestry, boolean dryRun) throws ClientException
Merge changes from two paths into a new local path.
- Parameters:
path1
- first path or urlrevision1
- first revisionpath2
- second path or urlrevision2
- second revisionlocalPath
- target local pathforce
- overwrite local changesrecurse
- traverse into subdirectoriesignoreAncestry
- ignore if files are not relateddryRun
- do not change anything
- Throws:
ClientException
-
- Since:
- 1.2
public void merge(String path, Revision pegRevision, Revision revision1, Revision revision2, String localPath, boolean force, boolean recurse, boolean ignoreAncestry, boolean dryRun) throws ClientException
Merge changes from two paths into a new local path.
- Parameters:
path
- path or urlpegRevision
- revision to interpret pathrevision1
- first revisionrevision2
- second revisionlocalPath
- target local pathforce
- overwrite local changesrecurse
- traverse into subdirectoriesignoreAncestry
- ignore if files are not relateddryRun
- do not change anything
- Throws:
ClientException
-
- Since:
- 1.2
public void mkdir(String[] path, String message) throws ClientException
Creates a directory directly in a repository or creates a directory on disk and schedules it for addition.
- Parameters:
path
- directories to be createdmessage
- commit message to used if path contains urls
- Throws:
ClientException
-
public void move(String srcPath, String destPath, String message, boolean force) throws ClientException
Moves or renames a file.
- Parameters:
srcPath
- source path or urldestPath
- destination path or urlmessage
- commit message if destPath is an urlforce
- even with local modifications.
- Throws:
ClientException
-
- Since:
- 1.2
public void move(String srcPath, String destPath, String message, Revision revision, boolean force) throws ClientException
Moves or renames a file.
- Parameters:
srcPath
- source path or urldestPath
- destination path or urlmessage
- commit message if destPath is an urlrevision
- source revision (unused)force
- even with local modifications.
- Throws:
ClientException
-
public void notification(Notify notify)
Deprecated. use notification2 instead
Sets the notification callback used to send processing information back to the calling program.
- Parameters:
notify
- listener that the SVN library should call on many file operations.
public void notification2(Notify2 notify)
Sets the notification callback used to send processing information back to the calling program.
- Parameters:
notify
- listener that the SVN library should call on many file operations.
- Since:
- 1.2
public void password(String password)
Sets the password used for authentication.
- Parameters:
password
- The password, ignored if the empty string. Set to the empty string to clear it.
- See Also:
username(String)
public PropertyData[] properties(String path) throws ClientException
Retrieves the properties of an item
- Parameters:
path
- the path of the item
- Returns:
- array of property objects
public PropertyData[] properties(String path, Revision revision) throws ClientException
Retrieves the properties of an item
- Parameters:
path
- the path of the itemrevision
- the revision of the item
- Returns:
- array of property objects
- Since:
- 1.2
public PropertyData[] properties(String path, Revision revision, Revision pegRevision) throws ClientException
Retrieves the properties of an item
- Parameters:
path
- the path of the itemrevision
- the revision of the itempegRevision
- the revision to interpret path
- Returns:
- array of property objects
- Since:
- 1.2
public void propertyCreate(String path, String name, String value, boolean recurse) throws ClientException
Create and sets one property of an item with a String value
- Parameters:
path
- path of the itemname
- name of the propertyvalue
- new value of the propertyrecurse
- set property also on the subdirectories
- Throws:
ClientException
-
public void propertyCreate(String path, String name, String value, boolean recurse, boolean force) throws ClientException
Create and sets one property of an item with a String value
- Parameters:
path
- path of the itemname
- name of the propertyvalue
- new value of the propertyrecurse
- set property also on the subdirectoriesforce
- do not check if the value is valid
- Throws:
ClientException
-
- Since:
- 1.2
public void propertyCreate(String path, String name, byte[] value, boolean recurse) throws ClientException
Create and sets one property of an item with a byte array value
- Parameters:
path
- path of the itemname
- name of the propertyvalue
- new value of the propertyrecurse
- set property also on the subdirectories
- Throws:
ClientException
-
public void propertyCreate(String path, String name, byte[] value, boolean recurse, boolean force) throws ClientException
Create and sets one property of an item with a byte array value
- Parameters:
path
- path of the itemname
- name of the propertyvalue
- new value of the propertyrecurse
- set property also on the subdirectoriesforce
- do not check if the value is valid
- Throws:
ClientException
-
- Since:
- 1.2
public PropertyData propertyGet(String path, String name) throws ClientException
Retrieve one property of one iten
- Parameters:
path
- path of the itemname
- name of property
- Returns:
- the Property
- Throws:
ClientException
-
public PropertyData propertyGet(String path, String name, Revision revision) throws ClientException
Retrieve one property of one iten
- Parameters:
path
- path of the itemname
- name of propertyrevision
- revision of the item
- Returns:
- the Property
- Throws:
ClientException
-
- Since:
- 1.2
public PropertyData propertyGet(String path, String name, Revision revision, Revision pegRevision) throws ClientException
Retrieve one property of one iten
- Parameters:
path
- path of the itemname
- name of propertyrevision
- revision of the itempegRevision
- the revision to interpret path
- Returns:
- the Property
- Throws:
ClientException
-
- Since:
- 1.2
public void propertyRemove(String path, String name, boolean recurse) throws ClientException
Remove one property of an item.
- Parameters:
path
- path of the itemname
- name of the propertyrecurse
- remove the property also on subdirectories
- Throws:
ClientException
-
public void propertySet(String path, String name, String value, boolean recurse) throws ClientException
Sets one property of an item with a String value
- Parameters:
path
- path of the itemname
- name of the propertyvalue
- new value of the propertyrecurse
- set property also on the subdirectories
- Throws:
ClientException
-
public void propertySet(String path, String name, String value, boolean recurse, boolean force) throws ClientException
Sets one property of an item with a String value
- Parameters:
path
- path of the itemname
- name of the propertyvalue
- new value of the propertyrecurse
- set property also on the subdirectoriesforce
- do not check if the value is valid
- Throws:
ClientException
-
- Since:
- 1.2
public void propertySet(String path, String name, byte[] value, boolean recurse) throws ClientException
Sets one property of an item with a byte array value
- Parameters:
path
- path of the itemname
- name of the propertyvalue
- new value of the propertyrecurse
- set property also on the subdirectories
- Throws:
ClientException
-
public void propertySet(String path, String name, byte[] value, boolean recurse, boolean force) throws ClientException
Sets one property of an item with a byte array value
- Parameters:
path
- path of the itemname
- name of the propertyvalue
- new value of the propertyrecurse
- set property also on the subdirectoriesforce
- do not check if the value is valid
- Throws:
ClientException
-
- Since:
- 1.2
public void relocate(String from, String to, String path, boolean recurse) throws ClientException
Rewrite the url's in the working copy
- Parameters:
from
- old urlto
- new urlpath
- working copy pathrecurse
- recurse into subdirectories
- Throws:
ClientException
-
public void remove(String[] path, String message, boolean force) throws ClientException
Sets a file for deletion.
- Parameters:
path
- path or url to be deletedmessage
- if path is a url, this will be the commit message.force
- delete even when there are local modifications.
- Throws:
ClientException
-
public void resolved(String path, boolean recurse) throws ClientException
Removes the 'conflicted' state on a file.
- Parameters:
path
- path to cleanuprecurse
- recurce into subdirectories
- Throws:
ClientException
-
public PropertyData[] revProperties(String path, Revision rev) throws ClientException
Retrieve all revsision properties of one item
- Parameters:
path
- path of the itemrev
- revision to retrieve
- Returns:
- the Properties
- Throws:
ClientException
-
- Since:
- 1.2
public PropertyData revProperty(String path, String name, Revision rev) throws ClientException
Retrieve one revsision property of one item
- Parameters:
path
- path of the itemname
- name of the propertyrev
- revision to retrieve
- Returns:
- the Property
- Throws:
ClientException
-
public void revert(String path, boolean recurse) throws ClientException
Reverts a file to a pristine state.
- Parameters:
path
- path of the file.recurse
- recurse into subdirectories
- Throws:
ClientException
-
public void setConfigDirectory(String configDir) throws ClientException
Set directory for the configuration information, taking the usual steps to ensure that Subversion's config file templates exist in the specified location.
- Parameters:
configDir
- path of the directory
- Throws:
ClientException
-
public void setPrompt(PromptUserPassword prompt)
Register callback interface to supply username and password on demand
- Parameters:
prompt
- the callback interface
public void setRevProperty(String path, String name, Revision rev, String value, boolean force) throws ClientException
set one revsision property of one item
- Parameters:
path
- path of the itemname
- name of the propertyrev
- revision to retrievevalue
- value of the propertyforce
- use force to set
- Throws:
ClientException
-
- Since:
- 1.2
public Status singleStatus(String path, boolean onServer) throws ClientException
Returns the status of a single file in the path.
- Parameters:
path
- File to gather status.onServer
- Request status information from the server.
- Returns:
- the subversion status of the file.
public Status[] status(String path, boolean descend, boolean onServer, boolean getAll) throws ClientException
List a directory or file of the working copy.
- Parameters:
path
- Path to explore.descend
- Recurse into subdirectories if they exist.onServer
- Request status information from server.getAll
- get status for uninteristing files (unchanged).
- Returns:
- Array of Status entries.
public Status[] status(String path, boolean descend, boolean onServer, boolean getAll, boolean noIgnore) throws ClientException
List a directory or file of the working copy.
- Parameters:
path
- Path to explore.descend
- Recurse into subdirectories if they exist.onServer
- Request status information from server.getAll
- get status for uninteristing files (unchanged).noIgnore
- get status for normaly ignored files and directories.
- Returns:
- Array of Status entries.
public Status[] status(String path, boolean descend, boolean onServer, boolean getAll, boolean noIgnore, boolean ignoreExternals) throws ClientException
List a directory or file of the working copy.
- Parameters:
path
- Path to explore.descend
- Recurse into subdirectories if they exist.onServer
- Request status information from server.getAll
- get status for uninteristing files (unchanged).noIgnore
- get status for normaly ignored files and directories.ignoreExternals
- if externals are ignored during status
- Returns:
- Array of Status entries.
- Since:
- 1.2
public void streamFileContent(String path, Revision revision, Revision pegRevision, int bufferSize, OutputStream stream) throws ClientException
Write the file's content to the specified output stream. If you need an InputStream, use a PipedInputStream/PipedOutputStream combination.
- Parameters:
path
- the path of the filerevision
- the revision to retrievepegRevision
- the revision at which to interpret the path
- Throws:
ClientException
-
- See Also:
PipedOutputStream
,PipedInputStream
public void unlock(String[] path, boolean force) throws ClientException
Unlock a working copy item
- Parameters:
path
- path of the itemforce
- break an existing lock
- Throws:
ClientException
-
- Since:
- 1.2
public long update(String path, Revision revision, boolean recurse) throws ClientException
Updates the directory or file from repository
- Parameters:
path
- target file.revision
- the revision number to update. Revision.HEAD will update to the latest revision.recurse
- recursively update.
- Throws:
ClientException
-
public long[] update(String[] path, Revision revision, boolean recurse, boolean ignoreExternals) throws ClientException
Updates the directories or files from repository
- Parameters:
path
- array of target files.revision
- the revision number to update. Revision.HEAD will update to the latest revision.recurse
- recursively update.ignoreExternals
- if externals are ignored during update
- Throws:
ClientException
-
- Since:
- 1.2
public void username(String username)
Sets the username used for authentication.
- Parameters:
username
- The username, ignored if the empty string. Set to the empty string to clear it.
- See Also:
password(String)