com.perforce.p4java.server.delegator

Interface IGrepDelegator

All Known Subinterfaces:

IOptionsServer, IServer, IStreamingServer

All Known Implementing Classes:

GrepDelegator, NtsServerImpl, OneShotServerImpl, RpcServer, Server

public interface IGrepDelegator

The Interface for 'p4 grep' implementations.

Method Summary

Modifier and Type	Method and Description
java.util.List<IFileLineMatch>	getMatchingLines(java.util.List<IFileSpec> fileSpecs, java.lang.String pattern, java.util.List<java.lang.String> infoLines, MatchingLinesOptions options) Get list of matching lines in the specified file specs.
java.util.List<IFileLineMatch>	getMatchingLines(java.util.List<IFileSpec> fileSpecs, java.lang.String pattern, MatchingLinesOptions options) Get list of matching lines in the specified file specs.

Method Detail

getMatchingLines

java.util.List<IFileLineMatch> getMatchingLines(java.util.List<IFileSpec> fileSpecs,
                                                java.lang.String pattern,
                                                MatchingLinesOptions options)
                                         throws P4JavaException

Get list of matching lines in the specified file specs. This method implements the p4 grep command; for full semantics, see the separate p4 documentation and / or the GrepOptions Javadoc.

Parameters:

fileSpecs - file specs to search for matching lines

pattern - non-null string pattern to be passed to the grep command

options - - Options to grep command

Returns:

- non-null but possibly empty list of file line matches

Throws:

P4JavaException - if any error occurs in the processing of this method.

getMatchingLines

java.util.List<IFileLineMatch> getMatchingLines(@Nonnull
                                                java.util.List<IFileSpec> fileSpecs,
                                                @Nonnull
                                                java.lang.String pattern,
                                                @Nullable
                                                java.util.List<java.lang.String> infoLines,
                                                MatchingLinesOptions options)
                                         throws P4JavaException

Get list of matching lines in the specified file specs. This method implements the p4 grep command; for full semantics, see the separate p4 documentation and / or the GrepOptions Javadoc.

This method allows the user to retrieve useful info and warning message lines the Perforce server may generate in response to things like encountering a too-long line, etc., by passing in a non-null infoLines parameter.

Parameters:

fileSpecs - file specs to search for matching lines

pattern - non-null string pattern to be passed to the grep command

infoLines - if not null, any "info" lines returned from the server (i.e. warnings about exceeded line lengths, etc.) will be put into the passed-in list in the order they are received.

options - - Options to grep command

Returns:

- non-null but possibly empty list of file line matches

Throws:

P4JavaException - if any error occurs in the processing of this method.

Since:

2011.1