oracle.ifs.server
Class S_LibrarySession

java.lang.Object
  |
  +--oracle.ifs.server.S_LibrarySession

All Implemented Interfaces:

oracle.ifs.common.CollectionResolver, IfsEventHandler, LibraryConstants, LibrarySessionInterface, oracle.ifs.server.S_LibrarySessionInterface, Traceable

public class S_LibrarySession

extends java.lang.Object

implements LibrarySessionInterface, oracle.ifs.server.S_LibrarySessionInterface, oracle.ifs.common.CollectionResolver, IfsEventHandler, Traceable, LibraryConstants

An S_LibrarySession represents a user session in the iFS repository.

For every S_LibrarySession there is a corresponding LibrarySession. LibrarySession, in the package oracle.ifs.beans, forms part of the iFS application development API, informally known as the "beans API". Applications invoke iFS functionality by calling the beans API. S_LibrarySession, however, is in the oracle.ifs.server package, and forms part of the iFS server extensibility API, also known as the "server API". The server API is used to override or extend out-of-the-box iFS behavior by injecting your code into certain methods that are automatically invoked by the iFS repository. Applications do not directly call the server API.

S_LibrarySession provides helpful methods as you use the server API to change the behavior of S_LibraryObject subclasses. To get a reference to the S_LibrarySession, call getSession on S_LibraryObject.

You cannot change the behavior of S_LibrarySession itself.

Fields inherited from interface oracle.ifs.beans.resources.LibraryConstants

IFS_DOMAIN_ACLINDEX_EVENTTARGET, IFS_DOMAIN_AUDIT_AUDITINGENABLED, IFS_DOMAIN_AUDITRULEEVALUATORCLASS, IFS_DOMAIN_CREDENTIALMANAGER_ANONYMOUSUSERNAME, IFS_DOMAIN_DOMAINREGISTRY_PASSWORDREQUIRED, IFS_DOMAIN_FOLDERINDEX_EVENTTARGET, IFS_DOMAIN_LIBRARYOBJECT_CLASSACCESSCONTROLLIST_CLASSPRIVATE, IFS_DOMAIN_LIBRARYOBJECT_CLASSACCESSCONTROLLIST_CLASSPUBLIC, IFS_DOMAIN_LIBRARYOBJECT_CLASSACCESSCONTROLLIST_CLASSRESTRICTCREATION, IFS_DOMAIN_LIBRARYOBJECT_MEDIA_DEFAULTCONTENTMEDIA, IFS_DOMAIN_LIBRARYOBJECT_MEDIA_NONCONTENTMEDIA, IFS_DOMAIN_LIBRARYOBJECT_MEDIA_READMODEGETBYTES, IFS_DOMAIN_LIBRARYOBJECT_SERVICECONFIGURATION_DEFAULTSERVICECONFIGURATION, IFS_DOMAIN_LIBRARYOBJECT_SYSTEMACCESSCONTROLLIST_PRIVATE, IFS_DOMAIN_LIBRARYOBJECT_SYSTEMACCESSCONTROLLIST_PUBLIC, IFS_DOMAIN_LIBRARYOBJECT_SYSTEMACCESSCONTROLLIST_PUBLISHED, IFS_DOMAIN_LIBRARYOBJECT_SYSTEMLOCKOBJECT_SYSTEMHARDLOCK, IFS_DOMAIN_LIBRARYOBJECT_SYSTEMLOCKOBJECT_SYSTEMSOFTLOCK, IFS_DOMAIN_PROPERTYBUNDLE_NAME, IFS_SERVICE_ACLCACHE_EMERGENCYTRIGGER, IFS_SERVICE_ACLCACHE_NORMALTRIGGER, IFS_SERVICE_ACLCACHE_PURGETARGET, IFS_SERVICE_ACLCACHE_SIZE, IFS_SERVICE_ACLCACHE_URGENTTRIGGER, IFS_SERVICE_AUDITINGENABLED, IFS_SERVICE_CASESENSITIVEAUTHENTICATION, IFS_SERVICE_CHECKFORORPHANSESSIONSPERIOD, IFS_SERVICE_CONNECTIONPOOL_READONLY_MAXIMUMSIZE, IFS_SERVICE_CONNECTIONPOOL_READONLY_MAXIMUMSIZETIMEOUT, IFS_SERVICE_CONNECTIONPOOL_READONLY_MINIMUMSIZE, IFS_SERVICE_CONNECTIONPOOL_READONLY_TARGETSIZE, IFS_SERVICE_CONNECTIONPOOL_READONLY_TARGETSIZETIMEOUT, IFS_SERVICE_CONNECTIONPOOL_WRITEABLE_MAXIMUMSIZE, IFS_SERVICE_CONNECTIONPOOL_WRITEABLE_MAXIMUMSIZETIMEOUT, IFS_SERVICE_CONNECTIONPOOL_WRITEABLE_MINIMUMSIZE, IFS_SERVICE_CONNECTIONPOOL_WRITEABLE_TARGETSIZE, IFS_SERVICE_CONNECTIONPOOL_WRITEABLE_TARGETSIZETIMEOUT, IFS_SERVICE_CREDENTIALMANAGER_CREDENTIALNAMETOKENIZER, IFS_SERVICE_CREDENTIALMANAGER_NAMES, IFS_SERVICE_DATACACHE_EMERGENCYTRIGGER, IFS_SERVICE_DATACACHE_NORMALTRIGGER, IFS_SERVICE_DATACACHE_PURGETARGET, IFS_SERVICE_DATACACHE_SIZE, IFS_SERVICE_DATACACHE_URGENTTRIGGER, IFS_SERVICE_DEFAULTCHARACTERSET, IFS_SERVICE_DEFAULTLANGUAGE, IFS_SERVICE_EVENTEXCHANGER, IFS_SERVICE_JDBC_DATABASEURL, IFS_SERVICE_JDBC_DEFAULTROWPREFETCH, IFS_SERVICE_JDBC_DRIVER, IFS_SERVICE_JDBC_DRIVERTYPE, IFS_SERVICE_JDBC_SCHEMA, IFS_SERVICE_JDBC_TRACINGENABLED, IFS_SERVICE_MAXIMUMCONCURRENTSESSIONS, IFS_SERVICE_MAXIMUMCONCURRENTSESSIONSPERUSER, IFS_SERVICE_ORPHANSESSIONTIMEOUTPERIOD, IFS_SERVICE_POLLFOREVENTSFROMOTHERSERVICESPERIOD, IFS_SERVICE_SERVICEKEEPALIVEEVENTPERIOD, IFS_SERVICE_SESSION_BEANSOBJECTCACHE_SIZE, IFS_SERVICE_SESSION_BEANSSESSION, IFS_SERVICE_SESSION_DATACACHE_EMERGENCYTRIGGER, IFS_SERVICE_SESSION_DATACACHE_NORMALTRIGGER, IFS_SERVICE_SESSION_DATACACHE_PURGETARGET, IFS_SERVICE_SESSION_DATACACHE_SIZE, IFS_SERVICE_SESSION_DATACACHE_URGENTTRIGGER, IFS_SERVICE_SESSION_DEFAULTSEARCHTIMEOUTPERIOD, IFS_SERVICE_SESSION_EVENTPOLLER, IFS_SERVICE_SESSION_EVENTPOLLERPERIOD, IFS_SERVICE_SESSION_FOLDERPATHCACHE_ENABLED, IFS_SERVICE_SESSION_FOLDERPATHCACHE_NORMALTRIGGER, IFS_SERVICE_SESSION_FOLDERPATHCACHE_PURGETARGET, IFS_SERVICE_SESSION_FOLDERPATHCACHE_SIZE, IFS_SERVICE_SESSION_FOLDERPATHCACHE_URGENTTRIGGER, IFS_SERVICE_SESSION_SERVEROBJECTCACHE_EMERGENCYTRIGGER, IFS_SERVICE_SESSION_SERVEROBJECTCACHE_ISUNBOUNDED, IFS_SERVICE_SESSION_SERVEROBJECTCACHE_NORMALTRIGGER, IFS_SERVICE_SESSION_SERVEROBJECTCACHE_PURGETARGET, IFS_SERVICE_SESSION_SERVEROBJECTCACHE_SIZE, IFS_SERVICE_SESSION_SERVEROBJECTCACHE_URGENTTRIGGER, IFS_SERVICE_SESSION_SERVERSESSION, IFS_SERVICE_SESSION_TRANSACTIONSTACKSIZE, IFS_SERVICE_SESSIONOPERATIONTIMEOUTPERIOD, IFS_SERVICE_TRACING_BEANSSESSIONTRACETYPE, IFS_SERVICE_TRACING_CHANNELCOUNT, IFS_SERVICE_TRACING_CHANNELLEVEL, IFS_SERVICE_TRACING_DEFAULTTRACELEVEL, IFS_SERVICE_TRACING_SERVERSESSIONTRACETYPE, IFS_SERVICE_TRACING_SERVICETRACETYPE, IFS_SERVICE_TRANSPORTEVENTSTOOTHERSERVICESPERIOD

