|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
An interface for an object that provides fundamental object access services to Lighthouse components and applications.
Field Summary | |
static java.lang.String |
HIGH_VALUES
A sentinel value that represents the highest possible value of a sort key (e.g., OP_ORDER_BY). |
static java.lang.String |
OP_ALLOW_NOT_FOUND
An option that may be recognized by checkoutObject
to return null if it cannot find the specified object. |
static java.lang.String |
OP_ATTRIBUTES
The name of a query option used to specify search conditions. |
static java.lang.String |
OP_BLOCK_SIZE
The size of the block used when buffering query results. |
static java.lang.String |
OP_BUFFERED
The name of a query option used to requst result buffering. |
static java.lang.String |
OP_CONDITIONS
The name of a query option used to specify search conditions. |
static java.lang.String |
OP_END_BEFORE
The name of a query option that specifies a concatenated key value. |
static java.lang.String |
OP_FAST
An option that may be recognized by checkinObject
to perform the fastest possible checkin. |
static java.lang.String |
OP_FILTER
|
static java.lang.String |
OP_FORCE
An option that may be used with the checkinObject
method to disable any constraint checking that might ordinarilly
be performed during the checkin. |
static java.lang.String |
OP_KEEP_LOCK
An option that may be recognized by checkinObject
to preserve the caller's logical lock on the specified object. |
static java.lang.String |
OP_MAX_ROWS
The name of a query option used to specify the maximum number of rows to return in a result. |
static java.lang.String |
OP_NO_CACHE
In some cases, the results of a listObjects call may be cached and reused. |
static java.lang.String |
OP_NO_RULE_DRIVEN_MEMBERS
The name of a query option used to specify that the query results should not include any rule driven members when a query includes the memberObjectGroup scoping attribute. |
static java.lang.String |
OP_ONLY_NAMES
Return only names (and IDs) in the query result. |
static java.lang.String |
OP_ORDER_BY
The name of a query option used to specify sorting of the result. |
static java.lang.String |
OP_START_AFTER
The name of a query option that specifies a concatenated key value. |
static java.lang.String |
OP_SUBJECT
The name of a query option used to specify the authorization filtering. |
static java.lang.String |
OP_SUBTYPES
A flag recognized by getObject and getObjectIfExists that will cause it to search repository subtypes of the given type. |
static java.lang.String |
OP_USER
The name of an option used with a number of PersistentObject access methods to specify the name of the Lighthouse user that is to be considered the performer of the requst. |
Method Summary | |
boolean |
breakLock(java.lang.Object type,
java.lang.String id,
java.util.Map options)
Break a lock held on an object. |
WavesetResult |
checkinObject(PersistentObject obj,
java.util.Map options)
Store changes to an object and release the logical lock. |
WavesetResult |
checkinView(GenericObject view,
java.util.Map options)
Checkin a view. |
PersistentObject |
checkoutObject(java.lang.Object type,
java.lang.String id,
java.util.Map options)
Checkout a persistent object for editing. |
GenericObject |
checkoutView(java.lang.String id,
java.util.Map options)
Checkout a view. |
WavesetResult |
commitView(GenericObject view,
java.util.Map options)
Commit a view. |
int |
countObjects(java.lang.Object type,
java.util.Map options)
Get a count of objects of a given type. |
GenericObject |
createView(java.lang.String id,
java.util.Map options)
Create a view. |
void |
deleteObject(java.lang.Object type,
java.lang.String id,
java.util.Map options)
Delete an object. |
void |
deleteObjects(java.lang.Object type,
java.util.Map options)
Delete all objects matching certain conditions. |
WavesetResult |
deleteView(java.lang.String id,
java.util.Map options)
Delete the repository objects that are associated with the view id. |
ObjectCache |
getCache()
Get a handle to the object cache. |
Form |
getForm(GenericObject view,
java.util.Map options)
Get the form to be used with a view. |
LockInfo |
getLock(java.lang.Object type,
java.lang.String id)
Obtain current lock status. |
PersistentObject |
getObject(java.lang.Object type,
java.lang.String id)
Get a read-only copy of an object. |
PersistentObject |
getObject(java.lang.Object type,
java.lang.String id,
java.util.Map options)
Get a read-only copy of an object. |
PersistentObject |
getObjectIfExists(java.lang.Object type,
java.lang.String id)
Get a read-only object copy of an object, but do not throw an exception if it does not exist. |
PersistentObject |
getObjectIfExists(java.lang.Object type,
java.lang.String id,
java.util.Map options)
Get a read-only object copy of an object, but do not throw an exception if it does not exist. |
QueryResult |
getObjects(java.lang.Object type,
java.util.Map options)
Get a list of objects of a given type. |
GenericObject |
getSystemConfiguration()
Obtain the system configuration object. |
GenericObject |
getView(java.lang.String id,
java.util.Map options)
Get a view. |
QueryResult |
listObjects(java.lang.Object type,
java.util.Map options)
Get a list of summary attributes for objects of a given type. |
LockInfo |
lockObject(java.lang.Object type,
java.lang.String id,
java.util.Map options)
Acquire a logical lock an object, without retrieving it. |
GenericObject |
refreshView(GenericObject view,
java.util.Map options)
Refresh a view. |
void |
renameObject(java.lang.Object type,
java.lang.String id,
java.lang.String newName,
java.util.Map options)
Rename an object. |
void |
unlockObject(java.lang.Object type,
java.lang.String id,
java.util.Map options)
Unlock a previously locked object. |
void |
unlockView(GenericObject view,
java.util.Map options)
Unlock a view. |
Field Detail |
public static final java.lang.String OP_ORDER_BY
public static final java.lang.String OP_START_AFTER
'orderBy'
values
are greater than the set of values that this option specifies.
The value is expected to be a list of string values
that correspond positionally to the attribute names
that are specified as the value of OP_ORDER_BY
.
public static final java.lang.String OP_END_BEFORE
'orderBy'
values
are less than the set of values that this option specifies.
The value is expected to be a list of string values
that correspond positionally to the attribute names
that are specified as the value of OP_ORDER_BY
.
public static final java.lang.String HIGH_VALUES
HIGH_VALUES
as the value of OP_END_BEFORE
should contain the items
with the highest 'orderBy'
values.
public static final java.lang.String OP_ATTRIBUTES
public static final java.lang.String OP_CONDITIONS
public static final java.lang.String OP_MAX_ROWS
public static final java.lang.String OP_SUBJECT
public static final java.lang.String OP_FILTER
public static final java.lang.String OP_BUFFERED
public static final java.lang.String OP_BLOCK_SIZE
public static final java.lang.String OP_NO_CACHE
This option will also be recognized by the PersistentObject access methods such as getObject and getObjectIfExists to avoid the object cache. The checkoutObject method will always bypass the cache when obtaining a lock.
public static final java.lang.String OP_ONLY_NAMES
public static final java.lang.String OP_SUBTYPES
public static final java.lang.String OP_USER
The ObjectSource is not required to support this option, if it does not it will be silently ignored.
public static final java.lang.String OP_FORCE
checkinObject
method to disable any constraint checking that might ordinarilly
be performed during the checkin. This may be used to improve
the performance of the checkin in sitations where you know that
the object is valid. The ObjectSource may ignore this option.
When used with the deleteObject
method, it indiciates
that inter-object delete constraints will not be checked. For
WSUser objects, it indicates that the WSUser may be deleted even
if the user has provisioned resource accounts.
public static final java.lang.String OP_FAST
checkinObject
to perform the fastest possible checkin. This may cause
certain constraint checking that is performed even with the OP_FORCE
option.
public static final java.lang.String OP_KEEP_LOCK
checkinObject
to preserve the caller's logical lock on the specified object.
Otherwise, checkinObject
releases any logical lock
after updating the object.
public static final java.lang.String OP_ALLOW_NOT_FOUND
checkoutObject
to return null
if it cannot find the specified object.
Otherwise, checkoutObject
throws ItemNotFound
if it cannot find the specified object.
public static final java.lang.String OP_NO_RULE_DRIVEN_MEMBERS
Method Detail |
public GenericObject getSystemConfiguration() throws WavesetException
WavesetException
public ObjectCache getCache()
public PersistentObject getObject(java.lang.Object type, java.lang.String id) throws WavesetException, ItemNotFound
checkoutObject
method.
WavesetException
ItemNotFound
public PersistentObject getObject(java.lang.Object type, java.lang.String id, java.util.Map options) throws WavesetException, ItemNotFound
WavesetException
ItemNotFound
public PersistentObject getObjectIfExists(java.lang.Object type, java.lang.String id) throws WavesetException
WavesetException
public PersistentObject getObjectIfExists(java.lang.Object type, java.lang.String id, java.util.Map options) throws WavesetException
WavesetException
public LockInfo lockObject(java.lang.Object type, java.lang.String id, java.util.Map options) throws ItemNotFound, LockedByAnother, WavesetException
The OP_USER
option may be used to specify the
name of the user considered to be acquiring the lock.
ItemNotFound
LockedByAnother
WavesetException
public void unlockObject(java.lang.Object type, java.lang.String id, java.util.Map options) throws ItemNotFound, ItemNotLocked, LockedByAnother, WavesetException
The OP_USER
option may be used to specify the
name of the user considered to be releasing the lock.
ItemNotFound
ItemNotLocked
LockedByAnother
WavesetException
public LockInfo getLock(java.lang.Object type, java.lang.String id) throws ItemNotFound, WavesetException
ItemNotFound
WavesetException
public boolean breakLock(java.lang.Object type, java.lang.String id, java.util.Map options) throws ItemNotFound, WavesetException
There is no guarentee a lock will be broken, you normally must have authority over the user that is currently holding the lock.
The OP_USER
option may be used to specify the
name of the user considered to be breaking the lock.
ItemNotFound
WavesetException
public PersistentObject checkoutObject(java.lang.Object type, java.lang.String id, java.util.Map options) throws ItemNotFound, LockedByAnother, WavesetException
It is usually more efficient to call checkoutObject
rather
than make individual calls to lockObject
and getObject
The OP_USER
option may be used to specify the
name of the user considered to be checking out the object.
The OP_ALLOW_NOT_FOUND
option may be passed
to return null
if cannot find the specified object.
Otherwise, this method throws ItemNotFound
.
ItemNotFound
LockedByAnother
WavesetException
public WavesetResult checkinObject(PersistentObject obj, java.util.Map options) throws ItemNotFound, ItemNotLocked, LockedByAnother, WavesetException
The OP_USER
option may be used to specify the
name of the user considered to be checkin in the object.
The OP_FORCE
option may be passed to inhibit
any constraint checking that would ordinarilly be done
prior to storage. This is normally
off, but since constraint checking can be expensive, there may
be performance reasons for turning it on if you can ensure that
the object is correct.
The OP_KEEP_LOCK
option may be passed
to preserve the caller's logical lock on the specified object.
Otherwise, this method releases any lock after updating the object.
ItemNotFound
ItemNotLocked
LockedByAnother
WavesetException
public void deleteObject(java.lang.Object type, java.lang.String id, java.util.Map options) throws ItemNotFound, LockedByAnother, WavesetException
The OP_FORCE
option may be passed to inhibit
any constraint checking that would ordinarilly be done.
This may be used to delete a WSUser object that has provisioned
resource accounts, normally a WSUser cannot be deleted until
it has been fully deprovisioned.
ItemNotFound
LockedByAnother
WavesetException
public void deleteObjects(java.lang.Object type, java.util.Map options) throws LockedByAnother, WavesetException
LockedByAnother
WavesetException
public void renameObject(java.lang.Object type, java.lang.String id, java.lang.String newName, java.util.Map options) throws ItemNotFound, LockedByAnother, AlreadyExists, WavesetException
The object must unlocked, or locked by the current user. It will be implicitly locked to perform the rename.
The OP_USER
option may be used to specify the
name of the user considered to be renaming the object.
ItemNotFound
LockedByAnother
AlreadyExists
WavesetException
public QueryResult listObjects(java.lang.Object type, java.util.Map options) throws WavesetException
WavesetException
public QueryResult getObjects(java.lang.Object type, java.util.Map options) throws WavesetException
WavesetException
public int countObjects(java.lang.Object type, java.util.Map options) throws WavesetException
WavesetException
public GenericObject getView(java.lang.String id, java.util.Map options) throws WavesetException
WavesetException
public Form getForm(GenericObject view, java.util.Map options) throws WavesetException
WavesetException
public GenericObject createView(java.lang.String id, java.util.Map options) throws WavesetException
WavesetException
public GenericObject checkoutView(java.lang.String id, java.util.Map options) throws WavesetException
WavesetException
public GenericObject refreshView(GenericObject view, java.util.Map options) throws WavesetException
WavesetException
public WavesetResult checkinView(GenericObject view, java.util.Map options) throws WavesetException
WavesetException
public WavesetResult commitView(GenericObject view, java.util.Map options) throws WavesetException
WavesetException
public void unlockView(GenericObject view, java.util.Map options) throws WavesetException
WavesetException
public WavesetResult deleteView(java.lang.String id, java.util.Map options) throws WavesetException
WavesetException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |