com.perforce.p4java
Class PropertyDefs

java.lang.Object
  com.perforce.p4java.PropertyDefs

public class PropertyDefs
extends Object

Defines keys and default values for common and useful P4Java-wide properties. Particularly useful for initial properties passed in through the server factory to define things like calling-program name and version, but note that (as individually noted below) some properties defined here must be defined at load time through the system properties or they will have no effect.

Unless otherwise noted in the individual definitions below, properties defined here apply to all protocol implementations.

Unless noted otherwise below, most properties can have an optional short form which is typically just the full form without the cumbersome com.perforce.p4java (etc.) prefix; use of the short form is particularly convenient for passing in properties through the server factory url mechanism, but you have to be careful that there are no system or environment properties with a conflicting name.

Field Summary

static String	AUTH_FILE_LOCK_DELAY_KEY If this property is set, attempt to use this value as the number of milliseconds delay for deciding if the auth lock file is new or old based on file time stamp.
static String	AUTH_FILE_LOCK_DELAY_KEY_SHORT_FORM If this property is set, attempt to use this value as the number of milliseconds delay for deciding if the auth lock file is new or old based on file time stamp.
static String	AUTH_FILE_LOCK_TRY_KEY If this property is set, attempt to use this value as the number of tries for creating a auth lock file.
static String	AUTH_FILE_LOCK_TRY_KEY_SHORT_FORM If this property is set, attempt to use this value as the number of tries for creating a auth lock file.
static String	AUTH_FILE_LOCK_WAIT_KEY If this property is set, attempt to use this value as the number of milliseconds the current thread should wait (pause execution) for the other thread/process to finish handling the auth lock file.
static String	AUTH_FILE_LOCK_WAIT_KEY_SHORT_FORM If this property is set, attempt to use this value as the number of milliseconds the current thread should wait (pause execution) for the other thread/process to finish handling the auth lock file.
static String	AUTO_CONNECT_KEY If AUTO_CONNECT_KEY (or its short form) is set, attempt to connect with the client name, if the clientName is also set.
static String	AUTO_CONNECT_KEY_SHORTFORM Short form autoconnect key.
static String	AUTO_LOGIN_KEY If AUTO_LOGIN_KEY (or its short form) is set, attempt to perform a login on connect().
static String	AUTO_LOGIN_KEY_SHORTFORM Short form auto login key.
static String	CLIENT_NAME_KEY Property key for a Perforce client name set though the P4Java properties mechanism.
static String	CLIENT_NAME_KEY_SHORTFORM Short form client name key.
static String	CLIENT_UNSET_NAME_DEFAULT Default value to be used for the unset client name (see the comments for CLIENT_UNSET_NAME_KEY, above) when no associated property is set.
static String	CLIENT_UNSET_NAME_KEY Property key for passing in a suitable client name to be used when we don't actually have (or want) a Perforce client associated with a Perforce server connection.
static String	DEFAULT_CHARSET_KEY If DEFAULT_CHARSET_KEY is set in the Java system properties, it defines the name of the charset used to convert strings to and from the Perforce server if that server is NOT in Unicode mode.
static String	ENABLE_PROGRESS If the ENABLE_PROGRESS property is set (to any value), a variable "progress" will be set to 1 to indicate that the server should send progress messages to the client if they are available for that command.
static String	ENABLE_PROGRESS_SHORT_FORM Short form of the ENABLE_PROGRESS property (below).
static String	ENABLE_TRACKING If the ENABLE_TRACKING property is set (to any value), the server performance tracking information will be returned as part of the result for applicable commands.
static String	ENABLE_TRACKING_SHORT_FORM Short form of the ENABLE_TRACKING property (below).
static String	IGNORE_FILE_NAME_KEY If this property is set, attempt to use this ignore file name.
static String	IGNORE_FILE_NAME_KEY_SHORT_FORM If this property is set, attempt to use this ignore file name.
static String	NON_CHECKED_SYNC If the NON_CHECKED_SYNC property is set (to any value), syncs and certain other operations (see below) against 2010.2 or later Perforce servers will not have integrity checks performed during the operations.
static String	NON_CHECKED_SYNC_SHORT_FORM Short form of the NON_CHECKED_SYNC property (below).
static String	P4JAVA_PROP_KEY_PREFIX The standard default P4Java server properties key prefix.
static String	P4JAVA_TMP_DIR_KEY Property name key for the P4Java API's temporary directory.
static String	PASSWORD_KEY Property key for a Perforce password set though the P4Java properties mechanism.
static String	PASSWORD_KEY_SHORTFORM Short form password key.
static String	PROG_NAME_DEFAULT Default calling-program name to use if no calling program property is set with the PROG_NAME_KEY key, above.
static String	PROG_NAME_KEY Properties key for the calling-program name.
static String	PROG_NAME_KEY_SHORTFORM Short form program name key.
static String	PROG_VERSION_DEFAULT Default calling-program version to use if no calling program property is set with the PROG_VERSION_KEY key, above.
static String	PROG_VERSION_KEY Properties key for the calling-program version.
static String	PROG_VERSION_KEY_SHORTFORM Short form program version key.
static String	QUIET_MODE If the QUIET_MODE property is set (to any value), suppress ALL info-level output.
static String	QUIET_MODE_SHORT_FORM Short form of the QUIET_MODE property (below).
static String	TICKET_PATH_KEY If this property is set, attempt to use this path as the p4tickets file.
static String	TICKET_PATH_KEY_SHORT_FORM If this property is set, attempt to use this path as the p4tickets file.
static String	TRUST_PATH_KEY If this property is set, attempt to use this path as the p4trust file.
static String	TRUST_PATH_KEY_SHORT_FORM If this property is set, attempt to use this path as the p4trust file.
static String	UNICODE_MAPPING If the UNICODE_MAPPING property is set (to any value), attempt to apply Perforce specific updates to character mappings in the P4ShiftJIS charset implementation.
static String	UNICODE_MAPPING_SHORT_FORM Short form of the UNICODE_MAPPING property (below).
static String	USE_AUTH_MEMORY_STORE_KEY If this property is set (to any value), attempt to use memory instead of file to store auth tickets and fingerprints.
static String	USE_AUTH_MEMORY_STORE_KEY_SHORT_FORM If this property is set (to any value), attempt to use memory instead of file to store auth tickets and fingerprints.
static String	USER_NAME_KEY Property key for a Perforce user name set though the P4Java properties mechanism.
static String	USER_NAME_KEY_SHORTFORM Short form user name key.
static String	USER_UNSET_NAME_DEFAULT Default value to be used for the unset user name (see the comments for USER_UNSET_NAME_KEY, above) when no associated property is set.
static String	USER_UNSET_NAME_KEY Property key for passing in a suitable user name to be used when we don't actually have (or want) a Perforce user associated with a Perforce server connection.
static String	WRITE_IN_PLACE_KEY If WRITE_IN_PLACE_KEY is true, certain operations listed below may write file contents from the Perforce server directly to the target client file rather than to a temporary file (which is then renamed to the target file).
static String	WRITE_IN_PLACE_SHORT_FORM Short form of the WRITE_IN_PLACE_KEY, below.

