public class NtsServerImpl extends RpcServer
By "not thread safe" we really mean that it's up to the consumer to synchronize calls to the server object; if you want a thread-safe implementation see the OneShotServerImpl class (which is marginally slower but thread safe). The intention here is that if you can guarantee that only one thread at a time will access the connect / disconnect and exec series of methods on this object, you can use this class, which will typically have lower network connection latency than the OneShotServerImpl implementation; overll throughput, though, should be roughly comparable for both implementations over time.
Modifier and Type | Field and Description |
---|---|
static boolean |
DEFAULT_STATUS
True IFF this is the default implementation.
|
protected RpcPacketDispatcher |
dispatcher |
static java.lang.String |
IMPL_COMMENTS
Implementation-specific comments (dependencies, limitations, etc.).
|
static int |
MINIMUM_SUPPORTED_SERVER_LEVEL
The minimum Perforce server level required by this implementation.
|
static java.lang.String |
PROTOCOL_NAME
The specific protocol name to be used in URIs for this implementation.
|
protected ProtocolCommand |
protocolSpecs |
protected RpcConnection |
rpcConnection |
static java.lang.String |
SCREEN_NAME
The short-form name (display name) of this implementation.
|
static java.lang.String |
SSL_PROTOCOL_NAME
The specific SSL protocol name to be used in URIs for this implementation.
|
static java.lang.String |
TRACE_PREFIX
What we use as a P4JTracer trace prefix for methods here.
|
applicationName, authCounter, authFileLockDelay, authFileLockTry, authFileLockWait, clientApiLevel, clientTrust, cmdMapArgs, connectionStart, DEFAULT_CLIENT_API_LEVEL, DEFAULT_PROG_NAME, DEFAULT_PROG_VERSION, DEFAULT_SERVER_API_LEVEL, IMPL_TYPE, localHostName, pBufs, relaxCmdNameValidationChecks, RPC_ENABLE_STREAMS, RPC_ENV_CWD_KEY, RPC_ENV_NOCLIENT_SPEC, RPC_ENV_NOHOST_SPEC, RPC_ENV_NOUSER_SPEC, RPC_ENV_OS_NAME_KEY, RPC_ENV_UNIX_SPEC, RPC_ENV_WINDOWS_PREFIX, RPC_ENV_WINDOWS_SPEC, RPC_TAGS_USED, RPC_TMP_CONVERTER_KEY, RPC_TMP_OUTFILE_STREAM_KEY, rpcServerAddress, secretKeys, serverApiLevel, serverId, serverProtocolMap, serverStats, ticketsFilePath, trustFilePath, validatedByChain, validatedByFingerprint, validatedByHostname
authTickets, browserCallback, browserVersion, caseSensitive, charsetName, client, clientName, clientPath, clientUnsetName, commandCallback, connected, CORE_AUTH_FAIL_STRING_1, CORE_AUTH_FAIL_STRING_2, CORE_AUTH_FAIL_STRING_3, CORE_AUTH_FAIL_STRING_4, DEFAULT_STATUS_FIELD_NAME, enableAndmaps, enableGraph, enableProgress, enableStreams, enableTracking, ignoreFileName, IMPL_COMMENTS_FIELD_NAME, IMPL_TYPE_FIELD_NAME, loginOnConnect, MINIMUM_SUPPORTED_SERVER_LEVEL_FIELD_NAME, minimumSupportedServerVersion, nextCmdCallBackKey, nextProgressCallbackKey, nonCheckedSyncs, p4Charset, P4IGNORE_ENV_VAR, P4TICKETS_DEFAULT_OTHER, P4TICKETS_DEFAULT_WINDOWS, P4TICKETS_ENV_VAR, P4TRUST_DEFAULT_OTHER, P4TRUST_DEFAULT_WINDOWS, P4TRUST_ENV_VAR, password, progressCallback, props, PROTOCOL_NAME_FIELD_NAME, quietMode, rand, rsh, runningOnWindows, SCREEN_NAME_FIELD_NAME, secure, serverAddress, serverHost, serverInfo, serverPort, serverProtocol, serverVersion, setupOnConnect, ssoCallback, ssoKey, status, tmpDirName, UNKNOWN_SERVER_HOST, UNKNOWN_SERVER_PORT, UNKNOWN_SERVER_VERSION, usageOptions, useAuthMemoryStore, userName
ATTRIBUTE_STREAM_MAP_KEY, IN_MAP_USE_TAGS_KEY
Constructor and Description |
---|
NtsServerImpl() |
Modifier and Type | Method and Description |
---|---|
void |
connect()
Try to establish an actual RPC connection to the target Perforce server.
|
void |
disconnect()
Try to cleanly disconnect from the Perforce server at the other end
of the current connection (with the emphasis on "cleanly").
|
java.util.Map<java.lang.String,java.lang.Object>[] |
execInputStringMapCmd(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.lang.String inString)
Issue an arbitrary P4Java command to the Perforce server and return the
results as a map.
|
java.util.List<java.util.Map<java.lang.String,java.lang.Object>> |
execInputStringMapCmdList(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.lang.String inString)
Issue an arbitrary P4Java command to the Perforce server and return the
results as a list of maps.
|
java.util.List<java.util.Map<java.lang.String,java.lang.Object>> |
execInputStringMapCmdList(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.lang.String inString,
IFilterCallback filterCallback)
Issue an arbitrary P4Java command to the Perforce server and return the
results as a list of maps.
|
java.io.InputStream |
execInputStringStreamCmd(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.lang.String inString)
Issue an arbitrary P4Java command to the Perforce server and return the
results as a stream.
|
void |
execInputStringStreamingMapCmd(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.lang.String inString,
IStreamingCallback callback,
int key)
Issue a streaming map command to the Perforce server, using an optional
string for any input expected by the server (such as label or job specs,
etc.).
|
void |
execInputStringStreamingMapComd(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.lang.String inString,
IStreamingCallback callback,
int key)
Deprecated.
|
java.util.Map<java.lang.String,java.lang.Object>[] |
execMapCmd(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.util.Map<java.lang.String,java.lang.Object> inMap)
Issue an arbitrary P4Java command to the Perforce server and return the
results as a map.
|
protected java.util.Map<java.lang.String,java.lang.Object>[] |
execMapCmd(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.util.Map<java.lang.String,java.lang.Object> inMap,
java.lang.String inString,
boolean ignoreCallbacks,
IStreamingCallback callback,
int callbackKey,
IFilterCallback filterCallback) |
java.util.List<java.util.Map<java.lang.String,java.lang.Object>> |
execMapCmdList(java.lang.String cmdName,
java.lang.String[] cmdArgs,
IFilterCallback filterCallback,
IParallelCallback parallelCallback)
Issue an arbitrary P4Java command to the Perforce server and return the
results as a list of maps.
|
java.util.List<java.util.Map<java.lang.String,java.lang.Object>> |
execMapCmdList(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.util.Map<java.lang.String,java.lang.Object> inMap)
Issue an arbitrary P4Java command to the Perforce server and return the
results as a list of maps.
|
java.util.List<java.util.Map<java.lang.String,java.lang.Object>> |
execMapCmdList(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.util.Map<java.lang.String,java.lang.Object> inMap,
IFilterCallback filterCallback)
Issue an arbitrary P4Java command to the Perforce server and return the
results as a list of maps.
|
protected java.util.List<java.util.Map<java.lang.String,java.lang.Object>> |
execMapCmdList(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.util.Map<java.lang.String,java.lang.Object> inMap,
java.lang.String inString,
boolean ignoreCallbacks,
IStreamingCallback callback,
int callbackKey,
IFilterCallback filterCallback,
IParallelCallback parallelCallback) |
java.util.Map<java.lang.String,java.lang.Object>[] |
execQuietMapCmd(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.util.Map<java.lang.String,java.lang.Object> inMap)
Issue an arbitrary P4Java command to the Perforce server and return the
results as a map without invoking any command callbacks.
|
java.util.List<java.util.Map<java.lang.String,java.lang.Object>> |
execQuietMapCmdList(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.util.Map<java.lang.String,java.lang.Object> inMap)
Issue an arbitrary P4Java command to the Perforce server and return the
results as a list of maps without invoking any command callbacks.
|
java.io.InputStream |
execQuietStreamCmd(java.lang.String cmdName,
java.lang.String[] cmdArgs)
Issue an arbitrary P4Java command to the Perforce server and get the
results as a stream without invoking any command callbacks.
|
java.io.InputStream |
execStreamCmd(java.lang.String cmdName,
java.lang.String[] cmdArgs)
Issue an arbitrary P4Java command to the Perforce server and get the
results as a stream.
|
java.io.InputStream |
execStreamCmd(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.util.Map<java.lang.String,java.lang.Object> inMap)
Issue an arbitrary P4Java command to the Perforce server and get the
results as a stream.
|
protected java.io.InputStream |
execStreamCmd(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.util.Map<java.lang.String,java.lang.Object> inMap,
java.lang.String inString,
boolean ignoreCallbacks)
Note that this method does the access / request exception processing here rather
than passing things up the stack; we may introduce an extended version of this
method to take the map array as an output parameter in later releases.
|
void |
execStreamingMapCommand(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.util.Map<java.lang.String,java.lang.Object> inMap,
IStreamingCallback callback,
int key)
Issue a streaming map command to the Perforce server, using an optional
map for any input expected by the server (such as label or job specs,
etc.).
|
void |
execStreamingMapCommand(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.util.Map<java.lang.String,java.lang.Object> inMap,
IStreamingCallback callback,
int key,
IParallelCallback parallelCallback)
Issue a parallelised streaming map command to the Perforce server, using an optional
map for any input expected by the server (such as label or job specs,
etc.).
|
RpcConnection |
getRpcConnection() |
IServerAddress |
getServerAddressDetails()
Get server address object
|
ServerStatus |
init(java.lang.String host,
int port,
java.util.Properties props)
Shorthand for the options-based init() above, but with a null opts arg.
|
ServerStatus |
init(java.lang.String host,
int port,
java.util.Properties props,
UsageOptions opts)
Shorthand for the options-based init() above, but with a fasle secure arg.
|
ServerStatus |
init(java.lang.String host,
int port,
java.util.Properties properties,
UsageOptions opts,
boolean secure)
Shorthand for the options-based init() above, but with a fasle secure arg.
|
ServerStatus |
init(java.lang.String host,
int port,
java.util.Properties props,
UsageOptions opts,
boolean secure,
java.lang.String rsh)
Initialize the server.
|
boolean |
setCharsetName(java.lang.String charsetName)
Need to override this method at this level as we keep the connection open here...
|
void |
setRpcConnection(RpcConnection rpcConnection) |
protected ExternalEnv |
setupCmd(java.lang.String cmdName,
java.lang.String[] cmdArgs,
java.util.Map<java.lang.String,java.lang.Object> inMap,
boolean ignoreCallbacks,
int cmdCallBackKey,
boolean isStream)
Factors out the command setup that's common to stream and map commands.
|
addTrust, addTrust, addTrust, checkFingerprint, composeAuthTicketEntryKey, getApplicationName, getAuthCounter, getAuthId, getAuthTicket, getAuthTicket, getClientApiLevel, getClientCharset, getClientNameForEnv, getErrorOrInfoStr, getErrorStr, getGenericCode, getHostForEnv, getInfoStr, getLanguageForEnv, getOsTypeForEnv, getPBuf, getPerfMonitor, getRpcPacketFieldRule, getRpcServerAddress, getSecretKey, getSecretKey, getServerAddress, getServerHostPort, getServerId, getSeverityCode, getTicketsFilePath, getTrust, getTrustFilePath, getTrusts, getTrusts, getUserForEnv, isAuthFail, isInfoMessage, isLoginNotRequired, isRelaxCmdNameValidationChecks, isServerUnicode, isValidatedByChain, isValidatedByFingerprint, isValidatedByHostname, loadFingerprint, loadFingerprints, loadTicket, loadTicket, processCmdCallbacks, removeTrust, removeTrust, saveCurrentTicket, saveFingerprint, saveTicket, saveTicket, setApplicationName, setAuthTicket, setAuthTicket, setClientApiLevel, setPbuf, setPerfMonitor, setRelaxCmdNameValidationChecks, setRpcServerAddress, setSecretKey, setSecretKey, setServerId, setTicketsFilePath, setTrustFilePath, supportsSmartMove, trustConnectionCheck, useTags, writeInPlace
changePassword, createBranchSpec, createClient, createDepot, createExtensionConfig, createJob, createLabel, createProtectionEntries, createStream, createTempClient, createTriggerEntries, createUser, createUser, createUserGroup, createUserGroup, deleteBranchSpec, deleteBranchSpec, deleteClient, deleteClient, deleteCounter, deleteDepot, deleteExtension, deleteJob, deleteKey, deleteLabel, deleteLabel, deletePendingChangelist, deletePendingChangelist, deleteProperty, deleteStream, deleteUser, deleteUser, deleteUserGroup, deleteUserGroup, doGraphReceivePack, duplicateRevisions, fixJobs, fixJobs, getAuthTicket, getBlobObject, getBranchSpec, getBranchSpec, getBranchSpecs, getBranchSpecs, getBrowserCallback, getChangelist, getChangelist, getChangelistDiffs, getChangelistDiffs, getChangelistDiffsStream, getChangelistExtendedFiles, getChangelistExtendedFiles, getChangelistFiles, getChangelistFiles, getChangelists, getChangelists, getChangelists, getCharsetName, getClient, getClient, getClientName, getClientPath, getClients, getClients, getClientTemplate, getClientTemplate, getClientTemplate, getCommitFiles, getCommitObject, getCommitObject, getCounter, getCounter, getCounters, getCounters, getCounters, getCurrentClient, getCurrentServerInfo, getDbSchema, getDefaultP4TicketsFile, getDefaultP4TrustFile, getDepot, getDepotFiles, getDepotFiles, getDepots, getDepots, getDirectories, getDirectories, getDiskSpace, getExportRecords, getExportRecords, getExtendedFiles, getExtendedFiles, getExtensionConfig, getFileAnnotations, getFileAnnotations, getFileContents, getFileContents, getFileDiffs, getFileDiffs, getFileDiffsStream, getFileSizes, getFixes, getFixList, getGraphCommitLogList, getGraphListTree, getGraphObject, getGraphRevList, getGraphShowRefs, getIgnoreFileName, getInfoServerAddress, getInterchanges, getInterchanges, getInterchanges, getInterchanges, getJob, getJobs, getJobs, getJobSpec, getKey, getKeys, getKnownCharsets, getLabel, getLabels, getLabels, getLicense, getLimits, getListData, getListData, getLogin2Status, getLogin2Status, getLoginStatus, getLogTail, getMatchingLines, getMatchingLines, getOpenedFiles, getOpenedFiles, getPreferredPathArray, getPreferredPathArray, getProperties, getProperty, getProtectionEntries, getProtectionEntries, getProtectionsTable, getRandomInt, getRepos, getRepos, getRepos, getReviewChangelists, getReviews, getReviews, getRevisionHistory, getRevisionHistory, getServerFileDiffs, getServerInfo, getServerProcesses, getServerProcesses, getServerVersion, getServerVersionNumber, getShelvedFiles, getShelvedFiles, getSpec, getSSOCallback, getSSOKey, getStatus, getStream, getStream, getStreamingExportRecords, getStreamIntegrationStatus, getStreamlog, getStreams, getSubmittedIntegrations, getSubmittedIntegrations, getTriggerEntries, getTriggersTable, getUsageOptions, getUser, getUserGroup, getUserGroups, getUserGroups, getUserName, getUsers, getUsers, getWorkingDirectory, guardNull, handleFileReturn, handleFileReturn, installExtension, isCaseSensitive, isConnected, isDontWriteTicket, isEnableProgress, isEnableTracking, isNonCheckedSyncs, isQuietMode, isRunningOnWindows, isSecure, isUnicode, journalWait, listExtensions, login, login, login, login, login, login2, login2, login2CheckAuth, login2InitAuth, login2ListMethods, logout, logout, moveFile, moveFile, obliterateFiles, packageExtension, parseVersionString, populatePathArray, registerBrowserCallback, registerCallback, registerProgressCallback, registerSSOCallback, reload, renameUser, sampleExtension, searchJobs, setAuthTicket, setClientName, setClientPath, setCounter, setCounter, setCurrentClient, setCurrentServerInfo, setEnableProgress, setEnableTracking, setFileAttributes, setFileAttributes, setIgnoreFileName, setKey, setNonCheckedSyncs, setOrUnsetServerConfigurationValue, setProperty, setQuietMode, setSecure, setUsageOptions, setUserName, setWorkingDirectory, showServerConfiguration, supportsUnicode, switchClientView, switchStreamView, tagFiles, tagFiles, unload, unsetFileAttribute, unsetFileAttributes, updateBranchSpec, updateClient, updateClient, updateClient, updateExtensionConfig, updateJob, updateLabel, updateLicense, updateProtectionEntries, updateSpec, updateSpecString, updateStream, updateTriggerEntries, updateUser, updateUser, updateUserGroup, updateUserGroup, verifyFiles
execMapCmdList, handleErrorStr, handleFileErrorStr
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
execMapCmdList, handleErrorStr, handleFileErrorStr
public static final java.lang.String SCREEN_NAME
public static final java.lang.String IMPL_COMMENTS
public static final java.lang.String PROTOCOL_NAME
public static final java.lang.String SSL_PROTOCOL_NAME
public static final int MINIMUM_SUPPORTED_SERVER_LEVEL
public static final boolean DEFAULT_STATUS
public static final java.lang.String TRACE_PREFIX
protected ProtocolCommand protocolSpecs
protected RpcPacketDispatcher dispatcher
protected RpcConnection rpcConnection
public ServerStatus init(java.lang.String host, int port, java.util.Properties props, UsageOptions opts, boolean secure, java.lang.String rsh) throws ConfigException, ConnectionException
init
in interface IServerControl
init
in class Server
host
- the Perforce server hostname or IP address as passed in to the factory methodport
- the Perforce server port number as passed in to the factory methodprops
- the properties passed in to the factory methodopts
- the UsageOptions object to be associated with the server object; if null,
the server should construct a new default UsageOptions object.secure
- indicates whether the server is secure (SSL) or not.rsh
- the 'rsh' mode server launch command.ConfigException
- if there's something wrong with the
specified configuration or associated config files, etc.ConnectionException
- if the server is unreachable on initialization, and that
unreachability is serious and unrecoverable (there are implementations that don't
really do connections per se, so they may not consider this an error or even try
connecting during initialisation).RpcServer.init(java.lang.String, int, java.util.Properties, com.perforce.p4java.option.UsageOptions, boolean)
public ServerStatus init(java.lang.String host, int port, java.util.Properties properties, UsageOptions opts, boolean secure) throws ConfigException, ConnectionException
init
in interface IServerControl
init
in class RpcServer
host
- the Perforce server hostname or IP address as passed in to the factory methodport
- the Perforce server port number as passed in to the factory methodproperties
- the properties passed in to the factory methodopts
- the UsageOptions object to be associated with the server object; if null,
the server should construct a new default UsageOptions object.secure
- secure optionConfigException
- if there's something wrong with the
specified configuration or associated config files, etc.ConnectionException
- if the server is unreachable on initialization, and that
unreachability is serious and unrecoverable (there are implementations that don't
really do connections per se, so they may not consider this an error or even try
connecting during initialisation).RpcServer.init(java.lang.String, int, java.util.Properties, com.perforce.p4java.option.UsageOptions, boolean)
public ServerStatus init(java.lang.String host, int port, java.util.Properties props, UsageOptions opts) throws ConfigException, ConnectionException
init
in interface IServerControl
init
in class RpcServer
host
- the Perforce server hostname or IP address as passed in to the factory methodport
- the Perforce server port number as passed in to the factory methodprops
- the properties passed in to the factory methodopts
- the UsageOptions object to be associated with the server object; if null,
the server should construct a new default UsageOptions object.ConfigException
- if there's something wrong with the
specified configuration or associated config files, etc.ConnectionException
- if the server is unreachable on initialization, and that
unreachability is serious and unrecoverable (there are implementations that don't
really do connections per se, so they may not consider this an error or even try
connecting during initialisation).RpcServer.init(java.lang.String, int, java.util.Properties, com.perforce.p4java.option.UsageOptions)
public ServerStatus init(java.lang.String host, int port, java.util.Properties props) throws ConfigException, ConnectionException
init
in interface IServerControl
init
in class RpcServer
host
- the Perforce server hostname or IP address as passed in to the factory methodport
- the Perforce server port number as passed in to the factory methodprops
- the UsageOptions object to be associated with the server object; if null,
the server should construct a new default UsageOptions object.ConfigException
- if there's something wrong with the
specified configuration or associated config files, etc.ConnectionException
- if the server is unreachable on initialization, and that
unreachability is serious and unrecoverable (there are implementations that don't
really do connections per se, so they may not consider this an error or even try
connecting during initialisation).RpcServer.init(java.lang.String, int, java.util.Properties)
public void connect() throws ConnectionException, AccessException, RequestException, ConfigException
connect
in interface IServer
connect
in class RpcServer
ConnectionException
- if the Perforce server is unreachable or is not connected.AccessException
- if the Perforce server denies access to the callerRequestException
- if the Perforce server encounters an error during its
processing of the requestConfigException
- if local I/O exception occursServer.connect()
public void disconnect() throws ConnectionException, AccessException
disconnect
in interface IServer
disconnect
in class RpcServer
ConnectionException
- on errorAccessException
- on errorServer.disconnect()
public boolean setCharsetName(java.lang.String charsetName) throws java.nio.charset.UnsupportedCharsetException
setCharsetName
in interface IServer
setCharsetName
in class Server
charsetName
- charset name; if null, resets the charset to "no charset".java.nio.charset.UnsupportedCharsetException
- if the Perforce server doesn't support or recognize the
charset name.Server.setCharsetName(java.lang.String)
public java.util.Map<java.lang.String,java.lang.Object>[] execMapCmd(java.lang.String cmdName, java.lang.String[] cmdArgs, java.util.Map<java.lang.String,java.lang.Object> inMap) throws ConnectionException, AccessException, RequestException
IServer
This method is intended for low-level commands in the spirit and format of the p4 command line interpreter, and offers a simple way to issue commands to the associated Perforce server without the overhead of the more abstract Java interfaces and methods.
No guidance is given here on the format of the returned map; however, it produces the same output as the p4 command line interpreter in -G (Python map) mode.
Note that this method does not allow you to set "usage" options for the command; these may be added later. Note also that although option arguments passed to this method must be in a form recognized by the p4 command line interpreter, that does not mean the method is being implemented by the interpreter -- the actual implementation depends on the options used to get the server object in the first place from the server factory.
cmdName
- the command to be issued; must be non-null, and correspond to
a Perforce command recognized by P4Java and defined in
CmdSpec.cmdArgs
- the array of command arguments (options and file arguments,
etc.) to be sent to the Perforce server. These must be in the
form used by the corresponding p4 command line interpreter.
Ignored if null.inMap
- an optional map to be sent to the server as standard input,
using the Python map format (-G) form. You must remember to
issue the relevant command-specific option to enable this if
needed.ConnectionException
- if the Perforce server is unreachable or is not connected.AccessException
- if the Perforce server denies access to the callerRequestException
- if the Perforce server encounters an error during its
processing of the requestIServer.execMapCmd(java.lang.String, java.lang.String[], java.util.Map)
public java.util.List<java.util.Map<java.lang.String,java.lang.Object>> execMapCmdList(java.lang.String cmdName, java.lang.String[] cmdArgs, java.util.Map<java.lang.String,java.lang.Object> inMap) throws ConnectionException, AccessException, RequestException
IHelixCommandExecutor
This method is intended for low-level commands in the spirit and format of the p4 command line interpreter, and offers a simple way to issue commands to the associated Perforce server without the overhead of the more abstract Java interfaces and methods.
No guidance is given here on the format of the returned map; however, it produces the same output as the p4 command line interpreter in -G (Python map) mode.
Note that this method does not allow you to set "usage" options for the command; these may be added later. Note also that although option arguments passed to this method must be in a form recognized by the p4 command line interpreter, that does not mean the method is being implemented by the interpreter -- the actual implementation depends on the options used to get the server object in the first place from the server factory.
cmdName
- the command to be issued; must be non-null, and correspond to
a Perforce command recognized by P4Java and defined in
CmdSpec.cmdArgs
- the array of command arguments (options and file arguments,
etc.) to be sent to the Perforce server. These must be in the
form used by the corresponding p4 command line interpreter.
Ignored if null.inMap
- an optional map to be sent to the server as standard input,
using the Python map format (-G) form. You must remember to
issue the relevant command-specific option to enable this if
needed.ConnectionException
- if the Perforce server is unreachable or is not connected.AccessException
- if the Perforce server denies access to the callerRequestException
- if the Perforce server encounters an error during its
processing of the requestIHelixCommandExecutor.execMapCmdList(java.lang.String, java.lang.String[], java.util.Map)
public java.util.List<java.util.Map<java.lang.String,java.lang.Object>> execMapCmdList(java.lang.String cmdName, java.lang.String[] cmdArgs, java.util.Map<java.lang.String,java.lang.Object> inMap, IFilterCallback filterCallback) throws P4JavaException
IHelixCommandExecutor
This method is intended for low-level commands in the spirit and format of the p4 command line interpreter, and offers a simple way to issue commands to the associated Perforce server without the overhead of the more abstract Java interfaces and methods.
No guidance is given here on the format of the returned map; however, it produces the same output as the p4 command line interpreter in -G (Python map) mode.
Note that this method does not allow you to set "usage" options for the command; these may be added later. Note also that although option arguments passed to this method must be in a form recognized by the p4 command line interpreter, that does not mean the method is being implemented by the interpreter -- the actual implementation depends on the options used to get the server object in the first place from the server factory.
cmdName
- the command to be issued; must be non-null, and correspond to
a Perforce command recognized by P4Java and defined in
CmdSpec.cmdArgs
- the array of command arguments (options and file arguments,
etc.) to be sent to the Perforce server. These must be in the
form used by the corresponding p4 command line interpreter.
Ignored if null.inMap
- an optional map to be sent to the server as standard input,
using the Python map format (-G) form. You must remember to
issue the relevant command-specific option to enable this if
needed.filterCallback
- an optional filter callback to decide on skipping or keeping
individual key/value pairs as part of the results map.P4JavaException
- if an error occurs processing this method and its parameters.IHelixCommandExecutor.execMapCmdList(java.lang.String, java.lang.String[], java.util.Map, com.perforce.p4java.server.callback.IFilterCallback)
public java.util.Map<java.lang.String,java.lang.Object>[] execQuietMapCmd(java.lang.String cmdName, java.lang.String[] cmdArgs, java.util.Map<java.lang.String,java.lang.Object> inMap) throws ConnectionException, RequestException, AccessException
IServer
Basically equivalent to execMapCmd with temporary disabling of any ICommandCallback calls and / or listeners; this turns out to be useful for various reasons we won't go into here...
cmdName
- the command to be issued; must be non-null, and correspond to
a Perforce command recognized by P4Java and defined in
CmdSpec.cmdArgs
- the array of command arguments (options and file arguments,
etc.) to be sent to the Perforce server. These must be in the
form used by the corresponding p4 command line interpreter.
Ignored if null.inMap
- an optional map to be sent to the server as standard input,
using the Python map format (-G) form. You must remember to
issue the relevant command-specific option to enable this if
needed.ConnectionException
- if the Perforce server is unreachable or is not connected.RequestException
- if the Perforce server encounters an error during its
processing of the requestAccessException
- if the Perforce server denies access to the callerIServer.execQuietMapCmd(java.lang.String, java.lang.String[], java.util.Map)
public java.util.List<java.util.Map<java.lang.String,java.lang.Object>> execQuietMapCmdList(java.lang.String cmdName, java.lang.String[] cmdArgs, java.util.Map<java.lang.String,java.lang.Object> inMap) throws P4JavaException
IOptionsServer
Basically equivalent to execMapCmd with temporary disabling of any ICommandCallback calls and / or listeners; this turns out to be useful for various reasons we won't go into here...
cmdName
- the command to be issued; must be non-null, and correspond to
a Perforce command recognized by P4Java and defined in
CmdSpec.cmdArgs
- the array of command arguments (options and file arguments,
etc.) to be sent to the Perforce server. These must be in the
form used by the corresponding p4 command line interpreter.
Ignored if null.inMap
- an optional map to be sent to the server as standard input,
using the Python map format (-G) form. You must remember to
issue the relevant command-specific option to enable this if
needed.P4JavaException
- if an error occurs processing this method and its parametersIOptionsServer.execQuietMapCmdList(java.lang.String, java.lang.String[], java.util.Map)
public java.util.Map<java.lang.String,java.lang.Object>[] execInputStringMapCmd(java.lang.String cmdName, java.lang.String[] cmdArgs, java.lang.String inString) throws P4JavaException
IServer
This method is intended for low-level commands in the spirit and format of the p4 command line interpreter, and offers a simple way to issue commands to the associated Perforce server without the overhead of the more abstract Java interfaces and methods.
No guidance is given here on the format of the returned map; however, it produces the same output as the p4 command line interpreter in -G (Python map) mode.
Note that this method does not allow you to set "usage" options for the command; these may be added later. Note also that although option arguments passed to this method must be in a form recognized by the p4 command line interpreter, that does not mean the method is being implemented by the interpreter -- the actual implementation depends on the options used to get the server object in the first place from the server factory.
cmdName
- the command to be issued; must be non-null, and correspond to
a Perforce command recognized by P4Java and defined in
CmdSpec.cmdArgs
- the array of command arguments (options and file arguments,
etc.) to be sent to the Perforce server. These must be in the
form used by the corresponding p4 command line interpreter.
Ignored if null.inString
- an optional string to be sent to the server as standard input
unchanged (this must be in the format expected by the server,
typically as required when using the "-i" flag to the p4
command line app for the same command). You must remember to
issue the relevant command-specific option to enable this if
needed.P4JavaException
- if an error occurs processing this method and its parametersIServer.execInputStringMapCmd(java.lang.String, java.lang.String[], java.lang.String)
public java.util.List<java.util.Map<java.lang.String,java.lang.Object>> execInputStringMapCmdList(java.lang.String cmdName, java.lang.String[] cmdArgs, java.lang.String inString) throws P4JavaException
IOptionsServer
This method is intended for low-level commands in the spirit and format of the p4 command line interpreter, and offers a simple way to issue commands to the associated Perforce server without the overhead of the more abstract Java interfaces and methods.
No guidance is given here on the format of the returned map; however, it produces the same output as the p4 command line interpreter in -G (Python map) mode.
Note that this method does not allow you to set "usage" options for the command; these may be added later. Note also that although option arguments passed to this method must be in a form recognized by the p4 command line interpreter, that does not mean the method is being implemented by the interpreter -- the actual implementation depends on the options used to get the server object in the first place from the server factory.
cmdName
- the command to be issued; must be non-null, and correspond to
a Perforce command recognized by P4Java and defined in
CmdSpec.cmdArgs
- the array of command arguments (options and file arguments,
etc.) to be sent to the Perforce server. These must be in the
form used by the corresponding p4 command line interpreter.
Ignored if null.inString
- an optional string to be sent to the server as standard input
unchanged (this must be in the format expected by the server,
typically as required when using the "-i" flag to the p4
command line app for the same command). You must remember to
issue the relevant command-specific option to enable this if
needed.P4JavaException
- if an error occurs processing this method and its parametersIOptionsServer.execInputStringMapCmdList(java.lang.String, java.lang.String[], java.lang.String)
public java.util.List<java.util.Map<java.lang.String,java.lang.Object>> execInputStringMapCmdList(java.lang.String cmdName, java.lang.String[] cmdArgs, java.lang.String inString, IFilterCallback filterCallback) throws P4JavaException
IOptionsServer
This method is intended for low-level commands in the spirit and format of the p4 command line interpreter, and offers a simple way to issue commands to the associated Perforce server without the overhead of the more abstract Java interfaces and methods.
No guidance is given here on the format of the returned map; however, it produces the same output as the p4 command line interpreter in -G (Python map) mode.
Note that this method does not allow you to set "usage" options for the command; these may be added later. Note also that although option arguments passed to this method must be in a form recognized by the p4 command line interpreter, that does not mean the method is being implemented by the interpreter -- the actual implementation depends on the options used to get the server object in the first place from the server factory.
cmdName
- the command to be issued; must be non-null, and correspond to
a Perforce command recognized by P4Java and defined in
CmdSpec.cmdArgs
- the array of command arguments (options and file arguments,
etc.) to be sent to the Perforce server. These must be in the
form used by the corresponding p4 command line interpreter.
Ignored if null.inString
- an optional string to be sent to the server as standard input
unchanged (this must be in the format expected by the server,
typically as required when using the "-i" flag to the p4
command line app for the same command). You must remember to
issue the relevant command-specific option to enable this if
needed.filterCallback
- an optional filter callback to decide on skipping or keeping
individual key/value pairs as part of the results map.P4JavaException
- if an error occurs processing this method and its parametersIOptionsServer.execInputStringMapCmdList(java.lang.String, java.lang.String[], java.lang.String, com.perforce.p4java.server.callback.IFilterCallback)
public java.util.List<java.util.Map<java.lang.String,java.lang.Object>> execMapCmdList(java.lang.String cmdName, java.lang.String[] cmdArgs, IFilterCallback filterCallback, IParallelCallback parallelCallback) throws P4JavaException
IOptionsServer
This method is intended for low-level commands in the spirit and format of the p4 command line interpreter, and offers a simple way to issue commands to the associated Perforce server without the overhead of the more abstract Java interfaces and methods.
No guidance is given here on the format of the returned map; however, it produces the same output as the p4 command line interpreter in -G (Python map) mode.
Note that this method does not allow you to set "usage" options for the command; these may be added later. Note also that although option arguments passed to this method must be in a form recognized by the p4 command line interpreter, that does not mean the method is being implemented by the interpreter -- the actual implementation depends on the options used to get the server object in the first place from the server factory.
cmdName
- the command to be issued; must be non-null, and correspond to
a Perforce command recognized by P4Java and defined in
CmdSpec.cmdArgs
- the array of command arguments (options and file arguments,
etc.) to be sent to the Perforce server. These must be in the
form used by the corresponding p4 command line interpreter.
Ignored if null.filterCallback
- an optional filter callback to decide on skipping or keeping
individual key/value pairs as part of the results map.parallelCallback
- an optional parallel sync/submit callback to provide a
multi-threaded file transfer implementation.P4JavaException
- if an error occurs processing this method and its parameters@Deprecated public void execInputStringStreamingMapComd(java.lang.String cmdName, java.lang.String[] cmdArgs, java.lang.String inString, IStreamingCallback callback, int key) throws P4JavaException
execInputStringStreamingMapCmd(java.lang.String, java.lang.String[], java.lang.String, com.perforce.p4java.server.callback.IStreamingCallback, int)
IServer
Streaming commands allow users to get each result from a suitably-issued command as it comes in from the server, rather than waiting for the entire command method to complete (and getting the results back as a completed List or Map or whatever).
The results are sent to the user using the IStreamingCallback handleResult method; see the IStreamingCallback Javadoc for details. The payload passed to handleResult is usually the raw map gathered together deep in the RPC protocol layer, and the user is assumed to have the knowledge and technology to be able to parse it and use it suitably in much the same way as a user unpacks or processes the results from the other low-level exec methods like execMapCommand.
NOTE: 'streaming' here has nothing at all to do with Perforce 'streams', which are (or will be) implemented elsewhere.
cmdName
- the command to be issued; must be non-null, and correspond to
a Perforce command recognized by P4Java and defined in
CmdSpec.cmdArgs
- the array of command arguments (options and file arguments,
etc.) to be sent to the Perforce server. These must be in the
form used by the corresponding p4 command line interpreter.
Ignored if null.inString
- an optional string to be sent to the server as standard input
unchanged (this must be in the format expected by the server,
typically as required when using the "-i" flag to the p4
command line app for the same command). You must remember to
issue the relevant command-specific option to enable this if
needed.callback
- a non-null IStreamingCallback to be used to process the
incoming results.key
- an opaque integer key that is passed to the IStreamingCallback
callback methods to identify the action as being associated
with this specific call.P4JavaException
- if an error occurs processing this method and its parameters.IServer.execInputStringStreamingMapComd(java.lang.String, java.lang.String[], java.lang.String, com.perforce.p4java.server.callback.IStreamingCallback, int)
public void execInputStringStreamingMapCmd(java.lang.String cmdName, java.lang.String[] cmdArgs, java.lang.String inString, IStreamingCallback callback, int key) throws P4JavaException
IOptionsServer
Streaming commands allow users to get each result from a suitably-issued command as it comes in from the server, rather than waiting for the entire command method to complete (and getting the results back as a completed List or Map or whatever).
The results are sent to the user using the IStreamingCallback handleResult method; see the IStreamingCallback Javadoc for details. The payload passed to handleResult is usually the raw map gathered together deep in the RPC protocol layer, and the user is assumed to have the knowledge and technology to be able to parse it and use it suitably in much the same way as a user unpacks or processes the results from the other low-level exec methods like execMapCommand.
NOTE: 'streaming' here has nothing at all to do with Perforce 'streams', which are (or will be) implemented elsewhere.
cmdName
- the command to be issued; must be non-null, and correspond to
a Perforce command recognized by P4Java and defined in
CmdSpec.cmdArgs
- the array of command arguments (options and file arguments,
etc.) to be sent to the Perforce server. These must be in the
form used by the corresponding p4 command line interpreter.
Ignored if null.inString
- an optional string to be sent to the server as standard input
unchanged (this must be in the format expected by the server,
typically as required when using the "-i" flag to the p4
command line app for the same command). You must remember to
issue the relevant command-specific option to enable this if
needed.callback
- a non-null IStreamingCallback to be used to process the
incoming results.key
- an opaque integer key that is passed to the IStreamingCallback
callback methods to identify the action as being associated
with this specific call.P4JavaException
- if an error occurs processing this method and its parameters.IOptionsServer.execInputStringStreamingMapCmd(java.lang.String, java.lang.String[], java.lang.String, com.perforce.p4java.server.callback.IStreamingCallback, int)
protected java.util.Map<java.lang.String,java.lang.Object>[] execMapCmd(java.lang.String cmdName, java.lang.String[] cmdArgs, java.util.Map<java.lang.String,java.lang.Object> inMap, java.lang.String inString, boolean ignoreCallbacks, IStreamingCallback callback, int callbackKey, IFilterCallback filterCallback) throws ConnectionException, AccessException, RequestException
protected java.util.List<java.util.Map<java.lang.String,java.lang.Object>> execMapCmdList(java.lang.String cmdName, java.lang.String[] cmdArgs, java.util.Map<java.lang.String,java.lang.Object> inMap, java.lang.String inString, boolean ignoreCallbacks, IStreamingCallback callback, int callbackKey, IFilterCallback filterCallback, IParallelCallback parallelCallback) throws ConnectionException, AccessException, RequestException
public void execStreamingMapCommand(java.lang.String cmdName, java.lang.String[] cmdArgs, java.util.Map<java.lang.String,java.lang.Object> inMap, IStreamingCallback callback, int key) throws P4JavaException
IServer
Streaming commands allow users to get each result from a suitably-issued command as it comes in from the server, rather than waiting for the entire command method to complete (and getting the results back as a completed List or Map or whatever).
The results are sent to the user using the IStreamingCallback handleResult method; see the IStreamingCallback Javadoc for details. The payload passed to handleResult is usually the raw map gathered together deep in the RPC protocol layer, and the user is assumed to have the knowledge and technology to be able to parse it and use it suitably in much the same way as a user unpacks or processes the results from the other low-level exec methods like execMapCommand.
NOTE: 'streaming' here has nothing at all to do with Perforce 'streams', which are (or will be) implemented elsewhere.
cmdName
- the command to be issued; must be non-null, and correspond to
a Perforce command recognized by P4Java and defined in
CmdSpec.cmdArgs
- the array of command arguments (options and file arguments,
etc.) to be sent to the Perforce server. These must be in the
form used by the corresponding p4 command line interpreter.
Ignored if null.inMap
- an optional map to be sent to the server as standard input,
using the Python map format (-G) form. You must remember to
issue the relevant command-specific option to enable this if
needed.callback
- a non-null IStreamingCallback to be used to process the
incoming results.key
- an opaque integer key that is passed to the IStreamingCallback
callback methods to identify the action as being associated
with this specific call.P4JavaException
- if an error occurs processing this method and its parameters.IServer.execStreamingMapCommand(java.lang.String, java.lang.String[], java.util.Map, com.perforce.p4java.server.callback.IStreamingCallback, int)
public void execStreamingMapCommand(java.lang.String cmdName, java.lang.String[] cmdArgs, java.util.Map<java.lang.String,java.lang.Object> inMap, IStreamingCallback callback, int key, IParallelCallback parallelCallback) throws P4JavaException
IServer
Streaming commands allow users to get each result from a suitably-issued command as it comes in from the server, rather than waiting for the entire command method to complete (and getting the results back as a completed List or Map or whatever).
The results are sent to the user using the IStreamingCallback handleResult method; see the IStreamingCallback Javadoc for details. The payload passed to handleResult is usually the raw map gathered together deep in the RPC protocol layer, and the user is assumed to have the knowledge and technology to be able to parse it and use it suitably in much the same way as a user unpacks or processes the results from the other low-level exec methods like execMapCommand.
NOTE: 'streaming' here has nothing at all to do with Perforce 'streams', which are (or will be) implemented elsewhere.
cmdName
- the command to be issued; must be non-null, and correspond to
a Perforce command recognized by P4Java and defined in
CmdSpec.cmdArgs
- the array of command arguments (options and file arguments,
etc.) to be sent to the Perforce server. These must be in the
form used by the corresponding p4 command line interpreter.
Ignored if null.inMap
- an optional map to be sent to the server as standard input,
using the Python map format (-G) form. You must remember to
issue the relevant command-specific option to enable this if
needed.callback
- a non-null IStreamingCallback to be used to process the
incoming results.key
- an opaque integer key that is passed to the IStreamingCallback
callback methods to identify the action as being associated
with this specific call.parallelCallback
- IParallelCallback used to parallelise the taskP4JavaException
- on errorpublic java.io.InputStream execQuietStreamCmd(java.lang.String cmdName, java.lang.String[] cmdArgs) throws ConnectionException, RequestException, AccessException
IServer
Basically equivalent to execStreamCmd with temporary disabling of any ICommandCallback calls and / or listeners; this turns out to be useful for various reasons we won't go into here...
cmdName
- the command to be issued; must be non-null, and correspond to
a Perforce command recognized by P4Java and defined in
CmdSpec.cmdArgs
- the array of command arguments (options and file arguments,
etc.) to be sent to the Perforce server. These must be in the
form used by the corresponding p4 command line interpreter.
Ignored if null.ConnectionException
- if the Perforce server is unreachable or is not connected.RequestException
- if the Perforce server encounters an error during its
processing of the requestAccessException
- if the Perforce server denies access to the callerIServer.execQuietStreamCmd(java.lang.String, java.lang.String[])
public java.io.InputStream execStreamCmd(java.lang.String cmdName, java.lang.String[] cmdArgs) throws ConnectionException, RequestException, AccessException
IHelixCommandExecutor
This method is intended for low-level commands in the spirit and format of the p4 command line interpreter, and offers a simple way to issue commands to the associated Perforce server without the overhead of the more abstract Java interfaces and methods.
Note that this method is intended for things like getting file contents, and may have unpredictable results on commands not originally expected to return i/o streams.
Note that this method does not allow you to set "usage" options for the command; these may be added later. Note also that although option arguments passed to this method must be in a form recognized by P4Java (as defined by the CmdSpec enum), that does not mean the method is being implemented by the interpreter -- the actual implementation depends on the options used to get the server object in the first place from the server factory.
cmdName
- the command to be issued; must be non-null, and correspond to
a Perforce command recognized by P4Java and defined in
CmdSpec.cmdArgs
- the array of command arguments (options and file arguments,
etc.) to be sent to the Perforce server. These must be in the
form used by the corresponding p4 command line interpreter.
Ignored if null.ConnectionException
- if the Perforce server is unreachable or is not connected.RequestException
- if the Perforce server encounters an error during its
processing of the requestAccessException
- if the Perforce server denies access to the callerIHelixCommandExecutor.execStreamCmd(java.lang.String, java.lang.String[])
public java.io.InputStream execStreamCmd(java.lang.String cmdName, java.lang.String[] cmdArgs, java.util.Map<java.lang.String,java.lang.Object> inMap) throws P4JavaException
IOptionsServer
This method is intended for low-level commands in the spirit and format of the p4 command line interpreter, and offers a simple way to issue commands to the associated Perforce server without the overhead of the more abstract Java interfaces and methods.
Note that this method is intended for things like getting file contents, and may have unpredictable results on commands not originally expected to return i/o streams.
Note that this method does not allow you to set "usage" options for the command; these may be added later. Note also that although option arguments passed to this method must be in a form recognized by P4Java (as defined by the CmdSpec enum), that does not mean the method is being implemented by the interpreter -- the actual implementation depends on the options used to get the server object in the first place from the server factory.
cmdName
- the command to be issued; must be non-null, and correspond to
a Perforce command recognized by P4Java and defined in
CmdSpec.cmdArgs
- the array of command arguments (options and file arguments,
etc.) to be sent to the Perforce server. These must be in the
form used by the corresponding p4 command line interpreter.
Ignored if null.inMap
- an optional map to be sent to the server as standard input,
using the Python map format (-G) form. You must remember to
issue the relevant command-specific option to enable this if
needed.ConnectionException
- if the Perforce server is unreachable or is not connected.RequestException
- if the Perforce server encounters an error during its
processing of the requestAccessException
- if the Perforce server denies access to the callerP4JavaException
IOptionsServer.execStreamCmd(java.lang.String, java.lang.String[], java.util.Map)
public java.io.InputStream execInputStringStreamCmd(java.lang.String cmdName, java.lang.String[] cmdArgs, java.lang.String inString) throws P4JavaException
IOptionsServer
This method is intended for low-level commands in the spirit and format of the p4 command line interpreter, and offers a simple way to issue commands to the associated Perforce server without the overhead of the more abstract Java interfaces and methods.
Note that this method is intended for things like getting file contents, and may have unpredictable results on commands not originally expected to return i/o streams.
Note that this method does not allow you to set "usage" options for the command; these may be added later. Note also that although option arguments passed to this method must be in a form recognized by the p4 command line interpreter, that does not mean the method is being implemented by the interpreter -- the actual implementation depends on the options used to get the server object in the first place from the server factory.
cmdName
- the command to be issued; must be non-null, and correspond to
a Perforce command recognized by P4Java and defined in
CmdSpec.cmdArgs
- the array of command arguments (options and file arguments,
etc.) to be sent to the Perforce server. These must be in the
form used by the corresponding p4 command line interpreter.
Ignored if null.inString
- an optional string to be sent to the server as standard input
unchanged (this must be in the format expected by the server,
typically as required when using the "-i" flag to the p4
command line app for the same command). You must remember to
issue the relevant command-specific option to enable this if
needed.P4JavaException
- if an error occurs processing this method and its parametersIOptionsServer.execInputStringStreamCmd(java.lang.String, java.lang.String[], java.lang.String)
protected java.io.InputStream execStreamCmd(java.lang.String cmdName, java.lang.String[] cmdArgs, java.util.Map<java.lang.String,java.lang.Object> inMap, java.lang.String inString, boolean ignoreCallbacks) throws ConnectionException, RequestException, AccessException
cmdName
- cmdNamecmdArgs
- cmdArgsinMap
- inMapinString
- inStringignoreCallbacks
- ignoreCallbacksConnectionException
- on errorRequestException
- on errorAccessException
- on errorprotected ExternalEnv setupCmd(java.lang.String cmdName, java.lang.String[] cmdArgs, java.util.Map<java.lang.String,java.lang.Object> inMap, boolean ignoreCallbacks, int cmdCallBackKey, boolean isStream) throws ConnectionException, AccessException, RequestException
cmdName
- cmdNamecmdArgs
- cmdArgsinMap
- inMapignoreCallbacks
- ignoreCallbackscmdCallBackKey
- cmdCallBackKeyisStream
- isStreamConnectionException
- on errorAccessException
- on errorRequestException
- on errorpublic RpcConnection getRpcConnection()
public void setRpcConnection(RpcConnection rpcConnection)
public IServerAddress getServerAddressDetails()
getServerAddressDetails
in class Server