Package com.perforce.p4java.impl.mapbased.server.cmd

Class FstatDelegator

    • Constructor Detail

      • FstatDelegator

        public FstatDelegator​(IOptionsServer server)
        Instantiates a new fstat delegator.
        Parameters:
        server - the server

    • Method Detail

      • getExtendedFiles

        public java.util.List<IExtendedFileSpec> getExtendedFiles​(java.util.List<IFileSpec> fileSpecs,
                                                          int maxFiles,
                                                          int sinceChangelist,
                                                          int affectedByChangelist,
                                                          FileStatOutputOptions outputOptions,
                                                          FileStatAncilliaryOptions ancilliaryOptions)
                                                   throws ConnectionException,
                                                          AccessException
        Description copied from interface: IFstatDelegator
        Return a list of everything Perforce knows about a possibly very large set of Perforce files.

        This method is not intended for general use, and is not documented in detail here; consult the main Perforce fstat command documentation for detailed help. In particular, the various options are too complex to be described in a few sentences here, and the various option arguments reflect this complexity. Note that setting both sinceChangelist and affectedByChangelist to zero or a positive value will cause usage errors from the server (these are currently intended to be mutually-exclusive options).

        This method can be a real server and bandwidth resource hog, and should be used as sparingly as possible; alternatively, try to use it with as narrow a set of file specs as possible.

        Specified by:
        getExtendedFiles in interface IFstatDelegator
        Parameters:
        fileSpecs - non-null list of Perforce file specification(s)
        maxFiles - if positive, restrict the output to the first maxReturns files. Implementations are free to ignore this parameter if necessary (and return all qualifying results).
        sinceChangelist - if larger than or equal to zero, display only files affected since the given changelist number; zero is equivalent to IChangelist.DEFAULT.
        affectedByChangelist - if larger than or equal to zero, display only files affected by the given changelist number; zero is equivalent to IChangelist.DEFAULT.
        outputOptions - if non-null, specifies the oputput options to be used
        ancilliaryOptions - if non-null, specifies the ancilliary output options to be used
        Returns:
        a non-null (but possibly empty) list of qualifying files and associated stat info
        Throws:
        ConnectionException - if the Perforce server is unreachable or is not connected.
        AccessException - if the Perforce server denies access to the caller

      • getExtendedFiles

        public java.util.List<IExtendedFileSpec> getExtendedFiles​(java.util.List<IFileSpec> fileSpecs,
                                                          GetExtendedFilesOptions opts)
                                                   throws P4JavaException
        Description copied from interface: IFstatDelegator
        Return a list of everything Perforce knows about a set of Perforce files.

        This method is not intended for general use, and is not documented in detail here; consult the main Perforce fstat command documentation for detailed help. This method can be a real server and bandwidth resource hog, and should be used as sparingly as possible; alternatively, try to use it with as narrow a set of file specs as possible.

        Specified by:
        getExtendedFiles in interface IFstatDelegator
        Parameters:
        fileSpecs - non-null list of Perforce file specification(s).
        opts - GetExtendedFilesOptions object describing optional parameters; if null, no options are set.
        Returns:
        non-null (but possibly empty) list of qualifying files and associated stat info.
        Throws:
        P4JavaException - if an error occurs processing this method and its parameters.