com.ibm.websphere.objectgrid
Interface ObjectGrid

All Superinterfaces:

StreamQueryManager

public interface ObjectGrid
extends StreamQueryManager

This object is used for creating sessions to the ObjectGrid. It is the central core of the ObjectGrid framework. Besides creating Sessions, it is also responsible for defining BackingMaps, setting a TransactionCallback, managing keywords, adding event listeners, and managing the security settings.

Since:

WAS XD 6.0

Field Summary

static int	CLIENT Indicates the ObjectGrid is a client-side distributed ObjectGrid.
static int	LOCAL Indicates the ObjectGrid is a local ObjectGrid.
static int	SERVER Indicates the ObjectGrid is a server-side distributed ObjectGrid.

Method Summary

void	addEventListener(ObjectGridEventListener listener) Adds an ObjectGridEventListener.
void	associateKeyword(java.io.Serializable parent, java.io.Serializable child) Deprecated. Use Index or query function to get Objects with specific attributes
BackingMap	createMap(java.lang.String name) Creates a BackingMap, but does not associate it with this ObjectGrid.
BackingMap	defineMap(java.lang.String name) Defines a BackingMap that will be used by the application.
void	destroy() Destroys this instance.
java.util.List	getEventListeners() Returns the current list of ObjectGridEventListeners.
java.util.List	getListOfMapNames() Gets the list of map names currently defined for this ObjectGrid instance.
BackingMap	getMap(java.lang.String name) Returns a BackingMap previously configured by calling the defineMap(String) or setMaps(List) method.
java.lang.String	getName() Gets the name of this ObjectGrid.
int	getObjectGridType() Returns the type of ObjectGrid.
Session	getSession() Gets a Session object that can be used by a single thread at a time.
Session	getSession(CredentialGenerator credGen) Get a session using a CredentialGenerator.
Session	getSession(javax.security.auth.Subject subject) Allows the use of a specific Subject rather than use the SubjectSource configured on the ObjectGrid to get a Session.
TransactionCallback	getTransactionCallback() Retrieves the TransactionCallback object.
int	getTxTimeout() Gets transaction timeout setting for this ObjectGrid instance.
void	initialize() Begins the bootstrapping of the ObjectGrid and Session instances.
boolean	isSecurityEnabled() Checks whether security is enabled on this ObjectGrid or not.
void	registerEntities(java.lang.Class[] entities) Register one or more entities based on the class metadata.
void	registerEntities(java.net.URL entityXML) Registers one ore more entities from an entity XML file.
void	removeEventListener(ObjectGridEventListener listener) Removes an ObjectGridEventListener.
int	reserveSlot(java.lang.String containerName) Allows plugins on this ObjectGrid to reserve slots for use in to store transaction context data using TxID.
void	setAuthorizationMechanism(int authMechanism) Sets the authorization mechanism.
void	setEventListeners(java.util.List listeners) This overwrites the current list of ObjectGridEventListeners and replaces it with the supplied List of ObjectGridEventListeners.
void	setMapAuthorization(MapAuthorization mapAuthorization) Deprecated. in WAS XD 6.1. Use setObjectGridAuthorization(ObjectGridAuthoirzation) instead to plug in custom authorizations. If both setMapAuthorization(MapAuthorization) and setObjectGridAuthorization(ObjectGridAuthoirzation) are used, ObjectGrid will use the provided MapAuthorization to authorize map accesses, even though this method is deprecated.
void	setMaps(java.util.List mapList) Clears any BackingMaps that have been previously defined on this ObjectGrid and replaces them with the List of BackingMaps provided.
void	setName(java.lang.String gridName) Sets the name of this ObjectGrid.
void	setObjectGridAuthorization(ObjectGridAuthorization ogAuthorization) Sets the ObjectGridAuthorization for this ObjectGrid instance.
void	setPermissionCheckPeriod(int period) Sets the permission check period.
void	setQueryConfig(QueryConfig queryConfig) Set the QueryConfig object for this ObjectGrid.
void	setSecurityEnabled() Enables the ObjectGrid security.
void	setSubjectSource(SubjectSource source) Sets the SubjectSource plugin.
void	setSubjectValidation(SubjectValidation subjectValidation) Sets the SubjectValidation for this ObjectGrid instance.
void	setTransactionCallback(TransactionCallback callback) Sets the TransactionCallback object.
void	setTxTimeout(int timeout) Sets the transaction timeout value to a specified number of seconds.