Method Summary

AttributeValue	createPublicObjectInstance(OperationState opState, S_LibraryObjectDefinition sdef) Creates a new S_PublicObject based on the specified S_LibraryObjectDefinition within an OperationState context.
AttributeValue	createSchemaObjectInstance(OperationState opState, S_LibraryObjectDefinition sdef) Creates a new S_SchemaObject based on the specified S_LibraryObjectDefinition within an OperationState context.
AttributeValue	createSystemObjectInstance(OperationState opState, S_LibraryObjectDefinition sdef) Creates a new S_SystemObject based on the specified S_LibraryObjectDefinition within an OperationState context.
java.io.Serializable	DYNCredentialManagerAuthenticate(java.io.Serializable payload) Authenticates the specified credential.
java.io.Serializable	DYNCredentialManagerCreateUser(java.io.Serializable payload) Creates a new user in the specified CredentialManager.
java.io.Serializable	DYNCredentialManagerDeleteUser(java.io.Serializable payload) Deletes the specified user from the specified CredentialManager.
java.io.Serializable	DYNCredentialManagerGetProperty(java.io.Serializable payload) Gets the value of the specified dynamic property for the specified CredentialManager.
java.io.Serializable	DYNCredentialManagerListUsers(java.io.Serializable payload) Gets the distinguished names of all users managed by the specified CredentialManager.
java.io.Serializable	DYNCredentialManagerSetPassword(java.io.Serializable payload) Sets the password of the specified user in the specified CredentialManager.
java.io.Serializable	DYNCredentialManagerSupportsCreateUser(java.io.Serializable payload) Determines whether the specified CredentialManager supports the DYNCredentialManagerCreateUser method.
java.io.Serializable	DYNCredentialManagerSupportsDeleteUser(java.io.Serializable payload) Determines whether the specified CredentialManager supports the DYNCredentialManagerDeleteUser method.
java.io.Serializable	DYNCredentialManagerSupportsListUsers(java.io.Serializable payload) Determines whether the specified CredentialManager supports the DYNCredentialManagerListUsers method.
java.io.Serializable	DYNCredentialManagerSupportsSetPassword(java.io.Serializable payload) Determines whether the specified CredentialManager supports the DYNCredentialManagerSetPassword method.
java.io.Serializable	DYNCredentialManagerUserExists(java.io.Serializable payload) Determines whether the specified CredentialManager can authenticate the specified user.
java.io.Serializable	DYNGetCommittedLibraryObjectDataCachePerformanceString(java.io.Serializable payload) Gets the cache performance of the committed S_LibraryObjectData cache, as a string.
java.io.Serializable	DYNGetCommittedResolvedAclCachePerformanceString(java.io.Serializable payload) Gets the cache performance of the committed Resolved ACL cache, as a string.
java.io.Serializable	DYNGetFolderPathCachePerformanceString(java.io.Serializable payload) Gets the cache performance of the FolderPathCache, as a string.
java.io.Serializable	DYNGetLibraryObjectCachePerformanceString(java.io.Serializable payload) Gets the cache performance of the S_LibraryObject cache, as a string.
java.io.Serializable	DYNGetReadonlyConnectionPoolPerformanceString(java.io.Serializable payload) Gets performance statistics of the readonly connection pool.
java.io.Serializable	DYNGetUncommittedLibraryObjectDataCachePerformanceString(java.io.Serializable payload) Gets the cache performance of the uncommitted S_LibraryObjectData cache, as a string.
java.io.Serializable	DYNGetUncommittedResolvedAclCachePerformanceString(java.io.Serializable payload) Gets the cache performance of the uncommitted Resolved ACL cache, as a string.
java.io.Serializable	DYNGetWriteableConnectionPoolPerformanceString(java.io.Serializable payload) Gets performance statistics of the writeable connection pool.
S_DirectoryUser	getAuthenticatedUser() Gets the S_DirectoryUser for which this S_LibrarySession was authenticated.
Collection	getClassAccessControlListCollection() Gets a reference to the ClassAccessControlList collection.
Collection	getClassDomainCollection() Gets a reference to the S_ClassDomain collection.
S_ClassObject	getClassObjectByName(java.lang.String classname) Returns a class object given a class name.
Collection	getClassObjectCollection() Gets a reference to the S_ClassObject collection.
S_ContentQuota	getDefaultContentQuota() Gets the default ContentQuota to be used when creating new content
java.lang.String	getDefaultFolderRelationshipClassname() Gets the name of the default folder relationship classobject.
S_DirectoryObject	getDirectoryObject(java.lang.Long id) Gets an S_DirectoryObject by id.
S_DirectoryObject	getDirectoryObject(java.lang.Long id, java.lang.Long classId) Gets an S_DirectoryObject by id and classId.
Collection	getDirectoryUserCollection() Gets a reference to the DirectoryUser collection.
AttributeValue	getDomainPropertyValue(java.lang.String name) Gets the value of a domain property, by name.
Collection	getExtendedPermissionCollection() Gets a reference to the S_ExtendedPermission collection.
Collection	getExtendedUserProfileCollection() Gets a reference to the S_ExtendedUserProfile collection for this S_LibrarySessions user.
java.lang.String	getFolderPathDelimiter() Gets the Folder Path Delimiter for this session
Collection	getFormatCollection() Gets a reference to the S_Format collection, organized by name.
Collection	getFormatExtensionCollection() Gets a reference to the S_Format collection, organized by extension.
java.lang.Long	getId() Gets the id of this S_LibrarySession.
IfsConnection	getIfsConnection() Returns an IfsConnection for this S_LibrarySession.
S_LibraryObject	getLibraryObject(java.lang.Long id, java.lang.Long classId) Gets an S_LibraryObject by id and classId.
Localizer	getLocalizer() Gets the Localizer of this S_LibrarySession.
Collection	getMediaCollection() Gets a reference to the Media collection.
Collection	getPermissionBundleCollection() Gets a reference to the S_PermissionBundle collection.
Collection	getPolicyCollection() Gets a reference to the S_Policy collection.
S_PublicObject	getPublicObject(java.lang.Long id) Gets an S_PublicObject by id.
S_PublicObject	getPublicObject(java.lang.Long id, java.lang.Long classId) Gets an S_PublicObject by id and classId.
S_SchemaObject	getSchemaObject(java.lang.Long id) Gets an S_SchemaObject by id.
S_SchemaObject	getSchemaObject(java.lang.Long id, java.lang.Long classId) Gets an S_SchemaObject by id and classId.
S_LibraryService	getService() Gets the S_LibraryService hosting this S_LibrarySession.
AttributeValue	getServiceConfigurationProperty(java.lang.String name) Gets the specified service configuration property.
boolean	getServiceConfigurationProperty(java.lang.String name, boolean defaultValue) Gets the value of the specified service configuration property, as a boolean.
int	getServiceConfigurationProperty(java.lang.String name, int defaultValue) Gets the value of the specified service configuration property, as an integer.
java.lang.String	getServiceConfigurationProperty(java.lang.String name, java.lang.String defaultValue) Gets the value of the specified service configuration property, as a string.
Collection	getSharedAccessControlListCollection() Gets a reference to the shared AccessControlList collection.
Collection	getSystemAccessControlListCollection() Gets a reference to the SystemAccessControlList collection.
Collection	getSystemLockObjectCollection() Gets a reference to the SystemLockObject collection.
S_SystemObject	getSystemObject(java.lang.Long id) Gets an S_SystemObject by id.
S_SystemObject	getSystemObject(java.lang.Long id, java.lang.Long classId) Gets an S_SystemObject by id and classId.
TraceLogger	getTraceLogger() Gets the trace logger of this session.
S_DirectoryUser	getUser() Gets the current S_DirectoryUser for this S_LibrarySession.
Collection	getValueDefaultCollection() Gets a reference to the S_ValueDefault collection.
Collection	getValueDomainCollection() Gets a reference to the S_ValueDomain collection.
boolean	isAdministrationMode() Gets whether this S_LibrarySession is in administration mode.
boolean	isTraced(int channel, int level) Gets whether tracing is enabled for the specified channel and level.
S_PublicObject	newPublicObject(S_LibraryObjectDefinition def) Creates a new S_PublicObject based on the specified S_LibraryObjectDefinition.
S_SchemaObject	newSchemaObject(S_LibraryObjectDefinition def) Creates a new S_SchemaObject based on the specified S_LibraryObjectDefinition.
S_SystemObject	newSystemObject(S_LibraryObjectDefinition def) Creates a new S_SystemObject based on the specified S_LibraryObjectDefinition.
void	trace(int channel, int level, java.lang.String payload) Issues a trace request to the trace logger.
void	verifyConnected() Asserts that this S_LibrarySession is connected.