Constructor Summary

PropertyDefs()

Method Summary

Methods inherited from class java.lang.Object

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

Field Detail

P4JAVA_PROP_KEY_PREFIX

public static final String P4JAVA_PROP_KEY_PREFIX

The standard default P4Java server properties key prefix.

See Also:

Constant Field Values

PROG_NAME_KEY_SHORTFORM

public static final String PROG_NAME_KEY_SHORTFORM

Short form program name key.

See Also:

Constant Field Values

PROG_VERSION_KEY_SHORTFORM

public static final String PROG_VERSION_KEY_SHORTFORM

Short form program version key.

See Also:

Constant Field Values

PROG_VERSION_KEY

public static final String PROG_VERSION_KEY

Properties key for the calling-program version. Usage is intended to be similar to the p4 command lines -zversion flag. If no corresponding property is given, the value defined by PROG_VERSION_DEFAULT below is used.

See Also:

Constant Field Values

PROG_VERSION_DEFAULT

public static final String PROG_VERSION_DEFAULT

Default calling-program version to use if no calling program property is set with the PROG_VERSION_KEY key, above.

PROG_NAME_KEY

public static final String PROG_NAME_KEY

Properties key for the calling-program name. Usage is intended to be similar to the p4 command lines -zprog flag. If no corresponding property is given, the value defined by PROG_NAME_DEFAULT below is used.

