SecureReferenceLocator (ontimize-core 5.6.0 API)

java.lang.Object
- java.rmi.server.RemoteObject
- - java.rmi.server.RemoteServer
  - - java.rmi.server.UnicastRemoteObject
    - - com.ontimize.locator.SecureReferenceLocator

All Implemented Interfaces:

ConnectionOptimizer, RemoteApplicationPreferenceReferencer, RemotelyManageable, EntityReferenceLocator, SecureEntityReferenceLocator, ServerReferenceLocator, UtilReferenceLocator, RemoteLControlAdministration, RemoteLOk, RemoteReportReferencer, INoticeSendMails, INoticeSystem, ISSOServer, XMLClientProvider, XMLFormProvider, Serializable, Remote

Direct Known Subclasses:

PermissionSecureReferenceLocator
```
public class SecureReferenceLocator
extends UnicastRemoteObject
implements SecureEntityReferenceLocator, ServerReferenceLocator, ConnectionOptimizer, RemotelyManageable, UtilReferenceLocator, RemoteReportReferencer, RemoteApplicationPreferenceReferencer, RemoteLControlAdministration, RemoteLOk, INoticeSystem, INoticeSendMails, XMLClientProvider, ISSOServer
```
This class allow to get references to remote entities.
This is the server class to get entity access

Author:

Imatia Innovation

See Also:
Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`SecureReferenceLocator.BMessage` Internal class for utility messages.
`protected class`	`SecureReferenceLocator.LogStream`
`static class`	`SecureReferenceLocator.SMessage` Internal class for utility messages.
`protected class`	`SecureReferenceLocator.TWatchDog`
`protected class`	`SecureReferenceLocator.UpdateListThread`

Nested classes/interfaces inherited from interface com.ontimize.locator.UtilReferenceLocator
UtilReferenceLocator.Message

Field Summary

Fields
Modifier and Type	Field and Description
`protected static String`	`ADMIN_PASSWORD`
`protected static String`	`ADMIN_USER`
`static String`	`ALLOW_CERTIFICATE_LOGIN`
`protected static boolean`	`allowSSOLogin`
`protected String`	`attachmentEntity`
`protected String`	`attachmentPath`
`protected String`	`baseLogFileName`
`protected BufferedWriter`	`buffWriterLog`
`static String`	`CA_CERTIFICATES_PROP`
`protected static String`	`CHECK_SESSIONS_TIME`
`protected int`	`checkSessionsTime`
`protected static String`	`CLASS_ELEMENT`
`protected Hashtable`	`clientWatchUserList`
`protected static String`	`CLOSE_WAIT_TIME`
`protected boolean`	`closedServer`
`protected boolean`	`compressionEnabled`
`protected Hashtable`	`compressionThresholds`
`protected static String`	`CONTROL_ACCESS_ATTEMPTS`
`protected boolean`	`controlAccessAttempt`
`static String`	`CRL_CERTIFICATES_PROP`
`protected Hashtable`	`currentUserList`
`protected static String`	`DATABASE_PROPERTIES`
`protected DatabaseEntityManager`	`databaseEntityManager`
`protected static String`	`defaultNoticeDestinyEntityClass`
`protected static String`	`defaultNoticeEntityClass`
`protected String`	`domain`
`protected static String`	`DOMAIN`
`protected boolean`	`encrypt`
`protected String`	`entitiesClass`
`protected Hashtable`	`entitiesclasses_extends`
`protected ErrorAccessControl`	`errorAccessControl`
`protected String`	`fileLogExtension`
`protected FileWriter`	`fileWriterLog`
`protected static String`	`FORM_MANAGER_PROVIDER_ENTITY`
`protected static String`	`FORM_MANAGER_PROVIDER_ENTITY_FORM_NAME_COLUMN`
`protected static String`	`FORM_MANAGER_PROVIDER_ENTITY_ID_COLUMN`
`protected static String`	`FORM_MANAGER_PROVIDER_ENTITY_INTERACTION_MANAGER_COLUMN`
`protected static String`	`FORM_PROVIDER_ENTITY`
`protected static String`	`FORM_PROVIDER_ENTITY_FORMNAME_COLUMN`
`protected static String`	`FORM_PROVIDER_ENTITY_FORMRULE_COLUMN`
`protected static String`	`FORM_PROVIDER_ENTITY_FORMXML_COLUMN`
`protected String`	`formManagerProviderEntity`
`protected String`	`formManagerProviderEntityFormNameColumn`
`protected String`	`formManagerProviderEntityIdColumn`
`protected String`	`formManagerProviderEntityInteractionManagerColumn`
`protected String`	`formProviderEntity`
`protected String`	`formProviderEntityFormNameColumn`
`protected String`	`formProviderEntityFormRuleColumn`
`protected String`	`formProviderEntityFormXMLColumn`
`protected static String`	`ID_CARD_COLUMN`
`protected String`	`idCardColumn`
`protected Hashtable`	`idHostList`
`protected static String`	`IMAGE_PROVIDER_ENTITY`
`protected static String`	`IMAGE_PROVIDER_ENTITY_IMAGEBYTES_COLUMN`
`protected static String`	`IMAGE_PROVIDER_ENTITY_IMAGENAME_COLUMN`
`protected String`	`imageProviderEntity`
`protected String`	`imageProviderEntityImageBytesColumn`
`protected String`	`imageProviderEntityImageNameColumn`
`protected boolean`	`isZipLogFile`
`protected static String`	`JAAS_CONFIG_FILE`
`protected String`	`jaasconfigfile`
`protected String`	`kdc`
`protected static String`	`KDC`
`protected String`	`krealm`
`protected static String`	`KREALM`
`protected Hashtable`	`lastSessionAccessTimeList`
`protected LCMS`	`lcms`
`protected static String`	`LDAP_HOST`
`protected static String`	`LDAP_PORT`
`protected static String`	`LDAP_SSL`
`protected static String`	`LDAP_USERDN_KEY`
`protected String`	`ldaphost`
`protected int`	`ldapport`
`protected boolean`	`ldapSSL`
`protected Hashtable`	`loadedEntities`
`static String`	`LOCALE_ENTITY`
`static String`	`LOCALE_SUFFIX`
`protected String`	`localeEntity`
`protected String`	`localeSuffix`
`protected static String`	`LOG_BUFFER_SIZE`
`protected static String`	`LOG_FILE`
`protected StringBuffer`	`logBuffer`
`protected int`	`logBufferSize`
`protected String`	`logFile`
`protected static String`	`LOGIN_ENTITY`
`protected String`	`loginEntity`
`protected boolean`	`logSessionEvents`
`protected SecureReferenceLocator.LogStream`	`logStreamErr`
`protected SecureReferenceLocator.LogStream`	`logStreamOut`
`protected DatabaseConnectionManager`	`manager`
`protected static String`	`MAX_INACTIVE_SESSION_TIME`
`protected static String`	`MAX_LOG_FILE_SIZE`
`protected int`	`maximumLogFileSize`
`protected int`	`maximumSessionTime`
`protected int`	`maximumUsers`
`protected static String`	`MAXUSERS`
`protected static String`	`MENU_PROVIDER_ENTITY`
`protected static String`	`MENU_PROVIDER_ENTITY_XML_COLUMN`
`protected String`	`menuProviderEntity`
`protected String`	`menuProviderEntityXMLColumn`
`protected com.ontimize.locator.SecureReferenceLocator.MessagesBuffer`	`messagesBuffer`
`static int`	`MIN_COMPRESSION_THRESHOLD`
`protected static String`	`MISSING_PARAMETER`
`protected static String`	`MODULE_DISCOVERY`
`protected ModuleManager`	`moduleManager`
`protected static String`	`MODULES`
`protected static String`	`MULTICONNECTION_MANAGER`
`protected boolean`	`multiConnectionManager`
`protected String`	`multiConnectionManagerPath`
`protected static String`	`NAME_ELEMENT`
`static String`	`NOTICE_ENTITY_DESTINY_NAME`
`static String`	`NOTICE_ENTITY_NAME`
`protected String`	`noticesPath`
`protected boolean`	`noticeSystem` Removed noticeEntity because it is not necessary this variable cached.
`protected static String`	`NUMBER_ACCESS_ATTEMPTS`
`protected int`	`numberAccessAttemps`
`protected boolean`	`oneSessionAllowed`
`protected static String`	`PACKAGE`
`protected String`	`packageS`
`protected static String`	`PARAM_ELEMENT`
`protected EntitiesPropertiesParser`	`parserProperties`
`protected String`	`pathProperties`
`protected int`	`port`
`protected static String`	`PREFERENCE_CLASS`
`protected static String`	`PRINTING_TEMPLATE_ENTITY`
`protected String`	`printingTemplatesEntity`
`protected static String`	`PRIVATE_REPORT_STORE`
`protected int`	`privilegedId`
`protected Hashtable`	`propertiesEntities`
`static String`	`REFERENCE_ELEMENT`
`protected Hashtable`	`referenceClassNames`
`protected Hashtable`	`referenceInstances`
`protected Hashtable`	`referenceParameters`
`static String`	`REFERENCES`
`static String`	`REFERENCES_ELEMENT`
`protected static String`	`REMOTE_OPERATION_MANAGER`
`static String`	`REMOTE_PREFERENCES_CONFIGURATION_FILE` DatabasePreferencesProperties property
`static String`	`REMOTE_REFERENCE_ELEMENT`
`static String`	`REMOTE_REFERENCES`
`static String`	`REMOTE_REFERENCES_ELEMENT`
`protected com.ontimize.locator.SecureReferenceLocator.MessagesBuffer`	`remoteAdministrationMessagesBuffer`
`protected IRemoteLogManager`	`remoteLogManager` This object stores the users that have an open session.
`protected Hashtable<String,String>`	`remoteReferenceClassNames`
`protected Hashtable`	`remoteReferenceInstances`
`protected Hashtable<String,Hashtable>`	`remoteReferenceParameters`
`protected List`	`remoteStoreList`
`protected static String`	`REPORT_STORE`
`protected static String`	`REPORT_STORE_PATH`
`protected List`	`reportEntities`
`protected static String`	`RESTART_COMMAND`
`protected RemoteOperationManager`	`rOperationManager`
`protected RemoteApplicationPreferences`	`rPrefs`
`protected static String`	`SEARCH_USER`
`protected static String`	`SEARCH_USER_PASSWORD`
`protected static String`	`SEARCH_USER_STRING`
`protected String`	`searchUser`
`protected String`	`searchUserPassword`
`protected String`	`searchUserString`
`protected SendMailThread`	`sendMailThread`
`protected TimeZone`	`serverTimeZone`
`protected HashMap<Integer,Locale>`	`sessionLocale`
`protected HashMap<Integer,Object>`	`sessionLocaleId`
`static String`	`SSO_CONFIG_FILE`
`protected String`	`ssoconfigfile`
`protected ISSOServer`	`ssoServer`
`protected Hashtable`	`startSessionTimeList`
`static long`	`TEMPORARY_PASSWORDS_DURATION`
`protected Map<String,String>`	`temporaryUsersPasswords` Single Sign-On related methods
`protected Map<String,Timestamp>`	`temporaryUsersTimestamps`
`protected static EntityResult`	`testRE`
`protected static String`	`TOOLBAR_PROVIDER_ENTITY`
`protected static String`	`TOOLBAR_PROVIDER_ENTITY_XML_COLUMN`
`protected String`	`toolbarProviderEntity`
`protected String`	`toolbarProviderEntityXMLColumn`
`protected SecureReferenceLocator.UpdateListThread`	`updateListThread`
`protected static String`	`USE_APPLICATION_USER`
`protected boolean`	`useApplicationUser`
`protected static String`	`USER_DN_STRING`
`protected static String`	`USER_DNS_STRING` Deprecated. Use USER_DN_STRING
`protected String`	`userDNString`
`protected Vector`	`userIdList`
`protected DefaultListModel`	`userInfoListModel`
`protected static String`	`VALUE_ELEMENT`
`protected SecureReferenceLocator.TWatchDog`	`watchDog`
`protected String`	`xmlDynamicMenu`
`protected String`	`xmlDynamicToolbar`
`static String`	`ZIP_LOG_FILE`