Method Detail

verifyConnected

public final void verifyConnected()
                           throws IfsException

Asserts that this S_LibrarySession is connected.

Throws:

IfsException - (IFS-21000) if the session is not connected

getId

public java.lang.Long getId()
                     throws IfsException

Gets the id of this S_LibrarySession.

Returns:

the id

Throws:

IfsException - if the operation fails

getService

public S_LibraryService getService()
                            throws IfsException

Gets the S_LibraryService hosting this S_LibrarySession.

Returns:

the service

Throws:

IfsException - if the operation fails

getLocalizer

public final Localizer getLocalizer()
                             throws IfsException

Gets the Localizer of this S_LibrarySession.

Specified by:

getLocalizer in interface LibrarySessionInterface

Returns:

the Localizer

Throws:

IfsException - if the operation fails

getFolderPathDelimiter

public final java.lang.String getFolderPathDelimiter()
                                              throws IfsException

Gets the Folder Path Delimiter for this session

Returns:

the delimiter

Throws:

IfsException - if the operation fails

getDefaultContentQuota

public final S_ContentQuota getDefaultContentQuota()
                                            throws IfsException

Gets the default ContentQuota to be used when creating new content

Returns:

the delimiter

Throws:

IfsException - if the operation fails

getDefaultFolderRelationshipClassname