See Also:

Constant Field Values

PROG_NAME_DEFAULT

public static final String PROG_NAME_DEFAULT

Default calling-program name to use if no calling program property is set with the PROG_NAME_KEY key, above.

See Also:

Constant Field Values

CLIENT_UNSET_NAME_KEY

public static final String CLIENT_UNSET_NAME_KEY

Property key for passing in a suitable client name to be used when we don't actually have (or want) a Perforce client associated with a Perforce server connection. If no such property is given, the value used defaults to CLIENT_UNSET_NAME_DEFAULT, below.

See Also:

Constant Field Values

CLIENT_UNSET_NAME_DEFAULT

public static final String CLIENT_UNSET_NAME_DEFAULT

Default value to be used for the unset client name (see the comments for CLIENT_UNSET_NAME_KEY, above) when no associated property is set.

See Also:

Constant Field Values

USER_UNSET_NAME_KEY

public static final String USER_UNSET_NAME_KEY

Property key for passing in a suitable user name to be used when we don't actually have (or want) a Perforce user associated with a Perforce server connection. If no such property is given, the value used defaults to USER_UNSET_NAME_DEFAULT, below.

See Also:

Constant Field Values

USER_UNSET_NAME_DEFAULT

public static final String USER_UNSET_NAME_DEFAULT

Default value to be used for the unset user name (see the comments for USER_UNSET_NAME_KEY, above) when no associated property is set.

See Also:

Constant Field Values

P4JAVA_TMP_DIR_KEY

public static final String P4JAVA_TMP_DIR_KEY

Property name key for the P4Java API's temporary directory. Unless otherwise noted, this directory will be used for temporary files, and, unless set by this property, it will default to whatever's in the system java.io.tmpdir property.

Note that sync operations will sync to temporary files in the enclosing directory of the target file rather than to the default tmp directory if this property is not set; this is so that cross-device copies are not needed at the end of each file sync from tmp to target. If set, however, this property's value will be used for sync ops as well.

See Also:

Constant Field Values

USER_NAME_KEY_SHORTFORM

public static final String USER_NAME_KEY_SHORTFORM

Short form user name key.

See Also:

Constant Field Values

USER_NAME_KEY

public static final String USER_NAME_KEY

Property key for a Perforce user name set though the P4Java properties mechanism. If set, an IServer returned from the server factory will have its user name set to this value.

See Also:

Constant Field Values

PASSWORD_KEY_SHORTFORM

public static final String PASSWORD_KEY_SHORTFORM

Short form password key.

See Also:

Constant Field Values

PASSWORD_KEY

public static final String PASSWORD_KEY

Property key for a Perforce password set though the P4Java properties mechanism. If set, an IServer returned from the server factory will have its password set to this value.

See Also:

Constant Field Values

CLIENT_NAME_KEY_SHORTFORM

public static final String CLIENT_NAME_KEY_SHORTFORM

Short form client name key.

See Also:

Constant Field Values

CLIENT_NAME_KEY

public static final String CLIENT_NAME_KEY

Property key for a Perforce client name set though the P4Java properties mechanism. If set, an IServer returned from the server factory will have its client name set to this value.

See Also:

Constant Field Values

AUTO_CONNECT_KEY_SHORTFORM

public static final String AUTO_CONNECT_KEY_SHORTFORM

Short form autoconnect key.

See Also:

Constant Field Values

AUTO_CONNECT_KEY

public static final String AUTO_CONNECT_KEY

If AUTO_CONNECT_KEY (or its short form) is set, attempt to connect with the client name, if the clientName is also set. Will be done after any auto logins (see below).

See Also:

Constant Field Values

AUTO_LOGIN_KEY_SHORTFORM

public static final String AUTO_LOGIN_KEY_SHORTFORM

Short form auto login key.

See Also:

Constant Field Values

AUTO_LOGIN_KEY

public static final String AUTO_LOGIN_KEY

If AUTO_LOGIN_KEY (or its short form) is set, attempt to perform a login on connect(). Will only actually try the login if userName and password are also set through the properties menachnism.

See Also:

Constant Field Values

TICKET_PATH_KEY_SHORT_FORM

public static final String TICKET_PATH_KEY_SHORT_FORM