Fields inherited from class java.rmi.server.RemoteObject
ref

Fields inherited from interface com.ontimize.locator.SecureEntityReferenceLocator
ACCESS_DENIED

Fields inherited from interface com.ontimize.gui.RemotelyManageable
ADMINISTRATION_PERMISSION, CONNECTION_INFO, IS_MULTICONNECTION, LOADED_ENTITIES, MULTICONNECTION_IDLIST, MULTICONNECTION_INFO

Constructor Summary

Constructors
Constructor and Description
`SecureReferenceLocator(DatabaseConnectionManager databaseManager, String entitiesPackage, int port)`
`SecureReferenceLocator(DatabaseConnectionManager databaseManager, String entitiesPackage, int port, boolean uniqueSession)`
`SecureReferenceLocator(DatabaseConnectionManager connectionManager, String entitiesPackage, int port, boolean uniqueSession, String loginEntity)`
`SecureReferenceLocator(int port, Hashtable params)` Creates a secure reference locator.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`addRemoteReportStore(ReportStore rs)`
`void`	`blockUserDB(String user)` Blocks an user in database
`EntityResult`	`changePassword(String password, int sessionId, Hashtable av, Hashtable kv)`
`boolean`	`checkBlockUserDB(String user)` Check if an user is blocked in database
`protected void`	`checkLogFileChange(int bytesToWriteCount)`
`void`	`checkNoticeAsSend(Object noticeKey)` This method marks the specified notice as sent
`void`	`checkNoticeSent(int sessionId, Object noticeKey)` This method sets a notices as sent
`protected boolean`	`checkTemporaryPassword(String user, String password)`
`boolean`	`checkToken(String token)`
`void`	`closeLockedConnections(String id, String databaseId)`
`void`	`closeServer()`
`void`	`closeServer(Frame fAux)`
`void`	`closeSession(int sessionId)`
`boolean`	`closeSession(String id, int sessionId)` This method close the user's session with the given sessionID.
`protected DatabaseConnectionManager`	`configureConnectionManager(boolean bStatisticViewer, URL dbPropertiesURL, URL autonumericalURL)` Deprecated.
`protected void`	`configureModuleRemoteReferences()`
`protected void`	`configureMultiConnectionManager()`
`protected void`	`configureReference(Node currentNode)`
`protected void`	`configureReferences(String xmlDefinitionResource)` The constructor of each reference must have the next parameters: EntityReferenceLocator: locator reference.
`protected void`	`configureRemoteReference(Node currentNode)`
`protected void`	`configureRemoteReferences(String xmlDefinitionResource)` The constructor of each remote reference must have the next parameters: int: rmi port EntityReferenceLocator: locator reference.
`protected DatabaseConnectionManager`	`createConnectionManager(boolean bStatisticViewer, URL dbPropertiesURL, URL autonumericalURL)`
`protected DatabaseConnectionManager`	`createConnectionManager(Hashtable databaseParams)`
`protected DatabaseEntityManager`	`createDatabaseEntityManager(Hashtable param)` Create the object to create the database entities
`protected Entity`	`createEntity(String sEntityClass, DatabaseConnectionManager entityConnectionManager, int port, String props)`
`protected Object`	`createReference(String className, Hashtable parameters)`
`protected Object`	`createRemoteReference(String className, Hashtable parameters)`
`void`	`endAdministrationSession()`
`void`	`endSession(int id)` This method finishes a client session.
`void`	`finishAdministrationRemoteSession(String id)` Method that finishes the remote session.
`protected void`	`flushLogBuffer()`
`protected void`	`forceFinishSession(int sessionId)`
`protected Class<Entity>`	`foundModuleEntityClass(String entityName)`
`void`	`freeServerResources()`
`static int`	`generatePrivilegedId()`
`boolean`	`getAccessControl()` Check if the control access attempts is enabled
`Entity`	`getAttachmentEntity(int sessionId)`
`protected Certificate`	`getCertificateFromText(String certText)`
`Hashtable`	`getConfigurationParameters(String clientName)`
`List`	`getConnectedSessionIds(int sessionId)`
`List`	`getConnectedUsers(int sessionId)`
`protected Hashtable`	`getConnectionInfo(DatabaseConnectionManager dBManager)` Method that returns the characteristics of the database connection to the given DatabaseConnecionManager.
`DatabaseConnectionManager`	`getConnectionManager()`
`int`	`getDataCompressionThreshold(int sessionId)` Gets the value of the data compression threshold for the specified user
`boolean`	`getDEBUGValueRemote(String id, String v)` Method to obtain the current value of the DEBUG Server variables.
`String`	`getDefaultPackage()`
`protected Entity`	`getEntity(String entityName)` Get a entity reference
`protected Entity`	`getEntity(String entityName, boolean checkDataBase)` Get the reference for the specified entity.
`Entity`	`getEntityReference(String entityName)` This method always throws a Exception because the secure implementation is not particularly interesting
`Entity`	`getEntityReference(String entityName, String user, int id)` This method replaces to `EntityReferenceLocator.getEntityReference(String)` and gets entity references with security
`Entity`	`getEntityReferenceFromServer(String entityName)` This method allows to get an entity reference only in the server side.
`ErrorAccessControl`	`getErrorAccessControl()` Return the ErrorAccesControl
`Hashtable`	`getFormManagerParameters(String formManagerId, int userid)`
`BytesBlock`	`getImage(String image, int userId)`
`EntityResult`	`getInternalNotices(int sessionId, boolean unsend, boolean unread, boolean deleted)` Method to get all notices for the specified user.
`String`	`getLastNCharactersFromLogFile(int nCharacters)` Method that recovers the n characters indicated from the log file.
`String`	`getLContent(int sessionId)`
`Object`	`getLInfoObject(int sessionId)`
`List`	`getLoadedEntities()`
`List`	`getLoadedEntities(int sessionId)`
`Locale`	`getLocale(int sessionId)`
`String`	`getLocaleEntity()`
`Object`	`getLocaleId(int sessionId)`
`String`	`getLogFile()`
`String`	`getLoginEntityName(int sessionId)` Get the name of the login entity (LoginEntity parameter)
`String`	`getLValue(int sessionId, String name)`
`Vector`	`getMessages(int sessionIdTo, int sessionId)`
`EntityResult`	`getNewMailNotice()` This method allows to get all e-mail notices not yet sent
`protected int`	`getNextLogFileIndex(File fileLog)` Get index of next log file and calls `#zipLogFile(String)` when `isZipLogFile` enabled.
`protected String`	`getNodeValue(Node son)`
`protected Entity`	`getNoticeEntity(String entityName, boolean isDestinyEntity)`
`String`	`getNoticeEntityDestinyName()` Get the name of the notice destiny entity
`String`	`getNoticeEntityName()` Get the name of the notice entity
`Vector`	`getNoticeTypes()` Get the identifies for all notices types in the application
`Hashtable`	`getParameters(String login, String password)`
`protected String`	`getPasswordFromCert(Certificate cert)` Returns the text of `CertificateUtils.DNIe_SERIALNUMBER` field.
`String`	`getPasswordFromCert(String certificate)` Returns the password.
`Entity`	`getPrintingTemplateEntity(int sessionId)`
`Object`	`getReference(String name)` Allows to get local references defined in 'references.xml' file when app is remote .
`Vector`	`getRemoteAdministrationMessages(int sessionIdTo, int sessionId)`
`RemoteApplicationPreferences`	`getRemoteApplicationPreferences(int sessionId)` getRemoteApplicationPreferences
`IRemoteLogManager`	`getRemoteLogManager(String id)`
`RemoteOperationManager`	`getRemoteOperationManager(int sessionId)`
`Properties`	`getRemotePreferencesFile(String id)` Method to get remotely the Server Preferences file.
`Object`	`getRemoteReference(String name)`
`Object`	`getRemoteReference(String name, int sessionId)` Gets a remote reference.
`List`	`getRemoteReportStore(int sessionId)`
`List`	`getReportEntityNames(int sessionId)`
`EntityResult`	`getSentNotices(int sessionId, Boolean deleted)` Method to query all notices sent by the specified user
`String`	`getSerial(String userAdmin, String password)`
`String`	`getServerServiceName(String clientName)`
`TimeZone`	`getServerTimeZone(int sessionId)` Get the Server TimeZone.
`int`	`getSessionId()` Always return -1 because the client session identifier is not available in server side.
`SessionInfo[]`	`getSessionInfo(String id)` This method returns the main information of all available user's sessions.
`protected Entity`	`getSpecialEntity(String entityName, String originalEntity)`
`Hashtable`	`getStartSessionTime(String id)` This method obtains a list with all the start times of all connections.
`String`	`getSuffixString()`
`Hashtable`	`getSystemInfo(String id, String key)` Method that returns system information about the connection with the database.
`String`	`getTemporaryPassword(String user)` Get a temporary password for the given user, this method is only accesible from server side.
`String`	`getToken()`
`String`	`getUser(int id)`
`protected String`	`getUserFromCert(Certificate cert)` Returns the user from certificate.
`String`	`getUserFromCert(String certificate)`
`Object`	`getUserId(int sessionId)` Get the identification of the user that must be stored in the notice system to identify this application user.
`Hashtable`	`getUserIds(String id)` This method returns a Hashtable with the current list of users's IDs.
`ListModel`	`getUserInfoListModel()`
`String`	`getXMLForm(String form, int userid)`
`String`	`getXMLMenu(int userid)`
`String`	`getXMLRules(String form, int userid)`
`String`	`getXMLToolbar(int userid)`
`boolean`	`hasSession(int sessionId)`
`boolean`	`hasSession(String user, int sessionId)` Return true if the user 'user' with session identifier 'id' has a current session opened
`static boolean`	`isAllowCertificateLogin()`
`boolean`	`isDevelopementL(int sessionId)`
`protected boolean`	`isLDAPUser(String user, String password)`
`boolean`	`isMultiConnectionManager()`
`protected boolean`	`isValidCertificateText(String certText)`
`protected Entity`	`loadEntity(String entityName, boolean checkDatabase, DatabaseConnectionManager entityConnectionManager)` Load the entity with the specified name.
`protected boolean`	`localAuthenticate(Exception e)`
`boolean`	`ok(int sessionId)`
`boolean`	`ok(int sessionId, String number)`
`boolean`	`ok(String login, String password)`
`boolean`	`ping()` unimplemented.
`void`	`reloadXMLMenu(int userid)`
`void`	`reloadXMLToolbar(int userid)`
`void`	`removeEntity(String entityName)`
`void`	`removeEntity(String entityName, int sessionId)`
`void`	`removeEntity(String id, String entityName)`
`void`	`removeReceivedNotices(int sessionId, Vector idNotices)` This method removes the specified received notices for the user with this session identifier.
`void`	`removeSentNotices(int sessionId, Vector idNotices)` This method sets the specified notices as deleted
`void`	`restartServer(String id)`
`InitialContext`	`retrieveInitialContext(int sessionId, Hashtable params)`
`byte[]`	`returnMessage(String contextRef, byte[] inData)`
`void`	`sendMessage(String message, String user, int sessionId)`
`void`	`sendMessage(UtilReferenceLocator.Message message, String user, int sessionId)`
`void`	`sendMessageToAll(String message, int sessionId)`
`void`	`sendNotice(Hashtable messageValues, int sessionId, boolean request)` Method used to send notices.
`void`	`sendRemoteAdministrationMessages(String message, int sessionId)`
`void`	`setCompressionEnabled(boolean enabled)`
`void`	`setDataCompressionThreshold(String user, int sessionId, int compressionThreshold)` Establishes the compression type for this user
`void`	`setDEBUGValueRemote(String id, String v, boolean b)` Method to set the DEBUG Server variables.
`protected void`	`setDefaultLocaleId(int sessionId)`
`void`	`setLocale(int sessionId, Locale locale)`
`void`	`setMultiConnectionManager(boolean multiConnectionManager)`
`void`	`setNoticesRead(int sessionId, Vector idNotices)` Method to set some notices as read
`void`	`setRemotePreferencesFile(String id, Properties prop)` Method to set remotely the Server Preferences file.
`void`	`setSessionIdLastAccessTime(long time, int sessionId)`
`String`	`startAdministrationRemoteSession(String user, String password)` This method starts a new remote session.
`protected int`	`startCertificateSession(String user, String password, ClientWatch clientWatch)` Checks whether session contains a valid certificate or is a usual user-password session.
`int`	`startSession(String user, String password, ClientWatch clientWatch)` Method to start a client session.
`protected int`	`startSessionInner(String user, String password, ClientWatch clientWatch)`
`protected String`	`startTemporalAdminitrationSession(String user, String password)`
`void`	`stopServer(String id)`
`boolean`	`supportChangePassword(String user, int sessionId)`
`EntityResult`	`testConnectionSpeed(int sizeInBytes, boolean compressed)` This method test the connection speed an return an EntityResult to check the line
`Hashtable`	`updateL(Hashtable h, String login, String password)`
`protected void`	`updateListInfo(Integer id)`
`protected File`	`zipLogFile(File directory, String logFilePath)` Zips custom log file just when this just reaches maximum log file capacity.

