oracle.ifs.server

Class AccessControlListIndexService

java.lang.Object

oracle.ifs.server.AccessControlListIndexService

All Implemented Interfaces:

SubService

Direct Known Subclasses:

TieAccessControlListIndexService

public class AccessControlListIndexService
extends Object
implements SubService

A AccessControlListIndexService manages the iFS ACL index, and updates it transactionally to reflect changes in the authorization model.

Version:

1.0

Author:

Dave Long

(Unpublished)

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFERRED_ACL_RESOLUTION_SEQ_NAME The name of the deferred ACL resolution sequence.
static String	DEFERRED_ACL_RESOLUTION_TABLE_NAME The name of the deferred ACL resolution table.
protected AccessControlListDiscoverAccessService	m_AclDiscoverAccessService The ACL resolver service.
protected AccessControlListProxyService	m_AclProxyService The ACL proxy service.
protected Boolean	m_AclResolutionSynchronous An indication as to whether ACL resolution of the discoverers table is performed synchronously or asynchronously (true indicates synchronous).
protected Long	m_GroupIndexPropertyBundleClassId The Class ID of the Folder Index Properties PropertyBundle
protected Long	m_GroupIndexPropertyBundleId The ID of the Folder Index Properties PropertyBundle
protected DirectoryGroupIndexService	m_GroupIndexService The Group index service.
protected S_LibraryService	m_Service The parent library service
protected static String	REPOS_PARAM_RESOLUTIONMODE_KEY The repository parameter key, used to indicate resolution mode.
protected static String	REPOS_PARAM_RESOLUTIONMODE_VALUE_ASYNC The repository parameter value of the REPOS_PARAM_RESOLUTIONMODE_KEY key that indicates asynchronous resolution mode.
protected static String	REPOS_PARAM_RESOLUTIONMODE_VALUE_SYNC The repository parameter value of the REPOS_PARAM_RESOLUTIONMODE_KEY key that indicates synchronous resolution mode.
protected static String	STATEMENT_DELETE_DEFERRED_RESOLUTION_ROW
protected static String	STATEMENT_INSERT_DEFERRED_RESOLUTION_ROW
protected static String	STATEMENT_SELECT_DEFERRED_RESOLUTION_ROWS

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AccessControlListIndexService(S_LibraryService service) Construct a AccessControlListIndexService.

Method Summary

Modifier and Type	Method and Description
protected void	addToGroup(S_LibrarySession sess, long parentid, long childid) Register a member added to a group.
protected void	applyDeferredUpdate(S_LibrarySession sess, AccessControlListDeferredUpdate acldu, boolean deleteAfterProcessing) Apply a deferred update entry.
protected void	changeUpdateMode(S_LibrarySession session, boolean isSync)
protected void	clearAclResolutionMode() Clears the cached ACL resolution mode.
protected PreparedStatement	constructPreparedStatement(LibraryConnection lc, Connection conn, String key, String sql) Constructs a PreparedStatement.
protected void	createDeferredUpdate(S_LibrarySession session, int operationType, long leftId, long rightId) Create a deferred update entry
protected void	deleteDeferredUpdate(S_LibrarySession session, Long id) Delete a set of deferred update entries
protected void	deleteDeferredUpdates(S_LibrarySession session, Long[] ids) Delete a set of deferred update entries
void	dispose() Terminate this subservice.
protected AccessControlListDiscoverAccessService	getAccessControlListDiscoverAccessService() Gets the AccessControlListProxyService for this S_LibraryService.
protected AccessControlListProxyService	getAccessControlListProxyService() Gets the AccessControlListProxyService for this S_LibraryService.
protected DirectoryGroupIndexService	getDirectoryGroupIndexService() Gets the DirectoryGroupIndexService for this S_LibraryService.
protected Long	getGroupIndexPropertyBundleClassId(S_LibrarySession sess) Get the Class ID of the PropertyBundle used for Group Index properties.
protected Long	getGroupIndexPropertyBundleId(S_LibrarySession sess) Get the ID of the PropertyBundle used for Group Index properties.
protected PreparedStatement	getPreparedStatement(LibraryConnection lc, Connection conn, String key) Gets a PreparedStatement that matches the specified key.
protected void	init(AccessControlListProxyService proxyServ, AccessControlListDiscoverAccessService aclrServ, DirectoryGroupIndexService groupServ) Initialize this subservice.
protected boolean	isAclResolutionSynchronous() Returns the ACL resolution mode.
protected void	postEvent(S_LibrarySession sess) Post an IfsEvent.
protected void	registerNewDirectoryObject(S_LibrarySession sess, long id) Register a new DirectoryObject.
protected void	removeFromGroup(S_LibrarySession sess, long parentid, long childid) Register a member being removed from a group.
protected Vector	selectDeferredResolutionEntries(S_LibrarySession session, int maxItems) Select a set of deferred update entries
protected void	unregisterFreedDirectoryObject(S_LibrarySession sess, long id) Unregister a freed DirectoryObject.
protected void	updateAclDiscovererTable(S_LibrarySession session, Long aclId) Handles a request to update the ACL discoverer table.

Methods inherited from class java.lang.Object

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

Field Detail

REPOS_PARAM_RESOLUTIONMODE_KEY

protected static final String REPOS_PARAM_RESOLUTIONMODE_KEY

The repository parameter key, used to indicate resolution mode.

See Also:

Constant Field Values

(Unpublished)

REPOS_PARAM_RESOLUTIONMODE_VALUE_SYNC

protected static final String REPOS_PARAM_RESOLUTIONMODE_VALUE_SYNC

The repository parameter value of the REPOS_PARAM_RESOLUTIONMODE_KEY key that indicates synchronous resolution mode.

See Also:

Constant Field Values

(Unpublished)

REPOS_PARAM_RESOLUTIONMODE_VALUE_ASYNC

protected static final String REPOS_PARAM_RESOLUTIONMODE_VALUE_ASYNC

The repository parameter value of the REPOS_PARAM_RESOLUTIONMODE_KEY key that indicates asynchronous resolution mode.

See Also:

Constant Field Values

(Unpublished)

DEFERRED_ACL_RESOLUTION_TABLE_NAME

public static final String DEFERRED_ACL_RESOLUTION_TABLE_NAME

The name of the deferred ACL resolution table.

See Also:

Constant Field Values

(Unpublished)

DEFERRED_ACL_RESOLUTION_SEQ_NAME

public static final String DEFERRED_ACL_RESOLUTION_SEQ_NAME

The name of the deferred ACL resolution sequence.

See Also:

Constant Field Values

(Unpublished)

STATEMENT_SELECT_DEFERRED_RESOLUTION_ROWS

protected static final String STATEMENT_SELECT_DEFERRED_RESOLUTION_ROWS

See Also:

Constant Field Values

STATEMENT_INSERT_DEFERRED_RESOLUTION_ROW

protected static final String STATEMENT_INSERT_DEFERRED_RESOLUTION_ROW

See Also:

Constant Field Values

STATEMENT_DELETE_DEFERRED_RESOLUTION_ROW

protected static final String STATEMENT_DELETE_DEFERRED_RESOLUTION_ROW

See Also:

Constant Field Values

m_Service

protected S_LibraryService m_Service

The parent library service

(Unpublished)

m_AclResolutionSynchronous

protected Boolean m_AclResolutionSynchronous

An indication as to whether ACL resolution of the discoverers table is performed synchronously or asynchronously (true indicates synchronous).

(Unpublished)

m_AclProxyService

protected AccessControlListProxyService m_AclProxyService

The ACL proxy service.

(Unpublished)

m_AclDiscoverAccessService

protected AccessControlListDiscoverAccessService m_AclDiscoverAccessService

The ACL resolver service.

(Unpublished)