public java.lang.String getDefaultFolderRelationshipClassname()
                                                       throws IfsException

Gets the name of the default folder relationship classobject.

Returns:

the classobject name

Throws:

IfsException - if the operation fails

getServiceConfigurationProperty

public AttributeValue getServiceConfigurationProperty(java.lang.String name)
                                               throws IfsException

Gets the specified service configuration property.

Parameters:

name - the property name

Returns:

the property, or null if there is no such property

Throws:

IfsException - (IFS-20004) if the operation fails

getServiceConfigurationProperty

public java.lang.String getServiceConfigurationProperty(java.lang.String name,
                                                        java.lang.String defaultValue)
                                                 throws IfsException

Gets the value of the specified service configuration property, as a string.

Parameters:

name - the property name

defaultValue - the default value

Returns:

the property value

Throws:

IfsException - (IFS-20004) if the operation fails

getServiceConfigurationProperty

public boolean getServiceConfigurationProperty(java.lang.String name,
                                               boolean defaultValue)
                                        throws IfsException

Gets the value of the specified service configuration property, as a boolean.

Parameters:

name - the property name

defaultValue - the default value

Returns:

the property value

Throws:

IfsException - (IFS-20004) if the operation fails

getServiceConfigurationProperty

public int getServiceConfigurationProperty(java.lang.String name,
                                           int defaultValue)
                                    throws IfsException

Gets the value of the specified service configuration property, as an integer.

Parameters:

name - the property name

defaultValue - the default value

Returns:

the property value

Throws:

IfsException - (IFS-20004) if the operation fails

getAuthenticatedUser

public S_DirectoryUser getAuthenticatedUser()
                                     throws IfsException

Gets the S_DirectoryUser for which this S_LibrarySession was authenticated.

Returns:

the user

Throws:

IfsException - if the operation fails

getUser

public S_DirectoryUser getUser()
                        throws IfsException

Gets the current S_DirectoryUser for this S_LibrarySession.

This is the same as the authenticated user, unless a "feign user" operation has been performed.

Returns:

the current user

Throws:

IfsException - if the operation fails

isAdministrationMode

public boolean isAdministrationMode()
                             throws IfsException

Gets whether this S_LibrarySession is in administration mode.

Returns:

whether in administration mode

Throws:

IfsException - if the operation fails

getClassObjectCollection

public final Collection getClassObjectCollection()
                                          throws IfsException

Gets a reference to the S_ClassObject collection.

Specified by:

getClassObjectCollection in interface LibrarySessionInterface

Returns:

the CachedSelectorCollection

Throws:

IfsException - if the operation fails

getClassObjectByName

public final S_ClassObject getClassObjectByName(java.lang.String classname)
                                         throws IfsException

Returns a class object given a class name. This uses the ClassObjectCollection and is simply a convenience method.

Parameters:

the - name of a class

Returns:

the S_ClassObject

Throws:

IfsException - if the operation fails

getClassDomainCollection

public final Collection getClassDomainCollection()
                                          throws IfsException

Gets a reference to the S_ClassDomain collection.

Specified by:

getClassDomainCollection in interface LibrarySessionInterface

Returns:

the CachedSelectorCollection

Throws:

IfsException - if the operation fails

getValueDefaultCollection

public final Collection getValueDefaultCollection()
                                           throws IfsException

Gets a reference to the S_ValueDefault collection.

Specified by:

getValueDefaultCollection in interface LibrarySessionInterface

Returns:

the CachedSelectorCollection

Throws:

IfsException - if the operation fails

getValueDomainCollection

public final Collection getValueDomainCollection()
                                          throws IfsException

Gets a reference to the S_ValueDomain collection.

Specified by:

getValueDomainCollection in interface LibrarySessionInterface

Returns:

the CachedSelectorCollection

Throws:

IfsException - if the operation fails

getPolicyCollection

public final Collection getPolicyCollection()
                                     throws IfsException

Gets a reference to the S_Policy collection.

Specified by:

getPolicyCollection in interface LibrarySessionInterface

Returns:

the CachedSelectorCollection

Throws:

IfsException - if the operation fails

getPermissionBundleCollection

public final Collection getPermissionBundleCollection()
                                               throws IfsException

Gets a reference to the S_PermissionBundle collection.

Specified by:

getPermissionBundleCollection in interface LibrarySessionInterface

Returns:

the CachedSelectorCollection

Throws:

IfsException - if the operation fails

getExtendedPermissionCollection

public final Collection getExtendedPermissionCollection()
                                                 throws IfsException

Gets a reference to the S_ExtendedPermission collection.

Specified by:

getExtendedPermissionCollection in interface LibrarySessionInterface

Returns:

the CachedSelectorCollection

Throws:

IfsException - if the operation fails

getExtendedUserProfileCollection

public final Collection getExtendedUserProfileCollection()
                                                  throws IfsException

Gets a reference to the S_ExtendedUserProfile collection for this S_LibrarySessions user.

Specified by:

getExtendedUserProfileCollection in interface LibrarySessionInterface

Returns:

the CachedSelectorCollection

Throws:

IfsException - if the operation fails

getFormatCollection

public final Collection getFormatCollection()
                                     throws IfsException

Gets a reference to the S_Format collection, organized by name.

Specified by:

getFormatCollection in interface LibrarySessionInterface

Returns:

the CachedResolverCollection

Throws:

IfsException - if the operation fails

getFormatExtensionCollection

public final Collection getFormatExtensionCollection()
                                              throws IfsException

Gets a reference to the S_Format collection, organized by extension.

Specified by:

getFormatExtensionCollection in interface LibrarySessionInterface

Returns:

the CachedResolverCollection

Throws:

IfsException - if the operation fails

getMediaCollection

public final Collection getMediaCollection()
                                    throws IfsException

Gets a reference to the Media collection.

Specified by:

getMediaCollection in interface LibrarySessionInterface

Returns:

the CachedSelectorCollection

Throws:

IfsException - if the operation fails

getSharedAccessControlListCollection

public final Collection getSharedAccessControlListCollection()
                                                      throws IfsException

Gets a reference to the shared AccessControlList collection.

Specified by:

getSharedAccessControlListCollection in interface LibrarySessionInterface

Returns:

the UncachedSelectorCollection

Throws:

IfsException - if the operation fails

getSystemAccessControlListCollection

public final Collection getSystemAccessControlListCollection()
                                                      throws IfsException

Gets a reference to the SystemAccessControlList collection.

Specified by:

getSystemAccessControlListCollection in interface LibrarySessionInterface

Returns:

the CachedSelectorCollection

Throws:

IfsException - if the operation fails

getSystemLockObjectCollection

public final Collection getSystemLockObjectCollection()
                                               throws IfsException

Gets a reference to the SystemLockObject collection.

Returns:

the CachedSelectorCollection

Throws:

IfsException - if the operation fails

getClassAccessControlListCollection

public final Collection getClassAccessControlListCollection()
                                                     throws IfsException

Gets a reference to the ClassAccessControlList collection.

Specified by:

getClassAccessControlListCollection in interface LibrarySessionInterface

Returns:

the CachedSelectorCollection

Throws:

IfsException - if the operation fails

getDirectoryUserCollection

public final Collection getDirectoryUserCollection()
                                            throws IfsException

Gets a reference to the DirectoryUser collection.

Specified by:

getDirectoryUserCollection in interface LibrarySessionInterface

Returns:

the UncachedSelectorCollection

Throws:

IfsException - if the operation fails

getDomainPropertyValue

public final AttributeValue getDomainPropertyValue(java.lang.String name)
                                            throws IfsException

Gets the value of a domain property, by name. If no property exists for the name specified, a null is returned.

Parameters:

name - the property name

Returns:

the property value, or null if no property exists for the name specified

Throws:

IfsException - if the operation fails

getLibraryObject

public S_LibraryObject getLibraryObject(java.lang.Long id,
                                        java.lang.Long classId)
                                 throws IfsException

Gets an S_LibraryObject by id and classId.

Parameters:

id - the id

classId - the classId

Returns:

the object

Throws:

IfsException - if the operation fails

getPublicObject

public S_PublicObject getPublicObject(java.lang.Long id,
                                      java.lang.Long classId)
                               throws IfsException

Gets an S_PublicObject by id and classId.

Parameters:

id - the id