Methods inherited from class java.rmi.server.UnicastRemoteObject
clone, exportObject, exportObject, exportObject, unexportObject

Methods inherited from class java.rmi.server.RemoteServer
getClientHost, getLog, setLog

Methods inherited from class java.rmi.server.RemoteObject
equals, getRef, hashCode, toString, toStub

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

REMOTE_PREFERENCES_CONFIGURATION_FILE
```
public static final String REMOTE_PREFERENCES_CONFIGURATION_FILE
```
DatabasePreferencesProperties property

See Also:
Constant Field Values

MISSING_PARAMETER

protected static final String MISSING_PARAMETER

See Also:: Constant Field Values

FORM_PROVIDER_ENTITY

protected static final String FORM_PROVIDER_ENTITY

See Also:: Constant Field Values

FORM_PROVIDER_ENTITY_FORMNAME_COLUMN

protected static final String FORM_PROVIDER_ENTITY_FORMNAME_COLUMN

See Also:: Constant Field Values

FORM_PROVIDER_ENTITY_FORMXML_COLUMN

protected static final String FORM_PROVIDER_ENTITY_FORMXML_COLUMN

See Also:: Constant Field Values

FORM_PROVIDER_ENTITY_FORMRULE_COLUMN

protected static final String FORM_PROVIDER_ENTITY_FORMRULE_COLUMN

See Also:: Constant Field Values

FORM_MANAGER_PROVIDER_ENTITY

protected static final String FORM_MANAGER_PROVIDER_ENTITY

See Also:: Constant Field Values

FORM_MANAGER_PROVIDER_ENTITY_ID_COLUMN

protected static final String FORM_MANAGER_PROVIDER_ENTITY_ID_COLUMN

See Also:: Constant Field Values

FORM_MANAGER_PROVIDER_ENTITY_FORM_NAME_COLUMN

protected static final String FORM_MANAGER_PROVIDER_ENTITY_FORM_NAME_COLUMN

See Also:: Constant Field Values

FORM_MANAGER_PROVIDER_ENTITY_INTERACTION_MANAGER_COLUMN

protected static final String FORM_MANAGER_PROVIDER_ENTITY_INTERACTION_MANAGER_COLUMN

See Also:: Constant Field Values

IMAGE_PROVIDER_ENTITY

protected static final String IMAGE_PROVIDER_ENTITY

See Also:: Constant Field Values

IMAGE_PROVIDER_ENTITY_IMAGENAME_COLUMN

protected static final String IMAGE_PROVIDER_ENTITY_IMAGENAME_COLUMN

See Also:: Constant Field Values

IMAGE_PROVIDER_ENTITY_IMAGEBYTES_COLUMN

protected static final String IMAGE_PROVIDER_ENTITY_IMAGEBYTES_COLUMN

See Also:: Constant Field Values

MENU_PROVIDER_ENTITY

protected static final String MENU_PROVIDER_ENTITY

See Also:: Constant Field Values

MENU_PROVIDER_ENTITY_XML_COLUMN

protected static final String MENU_PROVIDER_ENTITY_XML_COLUMN

See Also:: Constant Field Values

TOOLBAR_PROVIDER_ENTITY

protected static final String TOOLBAR_PROVIDER_ENTITY

See Also:: Constant Field Values

TOOLBAR_PROVIDER_ENTITY_XML_COLUMN

protected static final String TOOLBAR_PROVIDER_ENTITY_XML_COLUMN

See Also:: Constant Field Values

PREFERENCE_CLASS

protected static final String PREFERENCE_CLASS

See Also:: Constant Field Values

DATABASE_PROPERTIES

protected static final String DATABASE_PROPERTIES

See Also:: Constant Field Values

PRINTING_TEMPLATE_ENTITY

protected static final String PRINTING_TEMPLATE_ENTITY

See Also:: Constant Field Values

PRIVATE_REPORT_STORE

protected static final String PRIVATE_REPORT_STORE

See Also:: Constant Field Values

REPORT_STORE

protected static final String REPORT_STORE

See Also:: Constant Field Values

REPORT_STORE_PATH

protected static final String REPORT_STORE_PATH

See Also:: Constant Field Values

LDAP_SSL
```
protected static final String LDAP_SSL
```
See Also:
Constant Field Values

MODULES
```
protected static final String MODULES
```
See Also:
Constant Field Values

MODULE_DISCOVERY

protected static final String MODULE_DISCOVERY

See Also:: Constant Field Values

USER_DNS_STRING
```
@Deprecated
protected static final String USER_DNS_STRING
```
Deprecated. Use USER_DN_STRING

See Also:
Constant Field Values

USER_DN_STRING

protected static final String USER_DN_STRING

See Also:: Constant Field Values

SEARCH_USER_PASSWORD

protected static final String SEARCH_USER_PASSWORD

See Also:: Constant Field Values

SEARCH_USER

protected static final String SEARCH_USER

See Also:: Constant Field Values

SEARCH_USER_STRING

protected static final String SEARCH_USER_STRING

See Also:: Constant Field Values

JAAS_CONFIG_FILE

protected static final String JAAS_CONFIG_FILE

See Also:: Constant Field Values

DOMAIN
```
protected static final String DOMAIN
```
See Also:
Constant Field Values

LDAP_PORT

protected static final String LDAP_PORT

See Also:: Constant Field Values

LDAP_HOST

protected static final String LDAP_HOST

See Also:: Constant Field Values

KDC
```
protected static final String KDC
```
See Also:
Constant Field Values