Methods inherited from interface com.ibm.websphere.objectgrid.streamquery.StreamQueryManager

addStreamQuerySet, createStreamQuerySet, getStreamQuerySets, removeStreamQuerySet, setStreamQuerySets

Field Detail

LOCAL

static final int LOCAL

Indicates the ObjectGrid is a local ObjectGrid.

See Also:

Constant Field Values

SERVER

static final int SERVER

Indicates the ObjectGrid is a server-side distributed ObjectGrid.

See Also:

Constant Field Values

CLIENT

static final int CLIENT

Indicates the ObjectGrid is a client-side distributed ObjectGrid.

See Also:

Constant Field Values

Method Detail

getSession

Session getSession()
                   throws ObjectGridException,
                          TransactionCallbackException

Gets a Session object that can be used by a single thread at a time.

It is not allowed to share this Session object between threads without placing a critical section around it. While the core framework allows the object to move between threads, the TransactionCallback and Loader may prevent this usage, especially in J2EE environments.

When the ObjectGrid is a local ObjectGrid, and its security is enabled, this method will use the SubjectSource to get a Subject object and then associate the Subject object with this session .

When the ObjectGrid is a distributed ObjectGrid (client server mode), and its security is enabled, this method will utilize the client server security infrastructure to get a secure session.

If the initialize() method has not been invoked prior to the first getSession invocation, an implicit initialization will occur. This ensures that all of the configuration is complete before any runtime usage is required.

Returns:

An instance of Session

Throws:

ObjectGridException - if an error occurs during processing

TransactionCallbackException - if the TransactionCallback throws an exception

java.lang.IllegalStateException - if this method is called after the destroy() method is called.

See Also:

destroy(), initialize(), Session, SubjectSource

getSession

Session getSession(javax.security.auth.Subject subject)
                   throws ObjectGridException,
                          TransactionCallbackException,
                          InvalidSubjectException

Allows the use of a specific Subject rather than use the SubjectSource configured on the ObjectGrid to get a Session.

This method should only be used when ObjectGrid security is enabled. If the ObjectGrid security is disabled, the provided Subject object will not be used.

If the initialize() method has not been invoked prior to the first getSession invocation, an implicit initialization will occur. This ensures that all of the configuration is complete before any runtime usage is required.

Parameters:

subject - Subject to associate with the returned Session

Returns:

An instance of Session

Throws:

ObjectGridException - if an error occurs during processing

TransactionCallbackException - if the TransactionCallback throws an exception

InvalidSubjectException - the subject passed in is invalid based on the SubjectValidation mechanism.

java.lang.IllegalStateException - if this method is called after the destroy() method is called.

See Also:

destroy(), initialize(), Session, SubjectValidation

setTransactionCallback

void setTransactionCallback(TransactionCallback callback)

Sets the TransactionCallback object.

A single cache is a single domain. All Loaders defined for BackingMaps in an ObjectGrid will normally cooperate, thus a corresponding TransactionCallback object needs to be set on the ObjectGrid.

Parameters:

callback - An instance of a TransactionCallback

Throws:

java.lang.IllegalArgumentException - if callback is null

java.lang.IllegalStateException - if this method is called after the initialize() method is called.

See Also:

initialize(), TransactionCallback

getTransactionCallback

TransactionCallback getTransactionCallback()

Retrieves the TransactionCallback object.

The TransactionCallback can be used in conjunction with the TxID to house transaction-specific context data, such as the connection to the database.

Returns:

the argument that was passed to the setTransactionCallback(TransactionCallback) method of this interface or a default TransactionCallback object if setTransactionCallback was not previously called for this ObjectGrid.

See Also:

setTransactionCallback(TransactionCallback), TransactionCallback

defineMap

BackingMap defineMap(java.lang.String name)

Defines a BackingMap that will be used by the application.

Note, to avoid an IllegalStateException, this method must be called prior to the initialize() method. Also, keep in mind that the getSession methods implicitly call the initialize() method if it has yet to be called by the application.

Parameters:

name - the name of the map being defined.

Returns:

a BackingMap reference

Throws:

java.lang.IllegalArgumentException - if name is null

java.lang.IllegalStateException - if this method is called after the initialize() method is called.

See Also:

initialize(), BackingMap

createMap

BackingMap createMap(java.lang.String name)

Creates a BackingMap, but does not associate it with this ObjectGrid.

This method is to be used in tandem with the setMaps(List) method, which will associate BackingMaps with this ObjectGrid. These methods are for use when configuring an ObjectGrid with the Spring Framework.

Note, to avoid an IllegalStateException, this method must be called prior to the initialize() method. Also, keep in mind that the getSession methods implicitly call the initialize() method if it has yet to be called by the application.

Parameters:

name - the name of the map being defined.

Returns:

a BackingMap reference

Throws:

java.lang.IllegalArgumentException - if name is null

java.lang.IllegalStateException - if this method is called after the initialize() method is called.

Since:

WAS XD 6.0.1

See Also:

initialize(), setMaps(List)

setMaps

void setMaps(java.util.List mapList)

Clears any BackingMaps that have been previously defined on this ObjectGrid and replaces them with the List of BackingMaps provided.

Note, to avoid an IllegalStateException, this method must be called prior to the initialize() method. Also, keep in mind that the getSession methods implicitly call the initialize() method if it has yet to be called by the application.

Parameters:

mapList - a list of BackingMaps to set on this ObjectGrid.

Throws:

java.lang.IllegalStateException - if this method is called after the initialize() method is called.

Since:

WAS XD 6.0.1

See Also:

createMap(String), initialize()

getListOfMapNames

java.util.List getListOfMapNames()

Gets the list of map names currently defined for this ObjectGrid instance.

Note, once the initialize() method is called, the List returned will not change. However, it could change if called prior to initialization. Also, keep in mind that the getSession methods implicitly call the initialize() method if it has yet to be called by the application.

Returns:

a List of String objects, one String per map that was previously configured by the defineMap(String) or setMaps(List) method. An empty List is returned if no maps are currently defined.

See Also:

defineMap(String), initialize(), setMaps(List)

getMap

BackingMap getMap(java.lang.String name)

Returns a BackingMap previously configured by calling the defineMap(String) or setMaps(List) method.

Parameters:

name - the same name that was used as an argument to the defineMap(String) or createMap(String) method. A null reference is returned if a map is not associated with this ObjectGrid for the specified map name.

Returns:

the BackingMap instance

See Also:

createMap(String), defineMap(String), setMaps(List)

initialize

void initialize()
                throws ObjectGridException

Begins the bootstrapping of the ObjectGrid and Session instances.

After this method has been invoked, the configuration of the ObjectGrid is considered complete and is ready for runtime usage. Any additional configuration method invocations, such as defineMap(String), will result in an exception. This method is considered optional since the first call to one of the getSession methods will perform an implicit initialization.

Throws:

ObjectGridException - if an error occurs during processing

addEventListener

void addEventListener(ObjectGridEventListener listener)

Adds an ObjectGridEventListener.

Significant events will be communicated to interested listeners through the ObjectGridEventListener callback interface. Multiple event listeners are allowed to be registered, with no implied ordering of event notifications.