classId - the classId

Returns:

the object

Throws:

IfsException - if the operation fails

getPublicObject

public S_PublicObject getPublicObject(java.lang.Long id)
                               throws IfsException

Gets an S_PublicObject by id.

Parameters:

id - the id

Returns:

the object

Throws:

IfsException - if the operation fails

getSystemObject

public S_SystemObject getSystemObject(java.lang.Long id,
                                      java.lang.Long classId)
                               throws IfsException

Gets an S_SystemObject by id and classId.

Parameters:

id - the id

classId - the classId

Returns:

the object

Throws:

IfsException - if the operation fails

getSystemObject

public S_SystemObject getSystemObject(java.lang.Long id)
                               throws IfsException

Gets an S_SystemObject by id.

Parameters:

id - the id

Returns:

the object

Throws:

IfsException - if the operation fails

getSchemaObject

public S_SchemaObject getSchemaObject(java.lang.Long id,
                                      java.lang.Long classId)
                               throws IfsException

Gets an S_SchemaObject by id and classId.

Parameters:

id - the id

classId - the classId

Returns:

the object

Throws:

IfsException - if the operation fails

getSchemaObject

public S_SchemaObject getSchemaObject(java.lang.Long id)
                               throws IfsException

Gets an S_SchemaObject by id.

Parameters:

id - the id

Returns:

the object

Throws:

IfsException - if the operation fails

getDirectoryObject

public S_DirectoryObject getDirectoryObject(java.lang.Long id,
                                            java.lang.Long classId)
                                     throws IfsException

Gets an S_DirectoryObject by id and classId.

Parameters:

id - the id

classId - the classId

Returns:

the object

Throws:

IfsException - if the operation fails

getDirectoryObject

public S_DirectoryObject getDirectoryObject(java.lang.Long id)
                                     throws IfsException

Gets an S_DirectoryObject by id.

Parameters:

id - the id

Returns:

the object

Throws:

IfsException - if the operation fails

newPublicObject

public S_PublicObject newPublicObject(S_LibraryObjectDefinition def)
                               throws IfsException

Creates a new S_PublicObject based on the specified S_LibraryObjectDefinition.

Parameters:

def - the definition for the new PublicObject

Returns:

the new object

Throws:

IfsException - if the operation fails

newSystemObject

public S_SystemObject newSystemObject(S_LibraryObjectDefinition def)
                               throws IfsException

Creates a new S_SystemObject based on the specified S_LibraryObjectDefinition.

Parameters:

def - the definition

Returns:

the new object

Throws:

IfsException - if the operation fails

newSchemaObject

public S_SchemaObject newSchemaObject(S_LibraryObjectDefinition def)
                               throws IfsException

Creates a new S_SchemaObject based on the specified S_LibraryObjectDefinition.

Parameters:

def - the definition

Returns:

the new object

Throws:

IfsException - if the operation fails

createPublicObjectInstance

public AttributeValue createPublicObjectInstance(OperationState opState,
                                                 S_LibraryObjectDefinition sdef)
                                          throws IfsException

Creates a new S_PublicObject based on the specified S_LibraryObjectDefinition within an OperationState context.

This is identical to newPublicObject, except that the new object is returned as an AttributeValue.

Parameters:

opState - the operation state

sdef - the definition

Returns:

an AttributeValue containing the new object

Throws:

IfsException - if the operation fails

createSystemObjectInstance

public AttributeValue createSystemObjectInstance(OperationState opState,
                                                 S_LibraryObjectDefinition sdef)
                                          throws IfsException

Creates a new S_SystemObject based on the specified S_LibraryObjectDefinition within an OperationState context.

This is identical to newSystemObject, except that the new object is returned as an AttributeValue.

Parameters:

opState - the operation state

sdef - the definition

Returns:

an AttributeValue containing the new object

Throws:

IfsException - if the operation fails

createSchemaObjectInstance

public AttributeValue createSchemaObjectInstance(OperationState opState,
                                                 S_LibraryObjectDefinition sdef)
                                          throws IfsException

Creates a new S_SchemaObject based on the specified S_LibraryObjectDefinition within an OperationState context.

This is identical to newSchemaObject, except that the new object is returned as an AttributeValue.

Parameters:

opState - the operation state

sdef - the definition

Returns:

an AttributeValue containing the new object

Throws:

IfsException - if the operation fails

DYNGetCommittedLibraryObjectDataCachePerformanceString

public java.io.Serializable DYNGetCommittedLibraryObjectDataCachePerformanceString(java.io.Serializable payload)
                                                                            throws IfsException

Gets the cache performance of the committed S_LibraryObjectData cache, as a string.

Returns:

a string

Throws:

IfsException - if the operation fails

DYNGetCommittedResolvedAclCachePerformanceString

public java.io.Serializable DYNGetCommittedResolvedAclCachePerformanceString(java.io.Serializable payload)
                                                                      throws IfsException

Gets the cache performance of the committed Resolved ACL cache, as a string.

Returns:

a string

Throws:

IfsException - if the operation fails

DYNGetUncommittedLibraryObjectDataCachePerformanceString

public java.io.Serializable DYNGetUncommittedLibraryObjectDataCachePerformanceString(java.io.Serializable payload)
                                                                              throws IfsException

Gets the cache performance of the uncommitted S_LibraryObjectData cache, as a string.

Returns:

a string

Throws:

IfsException - if the operation fails

DYNGetUncommittedResolvedAclCachePerformanceString

public java.io.Serializable DYNGetUncommittedResolvedAclCachePerformanceString(java.io.Serializable payload)
                                                                        throws IfsException

