com.perforce.p4java.option.server
Class GetChangelistsOptions

java.lang.Object
  com.perforce.p4java.option.Options
      com.perforce.p4java.option.server.GetChangelistsOptions

public class GetChangelistsOptions
extends Options

Options class for IOptionsServer getChangelists method(s).

See Also:

IOptionsServer.getChangelists(java.util.List, com.perforce.p4java.option.server.GetChangelistsOptions)

Field Summary

protected java.lang.String	clientName If non-null, restrict the results to changelists associated with the given client.
protected boolean	includeIntegrated If true, also include any changelists integrated into the specified files (if any).
protected boolean	longDesc If true, produce a non-truncated long version of the description.
protected int	maxMostRecent If positive, restrict the list to the maxMostRecent most recent changelists.
static java.lang.String	OPTIONS_SPECS Recognized p4 changes options: -i -l -cclient -mmax -sstatus -uuser
protected IChangelist.Type	type If not null, restrict output to pending, shelved or submitted changelists.
protected java.lang.String	userName If non-null, restrict the results to changelists associated with the given user name.

Fields inherited from class com.perforce.p4java.option.Options

immutable, optionList, OPTPFX

Constructor Summary

GetChangelistsOptions()
Default constructor; sets all fields to null, zero, or false.

GetChangelistsOptions(int maxMostRecent, java.lang.String clientName, java.lang.String userName, boolean includeIntegrated, IChangelist.Type type, boolean longDesc)
Explicit-value constructor.

GetChangelistsOptions(java.lang.String... options)
String-based constructor; known options include -i -l -cclient -mmax -sstatus -uuser.

Method Summary

java.lang.String	getClientName()
int	getMaxMostRecent()
IChangelist.Type	getType()
java.lang.String	getUserName()
boolean	isIncludeIntegrated()
boolean	isLongDesc()
java.util.List<java.lang.String>	processOptions(IServer server) Turn this (specific) options object into a list of strings to be sent to the Perforce server as options for a specific command.
GetChangelistsOptions	setClientName(java.lang.String clientName)
GetChangelistsOptions	setIncludeIntegrated(boolean includeIntegrated)
GetChangelistsOptions	setLongDesc(boolean longDesc)
GetChangelistsOptions	setMaxMostRecent(int maxMostRecent)
GetChangelistsOptions	setType(IChangelist.Type type)
GetChangelistsOptions	setUserName(java.lang.String userName)

Methods inherited from class com.perforce.p4java.option.Options

applyRule, applyRule, applyRule, getOptions, isImmutable, processFields, setImmutable, setOptions

Methods inherited from class java.lang.Object

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

Field Detail

OPTIONS_SPECS

public static final java.lang.String OPTIONS_SPECS

Recognized p4 changes options: -i -l -cclient -mmax -sstatus -uuser

See Also:

Constant Field Values

maxMostRecent

protected int maxMostRecent

If positive, restrict the list to the maxMostRecent most recent changelists. Corresponds to -mmax.

clientName

protected java.lang.String clientName

If non-null, restrict the results to changelists associated with the given client. Corresponds to -cclient flag.

userName

protected java.lang.String userName

If non-null, restrict the results to changelists associated with the given user name. Corresponds to -uuser flag.

includeIntegrated

protected boolean includeIntegrated

If true, also include any changelists integrated into the specified files (if any). Corresponds to -i flag.

type

protected IChangelist.Type type

If not null, restrict output to pending, shelved or submitted changelists. Corresponds to -sstatus flag.

longDesc

protected boolean longDesc

If true, produce a non-truncated long version of the description. Corresponds to the -l flag.

Constructor Detail

GetChangelistsOptions

public GetChangelistsOptions()

Default constructor; sets all fields to null, zero, or false.

GetChangelistsOptions

public GetChangelistsOptions(java.lang.String... options)

String-based constructor; known options include -i -l -cclient -mmax -sstatus -uuser.

Parameters:

options - string options

GetChangelistsOptions

public GetChangelistsOptions(int maxMostRecent,
                             java.lang.String clientName,
                             java.lang.String userName,
                             boolean includeIntegrated,
                             IChangelist.Type type,
                             boolean longDesc)

Explicit-value constructor.

Method Detail

processOptions

public java.util.List<java.lang.String> processOptions(IServer server)
                                                throws OptionsException

Description copied from class: Options

Turn this (specific) options object into a list of strings to be sent to the Perforce server as options for a specific command. As a side effect, set the option list associated with this Option to the result.

The method is used by the server object to generate the string-based arguments expected by the Perforce server corresponding to the state of this method-specific options object. Will return an empty list if there are no "interesting" options set or available. May simply return the superclass options string list if is non-null, but that behaviour is neither guaranteed nor required.

Note that this method is not intended to be called directly by users but by the underlying P4Java plumbing; odd results may occur if this method is called in other contexts.

Specified by:

processOptions in class Options

Parameters:

server - possibly-null IServer representing the Perforce server the options are to be used against. If this parameter is null, it is acceptable to throw an OptionsException, but it is also possible to ignore it and do the best you can with what you've got...

Returns:

non-null (but possibly empty) string list representing the normalized Perforce server arguments corresponding to the state of this specific options object.

Throws:

OptionsException - if an error occurs in options processing that is not some species of ConnectionException, RequestException, AccessException, etc.

See Also:

Options.processOptions(com.perforce.p4java.server.IServer)

getMaxMostRecent

public int getMaxMostRecent()

setMaxMostRecent

public GetChangelistsOptions setMaxMostRecent(int maxMostRecent)

getClientName

public java.lang.String getClientName()

setClientName

public GetChangelistsOptions setClientName(java.lang.String clientName)

getUserName

public java.lang.String getUserName()

setUserName

public GetChangelistsOptions setUserName(java.lang.String userName)

isIncludeIntegrated

public boolean isIncludeIntegrated()

setIncludeIntegrated

public GetChangelistsOptions setIncludeIntegrated(boolean includeIntegrated)

getType

public IChangelist.Type getType()

setType

public GetChangelistsOptions setType(IChangelist.Type type)

isLongDesc

public boolean isLongDesc()

setLongDesc

public GetChangelistsOptions setLongDesc(boolean longDesc)