KREALM
```
protected static final String KREALM
```
See Also:
Constant Field Values

LOG_BUFFER_SIZE

protected static final String LOG_BUFFER_SIZE

See Also:: Constant Field Values

MAX_LOG_FILE_SIZE

protected static final String MAX_LOG_FILE_SIZE

See Also:: Constant Field Values

LOG_FILE
```
protected static final String LOG_FILE
```
See Also:
Constant Field Values

ZIP_LOG_FILE

public static final String ZIP_LOG_FILE

See Also:: Constant Field Values

RESTART_COMMAND

protected static final String RESTART_COMMAND

See Also:: Constant Field Values

ADMIN_PASSWORD

protected static final String ADMIN_PASSWORD

See Also:: Constant Field Values

ADMIN_USER

protected static final String ADMIN_USER

See Also:: Constant Field Values

LOGIN_ENTITY

protected static final String LOGIN_ENTITY

See Also:: Constant Field Values

ID_CARD_COLUMN

protected static final String ID_CARD_COLUMN

See Also:: Constant Field Values

USE_APPLICATION_USER

protected static final String USE_APPLICATION_USER

See Also:: Constant Field Values

CHECK_SESSIONS_TIME

protected static final String CHECK_SESSIONS_TIME

See Also:: Constant Field Values

MAX_INACTIVE_SESSION_TIME

protected static final String MAX_INACTIVE_SESSION_TIME

See Also:: Constant Field Values

CLOSE_WAIT_TIME

protected static final String CLOSE_WAIT_TIME

See Also:: Constant Field Values

MAXUSERS
```
protected static final String MAXUSERS
```
See Also:
Constant Field Values

MULTICONNECTION_MANAGER

protected static final String MULTICONNECTION_MANAGER

See Also:: Constant Field Values

PACKAGE
```
protected static final String PACKAGE
```
See Also:
Constant Field Values

REMOTE_OPERATION_MANAGER

protected static final String REMOTE_OPERATION_MANAGER

See Also:: Constant Field Values

REMOTE_REFERENCES

public static final String REMOTE_REFERENCES

See Also:: Constant Field Values

moduleManager
```
protected ModuleManager moduleManager
```

parserProperties

protected EntitiesPropertiesParser parserProperties

remoteReferenceClassNames

protected Hashtable<String,String> remoteReferenceClassNames

remoteReferenceParameters

protected Hashtable<String,Hashtable> remoteReferenceParameters

remoteReferenceInstances

protected Hashtable remoteReferenceInstances

REFERENCES
```
public static final String REFERENCES
```
See Also:
Constant Field Values

referenceClassNames

protected Hashtable referenceClassNames

referenceParameters

protected Hashtable referenceParameters

referenceInstances
```
protected Hashtable referenceInstances
```

LDAP_USERDN_KEY

protected static final String LDAP_USERDN_KEY

See Also:: Constant Field Values

formProviderEntity
```
protected String formProviderEntity
```

formProviderEntityFormNameColumn

protected String formProviderEntityFormNameColumn

formProviderEntityFormXMLColumn

protected String formProviderEntityFormXMLColumn

formProviderEntityFormRuleColumn

protected String formProviderEntityFormRuleColumn

databaseEntityManager

protected DatabaseEntityManager databaseEntityManager

imageProviderEntity
```
protected String imageProviderEntity
```

imageProviderEntityImageNameColumn

protected String imageProviderEntityImageNameColumn

imageProviderEntityImageBytesColumn

protected String imageProviderEntityImageBytesColumn

formManagerProviderEntity

protected String formManagerProviderEntity

formManagerProviderEntityIdColumn

protected String formManagerProviderEntityIdColumn

formManagerProviderEntityFormNameColumn

protected String formManagerProviderEntityFormNameColumn

formManagerProviderEntityInteractionManagerColumn

protected String formManagerProviderEntityInteractionManagerColumn

menuProviderEntity
```
protected String menuProviderEntity
```

menuProviderEntityXMLColumn

protected String menuProviderEntityXMLColumn

toolbarProviderEntity
```
protected String toolbarProviderEntity
```

toolbarProviderEntityXMLColumn

protected String toolbarProviderEntityXMLColumn

loadedEntities
```
protected Hashtable loadedEntities
```

manager

protected DatabaseConnectionManager manager

packageS
```
protected String packageS
```

maximumUsers
```
protected int maximumUsers
```

oneSessionAllowed
```
protected boolean oneSessionAllowed
```

userIdList
```
protected Vector userIdList
```

MIN_COMPRESSION_THRESHOLD

public static int MIN_COMPRESSION_THRESHOLD

sendMailThread

protected SendMailThread sendMailThread

remoteLogManager
```
protected IRemoteLogManager remoteLogManager
```
This object stores the users that have an open session. The key is the user session identifier (sessionId) and the value is the user name (User_)

currentUserList
```
protected Hashtable currentUserList
```

startSessionTimeList

protected Hashtable startSessionTimeList

lastSessionAccessTimeList

protected Hashtable lastSessionAccessTimeList

compressionThresholds

protected Hashtable compressionThresholds

clientWatchUserList

protected Hashtable clientWatchUserList

idHostList
```
protected Hashtable idHostList
```

entitiesclasses_extends

protected Hashtable entitiesclasses_extends

testRE
```
protected static EntityResult testRE
```

port
```
protected int port
```

loginEntity
```
protected String loginEntity
```

idCardColumn
```
protected String idCardColumn
```

useApplicationUser
```
protected boolean useApplicationUser
```

privilegedId
```
protected int privilegedId
```

logFile
```
protected String logFile
```

baseLogFileName
```
protected String baseLogFileName
```

fileLogExtension
```
protected String fileLogExtension
```

maximumLogFileSize
```
protected int maximumLogFileSize
```

isZipLogFile
```
protected boolean isZipLogFile
```

propertiesEntities
```
protected Hashtable propertiesEntities
```

entitiesClass
```
protected String entitiesClass
```

userInfoListModel

protected DefaultListModel userInfoListModel

maximumSessionTime
```
protected int maximumSessionTime
```

checkSessionsTime
```
protected int checkSessionsTime
```

closedServer
```
protected boolean closedServer
```

compressionEnabled
```
protected boolean compressionEnabled
```

logStreamOut

protected SecureReferenceLocator.LogStream logStreamOut

logStreamErr

protected SecureReferenceLocator.LogStream logStreamErr

updateListThread

protected SecureReferenceLocator.UpdateListThread updateListThread

logSessionEvents
```
protected boolean logSessionEvents
```

fileWriterLog
```
protected FileWriter fileWriterLog
```

buffWriterLog
```
protected BufferedWriter buffWriterLog
```

krealm
```
protected String krealm
```

kdc
```
protected String kdc
```

ldaphost
```
protected String ldaphost
```

ldapport
```
protected int ldapport
```

domain
```
protected String domain
```

jaasconfigfile
```
protected String jaasconfigfile
```

userDNString
```
protected String userDNString
```

searchUserString
```
protected String searchUserString
```

searchUser
```
protected String searchUser
```

searchUserPassword
```
protected String searchUserPassword
```

ldapSSL
```
protected boolean ldapSSL
```

reportEntities
```
protected List reportEntities
```

attachmentEntity
```
protected String attachmentEntity
```

attachmentPath
```
protected String attachmentPath
```

printingTemplatesEntity

protected String printingTemplatesEntity

rPrefs

protected RemoteApplicationPreferences rPrefs

encrypt
```
protected boolean encrypt
```

pathProperties
```
protected String pathProperties
```

defaultNoticeEntityClass

protected static String defaultNoticeEntityClass

defaultNoticeDestinyEntityClass

protected static String defaultNoticeDestinyEntityClass

NOTICE_ENTITY_NAME

public static String NOTICE_ENTITY_NAME

NOTICE_ENTITY_DESTINY_NAME

public static String NOTICE_ENTITY_DESTINY_NAME

noticesPath
```
protected String noticesPath
```

noticeSystem
```
protected boolean noticeSystem
```
Removed noticeEntity because it is not necessary this variable cached. It is just stored in loadedentities variable.

Since:

5.2073EN-0.3

CA_CERTIFICATES_PROP

public static final String CA_CERTIFICATES_PROP

See Also:: Constant Field Values

CRL_CERTIFICATES_PROP

public static final String CRL_CERTIFICATES_PROP

See Also:: Constant Field Values

ALLOW_CERTIFICATE_LOGIN

public static final String ALLOW_CERTIFICATE_LOGIN

See Also:: Constant Field Values

SSO_CONFIG_FILE

public static final String SSO_CONFIG_FILE

See Also:: Constant Field Values

ssoconfigfile
```
protected String ssoconfigfile
```

allowSSOLogin
```
protected static boolean allowSSOLogin
```

sessionLocale

protected HashMap<Integer,Locale> sessionLocale

sessionLocaleId

protected HashMap<Integer,Object> sessionLocaleId

LOCALE_ENTITY

public static final String LOCALE_ENTITY

See Also:: Constant Field Values

LOCALE_SUFFIX

public static final String LOCALE_SUFFIX

See Also:: Constant Field Values

CONTROL_ACCESS_ATTEMPTS

protected static final String CONTROL_ACCESS_ATTEMPTS

See Also:: Constant Field Values

NUMBER_ACCESS_ATTEMPTS

protected static final String NUMBER_ACCESS_ATTEMPTS

See Also:: Constant Field Values

localeEntity
```
protected String localeEntity
```

localeSuffix
```
protected String localeSuffix
```

controlAccessAttempt
```
protected boolean controlAccessAttempt
```

numberAccessAttemps
```
protected int numberAccessAttemps
```

errorAccessControl

protected ErrorAccessControl errorAccessControl

multiConnectionManager

protected boolean multiConnectionManager

serverTimeZone
```
protected TimeZone serverTimeZone
```

multiConnectionManagerPath

protected String multiConnectionManagerPath

watchDog

protected SecureReferenceLocator.TWatchDog watchDog

REMOTE_REFERENCES_ELEMENT

public static final String REMOTE_REFERENCES_ELEMENT

See Also:: Constant Field Values

REMOTE_REFERENCE_ELEMENT

public static final String REMOTE_REFERENCE_ELEMENT

See Also:: Constant Field Values

PARAM_ELEMENT

protected static final String PARAM_ELEMENT

