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

Class ProtectsDelegator

java.lang.Object

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

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

All Implemented Interfaces:

IProtectsDelegator

public class ProtectsDelegator
extends BaseDelegator
implements IProtectsDelegator

Implementation to handle the Protects command.

Field Summary

Fields inherited from class com.perforce.p4java.impl.mapbased.server.cmd.BaseDelegator

MAX_LIMIT_SUPPORTED_MIN_VERSION, QUERY_EXPRESSIONS_SUPPORTED_MIN_VERSION, USER_RESTRICTIONS_SUPPORTED_MIN_VERSION

Constructor Summary

Constructors

Constructor and Description
ProtectsDelegator(IOptionsServer server) Instantiate a new ProtectsDelegator, providing the server object that will be used to execute Perforce Helix attribute commands.

Method Summary

Modifier and Type	Method and Description
List<IProtectionEntry>	getProtectionEntries(boolean allUsers, String hostName, String userName, String groupName, List<IFileSpec> fileList) Get a list of Perforce protection entries for the passed-in arguments.
List<IProtectionEntry>	getProtectionEntries(List<IFileSpec> fileList, GetProtectionEntriesOptions opts) Get a list of Perforce protection entries for the passed-in arguments.

Methods inherited from class java.lang.Object

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

Constructor Detail

ProtectsDelegator

public ProtectsDelegator(IOptionsServer server)

Instantiate a new ProtectsDelegator, providing the server object that will be used to execute Perforce Helix attribute commands.

Parameters:

server - a concrete implementation of a Perforce Helix Server

Method Detail

getProtectionEntries

public List<IProtectionEntry> getProtectionEntries(boolean allUsers,
                                                   String hostName,
                                                   String userName,
                                                   String groupName,
                                                   List<IFileSpec> fileList)
                                            throws ConnectionException,
                                                   RequestException,
                                                   AccessException

Description copied from interface: IProtectsDelegator

Get a list of Perforce protection entries for the passed-in arguments.

Note that the behavior of this method is unspecified when using clashing options (e.g. having both userName and groupName set non-null). Consult the main Perforce admin documentation for semantics and usage.

Note that the annotations in the file paths will be dropped. The reason is the Perforce server 'protects' command requires a file list devoid of annotated revision specificity.

Specified by:

getProtectionEntries in interface IProtectsDelegator

Parameters:

allUsers - if true, protection lines for all users are displayed.

hostName - only protection entries that apply to the given host (IP address) are displayed.

userName - protection lines Perforce user "userName" are displayed.

groupName - protection lines for Perforce group "groupName" are displayed.

fileList - if non-null, only those protection entries that apply to the specified files are displayed.

Returns:

non-null but possibly empty list of protection entries.

Throws:

ConnectionException - if the Perforce server is unreachable or is not connected.

RequestException - if the Perforce server encounters an error during its processing of the request.

AccessException - if the Perforce server denies access to the caller.

getProtectionEntries

public List<IProtectionEntry> getProtectionEntries(List<IFileSpec> fileList,
                                                   GetProtectionEntriesOptions opts)
                                            throws P4JavaException

Description copied from interface: IProtectsDelegator

Get a list of Perforce protection entries for the passed-in arguments.

Note that the behavior of this method is unspecified when using clashing options (e.g. having both userName and groupName set non-null). Consult the main Perforce admin documentation for semantics and usage.

Note that any annotations in the file paths will be ignored. The reason is the Perforce server 'protects' command requires a file list devoid of annotated revision specificity.

Specified by:

getProtectionEntries in interface IProtectsDelegator

Parameters:

fileList - if non-null, only those protection entries that apply to the specified files are displayed.

opts - GetProtectionEntriesOptions object describing optional parameters; if null, no options are set.

Returns:

non-null but possibly empty list of protection entries.

Throws:

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