If this property is set, attempt to use this path as the p4tickets file.

See Also:

Constant Field Values

TICKET_PATH_KEY

public static final String TICKET_PATH_KEY

If this property is set, attempt to use this path as the p4tickets file.

See Also:

Constant Field Values

DEFAULT_CHARSET_KEY

public static final String DEFAULT_CHARSET_KEY

If DEFAULT_CHARSET_KEY is set in the Java system properties, it defines the name of the charset used to convert strings to and from the Perforce server if that server is NOT in Unicode mode. Note that this property is fundamental and must be set early on, i.e. in the System properties at P4Java startup / load time.

If this property is not set at P4Java load time, the default charset name is the current JVM default charset name if not null.

Note that this value has no effect whatever when running against a non-Unicode Perforce server.

Note also that this property has no short form.

See Also:

Constant Field Values

WRITE_IN_PLACE_SHORT_FORM

public static final String WRITE_IN_PLACE_SHORT_FORM

Short form of the WRITE_IN_PLACE_KEY, below.

See Also:

Constant Field Values

WRITE_IN_PLACE_KEY

public static final String WRITE_IN_PLACE_KEY

If WRITE_IN_PLACE_KEY is true, certain operations listed below may write file contents from the Perforce server directly to the target client file rather than to a temporary file (which is then renamed to the target file).