See Also:: Constant Field Values

NAME_ELEMENT

protected static final String NAME_ELEMENT

See Also:: Constant Field Values

CLASS_ELEMENT

protected static final String CLASS_ELEMENT

See Also:: Constant Field Values

VALUE_ELEMENT

protected static final String VALUE_ELEMENT

See Also:: Constant Field Values

REFERENCES_ELEMENT

public static final String REFERENCES_ELEMENT

See Also:: Constant Field Values

REFERENCE_ELEMENT

public static final String REFERENCE_ELEMENT

See Also:: Constant Field Values

logBuffer
```
protected StringBuffer logBuffer
```

logBufferSize
```
protected int logBufferSize
```

messagesBuffer

protected com.ontimize.locator.SecureReferenceLocator.MessagesBuffer messagesBuffer

remoteAdministrationMessagesBuffer

protected com.ontimize.locator.SecureReferenceLocator.MessagesBuffer remoteAdministrationMessagesBuffer

remoteStoreList
```
protected List remoteStoreList
```

lcms
```
protected LCMS lcms
```

xmlDynamicMenu
```
protected String xmlDynamicMenu
```

xmlDynamicToolbar
```
protected String xmlDynamicToolbar
```

rOperationManager

protected RemoteOperationManager rOperationManager

ssoServer
```
protected ISSOServer ssoServer
```

temporaryUsersPasswords

protected Map<String,String> temporaryUsersPasswords

Single Sign-On related methods

temporaryUsersTimestamps

protected Map<String,Timestamp> temporaryUsersTimestamps

TEMPORARY_PASSWORDS_DURATION

public static long TEMPORARY_PASSWORDS_DURATION

Constructor Detail
- SecureReferenceLocator
```
public SecureReferenceLocator(int port,
                      Hashtable params)
                       throws Exception
```
  Creates a secure reference locator. A database connection manager is also created automatically.
  Parameters:
  port -
  params - Parameters:
  
  Package:Entities classes package (with final dot)
  
  LogFile: File name with the local messages in the server side. To use this file the output System.out and/or System.err must be redirect to this file. ServerMonitor does it if it is specified.
  
  MaxLogFileSize: specifies the max size of log file (Kbytes). When the file exceeds this size a new log file is created in the same directory with the same name and a integer number at the end (1, 2, 3, etc). The file name can not have dots to avoid problems creating new log files with secuential number. This is an optional paramer, if not exist only one log file is created.
  
  LogBufferSize: buffer size of the log file (Bytes). Default values is 20480. A value small or big can diminish the performance
  
  DatabaseProperties
  
  AutonumericalProperties
  
  LoginEntity
  
  Viewer
  
  MaxUsers
  
  AdminUser
  
  AdminPassword
  
  RestartCommand
  
  MaxInactiveSessionTime
  
  CheckSessionTime
  
  EntityProperties: This parameter specifies the properties file that contains the definition of some entities. This entities are implemented with TableEntity class and will be automatically generated. Each line in this file represents one entity. File format is: "entity_name entity_properties_path"
  
  ReportEntities: Entity names list for the report designer. Default value is empty. Format is: "entity_name1;entity_name2
  
  Preferences: Remote preferences file name
  
  PreferencePath: Path (can contains . and ..) for remote preferences. Default value is '.'
  
  ReportStore: Remote report store description. This parameters ir required to use the remote repository
  
  ReportStorePath: Remote repository path. Default value is '.'
  
  AttachmentEntity: Entity to manage the standard attachment files.
  
  AttachmentEntityPath: Path where the attachment files are stored.
  
  MultiConnectionManager: Connection manager configuration file path (default connection manager not included).
  
  The next parameters are optional and, in case they are specified, a LDAP server will be used as authentification mechanism:
  
  UserDNSString: String related to the user credentials. The substring %USER% will be replaced in UserDNSString by the LDAP user login. example: 'cn=%USER%,ou=people,cn=imatia,cn=com'
  
  SearchUserString: String to look up the user credential in the directory. When specified, The substring %USER% will be replaced in SearchUserString by the LDAP user login. If the parameter 'UserDNSString' has been set, that parameter will be used as DN base for searching, and also the parameters 'SearchUser' and 'SearchUserPassword' must be especified.
  
  SearchUser: LDAP login used to search in the directory
  
  SearchUserPassword: Password of the user to search in the directory
  
  LDAPHost: Host LDAP
  
  LDAPPort: LDAP port. Optional. Default value is 389.
  
  LDAPSSL: Specifies if the connection uses SSL. Values 'yes', 'no'. Default value, 'no'.
  
  Domain: Domain name. Optional, when UPNs is used
  The following parameters will be set only when using secure authentification (GSSAPI):
  JAASConfigFile: JAAS file configuration path. The default file content must be:
  
  LDAP { com.sun.security.auth.module.Krb5LoginModule required; };
  KREALM: Kerberos Realm: In most cases, your Kerberos realm is your domain name, in upper-case letters. Usually this is the LDAP machine domain
  
  KDC: Kerberos Key Distribution Center. A machine that issues Kerberos tickets
  
  LocaleEntity: Specify the locale entity (Which extends from LocaleEntity)
  
  ControlAccessAttempts: 'true' to block an user when insert its password 5 times wrong. 'false' otherwise or if the property don't exist
  Throws:
  
  Exception
- SecureReferenceLocator
```
public SecureReferenceLocator(DatabaseConnectionManager connectionManager,
                      String entitiesPackage,
                      int port,
                      boolean uniqueSession,
                      String loginEntity)
                       throws Exception
```
  Throws:
  
  Exception
- SecureReferenceLocator
```
public SecureReferenceLocator(DatabaseConnectionManager databaseManager,
                      String entitiesPackage,
                      int port)
                       throws Exception
```
  Throws:
  
  Exception
- SecureReferenceLocator
```
public SecureReferenceLocator(DatabaseConnectionManager databaseManager,
                      String entitiesPackage,
                      int port,
                      boolean uniqueSession)
                       throws Exception
```
  Throws:
  
  Exception

Method Detail

isAllowCertificateLogin

public static boolean isAllowCertificateLogin()

isMultiConnectionManager

public boolean isMultiConnectionManager()

setMultiConnectionManager

public void setMultiConnectionManager(boolean multiConnectionManager)

configureConnectionManager

@Deprecated
protected DatabaseConnectionManager configureConnectionManager(boolean bStatisticViewer,
                                                              URL dbPropertiesURL,
                                                              URL autonumericalURL)
                                                        throws Exception

Deprecated.

Parameters:: bStatisticViewer -; dbPropertiesURL -; autonumericalURL -
Returns:
Throws:: Exception

createConnectionManager

protected DatabaseConnectionManager createConnectionManager(boolean bStatisticViewer,
                                                URL dbPropertiesURL,
                                                URL autonumericalURL)
                                                     throws Exception

Throws:: Exception

createConnectionManager

protected DatabaseConnectionManager createConnectionManager(Hashtable databaseParams)
                                                     throws Exception

Throws:: Exception

createDatabaseEntityManager

protected DatabaseEntityManager createDatabaseEntityManager(Hashtable param)
                                                     throws Exception

Create the object to create the database entities

Parameters:: param -
Returns:
Throws:: Exception

configureRemoteReferences

protected void configureRemoteReferences(String xmlDefinitionResource)

The constructor of each remote reference must have the next parameters:

int: rmi port
EntityReferenceLocator: locator reference.
Hashtable: Entry parameters

Example of xml definition.


 <RemoteReferences>
        <RemoteReference>
                <Name>name</Name>
                <Class>className</Class>
                <Param>
                        <Name>paramName1</Name>
                        <Value>paramValue1</Value>
                </Param>
                <Param>
                        <Name>paramName2</Name>
                        <Value>paramValue2</Value>
                </Param>
        </RemoteReference>
 </RemoteReferences>

Parameters:: xmlDefinitionResource - resource path where is loaded the xml definition in.

configureModuleRemoteReferences

protected void configureModuleRemoteReferences()

configureRemoteReference

protected void configureRemoteReference(Node currentNode)
                                 throws Exception

Throws:: Exception

configureReferences

protected void configureReferences(String xmlDefinitionResource)

The constructor of each reference must have the next parameters:

EntityReferenceLocator: locator reference.
Hashtable: Entry parameters

Example of xml definition.


 <References>
        <Reference>
                <Name>name</Name>
                <Class>className</Class>
                <Param>
                        <Name>paramName1</Name>
                        <Value>paramValue1</Value>
                </Param>
                <Param>
                        <Name>paramName2</Name>
                        <Value>paramValue2</Value>
                </Param>
        </Reference>
 </References>

Parameters:: xmlDefinitionResource - resource path where is loaded the xml definition in.

configureReference

protected void configureReference(Node currentNode)
                           throws Exception

Throws:: Exception

configureMultiConnectionManager

protected void configureMultiConnectionManager()

getNodeValue

protected String getNodeValue(Node son)

getEntityReference
```
public Entity getEntityReference(String entityName)
                          throws Exception
```
This method always throws a Exception because the secure implementation is not particularly interesting

Specified by:

getEntityReference in interface EntityReferenceLocator

Parameters:
entityName - Entity name

Returns:

Throws:

Exception

getSessionId
```
public int getSessionId()
```
Always return -1 because the client session identifier is not available in server side.

Specified by:

getSessionId in interface EntityReferenceLocator

Returns:
Client session identifier.

getEntityReferenceFromServer
```
public Entity getEntityReferenceFromServer(String entityName)
```
Description copied from interface: ServerReferenceLocator

This method allows to get an entity reference only in the server side.

Specified by:

getEntityReferenceFromServer in interface ServerReferenceLocator

Parameters:
entityName - Entity name

Returns:

getSpecialEntity

protected Entity getSpecialEntity(String entityName,
                      String originalEntity)

getNoticeEntity

protected Entity getNoticeEntity(String entityName,
                     boolean isDestinyEntity)

getEntity
```
protected Entity getEntity(String entityName)
```
Get a entity reference

Parameters:
entityName -

Returns:
See Also:
getEntity(String, boolean)

getEntity
```
protected Entity getEntity(String entityName,
               boolean checkDataBase)
```
Get the reference for the specified entity. If the entity is already loaded then return the reference, in other case it loads the entity and then return it

