com.perforce.p4java.option.client
Class GetDiffFilesOptions

java.lang.Object
  extended by com.perforce.p4java.option.Options
      extended by com.perforce.p4java.option.client.GetDiffFilesOptions

public class GetDiffFilesOptions
extends Options

Options subclass for the IClient.getDiffFiles method.

See Also:
IClient.getDiffFiles(java.util.List, com.perforce.p4java.option.client.GetDiffFilesOptions)

Field Summary
protected  boolean diffNonTextFiles
          If true, diff non-text files.
protected  int maxFiles
          If non-zero, return only this many results.
protected  boolean openedDifferentMissing
          If true, report opened files that are different from the revision in the depot, or missing.
protected  boolean openedForIntegrate
          If true, report files that are opened for integrate.
protected  boolean openedSame
          If true, report opened files that are the same as the revision in the depot.
static String OPTIONS_SPECS
          Options: -m[max], -t, -s[x]
protected  boolean unopenedDifferent
          If true, report unopened files that are different from the revision in the depot.
protected  boolean unopenedMissing
          If true, report unopened files that are missing on the client.
protected  boolean unopenedWithStatus
          If true, report every unopened file, along with the status of 'same, 'diff', or 'missing' as compared to its revision in the depot.
 
Fields inherited from class com.perforce.p4java.option.Options
immutable, optionList, OPTPFX
 
Constructor Summary
GetDiffFilesOptions()
          Default constructor.
GetDiffFilesOptions(int maxFiles, boolean diffNonTextFiles, boolean openedDifferentMissing, boolean openedForIntegrate, boolean unopenedMissing, boolean unopenedDifferent, boolean unopenedWithStatus, boolean openedSame)
          Explicit-value constructor.
GetDiffFilesOptions(String... options)
          Strings-based constructor; see 'p4 help [command]' for possible options.
 
Method Summary
 int getMaxFiles()
           
 boolean isDiffNonTextFiles()
           
 boolean isOpenedDifferentMissing()
           
 boolean isOpenedForIntegrate()
           
 boolean isOpenedSame()
           
 boolean isUnopenedDifferent()
           
 boolean isUnopenedMissing()
           
 boolean isUnopenedWithStatus()
           
 List<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.
 GetDiffFilesOptions setDiffNonTextFiles(boolean diffNonTextFiles)
           
 GetDiffFilesOptions setMaxFiles(int maxFiles)
           
 GetDiffFilesOptions setOpenedDifferentMissing(boolean openedDifferentMissing)
           
 GetDiffFilesOptions setOpenedForIntegrate(boolean openedForIntegrate)
           
 GetDiffFilesOptions setOpenedSame(boolean openedSame)
           
 GetDiffFilesOptions setUnopenedDifferent(boolean unopenedDifferent)
           
 GetDiffFilesOptions setUnopenedMissing(boolean unopenedMissing)
           
 GetDiffFilesOptions setUnopenedWithStatus(boolean unopenedWithStatus)
           
 
Methods inherited from class com.perforce.p4java.option.Options
applyRule, 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 String OPTIONS_SPECS
Options: -m[max], -t, -s[x]

See Also:
Constant Field Values

maxFiles

protected int maxFiles
If non-zero, return only this many results. Corresponds to -m flag.


diffNonTextFiles

protected boolean diffNonTextFiles
If true, diff non-text files. Corresponds to -t flag.


openedDifferentMissing

protected boolean openedDifferentMissing
If true, report opened files that are different from the revision in the depot, or missing. Corresponds to -sa.


openedForIntegrate

protected boolean openedForIntegrate
If true, report files that are opened for integrate. Corresponds to -sb flag.


unopenedMissing

protected boolean unopenedMissing
If true, report unopened files that are missing on the client. Corresponds to -sd.


unopenedDifferent

protected boolean unopenedDifferent
If true, report unopened files that are different from the revision in the depot. Corresponds to -se flag.


unopenedWithStatus

protected boolean unopenedWithStatus
If true, report every unopened file, along with the status of 'same, 'diff', or 'missing' as compared to its revision in the depot. Corresponds to -sl.


openedSame

protected boolean openedSame
If true, report opened files that are the same as the revision in the depot. Corresponds to -sr.

Constructor Detail

GetDiffFilesOptions

public GetDiffFilesOptions()
Default constructor.


GetDiffFilesOptions

public GetDiffFilesOptions(String... options)
Strings-based constructor; see 'p4 help [command]' for possible options.

WARNING: you should not pass more than one option or argument in each string parameter. Each option or argument should be passed-in as its own separate string parameter, without any spaces between the option and the option value (if any).

NOTE: setting options this way always bypasses the internal options values, and getter methods against the individual values corresponding to the strings passed in to this constructor will not normally reflect the string's setting. Do not use this constructor unless you know what you're doing and / or you do not also use the field getters and setters.

See Also:
Options.Options(java.lang.String...)

GetDiffFilesOptions

public GetDiffFilesOptions(int maxFiles,
                           boolean diffNonTextFiles,
                           boolean openedDifferentMissing,
                           boolean openedForIntegrate,
                           boolean unopenedMissing,
                           boolean unopenedDifferent,
                           boolean unopenedWithStatus,
                           boolean openedSame)
Explicit-value constructor.

Method Detail

processOptions

public List<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)

getMaxFiles

public int getMaxFiles()

setMaxFiles

public GetDiffFilesOptions setMaxFiles(int maxFiles)

isDiffNonTextFiles

public boolean isDiffNonTextFiles()

setDiffNonTextFiles

public GetDiffFilesOptions setDiffNonTextFiles(boolean diffNonTextFiles)

isOpenedDifferentMissing

public boolean isOpenedDifferentMissing()

setOpenedDifferentMissing

public GetDiffFilesOptions setOpenedDifferentMissing(boolean openedDifferentMissing)

isOpenedForIntegrate

public boolean isOpenedForIntegrate()

setOpenedForIntegrate

public GetDiffFilesOptions setOpenedForIntegrate(boolean openedForIntegrate)

isUnopenedMissing

public boolean isUnopenedMissing()

setUnopenedMissing

public GetDiffFilesOptions setUnopenedMissing(boolean unopenedMissing)

isUnopenedDifferent

public boolean isUnopenedDifferent()

setUnopenedDifferent

public GetDiffFilesOptions setUnopenedDifferent(boolean unopenedDifferent)

isUnopenedWithStatus

public boolean isUnopenedWithStatus()

setUnopenedWithStatus

public GetDiffFilesOptions setUnopenedWithStatus(boolean unopenedWithStatus)

isOpenedSame

public boolean isOpenedSame()

setOpenedSame

public GetDiffFilesOptions setOpenedSame(boolean openedSame)


Copyright © 2015 Perforce Software. All Rights Reserved.