Gets the cache performance of the uncommitted Resolved ACL cache, as a string.

Returns:

a string

Throws:

IfsException - if the operation fails

DYNGetLibraryObjectCachePerformanceString

public java.io.Serializable DYNGetLibraryObjectCachePerformanceString(java.io.Serializable payload)
                                                               throws IfsException

Gets the cache performance of the S_LibraryObject cache, as a string.

Returns:

a string

Throws:

IfsException - if the operation fails

DYNGetFolderPathCachePerformanceString

public java.io.Serializable DYNGetFolderPathCachePerformanceString(java.io.Serializable payload)
                                                            throws IfsException

Gets the cache performance of the FolderPathCache, as a string.

Returns:

a string

Throws:

IfsException - if the operation fails

getIfsConnection

public final IfsConnection getIfsConnection()
                                     throws IfsException

Returns an IfsConnection for this S_LibrarySession.

A writeable transaction must be in progress; if not, an IfsException (IFS-10665) is thrown.

Returns:

the connection

Throws:

IfsException - (IFS-10665) if the operation fails

DYNGetReadonlyConnectionPoolPerformanceString

public java.io.Serializable DYNGetReadonlyConnectionPoolPerformanceString(java.io.Serializable payload)
                                                                   throws IfsException

Gets performance statistics of the readonly connection pool.

Returns:

a String

Throws:

IfsException - if the operation fails

DYNGetWriteableConnectionPoolPerformanceString

public java.io.Serializable DYNGetWriteableConnectionPoolPerformanceString(java.io.Serializable payload)
                                                                    throws IfsException

Gets performance statistics of the writeable connection pool.

Returns:

a String

Throws:

IfsException - if the operation fails

DYNCredentialManagerAuthenticate

public java.io.Serializable DYNCredentialManagerAuthenticate(java.io.Serializable payload)
                                                      throws IfsException

Authenticates the specified credential.

This does not create a new session or change the existing session in any way. It simply determines the whether the supplied credential is valid for the specified distinguished name. It does not check the existence of a DirectoryUser for that user.

This method should only be invoked from the beans API by calling invokeServerMethod on LibrarySession. Do not call this method from the server API; instead, operate directly on the DirectoryService obtained by calling getDirectoryService.

To invoke this method, the session must be in administration mode.

The payload must be a Vector containing four String elements, as follows:

• credentialManagerName: the name of the CredentialManager
• distinguishedName: the distinguished name of the user
• credential: the credential to validate
• options: the ConnectOptions supplied by the user

Parameters:

payload - see method description

Returns:

a Boolean indicating whether the credential is valid

Throws:

IfsException - if the operation fails

DYNCredentialManagerUserExists

public java.io.Serializable DYNCredentialManagerUserExists(java.io.Serializable payload)
                                                    throws IfsException

Determines whether the specified CredentialManager can authenticate the specified user.

This method should only be invoked from the beans API by calling invokeServerMethod on LibrarySession. Do not call this method from the server API; instead, operate directly on the DirectoryService obtained by calling getDirectoryService.

The payload must be a Vector containing two String elements, as follows:

• credentialManagerName: the name of the CredentialManager
• distinguishedName: the distinguished name of the user

Parameters:

payload - see method description

Returns:

a Boolean indicating whether the CredentialManager manages the user

Throws:

IfsException - if the operation fails

DYNCredentialManagerSupportsCreateUser

public java.io.Serializable DYNCredentialManagerSupportsCreateUser(java.io.Serializable payload)
                                                            throws IfsException

Determines whether the specified CredentialManager supports the DYNCredentialManagerCreateUser method.

This method should only be invoked from the beans API by calling invokeServerMethod on LibrarySession. Do not call this method from the server API; instead, operate directly on the DirectoryService obtained by calling getDirectoryService.

Parameters:

payload - the String name of the CredentialManager

Returns:

a Boolean indicating whether DYNCredentialManagerCreateUser is supported

Throws:

IfsException - if the operation fails

DYNCredentialManagerSupportsDeleteUser

public java.io.Serializable DYNCredentialManagerSupportsDeleteUser(java.io.Serializable payload)
                                                            throws IfsException

Determines whether the specified CredentialManager supports the DYNCredentialManagerDeleteUser method.

This method should only be invoked from the beans API by calling invokeServerMethod on LibrarySession. Do not call this method from the server API; instead, operate directly on the DirectoryService obtained by calling getDirectoryService.

Parameters:

payload - the String name of the CredentialManager

Returns:

a Boolean indicating whether DYNCredentialManagerDeleteUser is supported

Throws:

IfsException - if the operation fails

DYNCredentialManagerSupportsSetPassword

public java.io.Serializable DYNCredentialManagerSupportsSetPassword(java.io.Serializable payload)
                                                             throws IfsException

Determines whether the specified CredentialManager supports the DYNCredentialManagerSetPassword method.

This method should only be invoked from the beans API by calling invokeServerMethod on LibrarySession. Do not call this method from the server API; instead, operate directly on the DirectoryService obtained by calling getDirectoryService.

Parameters:

payload - the String name of the CredentialManager

Returns:

a Boolean indicating whether DYNCredentialManagerSetPassword is supported

Throws:

IfsException - if the operation fails

DYNCredentialManagerSupportsListUsers

public java.io.Serializable DYNCredentialManagerSupportsListUsers(java.io.Serializable payload)
                                                           throws IfsException

Determines whether the specified CredentialManager supports the DYNCredentialManagerListUsers method.