Note, this method is allowed to be invoked before and after the initialize() method.

Parameters:

listener - An instance of ObjectGridEventListener

Throws:

java.lang.IllegalArgumentException - if listener is null

java.lang.IllegalStateException - if this method is called during initialization by one of the configured plugins and the ObjectGrid runtime is not in a usable state to initialize the ObjectGridEventListener.

See Also:

ObjectGridEventListener

removeEventListener

void removeEventListener(ObjectGridEventListener listener)

Removes an ObjectGridEventListener.

This method removes an ObjectGridEventListener that was previously added to this object using the addEventListener(ObjectGridEventListener) or setEventListeners(List) method. If the desired ObjectGridEventListener is not found, no error will be returned.

Note, this method is allowed to be invoked before and after the initialize() method.

Parameters:

listener - An instance of ObjectGridEventListener

Throws:

java.lang.IllegalArgumentException - if listener is null

See Also:

addEventListener(ObjectGridEventListener), setEventListeners(List), ObjectGridEventListener

setEventListeners

void setEventListeners(java.util.List listeners)

This overwrites the current list of ObjectGridEventListeners and replaces it with the supplied List of ObjectGridEventListeners.

Note, this method is allowed to be invoked before and after the initialize() method.

Parameters:

listeners - List of ObjectGridEventListeners

Throws:

java.lang.ClassCastException - if one of the elements in the provided list is not an instance of ObjectGridEventListener

java.lang.IllegalArgumentException - if listeners is null or contains a null reference.

java.lang.IllegalStateException - if this method is called during initialization by one of the configured plugins and the ObjectGrid runtime is not in a usable state to initialize the ObjectGridEventListener objects.

See Also:

ObjectGridEventListener

getEventListeners

java.util.List getEventListeners()

Returns the current list of ObjectGridEventListeners.

Returns:

The current list of ObjectGridEventListeners.

See Also:

addEventListener(ObjectGridEventListener), setEventListeners(List), ObjectGridEventListener

associateKeyword

void associateKeyword(java.io.Serializable parent,
                      java.io.Serializable child)

Deprecated. Use Index or query function to get Objects with specific attributes

Links the two keywords together in a directional relationship.

If map entries are invalidated using the parent keyword, map entries associated with the child keyword are also invalidated. Invalidating a child keyword has no impact on entries associated with the parent keyword. For example, this method can be used to add the keyword "New York" as a child of the keyword "USA" so that if "USA" is invalidated, all of the entries associated with the "New York" keyword will also be invalidated.

Note, this method is allowed to be invoked before and after the initialize() method.

Parameters:

parent - keyword to associate with the child parameter in a parent-child relationship

child - All entries associated with this keyword will also be associated with the parent keyword

See Also:

ObjectMap.invalidateUsingKeyword(Serializable, boolean)

getName

java.lang.String getName()

Gets the name of this ObjectGrid.

This method is useful for authorization as all Maps are prefixed with the ObjectGrid name.

Returns:

The name of the ObjectGrid.

See Also:

setName(String)

setName

void setName(java.lang.String gridName)

Sets the name of this ObjectGrid. Note, to avoid an IllegalStateException, this method must be called prior to the initialize() method. Also, keep in mind that the getSession methods implicitly call the initialize() method if it has yet to be called by the application.

Parameters:

gridName - The ObjectGrid name to use.

Throws:

java.lang.IllegalArgumentException - if gridName is null

java.lang.IllegalStateException - if this method is called after the initialize() method is called.

reserveSlot

int reserveSlot(java.lang.String containerName)

Allows plugins on this ObjectGrid to reserve slots for use in to store transaction context data using TxID.

Once a slot is reserved, the slot assignment is permanent and cannot be given back.

Note, this method is allowed to be invoked before and after the initialize() method.

Parameters:

containerName - The name of the Object with the slots.

Returns:

The slot index to use.

See Also:

TxID.SLOT_NAME, TxID.getSlot(int), TxID.putSlot(int, Object)

setSubjectValidation

void setSubjectValidation(SubjectValidation subjectValidation)

Sets the SubjectValidation for this ObjectGrid instance.

Passing null to this method removes a previously set SubjectValidation object from an earlier invocation of this method and indicates that this ObjectGrid is not associated with a SubjectValidation object.

This method should only be used when ObjectGrid security is enabled. If the ObjectGrid security is disabled, the provided SubjectValidation object will not be used.

A SubjectValidation plugin can be used to validate the Subject object passed in is a valid Subject. Please refer to SubjectValidation for more details.

Note, to avoid an IllegalStateException, this method must be called prior to the initialize() method. Also, keep in mind that the getSession methods implicitly call the initialize() method if it has yet to be called by the application.

Parameters:

subjectValidation - the SubjectValidation plugin

Throws:

java.lang.IllegalStateException - if this method is called after the initialize() method is called.

See Also:

getSession(Subject), initialize(), SubjectValidation

setMapAuthorization

void setMapAuthorization(MapAuthorization mapAuthorization)

Deprecated. in WAS XD 6.1. Use setObjectGridAuthorization(ObjectGridAuthoirzation) instead to plug in custom authorizations. If both setMapAuthorization(MapAuthorization) and setObjectGridAuthorization(ObjectGridAuthoirzation) are used, ObjectGrid will use the provided MapAuthorization to authorize map accesses, even though this method is deprecated.

Sets the MapAuthorization for this ObjectGrid instance.

Passing null to this method removes a previously set MapAuthorization object from an earlier invocation of this method and indicates that this ObjectGrid is not associated with a MapAuthorization object.

This method should only be used when ObjectGrid security is enabled. If the ObjectGrid security is disabled, the provided MapAuthorization object will not be used.

A MapAuthorization plugin can be used to authorize access to the maps. Please refer to MapAuthorization for more details.

Note, to avoid an IllegalStateException, this method must be called prior to the initialize() method. Also, keep in mind that the getSession methods implicitly call the initialize() method if it has yet to be called by the application.

Parameters:

mapAuthorization - the MapAuthorization plugin

Throws:

java.lang.IllegalStateException - if this method is called after the initialize() method is called.

See Also:

initialize(), MapAuthorization

setAuthorizationMechanism

void setAuthorizationMechanism(int authMechanism)

Sets the authorization mechanism.

If this method is not invoked, the default authorization mechanism is SecurityConstants.AUTHORIZATION_MECHANISM_JAAS.

This method should only be used when ObjectGrid security is enabled. If the ObjectGrid security is disabled, the provide authorization mechanism will not be used.

Note, to avoid an IllegalStateException, this method must be called prior to the initialize() method. Also, keep in mind that the getSession methods implicitly call the initialize() method if it has yet to be called by the application.

Parameters:

authMechanism - the authorization mechanism, must be one of the final static variable on the SecurityConstants class.

Throws:

java.lang.IllegalStateException - if this method is called after the initialize() method is called.

See Also:

initialize(), SecurityConstants.AUTHORIZATION_MECHANISM_CUSTOM, SecurityConstants.AUTHORIZATION_MECHANISM_JAAS

setSecurityEnabled

void setSecurityEnabled()

Enables the ObjectGrid security.

Security on the ObjectGrid level refers to ObjectGrid authorizations.

Note, to avoid an IllegalStateException, this method must be called prior to the initialize() method. Also, keep in mind that the getSession methods implicitly call the initialize() method if it has yet to be called by the application.

Throws:

java.lang.IllegalStateException - if this method is called after the initialize() method is called.

See Also:

initialize()

isSecurityEnabled

boolean isSecurityEnabled()

Checks whether security is enabled on this ObjectGrid or not.

Security on the ObjectGrid level refers to ObjectGrid authorizations. Security is disabled by default.

Returns:

true if security is enabled on this ObjectGrid; false otherwise.

See Also:

setSecurityEnabled()

setPermissionCheckPeriod

void setPermissionCheckPeriod(int period)

Sets the permission check period.

This method takes a single parameter indicating how often the customer wants to check the permission used to allow a client access. If the parameter is 0 then every single authorized operation call will ask the authorization mechanism, either JAAS authorization or custom authorization to check if the current Subject has permission. This approach may be prohibitively expensive from a performance point of view depending on the authorization implementation, but if it is required then you can do it. Alternatively, if the parameter is > 0 then it indicates the number of seconds to cache a set of permissions before returning to the authorization mechanism to refresh them. This mechanism provides much better performance, but you run the risk that if the back-end permissions are changed during this time, the ObjectGrid will possibly allow or prevent access even though the back-end security provider has been modified.

Note, to avoid an IllegalStateException, this method must be called prior to the initialize() method. Also, keep in mind that the getSession methods implicitly call the initialize() method if it has yet to be called by the application.

Parameters:

period - the permission check period in seconds.

Throws:

java.lang.IllegalStateException - if this method is called after the initialize() method is called.

See Also:

initialize()

setSubjectSource

void setSubjectSource(SubjectSource source)

Sets the SubjectSource plugin.

Passing null to this method removes a previously set SubjectSource object from an earlier invocation of this method and indicates that this ObjectGrid is not associated with a SubjectSource object.

A SubjectSource plugin can be used to get a Subject object from the environment to represent the ObjectGrid client.

This method should only be used when ObjectGrid security is enabled. If the ObjectGrid security is disabled, the provided SubjectSource object will not be used.

Note, to avoid an IllegalStateException, this method must be called prior to the initialize() method. Also, keep in mind that the getSession methods implicitly call the initialize() method if it has yet to be called by the application.

Parameters:

source - the SubjectSource plugin

Throws:

java.lang.IllegalStateException - if this method is called after the initialize() method is called.

See Also:

initialize(), SubjectSource

setTxTimeout

void setTxTimeout(int timeout)

Sets the transaction timeout value to a specified number of seconds.

Any transaction that is started by use of a Session returned by one of the getSession methods on this interface must complete within the number of seconds specified by the transaction timeout parameter of this method. The timeout value is the maximum number of seconds the transaction is allowed to execute. If a transaction executes longer than this amount, a TransactionTimeoutException is thrown and the transaction is rolled back even if commit is requested.

Note, to avoid an IllegalStateException, this method must be called prior to the initialize() method. Also, keep in mind that the getSession methods implicitly call the initialize() method if it has yet to be called by the application.

The transaction timeout is used by any transaction started by a Session that is returned by the getSession methods of this interface. Since this method must be called prior to getSession method to avoid IllegalStateException, this method only affects transactions that are started after this method is called. If this method is never called, the transaction is allowed unlimited amount of time to complete.

Parameters:

timeout - is the transaction timeout value in seconds. Use a value of 0 to indicate a transaction is allowed unlimited amount of time so that no TransactionTimeoutException ever occurs.

Throws:

java.lang.IllegalStateException - if this method is called after the initialize() method is called.

Since:

WAS XD 6.0.1

See Also:

initialize(), Session.TRANSACTION_NO_TIMEOUT, Session.setTransactionTimeout(int), TransactionTimeoutException

getTxTimeout

int getTxTimeout()

Gets transaction timeout setting for this ObjectGrid instance.

Returns:

timeout value that was passed to the setTxTimeout(int) method or 0 if setTxTimeout was never called.

Since:

WAS XD 6.0.1

See Also:

setTxTimeout(int)

destroy

void destroy()

Destroys this instance.

This method should be invoked when the ObjectGrid is no longer being used. When this method is called, the ObjectGrid can free up any resources it is using. No new Sessions can be created or used after the destroy() has been invoked. Any in-flight Sessions will be allowed to continue, if the resources are still available to complete processing.