Parameters:
entityName - Name of the entity
checkDataBase - If true then it checks if this entity name exists in the database, only if database entities provider has been configured

Returns:

createEntity

protected Entity createEntity(String sEntityClass,
                  DatabaseConnectionManager entityConnectionManager,
                  int port,
                  String props)
                       throws Exception

Throws:: Exception

foundModuleEntityClass

protected Class<Entity> foundModuleEntityClass(String entityName)

loadEntity
```
protected Entity loadEntity(String entityName,
                boolean checkDatabase,
                DatabaseConnectionManager entityConnectionManager)
                     throws Exception
```
Load the entity with the specified name. First of all and only if checkDatabase is true it searches the properties in the database. Secondly it search the entity name in the entities properties file and if it exists then creates a default entity object. At last, if entity has not been created yet then use the name of the entity to search for a class with the same name and uses this class.

Parameters:
entityName - Name of the entity
checkDatabase - If this is true then use the database to search for the properties, the class name and the alias to configure the entity
entityConnectionManager - DatabaseConnectionManager configured for this entity name

Returns:

Throws:

Exception

removeEntity

public void removeEntity(String entityName,
                int sessionId)
                  throws Exception

Specified by:: removeEntity in interface UtilReferenceLocator
Throws:: Exception

removeEntity
```
public void removeEntity(String entityName)
                  throws Exception
```
Specified by:

removeEntity in interface ServerReferenceLocator

Throws:

Exception

getLoadedEntities
```
public List getLoadedEntities()
```
Specified by:

getLoadedEntities in interface ServerReferenceLocator

getLoadedEntities
```
public List getLoadedEntities(int sessionId)
                       throws Exception
```
Specified by:

getLoadedEntities in interface UtilReferenceLocator

Throws:

Exception

getEntityReference
```
public Entity getEntityReference(String entityName,
                        String user,
                        int id)
                          throws Exception
```
Description copied from interface: SecureEntityReferenceLocator

This method replaces to EntityReferenceLocator.getEntityReference(String) and gets entity references with security

Specified by:

getEntityReference in interface SecureEntityReferenceLocator

Parameters:
entityName - Requested entity name
user - Name of the user who is asking for the reference
id - Session identifier for the user who is asking the reference

Returns:
Entity, or null if this entity no exist or the user authentification is wrong

Throws:

Exception

startSession
```
public int startSession(String user,
               String password,
               ClientWatch clientWatch)
                 throws Exception
```
Description copied from interface: EntityReferenceLocator

Method to start a client session. Entity reference locator returns an integer value that must be used in all entity requests.

Specified by:

startSession in interface EntityReferenceLocator

Parameters:
user - User name
password - User password
clientWatch - Object to checks if this session is open

Returns:
Integer value not negative used to identifier this client and allows him to get entity references

Throws:

Exception

setDefaultLocaleId

protected void setDefaultLocaleId(int sessionId)

getCertificateFromText

protected Certificate getCertificateFromText(String certText)
                                      throws Exception

Throws:: Exception

isValidCertificateText

protected boolean isValidCertificateText(String certText)

startCertificateSession
```
protected int startCertificateSession(String user,
                          String password,
                          ClientWatch clientWatch)
                               throws Exception
```
Checks whether session contains a valid certificate or is a usual user-password session.

Parameters:
user - Application user
password - Application password or when is certificated corresponds with certificate content.
clientWatch -

Returns:
the session identifier

Throws:

Exception - When locator throws invalid session Exception

startSessionInner

protected int startSessionInner(String user,
                    String password,
                    ClientWatch clientWatch)
                         throws Exception

Throws:: Exception

endSession
```
public void endSession(int id)
                throws Exception
```
Description copied from interface: EntityReferenceLocator

This method finishes a client session. When this method is called, the entity reference locator does not provide more entity references to this client identifier.

Specified by:

endSession in interface EntityReferenceLocator

Parameters:
id - Client session identifier

Throws:

Exception

getUser

public String getUser(int id)
               throws Exception

Throws:: Exception

testConnectionSpeed
```
public EntityResult testConnectionSpeed(int sizeInBytes,
                               boolean compressed)
                                 throws Exception
```
Description copied from interface: ConnectionOptimizer

This method test the connection speed an return an EntityResult to check the line

Specified by:

testConnectionSpeed in interface ConnectionOptimizer

Returns:

Throws:

Exception

setDataCompressionThreshold
```
public void setDataCompressionThreshold(String user,
                               int sessionId,
                               int compressionThreshold)
```
Establishes the compression type for this user

Specified by:

setDataCompressionThreshold in interface ConnectionOptimizer

Parameters:
user - User name
sessionId - User session identifier
compressionThreshold - Compression threshold value

updateListInfo

protected void updateListInfo(Integer id)

localAuthenticate

protected boolean localAuthenticate(Exception e)

getDataCompressionThreshold
```
public int getDataCompressionThreshold(int sessionId)
```
Description copied from interface: ConnectionOptimizer

Gets the value of the data compression threshold for the specified user

Specified by:

getDataCompressionThreshold in interface ConnectionOptimizer

Parameters:
sessionId - User session identifier

Returns:

setSessionIdLastAccessTime

public void setSessionIdLastAccessTime(long time,
                              int sessionId)

hasSession

public boolean hasSession(int sessionId)

hasSession
```
public boolean hasSession(String user,
                 int sessionId)
                   throws Exception
```
Description copied from interface: SecureEntityReferenceLocator

Return true if the user 'user' with session identifier 'id' has a current session opened

Specified by:

hasSession in interface SecureEntityReferenceLocator

Returns:

Throws:

Exception

startAdministrationRemoteSession
```
public String startAdministrationRemoteSession(String user,
                                      String password)
                                        throws Exception
```
Description copied from interface: RemotelyManageable

This method starts a new remote session. It returns a String that are going to be the ID that allows to perform any remote action in the server.

Specified by:

startAdministrationRemoteSession in interface RemotelyManageable

Parameters:
user - String with the user.
password - String with the password.

Returns:
a String with the administrator id of the remote session.

Throws:

Exception

startTemporalAdminitrationSession

protected String startTemporalAdminitrationSession(String user,
                                       String password)
                                            throws Exception

Throws:: Exception

closeSession
```
public boolean closeSession(String id,
                   int sessionId)
                     throws Exception
```
Description copied from interface: RemotelyManageable

This method close the user's session with the given sessionID.

Specified by:

closeSession in interface RemotelyManageable

Parameters:
id - String with the administrator id of the remote session.
sessionId - int with the session id of the user's session.

Returns:
a boolean with the result of the operation.

Throws:

Exception

getStartSessionTime
```
public Hashtable getStartSessionTime(String id)
                              throws Exception
```
Description copied from interface: RemotelyManageable

This method obtains a list with all the start times of all connections.

Specified by:

getStartSessionTime in interface RemotelyManageable

Parameters:
id - String with the administrator id of the remote session.

Returns:
a Hashtable with the values.

Throws:

Exception

getUserIds
```
public Hashtable getUserIds(String id)
                     throws Exception
```
Description copied from interface: RemotelyManageable

This method returns a Hashtable with the current list of users's IDs.

Specified by:

getUserIds in interface RemotelyManageable

Parameters:
id - String with the administrator id of the remote session.

Returns:
a Hashtable with the user's IDs.

Throws:

Exception

getConnectedUsers
```
public List getConnectedUsers(int sessionId)
                       throws Exception
```
Specified by:

getConnectedUsers in interface UtilReferenceLocator

Throws:

Exception

getConnectedSessionIds
```
public List getConnectedSessionIds(int sessionId)
                            throws Exception
```
Specified by:

getConnectedSessionIds in interface UtilReferenceLocator

Throws:

Exception

getRemoteLogManager

public IRemoteLogManager getRemoteLogManager(String id)
                                      throws Exception

Specified by:: getRemoteLogManager in interface RemotelyManageable
Throws:: Exception

freeServerResources
```
public void freeServerResources()
```

closeServer
```
public void closeServer(Frame fAux)
```

closeServer
```
public void closeServer()
```

stopServer
```
public void stopServer(String id)
                throws Exception
```
Specified by:

stopServer in interface RemotelyManageable

Throws:

Exception

restartServer
```
public void restartServer(String id)
                   throws Exception
```
Specified by:

restartServer in interface RemotelyManageable

Throws:

Exception

finishAdministrationRemoteSession
```
public void finishAdministrationRemoteSession(String id)
                                       throws Exception
```
Description copied from interface: RemotelyManageable

Method that finishes the remote session.

Specified by:

finishAdministrationRemoteSession in interface RemotelyManageable

Parameters:
id - String with the administrator id of the remote session.

Throws:

Exception

endAdministrationSession

public void endAdministrationSession()
                              throws Exception

Throws:: Exception

getUserInfoListModel

public ListModel getUserInfoListModel()

getConnectionManager

public DatabaseConnectionManager getConnectionManager()

setCompressionEnabled

public void setCompressionEnabled(boolean enabled)

closeSession

public void closeSession(int sessionId)

forceFinishSession

protected void forceFinishSession(int sessionId)

generatePrivilegedId

public static int generatePrivilegedId()

getLogFile
```
public String getLogFile()
```

checkLogFileChange

protected void checkLogFileChange(int bytesToWriteCount)

getNextLogFileIndex
```
protected int getNextLogFileIndex(File fileLog)
```
Get index of next log file and calls #zipLogFile(String) when isZipLogFile enabled.

Returns:
index of next log file to be generated
Since:

5.2068EN-0.2

zipLogFile
```
protected File zipLogFile(File directory,
              String logFilePath)
```
Zips custom log file just when this just reaches maximum log file capacity.

Returns:
Created .zip file
Since:

5.2068EN-0.2

flushLogBuffer
```
protected void flushLogBuffer()
```

getLastNCharactersFromLogFile
```
public String getLastNCharactersFromLogFile(int nCharacters)
                                     throws Exception
```
Description copied from interface: RemotelyManageable

Method that recovers the n characters indicated from the log file. If a -1 is passed as parameter the method returns the entire log file.

Specified by:

getLastNCharactersFromLogFile in interface RemotelyManageable

Parameters:
nCharacters - int with the number of characters that will be recovered.

Returns:
a String with the characters of the log file.

Throws:

Exception