This method should only be invoked from the beans API by calling invokeServerMethod on LibrarySession. Do not call this method from the server API; instead, operate directly on the DirectoryService obtained by calling getDirectoryService.

Parameters:

payload - the String name of the CredentialManager

Returns:

a Boolean indicating whether DYNCredentialManagerListUsers is supported

Throws:

IfsException - if the operation fails

DYNCredentialManagerGetProperty

public java.io.Serializable DYNCredentialManagerGetProperty(java.io.Serializable payload)
                                                     throws IfsException

Gets the value of the specified dynamic property for the specified CredentialManager.

This method should only be invoked from the beans API by calling invokeServerMethod on LibrarySession. Do not call this method from the server API; instead, operate directly on the DirectoryService obtained by calling getDirectoryService. The payload must be a Vector containing two elements, as follows:

• credentialManagerName: the String name of the CredentialManager
• name: the String name of the property

Parameters:

payload - see method description

Returns:

an AttributeValue representing the property value, or null if there is no such property

Throws:

IfsException - if the operation fails

getTraceLogger

public final TraceLogger getTraceLogger()
                                 throws IfsException

Gets the trace logger of this session.

Specified by:

getTraceLogger in interface Traceable

Throws:

IfsException - if the operation fails

isTraced

public final boolean isTraced(int channel,
                              int level)
                       throws IfsException

Gets whether tracing is enabled for the specified channel and level.

Specified by:

isTraced in interface Traceable

Parameters:

channel - the channel number

level - the level

Returns:

whether tracing is enabled

Throws:

IfsException - (IFS-11201) if the channel is invalid

trace

public final void trace(int channel,
                        int level,
                        java.lang.String payload)

Issues a trace request to the trace logger.

Specified by:

trace in interface Traceable

Parameters:

channel - the channel number

level - the level

payload - a string containing any additional information to be placed in the trace log

DYNCredentialManagerCreateUser

public java.io.Serializable DYNCredentialManagerCreateUser(java.io.Serializable payload)
                                                    throws IfsException

Creates a new user in the specified CredentialManager.

This method should only be invoked from the beans API by calling invokeServerMethod on LibrarySession. Do not call this method from the server API; instead, operate directly on the DirectoryService obtained by calling getDirectoryService.

The payload must be a Vector containing three elements, as follows:

• credentialManagerName: the name of the CredentialManager
• name: the String user name; some CredentialManagers may convert this name into a distinguished name if required; other CredentialManagers may require this to be a distinguished name to begin with
• password: the String password of the user
• options: an AttributeValue[] specifying CredentialManager-specific options; a null value requests default behavior

Deprecated payload format. The options element was introduced in iFS 9.0.2. Although it is currently optional, future releases of iFS will require that it be specified.

Parameters:

payload - see method description

Returns:

the String distinguished name of the created user

Throws:

IfsException - if the operation fails

DYNCredentialManagerListUsers

public java.io.Serializable DYNCredentialManagerListUsers(java.io.Serializable payload)
                                                   throws IfsException

Gets the distinguished names of all users managed by the specified CredentialManager.

This method should only be invoked from the beans API by calling invokeServerMethod on LibrarySession. Do not call this method from the server API; instead, operate directly on the DirectoryService obtained by calling getDirectoryService. The payload must be a Vector containing two elements, as follows:

• credentialManagerName: the String name of the CredentialManager
• options: an AttributeValue[] specifying CredentialManager-specific options; a null value requests default behavior

Deprecated payload format. Prior to iFS 9.0.2, the payload was a String specifying the name of the CredentialManager. Although this payload format is currently still supported, future releases of iFS will require the payload to be a Vector of two elements.

Parameters:

payload - see method description

Returns:

a Vector of String distinguished names

Throws:

IfsException - if the operation fails

DYNCredentialManagerSetPassword

public java.io.Serializable DYNCredentialManagerSetPassword(java.io.Serializable payload)
                                                     throws IfsException

Sets the password of the specified user in the specified CredentialManager.

This method should only be invoked from the beans API by calling invokeServerMethod on LibrarySession. Do not call this method from the server API; instead, operate directly on the DirectoryService obtained by calling getDirectoryService.

The payload must be a Vector containing four elements, as follows:

• credentialManagerName: the String name of the CredentialManager
• distinguishedName: the String distinguished name of the user
• password: the new String password
• options: an AttributeValue[] specifying CredentialManager-specific options; a null value requests default behavior

Deprecated payload format. The options element was introduced in iFS 9.0.2. Although it is currently optional, future releases of iFS will require that it be specified.

Parameters:

payload - see method description

Returns:

null

Throws:

IfsException - if the operation fails

DYNCredentialManagerDeleteUser

public java.io.Serializable DYNCredentialManagerDeleteUser(java.io.Serializable payload)
                                                    throws IfsException

Deletes the specified user from the specified CredentialManager.

This method should only be invoked from the beans API by calling invokeServerMethod on LibrarySession. Do not call this method from the server API; instead, operate directly on the DirectoryService obtained by calling getDirectoryService.

The payload must be a Vector containing three elements, as follows:

• credentialManagerName: the String name of the CredentialManager
• distinguishedName: the String distinguished name of the user
• options: an AttributeValue[] specifying CredentialManager-specific options; a null value requests default behavior

Deprecated payload format. The options element was introduced in iFS 9.0.2. Although it is currently optional, future releases of iFS will require that it be specified.

Parameters:

payload - see method description

Returns:

null

Throws:

IfsException - if the operation fails