m_GroupIndexService

protected DirectoryGroupIndexService m_GroupIndexService

The Group index service.

(Unpublished)

m_GroupIndexPropertyBundleId

protected Long m_GroupIndexPropertyBundleId

The ID of the Folder Index Properties PropertyBundle

(Unpublished)

m_GroupIndexPropertyBundleClassId

protected Long m_GroupIndexPropertyBundleClassId

The Class ID of the Folder Index Properties PropertyBundle

(Unpublished)

Constructor Detail

AccessControlListIndexService

protected AccessControlListIndexService(S_LibraryService service)
                                 throws IfsException

Construct a AccessControlListIndexService.

Parameters:

service - the requesting library service

Throws:

IfsException - if operation fails.

Method Detail

init

protected void init(AccessControlListProxyService proxyServ,
                    AccessControlListDiscoverAccessService aclrServ,
                    DirectoryGroupIndexService groupServ)
             throws IfsException

Initialize this subservice.

Hold on to the 3 inner subservices.

Parameters:

proxyServ - the AccessControlListProxyService

aclrServ - the AccessControlListDiscoverAccessService

groupServ - the DirectoryGroupIndexService

Throws:

IfsException - if the operation fails

(Unpublished)

dispose

public void dispose()
             throws IfsException

Terminate this subservice.

This method is required by the SubService interface; it currently does nothing.

Specified by:

dispose in interface SubService

Throws:

IfsException - if the operation fails

(Unpublished)

getAccessControlListProxyService

protected AccessControlListProxyService getAccessControlListProxyService()

Gets the AccessControlListProxyService for this S_LibraryService.

Returns:

the ACL proxy service

(Unpublished)

getAccessControlListDiscoverAccessService

protected AccessControlListDiscoverAccessService getAccessControlListDiscoverAccessService()

Gets the AccessControlListProxyService for this S_LibraryService.

Returns:

the ACL proxy service

(Unpublished)

getDirectoryGroupIndexService

protected DirectoryGroupIndexService getDirectoryGroupIndexService()

Gets the DirectoryGroupIndexService for this S_LibraryService.

Returns:

the group index service

(Unpublished)

isAclResolutionSynchronous

protected final boolean isAclResolutionSynchronous()

Returns the ACL resolution mode.

Returns:

true if the resolution mode is synchronous; false otherwise

(Unpublished)

clearAclResolutionMode

protected final void clearAclResolutionMode()

Clears the cached ACL resolution mode.

(Unpublished)

changeUpdateMode

protected void changeUpdateMode(S_LibrarySession session,
                                boolean isSync)
                         throws IfsException

Throws:

IfsException

createDeferredUpdate

protected void createDeferredUpdate(S_LibrarySession session,
                                    int operationType,
                                    long leftId,
                                    long rightId)
                             throws IfsException

Create a deferred update entry

Parameters:

session - the session

operationType - the Operation type

leftId - the ID of the left object

rightId - the ID of the right object (if any)

Throws:

IfsException - (IFS-10064) if the operation fails

(Unpublished)

deleteDeferredUpdate

protected void deleteDeferredUpdate(S_LibrarySession session,
                                    Long id)
                             throws IfsException

Delete a set of deferred update entries

Parameters:

session - the session

id - the ID of the deferred update entry

Throws:

IfsException - (IFS-10062) if the operation fails

(Unpublished)

deleteDeferredUpdates

protected void deleteDeferredUpdates(S_LibrarySession session,
                                     Long[] ids)
                              throws IfsException

Delete a set of deferred update entries

Parameters:

session - the session

ids - the IDs of the deferred update entries

Throws:

IfsException - (IFS-10062) if the operation fails

(Unpublished)

selectDeferredResolutionEntries

protected Vector selectDeferredResolutionEntries(S_LibrarySession session,
                                                 int maxItems)
                                          throws IfsException

Select a set of deferred update entries

Parameters:

session - the session