getSession

Session getSession(CredentialGenerator credGen)
                   throws ObjectGridException,
                          TransactionCallbackException

Get a session using a CredentialGenerator.

This method can only be called by the ObjectGrid client in an ObjectGrid client server environment. If ObjectGrid is used in a local model, that is, within the same JVM with no client or server existing, getSession(Subject) or the SubjectSource plugin should be used to secure the ObjectGrid.

If the initialize() method has not been invoked prior to the first getSession invocation, an implicit initialization will occur. This ensures that all of the configuration is complete before any runtime usage is required.

Parameters:

credGen - A CredentialGenerator for generating a credential for the session returned.

Returns:

An instance of Session

Throws:

ObjectGridException - if an error occurs during processing

TransactionCallbackException - if the TransactionCallback throws an exception

java.lang.IllegalStateException - if this method is called after the destroy() method is called.

Since:

WAS XD 6.0.1

See Also:

destroy(), initialize(), CredentialGenerator, Session

setQueryConfig

void setQueryConfig(QueryConfig queryConfig)

Set the QueryConfig object for this ObjectGrid. A QueryConfig object provides query configurations for executing object queries over the maps in this ObjectGrid.

Parameters:

queryConfig - The QueryConfig to associate with this ObjectGrid instance.

Since:

WAS XD 6.1

See Also:

QueryConfig

registerEntities

void registerEntities(java.net.URL entityXML)

Registers one ore more entities from an entity XML file.

Entity registration is required prior to ObjectGrid initialization to bind an Entity with a BackingMap and any defined indices.

This method may be called multiple times.

Parameters:

entityXML - the URL of the entity XML that defines the entities.

Throws:

java.lang.IllegalStateException - if this method is called after the initialize() method is called.

Since:

WAS XD 6.1

registerEntities

void registerEntities(java.lang.Class[] entities)

Register one or more entities based on the class metadata.

Entity registration is required prior to ObjectGrid initialization to bind an Entity with a BackingMap and any defined indices.

This method may be called multiple times.

Parameters:

entities - one or more annotated entity classes to register as entities.

Throws:

java.lang.IllegalStateException - if this method is called after the initialize() method is called.

Since:

WAS XD 6.1

getObjectGridType

int getObjectGridType()

Returns the type of ObjectGrid.

The return value is equivalent to one of the constants declared on this interface, LOCAL, SERVER, or CLIENT.

Returns:

the ObjectGrid type

Since:

WAS XD 6.1

setObjectGridAuthorization

void setObjectGridAuthorization(ObjectGridAuthorization ogAuthorization)

Sets the ObjectGridAuthorization for this ObjectGrid instance.

Passing null to this method removes a previously set ObjectGridAuthorization object from an earlier invocation of this method and indicates that this ObjectGrid is not associated with a ObjectGridAuthorization object.

This method should only be used when ObjectGrid security is enabled. If the ObjectGrid security is disabled, the provided ObjectGridAuthorization object will not be used.

A ObjectGridAuthorization plugin can be used to authorize access to the ObjectGrid and maps. Please refer to ObjectGridAuthorization for more details.

As of XD 6.1, the setMapAuthorization is deprecated and setObjectGridAuthorization is recommended for use. However, if both MapAuthorization plugin and ObjectGridAuthorization plugin are used, ObjectGrid will use the provided MapAuthorization to authorize map accesses, even though it is deprecated.

Note, to avoid an IllegalStateException, this method must be called prior to the initialize() method. Also, keep in mind that the getSession methods implicitly call the initialize() method if it has yet to be called by the application.

Parameters:

ogAuthorization - the ObjectGridAuthorization plugin

Throws:

java.lang.IllegalStateException - if this method is called after the initialize() method is called.

Since:

WAS XD 6.1

See Also:

initialize(), ObjectGridAuthorization