getSessionInfo
```
public SessionInfo[] getSessionInfo(String id)
                             throws Exception
```
Description copied from interface: RemotelyManageable
This method returns the main information of all available user's sessions. The information available of each session is:
- SessionID. The sessionID
- User. The user of the session.
- InitSessionDate. The time of the beginning of the session.
- From. The host where the session has been started.
- LastAccess. The time of the last access.
Specified by:

getSessionInfo in interface RemotelyManageable

Parameters:
id - String with the administrator id of the remote session.

Returns:
a SessionInfo[] with the information of the sessions.

Throws:

Exception

getMessages

public Vector getMessages(int sessionIdTo,
                 int sessionId)
                   throws Exception

Specified by:: getMessages in interface UtilReferenceLocator
Throws:: Exception

getRemoteAdministrationMessages

public Vector getRemoteAdministrationMessages(int sessionIdTo,
                                     int sessionId)
                                       throws Exception

Specified by:: getRemoteAdministrationMessages in interface UtilReferenceLocator
Throws:: Exception

sendMessage

public void sendMessage(UtilReferenceLocator.Message message,
               String user,
               int sessionId)
                 throws Exception

Specified by:: sendMessage in interface UtilReferenceLocator
Throws:: Exception

sendMessage

public void sendMessage(String message,
               String user,
               int sessionId)
                 throws Exception

Specified by:: sendMessage in interface UtilReferenceLocator
Throws:: Exception

sendMessageToAll

public void sendMessageToAll(String message,
                    int sessionId)
                      throws Exception

Specified by:: sendMessageToAll in interface UtilReferenceLocator
Throws:: Exception

sendRemoteAdministrationMessages

public void sendRemoteAdministrationMessages(String message,
                                    int sessionId)
                                      throws Exception

Specified by:: sendRemoteAdministrationMessages in interface UtilReferenceLocator
Throws:: Exception

getAttachmentEntity

public Entity getAttachmentEntity(int sessionId)
                           throws Exception

Specified by:: getAttachmentEntity in interface UtilReferenceLocator
Throws:: Exception

getPrintingTemplateEntity

public Entity getPrintingTemplateEntity(int sessionId)
                                 throws Exception

Specified by:: getPrintingTemplateEntity in interface UtilReferenceLocator
Throws:: Exception

getSerial

public String getSerial(String userAdmin,
               String password)
                 throws Exception

Throws:: Exception

ping
```
public boolean ping()
             throws Exception
```
Description copied from interface: RemotelyManageable

unimplemented.

Specified by:

ping in interface RemotelyManageable

Returns:

Throws:

Exception

getRemoteReportStore
```
public List getRemoteReportStore(int sessionId)
                          throws Exception
```
Specified by:

getRemoteReportStore in interface RemoteReportReferencer

Throws:

Exception

addRemoteReportStore

public void addRemoteReportStore(ReportStore rs)
                          throws Exception

Throws:: Exception

isLDAPUser

protected boolean isLDAPUser(String user,
                 String password)

getReportEntityNames
```
public List getReportEntityNames(int sessionId)
                          throws Exception
```
Specified by:

getReportEntityNames in interface RemoteReportReferencer

Throws:

Exception

getRemoteApplicationPreferences
```
public RemoteApplicationPreferences getRemoteApplicationPreferences(int sessionId)
                                                             throws Exception
```
getRemoteApplicationPreferences

Specified by:

getRemoteApplicationPreferences in interface RemoteApplicationPreferenceReferencer

Parameters:
sessionId - User session identifier

Returns:
RemoteApplicationPreferences

Throws:

Exception

getParameters

public Hashtable getParameters(String login,
                      String password)
                        throws Exception

Specified by:: getParameters in interface RemoteLControlAdministration
Throws:: Exception

updateL

public Hashtable updateL(Hashtable h,
                String login,
                String password)
                  throws Exception

Specified by:: updateL in interface RemoteLControlAdministration
Throws:: Exception

ok

public boolean ok(String login,
         String password)
           throws Exception

Specified by:: ok in interface RemoteLControlAdministration
Throws:: Exception

ok

public boolean ok(int sessionId)
           throws Exception

Specified by:: ok in interface RemoteLOk
Throws:: Exception

isDevelopementL

public boolean isDevelopementL(int sessionId)
                        throws Exception

Specified by:: isDevelopementL in interface RemoteLOk
Throws:: Exception

ok

public boolean ok(int sessionId,
         String number)
           throws Exception

Specified by:: ok in interface RemoteLOk
Throws:: Exception

getLValue

public String getLValue(int sessionId,
               String name)
                 throws Exception

Specified by:: getLValue in interface RemoteLOk
Throws:: Exception

getLContent

public String getLContent(int sessionId)
                   throws Exception

Specified by:: getLContent in interface RemoteLOk
Throws:: Exception

getLInfoObject

public Object getLInfoObject(int sessionId)
                      throws Exception

Specified by:: getLInfoObject in interface RemoteLOk
Throws:: Exception

sendNotice
```
public void sendNotice(Hashtable messageValues,
              int sessionId,
              boolean request)
                throws Exception
```
Description copied from interface: INoticeSystem

Method used to send notices. This method insert the notice in the notice entity and insert all destinies in the destiny notice entity

Specified by:

sendNotice in interface INoticeSystem

request - If this is true, the notices is a request notice. In this case the correct template must be selected

Throws:

Exception

getInternalNotices
```
public EntityResult getInternalNotices(int sessionId,
                              boolean unsend,
                              boolean unread,
                              boolean deleted)
                                throws Exception
```
Description copied from interface: INoticeSystem

Method to get all notices for the specified user.
In this method is possible specified if the user wants all messages or only unread ones

Specified by:

getInternalNotices in interface INoticeSystem

Parameters:
sessionId - User session identifier
unsend - When this is true only return the unsend notices
unread - When this is true ontly return the unread notices

Returns:

Throws:

Exception

setNoticesRead
```
public void setNoticesRead(int sessionId,
                  Vector idNotices)
                    throws Exception
```
Description copied from interface: INoticeSystem

Method to set some notices as read

Specified by:

setNoticesRead in interface INoticeSystem

Parameters:
sessionId - User session identifier
idNotices - Array with the notice keys

Throws:

Exception

getSentNotices
```
public EntityResult getSentNotices(int sessionId,
                          Boolean deleted)
                            throws Exception
```
Description copied from interface: INoticeSystem

Method to query all notices sent by the specified user

Specified by:

getSentNotices in interface INoticeSystem

Parameters:
sessionId - User session identifier
deleted - deleted = true only query the deleted notices
deleted = false only query not deleted notices
deleted = null query all sent notices

Returns:

Throws:

Exception

checkNoticeSent
```
public void checkNoticeSent(int sessionId,
                   Object noticeKey)
                     throws Exception
```
Description copied from interface: INoticeSystem

This method sets a notices as sent

Specified by:

checkNoticeSent in interface INoticeSystem

Parameters:
sessionId - User session identifier
noticeKey - Notice key.

Throws:

Exception

removeSentNotices
```
public void removeSentNotices(int sessionId,
                     Vector idNotices)
                       throws Exception
```
Description copied from interface: INoticeSystem

This method sets the specified notices as deleted

Specified by:

removeSentNotices in interface INoticeSystem

Parameters:
sessionId - User session identifier
idNotices - Keys of the notices to remove

Throws:

Exception

removeReceivedNotices
```
public void removeReceivedNotices(int sessionId,
                         Vector idNotices)
                           throws Exception
```
Description copied from interface: INoticeSystem

This method removes the specified received notices for the user with this session identifier.

Specified by:

removeReceivedNotices in interface INoticeSystem

Parameters:
sessionId - User session identifier
idNotices - Notice keys

Throws:

Exception

getNoticeTypes
```
public Vector getNoticeTypes()
                      throws Exception
```
Description copied from interface: INoticeSystem

Get the identifies for all notices types in the application

Specified by:

getNoticeTypes in interface INoticeSystem

Returns:

Throws:

Exception

getNoticeEntityName
```
public String getNoticeEntityName()
```
Description copied from interface: INoticeSystem

Get the name of the notice entity

Specified by:

getNoticeEntityName in interface INoticeSystem

Returns:

getNoticeEntityDestinyName
```
public String getNoticeEntityDestinyName()
```
Description copied from interface: INoticeSystem

Get the name of the notice destiny entity

Specified by:

getNoticeEntityDestinyName in interface INoticeSystem

Returns:

getNewMailNotice
```
public EntityResult getNewMailNotice()
                              throws Exception
```
Description copied from interface: INoticeSendMails

This method allows to get all e-mail notices not yet sent

Specified by:

getNewMailNotice in interface INoticeSendMails

Returns:

Throws:

Exception

checkNoticeAsSend
```
public void checkNoticeAsSend(Object noticeKey)
                       throws Exception
```
Description copied from interface: INoticeSendMails

This method marks the specified notice as sent

Specified by:

checkNoticeAsSend in interface INoticeSendMails

Parameters:
noticeKey - Notice key

Throws:

Exception

getUserId
```
public Object getUserId(int sessionId)
                 throws Exception
```
Description copied from interface: INoticeSystem

Get the identification of the user that must be stored in the notice system to identify this application user. In this way the identification of a user can be not only a string.

Specified by:

getUserId in interface INoticeSystem

Parameters:
sessionId - User session identifier

Returns:

Throws:

Exception

reloadXMLMenu
```
public void reloadXMLMenu(int userid)
                   throws Exception
```
Specified by:

reloadXMLMenu in interface XMLClientProvider

Throws:

Exception

getXMLMenu

public String getXMLMenu(int userid)
                  throws Exception

Specified by:: getXMLMenu in interface XMLClientProvider
Throws:: Exception

reloadXMLToolbar
```
public void reloadXMLToolbar(int userid)
                      throws Exception
```
Specified by:

reloadXMLToolbar in interface XMLClientProvider

Throws:

Exception

getXMLToolbar

public String getXMLToolbar(int userid)
                     throws Exception

Specified by:: getXMLToolbar in interface XMLClientProvider
Throws:: Exception

getFormManagerParameters

public Hashtable getFormManagerParameters(String formManagerId,
                                 int userid)
                                   throws Exception

Specified by:: getFormManagerParameters in interface XMLClientProvider
Throws:: Exception

getXMLForm