maxItems - max number of entries to select

Returns:

Vector of AccessControlListDeferredUpdate

Throws:

IfsException - (IFS-10063) if the operation fails

(Unpublished)

applyDeferredUpdate

protected void applyDeferredUpdate(S_LibrarySession sess,
                                   AccessControlListDeferredUpdate acldu,
                                   boolean deleteAfterProcessing)
                            throws IfsException

Apply a deferred update entry.

Parameters:

sess - the session

acldu - the deferred update entry

deleteAfterProcessing - whether to delete the entry after processing

Throws:

IfsException - (IFS-10063) if the operation fails

(Unpublished)

postEvent

protected void postEvent(S_LibrarySession sess)
                  throws IfsException

Post an IfsEvent.

Parameters:

sess - the session

Throws:

IfsException - if the operation fails

(Unpublished)

getGroupIndexPropertyBundleId

protected Long getGroupIndexPropertyBundleId(S_LibrarySession sess)
                                      throws IfsException

Get the ID of the PropertyBundle used for Group Index properties.

Parameters:

sess - the session

Returns:

the PropertyBundle ID

Throws:

IfsException - if the operation fails

(Unpublished)

getGroupIndexPropertyBundleClassId

protected Long getGroupIndexPropertyBundleClassId(S_LibrarySession sess)
                                           throws IfsException

Get the Class ID of the PropertyBundle used for Group Index properties.

Parameters:

sess - the session

Returns:

the PropertyBundle Class ID

Throws:

IfsException - if the operation fails

(Unpublished)

registerNewDirectoryObject

protected void registerNewDirectoryObject(S_LibrarySession sess,
                                          long id)
                                   throws IfsException

Register a new DirectoryObject.

Parameters:

sess - the session

id - the DirectoryObject ID

Throws:

IfsException - if the operation fails

unregisterFreedDirectoryObject

protected void unregisterFreedDirectoryObject(S_LibrarySession sess,
                                              long id)
                                       throws IfsException

Unregister a freed DirectoryObject.

Parameters:

sess - the session

id - the DirectoryObject ID

Throws:

IfsException - if the operation fails

addToGroup

protected void addToGroup(S_LibrarySession sess,
                          long parentid,
                          long childid)
                   throws IfsException

Register a member added to a group.

Parameters:

sess - the session

parentid - the group ID

childid - the member ID

Throws:

IfsException - if the operation fails

removeFromGroup

protected void removeFromGroup(S_LibrarySession sess,
                               long parentid,
                               long childid)
                        throws IfsException

Register a member being removed from a group.

Parameters:

sess - the session

parentid - the group ID

childid - the member ID

Throws:

IfsException - if the operation fails

updateAclDiscovererTable

protected void updateAclDiscovererTable(S_LibrarySession session,
                                        Long aclId)
                                 throws IfsException

Handles a request to update the ACL discoverer table.

If ASYNC mode is in effect, create a deferred update entry

Parameters:

session - the session

aclId - the ID of the ACL

Throws:

IfsException - (IFS-10065) if the operation fails

(Unpublished)

getPreparedStatement

protected PreparedStatement getPreparedStatement(LibraryConnection lc,
                                                 Connection conn,
                                                 String key)

Gets a PreparedStatement that matches the specified key.

Parameters:

lc - the LibraryConnection

conn - the Connection

key - the statement key

Returns:

the PreparedStatement that matches the key, or null if no match is found

Throws:

IfsException - if the operation fails

(Unpublished)

constructPreparedStatement

protected PreparedStatement constructPreparedStatement(LibraryConnection lc,
                                                       Connection conn,
                                                       String key,
                                                       String sql)
                                                throws SQLException

Constructs a PreparedStatement.

Parameters:

lc - the LibraryConnection

conn - the Connection

key - the statement key

sql - the SQL text

Returns:

the PreparedStatement

Throws:

IfsException - if the operation fails

SQLException

(Unpublished)