In general, this property should not be used unless you're on a Windows box and seeing performance issues with sync operations; even then it's probably best to consult with a Perforce support person before trying it, as this property has been introduced as a workaround to a known Java bug with file renaming on JDK 6 and earlier VMs on Windows boxes, and may not be an optimal solution for everyone. Known side-effects (besides performance) may include partial file content syncs in cases where network errors occur, but this is very rare and will not result in server-side data loss or corruption (in fact it's yet to be observed at all within Perforce).

Currently only the sync command honors this property.

See Also:

Constant Field Values

NON_CHECKED_SYNC_SHORT_FORM

public static final String NON_CHECKED_SYNC_SHORT_FORM

Short form of the NON_CHECKED_SYNC property (below).

Since:

2011.1

See Also:

Constant Field Values

NON_CHECKED_SYNC

public static final String NON_CHECKED_SYNC

If the NON_CHECKED_SYNC property is set (to any value), syncs and certain other operations (see below) against 2010.2 or later Perforce servers will not have integrity checks performed during the operations. The default is to use integrity checks on these operations with 2010.2 or later servers (these additional checks are not done for earlier server versions).

By default, for 2010.2 and later servers, the integrity checks are performed on the client for sync, revert, unshelve, and integ operations, and on the server for submit and shelve. Note that this feature can also be disabled on the server side (see the Perforce admin command for details).

Since:

2011.1

See Also:

Constant Field Values

ENABLE_TRACKING_SHORT_FORM

public static final String ENABLE_TRACKING_SHORT_FORM

Short form of the ENABLE_TRACKING property (below).

Since:

2012.1

See Also:

Constant Field Values

ENABLE_TRACKING

public static final String ENABLE_TRACKING

If the ENABLE_TRACKING property is set (to any value), the server performance tracking information will be returned as part of the result for applicable commands. You can see what tables a command is accessing, and implicitly locking. In addition to the command's usual output, the "track" information includes the table name and the type of locks obtained on that table.

Note that using "-Ztrack" users will have to handle tracking information return from the lower level "raw" IServer.exec* methods.

Since:

2012.1

See Also:

Constant Field Values

ENABLE_PROGRESS_SHORT_FORM

public static final String ENABLE_PROGRESS_SHORT_FORM

Short form of the ENABLE_PROGRESS property (below).

Since:

2012.3

See Also:

Constant Field Values

ENABLE_PROGRESS

public static final String ENABLE_PROGRESS

If the ENABLE_PROGRESS property is set (to any value), a variable "progress" will be set to 1 to indicate that the server should send progress messages to the client if they are available for that command.

Note that the progress indicator (p4 -I ) flag makes sense to be used with P4Java's lower level "raw" IServer.execStreamingMapCommand() method. This streaming method takes a callback handler and continuously report progress (in a result map) during the lifetime of a command.

Since:

2012.3

See Also:

Constant Field Values

QUIET_MODE_SHORT_FORM

public static final String QUIET_MODE_SHORT_FORM

Short form of the QUIET_MODE property (below).

Since:

2013.1

See Also:

Constant Field Values

QUIET_MODE

public static final String QUIET_MODE

If the QUIET_MODE property is set (to any value), suppress ALL info-level output.

Since:

2013.1

See Also:

Constant Field Values

IGNORE_FILE_NAME_KEY_SHORT_FORM

public static final String IGNORE_FILE_NAME_KEY_SHORT_FORM

If this property is set, attempt to use this ignore file name.

Since:

2012.1

See Also:

Constant Field Values

IGNORE_FILE_NAME_KEY

public static final String IGNORE_FILE_NAME_KEY

If this property is set, attempt to use this ignore file name.

Since:

2012.1

See Also:

Constant Field Values

TRUST_PATH_KEY_SHORT_FORM

public static final String TRUST_PATH_KEY_SHORT_FORM

If this property is set, attempt to use this path as the p4trust file.

Since:

2012.1

See Also:

Constant Field Values

TRUST_PATH_KEY

public static final String TRUST_PATH_KEY

If this property is set, attempt to use this path as the p4trust file.

Since:

2012.1

See Also:

Constant Field Values

USE_AUTH_MEMORY_STORE_KEY_SHORT_FORM

public static final String USE_AUTH_MEMORY_STORE_KEY_SHORT_FORM

If this property is set (to any value), attempt to use memory instead of file to store auth tickets and fingerprints.

Since:

2012.3

See Also:

Constant Field Values

USE_AUTH_MEMORY_STORE_KEY

public static final String USE_AUTH_MEMORY_STORE_KEY

If this property is set (to any value), attempt to use memory instead of file to store auth tickets and fingerprints.

Since:

2012.3

See Also:

Constant Field Values

UNICODE_MAPPING_SHORT_FORM

public static final String UNICODE_MAPPING_SHORT_FORM

Short form of the UNICODE_MAPPING property (below).

Since:

2012.3

See Also:

Constant Field Values

UNICODE_MAPPING

public static final String UNICODE_MAPPING

If the UNICODE_MAPPING property is set (to any value), attempt to apply Perforce specific updates to character mappings in the P4ShiftJIS charset implementation.

Since:

2012.3

See Also:

Constant Field Values

AUTH_FILE_LOCK_TRY_KEY_SHORT_FORM

public static final String AUTH_FILE_LOCK_TRY_KEY_SHORT_FORM

If this property is set, attempt to use this value as the number of tries for creating a auth lock file.

Since:

2015.2

See Also:

Constant Field Values

AUTH_FILE_LOCK_TRY_KEY

public static final String AUTH_FILE_LOCK_TRY_KEY

If this property is set, attempt to use this value as the number of tries for creating a auth lock file.

Since:

2015.2

See Also:

Constant Field Values

AUTH_FILE_LOCK_DELAY_KEY_SHORT_FORM

public static final String AUTH_FILE_LOCK_DELAY_KEY_SHORT_FORM

If this property is set, attempt to use this value as the number of milliseconds delay for deciding if the auth lock file is new or old based on file time stamp.

Since:

2015.2

See Also:

Constant Field Values

AUTH_FILE_LOCK_DELAY_KEY

public static final String AUTH_FILE_LOCK_DELAY_KEY

If this property is set, attempt to use this value as the number of milliseconds delay for deciding if the auth lock file is new or old based on file time stamp.

Since:

2015.2

See Also:

Constant Field Values

AUTH_FILE_LOCK_WAIT_KEY_SHORT_FORM

public static final String AUTH_FILE_LOCK_WAIT_KEY_SHORT_FORM

If this property is set, attempt to use this value as the number of milliseconds the current thread should wait (pause execution) for the other thread/process to finish handling the auth lock file.

Since:

2015.2

See Also:

Constant Field Values

AUTH_FILE_LOCK_WAIT_KEY

public static final String AUTH_FILE_LOCK_WAIT_KEY

If this property is set, attempt to use this value as the number of milliseconds the current thread should wait (pause execution) for the other thread/process to finish handling the auth lock file.

Since:

2015.2

See Also:

Constant Field Values

Constructor Detail

PropertyDefs

public PropertyDefs()