public String getXMLForm(String form,
                int userid)
                  throws Exception

Specified by:: getXMLForm in interface XMLFormProvider
Throws:: Exception

getImage

public BytesBlock getImage(String image,
                  int userId)
                    throws Exception

Specified by:: getImage in interface XMLClientProvider
Throws:: Exception

getXMLRules

public String getXMLRules(String form,
                 int userid)
                   throws Exception

Specified by:: getXMLRules in interface XMLClientProvider
Throws:: Exception

getRemoteOperationManager

public RemoteOperationManager getRemoteOperationManager(int sessionId)
                                                 throws Exception

Specified by:: getRemoteOperationManager in interface UtilReferenceLocator
Throws:: Exception

getDefaultPackage
```
public String getDefaultPackage()
```

getRemoteReference
```
public Object getRemoteReference(String name,
                        int sessionId)
                          throws Exception
```
Description copied from interface: UtilReferenceLocator

Gets a remote reference.

Specified by:

getRemoteReference in interface UtilReferenceLocator

Returns:

Throws:

Exception
See Also:
SecureReferenceLocator#configureRemoteReferences(String)}

getRemoteReference

public Object getRemoteReference(String name)
                          throws Exception

Throws:: Exception

createRemoteReference

protected Object createRemoteReference(String className,
                           Hashtable parameters)
                                throws Exception

Throws:: Exception

createReference

protected Object createReference(String className,
                     Hashtable parameters)
                          throws Exception

Throws:: Exception

getReference
```
public Object getReference(String name)
                    throws Exception
```
Description copied from interface: ServerReferenceLocator

Allows to get local references defined in 'references.xml' file when app is remote .

Specified by:

getReference in interface ServerReferenceLocator

Parameters:
name - The name of reference defined in 'references.xml' file.

Returns:
Object for this reference

Throws:

Exception - when something fails.

getServerTimeZone
```
public TimeZone getServerTimeZone(int sessionId)
                           throws Exception
```
Description copied from interface: UtilReferenceLocator

Get the Server TimeZone. If is local mode get the Application Time Zone

Specified by:

getServerTimeZone in interface UtilReferenceLocator

Returns:

Throws:

Exception

getLoginEntityName
```
public String getLoginEntityName(int sessionId)
                          throws Exception
```
Description copied from interface: UtilReferenceLocator

Get the name of the login entity (LoginEntity parameter)

Specified by:

getLoginEntityName in interface UtilReferenceLocator

Returns:
The name of the Login Entity

Throws:

Exception

getDEBUGValueRemote
```
public boolean getDEBUGValueRemote(String id,
                          String v)
                            throws Exception
```
Description copied from interface: RemotelyManageable

Method to obtain the current value of the DEBUG Server variables.

Specified by:

getDEBUGValueRemote in interface RemotelyManageable

Parameters:
id - String with the administrator id of the remote session.
v - String with the name of the variable.

Returns:
a boolean with the value of the indicated variable.

Throws:

Exception

setDEBUGValueRemote
```
public void setDEBUGValueRemote(String id,
                       String v,
                       boolean b)
                         throws Exception
```
Description copied from interface: RemotelyManageable

Method to set the DEBUG Server variables.

Specified by:

setDEBUGValueRemote in interface RemotelyManageable

Parameters:
id - String with the administrator id of the remote session.
v - String with the name of the variable.
b - Boolean with the value.

Throws:

Exception

getSystemInfo

public Hashtable getSystemInfo(String id,
                      String key)
                        throws Exception

Description copied from interface: RemotelyManageable

Method that returns system information about the connection with the database. The keys to request information are stored into static variables in the class RemoteUtilities. The available keys are:

key	meaning
CONNECTION_INFO	To get the connection information when exist only one connection.
IS_MULTICONNECTION	To know if multiconnection is available. Returns a String "true" or "false".
MULTICONNECTION_IDLIST	To get the list of Strings with the identification of the connections.
MULTICONNECTION_INFO	To get the connection information of all connections available.

NOTE: the connection information contains into the Hashtable returned is:

the number of connections with the database.
the number of locked connections.
the amount of locked time.
the maximum locked time.

Specified by:: getSystemInfo in interface RemotelyManageable
Parameters:: id - String with the administrator id of the remote session.; key - String indicating what information you wish to request.
Returns:: a Hashtable with the values.
Throws:: Exception

removeEntity

public void removeEntity(String id,
                String entityName)
                  throws Exception

Specified by:: removeEntity in interface RemotelyManageable
Throws:: Exception

getConnectionInfo

protected Hashtable getConnectionInfo(DatabaseConnectionManager dBManager)

Method that returns the characteristics of the database connection to the given DatabaseConnecionManager.

key	value	meaning
nConnections	Integer	the number of connections
nLockedConnections	Integer	the number of locked connections
nLockTime	Double	the amount of locked time
tMaxLock	Double	the maximum locked time

Parameters:: dBManager - The DatabaseConnectionManager.
Returns:: a Hashtable with the values.

getRemotePreferencesFile
```
public Properties getRemotePreferencesFile(String id)
                                    throws Exception
```
Description copied from interface: RemotelyManageable

Method to get remotely the Server Preferences file.

Specified by:

getRemotePreferencesFile in interface RemotelyManageable

Parameters:
id - String with the administrator id of the remote session.

Returns:
a Properties with the preferences.

Throws:

Exception

setRemotePreferencesFile
```
public void setRemotePreferencesFile(String id,
                            Properties prop)
                              throws Exception
```
Description copied from interface: RemotelyManageable

Method to set remotely the Server Preferences file.

Specified by:

setRemotePreferencesFile in interface RemotelyManageable

Parameters:
id - String with the administrator id of the remote session.
prop - The properties file to be established. This file will contain the structure of pair values: key-value.

Throws:

Exception

closeLockedConnections

public void closeLockedConnections(String id,
                          String databaseId)
                            throws Exception

Specified by:: closeLockedConnections in interface RemotelyManageable
Throws:: Exception

getToken
```
public String getToken()
                throws Exception
```
Specified by:

getToken in interface UtilReferenceLocator

Throws:

Exception

getUserFromCert

public String getUserFromCert(String certificate)
                       throws Exception

Specified by:: getUserFromCert in interface UtilReferenceLocator
Throws:: Exception

getPasswordFromCert
```
public String getPasswordFromCert(String certificate)
                           throws Exception
```
Returns the password.

Specified by:

getPasswordFromCert in interface UtilReferenceLocator

Throws:

Exception
Since:

5.2057EN-1.4 this method returned the password from cert., 5.2061EN returns the same value passed as parameter because password ( = the certificate text) is not checked in database, only certificate is validated in startSessionInner(String, String, ClientWatch).

checkToken

public boolean checkToken(String token)
                   throws Exception

Throws:: Exception

getUserFromCert
```
protected String getUserFromCert(Certificate cert)
```
Returns the user from certificate. Field CertificateUtils.DNIe_CN.

Parameters:
cert - Certificate

Returns:
the user field

getPasswordFromCert
```
protected String getPasswordFromCert(Certificate cert)
```
Returns the text of CertificateUtils.DNIe_SERIALNUMBER field.

Parameters:
cert - Certificate

Returns:
Text of serial number

retrieveInitialContext

public InitialContext retrieveInitialContext(int sessionId,
                                    Hashtable params)
                                      throws Exception

Specified by:: retrieveInitialContext in interface UtilReferenceLocator
Throws:: Exception

getServerServiceName

public String getServerServiceName(String clientName)
                            throws Exception

Specified by:: getServerServiceName in interface ISSOServer
Throws:: Exception

returnMessage

public byte[] returnMessage(String contextRef,
                   byte[] inData)
                     throws Exception

Specified by:: returnMessage in interface ISSOServer
Throws:: Exception

getConfigurationParameters

public Hashtable getConfigurationParameters(String clientName)
                                     throws Exception

Specified by:: getConfigurationParameters in interface ISSOServer
Throws:: Exception

getTemporaryPassword
```
public String getTemporaryPassword(String user)
```
Get a temporary password for the given user, this method is only accesible from server side. The password will be valid duration of "TEMPORARY_PASSWORDS_DURATION" milliseconds

checkTemporaryPassword

protected boolean checkTemporaryPassword(String user,
                             String password)

getLocale

public Locale getLocale(int sessionId)
                 throws Exception

Specified by:: getLocale in interface UtilReferenceLocator
Throws:: Exception

setLocale

public void setLocale(int sessionId,
             Locale locale)
               throws Exception

Specified by:: setLocale in interface UtilReferenceLocator
Throws:: Exception

getLocaleId
```
public Object getLocaleId(int sessionId)
                   throws Exception
```
Specified by:

getLocaleId in interface ServerReferenceLocator

Throws:

Exception

getSuffixString
```
public String getSuffixString()
```
Specified by:

getSuffixString in interface UtilReferenceLocator

getLocaleEntity
```
public String getLocaleEntity()
                       throws Exception
```
Specified by:

getLocaleEntity in interface UtilReferenceLocator

Throws:

Exception

supportChangePassword

public boolean supportChangePassword(String user,
                            int sessionId)
                              throws Exception

Specified by:: supportChangePassword in interface UtilReferenceLocator
Throws:: Exception

changePassword

public EntityResult changePassword(String password,
                          int sessionId,
                          Hashtable av,
                          Hashtable kv)
                            throws Exception

Specified by:: changePassword in interface UtilReferenceLocator
Throws:: Exception

getAccessControl
```
public boolean getAccessControl()
                         throws Exception
```
Check if the control access attempts is enabled

Specified by:

getAccessControl in interface UtilReferenceLocator

Throws:

Exception

getErrorAccessControl
```
public ErrorAccessControl getErrorAccessControl()
                                         throws Exception
```
Return the ErrorAccesControl

Specified by:

getErrorAccessControl in interface UtilReferenceLocator

Throws:

Exception

blockUserDB
```
public void blockUserDB(String user)
                 throws Exception
```
Blocks an user in database

Specified by:

blockUserDB in interface UtilReferenceLocator

Throws:

Exception

checkBlockUserDB
```
public boolean checkBlockUserDB(String user)
                         throws Exception
```
Check if an user is blocked in database

Specified by:

checkBlockUserDB in interface UtilReferenceLocator

Throws:

Exception

Class SecureReferenceLocator