AccessIntent interface

The AccessIntent interface is available to bean-managed persistence (BMP) entity beans.

A BMP entity bean can get and use an instance of the AccessIntent interface.

See see Use the AccessIntent API.

 

AccessIntent interface

package com.ibm.websphere.appprofile.accessintent; 

/** 
* This interface defines the essential access intents 
* available at run time. 
*/  

public interface AccessIntent { 

/** 
* Return the concurrency control intent, which indicates 
* the application prefers either pessimistic or optimistic 
* concurrency control when accessing the current component 
* in the context of the current transaction. 
*/  

  public int getConcurrencyControl();
  public final int CONCURRENCY_CONTROL_PESSIMISTIC = 1;
  public final int CONCURRENCY_CONTROL_OPTIMISTIC = 2; 


/** 
* Return access type intent, which indicates the application 
* intends either update or read access of the current component 
* in the context of the current transaction. 
*/  

public int getAccessType();
public final int ACCESS_TYPE_UPDATE= 1;  
public final int ACCESS_TYPE_READ = 2; 

/** 
* Return an integer value that indicates that the run time should 
* assume that there will be no collision on retrieved rows. 
*/  
public int getPessimisticUpdateLockHint(); 
public final static int PESSIMISTIC_UPDATE_LOCK_HINT_NOCOLLISION = 1; 
public final static int PESSIMISTIC_UPDATE_LOCK_HINT_WEAKEST_LOCK_AT_LOAD = 2;
 public final static int PESSIMISTIC_UPDATE_LOCK_HINT_NONE = 3;
 public final static int PESSIMISTIC_UPDATE_LOCK_HINT_EXCLUSIVE = 4; 

/* 
* Return an integer value that indicates that the run time should 
* assume that there will be collisions on retrieved rows. 
*/  
public int getPessimisticUpdateLockHint(); 
public final static int PESSIMISTIC_UPDATE_LOCK_HINT_NOCOLLISION = 1;
 public final static int PESSIMISTIC_UPDATE_LOCK_HINT_WEAKEST_LOCK_AT_LOAD = 2;
 public final static int PESSIMISTIC_UPDATE_LOCK_HINT_NONE = 3;
 public final static int PESSIMISTIC_UPDATE_LOCK_HINT_EXCLUSIVE = 4; 
 

/** 
* Return the collection access intent, which indicates the 
* application intends to access the objects returned by the 
* currently executing finder in either serial or random fashion. 
*/  
public int getCollectionAccess();  
public final int COLLECTION_ACCESS_RANDOM = 1;
  public final int COLLECTION_ACCESS_SERIAL = 2; 

/** 
* Return the collection scope, which indicates the maximum 
* lifespan of a lazy collection. 
*/  
public int getCollectionScope();  
public final int COLLECTION_SCOPE_TRANSACTION = 1;
  public final int COLLECTION_SCOPE_ACTIVITYSESSION = 2;
  public final int COLLECTION_SCOPE_TIMEOUT = 3; 

/** 
* Return the timeout value in seconds when collectionScope is Timeout. 
*/  
public int getCollectionTimeout(); 

/** 
* Return the number of elements the application requests be contained 
* in each segment of the element collection returned by the currently 
* executing finder. 
*/  
public int getCollectionIncrement(); 

/** 
* Return the ReadAheadHint requested by the application for the currently 
* executing finder. 
*/  
public ReadAheadHint getReadAheadHint(); 

/** 
* Return the number of elements the application requests be contained in 
* each segment of a query made on a database. 
*/  
public int getResourceManagerPreFetchIncrement(); 

} 

---

 

Related tasks

Access intent policies
Applying access intent policies to beans
Set read-read consistency checking with an assembly tool
Applying access intent policies to methods

 

Related

Access intent exceptions
Access intent troubleshooting tips