A script enabled browser is required for this page to function properly
Oracle® Beehive RESTful Web Services API Reference
Release 2 (2.0.1.7)
E16658-04
Overview
An entity may be locked by an actor, and the Lock may be jointly
held by a set of owners; a lock may be owned by either an actor or
a group. The locking actor must have write access on the entity.
Actors not included in this owner set are prevented from modifying
the properties of the locked entity. A Lock has an optional timeout
value, after which point the lock is automatically released. The Lock
creator, Lock holders, and users that have administrative privileges on
the locked entity (such as workspace coordinators) may release the
lock manually. Every Lock has a lock type associated with it.
A given set of owners may hold two locks of different types
on an entity simultaneously, but may not hold two locks of the same type on
a single entity. If the entity on which a Lock is held is a container, then the
Lock is also in effect for all entities contained within the container.
Since access control for locks is governed by the lock holders, the
standard Beehive-wide access control members should be ignored for this entity.
Members
Show inherited members
Projections
BASIC
EMPTY
FULL
META
Name
Type
Required
Description
attachedMarkers
marker []
Set of marker elements associated with the entity.
attachedReminders
reminder []
List of reminders attached to the entity
attachedSubscriptions
subscription []
List of subscriptions attached to the entity
collabId
beeId
CollabId of the snapshot
createdOn
dateTime
Entity's creation date
creator
actor
The actor that created this entity
deleted
boolean
Deletion flag. If this property is set to true the entity is
deleted.
lockHolders
accessor []
The list of holders of the lock. A lock holder can be either an actor
or a group.
lockType
lockType
The type of the lock. This member is not related to the type of entity on
which the lock is held but rather the means/purpose for which the lock
was acquired.
lockedEntity
entity
The entity on which the lock was applied.
modifiedBy
actor
The actor that last modified the entity
modifiedOn
dateTime
The date when entity was last modified
name
string
Name of the entity.
parent
entity
The parent for this entity.
properties
collabProperties
Custom properties defined on the lock.
snapshotId
string
Contains the snapshot identifier for this snapshot. Snapshot identifiers
are used to implement optimistic locking on the server.
timeout
dateTime
Time at which the lock will expire and no longer be in effect.
Hierarchy
Examples
Below are examples in JSON and XML formats. All examples are shown with all inherited members. Quoting when required is part of the examples, but you must obviously populate with your own data.
XML Example
(show inherited members)
<obh:lock xsi:type="obh:lock" xmlns:obh="http://www.oracle.com/beehive" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<obh:attachedMarkers>your_marker_0 </obh:attachedMarkers>
<obh:attachedMarkers>your_marker_1 </obh:attachedMarkers>
<obh:attachedMarkers>your_marker_2 </obh:attachedMarkers>
<obh:attachedReminders>your_reminder_0 </obh:attachedReminders>
<obh:attachedReminders>your_reminder_1 </obh:attachedReminders>
<obh:attachedReminders>your_reminder_2 </obh:attachedReminders>
<obh:attachedSubscriptions>your_subscription_0 </obh:attachedSubscriptions>
<obh:attachedSubscriptions>your_subscription_1 </obh:attachedSubscriptions>
<obh:attachedSubscriptions>your_subscription_2 </obh:attachedSubscriptions>
<obh:collabId>your_beeId_0 </obh:collabId>
<obh:createdOn>your_dateTime_0 </obh:createdOn>
<obh:creator>your_actor_0 </obh:creator>
<obh:deleted>your_boolean_0 </obh:deleted>
<obh:lockHolders>your_accessor_0 </obh:lockHolders>
<obh:lockHolders>your_accessor_1 </obh:lockHolders>
<obh:lockHolders>your_accessor_2 </obh:lockHolders>
<obh:lockType>your_lockType_0 </obh:lockType>
<obh:lockedEntity>your_entity_0 </obh:lockedEntity>
<obh:modifiedBy>your_actor_0 </obh:modifiedBy>
<obh:modifiedOn>your_dateTime_0 </obh:modifiedOn>
<obh:name>your_string_0 </obh:name>
<obh:parent>your_entity_0 </obh:parent>
<obh:properties>your_collabProperties_0 </obh:properties>
<obh:snapshotId>your_string_0 </obh:snapshotId>
<obh:timeout>your_dateTime_0 </obh:timeout>
</obh:lock>
JSON Example
(show inherited members)
{
"beeType":"lock",
"attachedMarkers":[
{ your_{http://www.oracle.com/beehive}attachedMarkers_as_marker0 },
{ your_{http://www.oracle.com/beehive}attachedMarkers_as_marker1 },
{ your_{http://www.oracle.com/beehive}attachedMarkers_as_marker2 }
],
"attachedReminders":[
{ your_{http://www.oracle.com/beehive}attachedReminders_as_reminder0 },
{ your_{http://www.oracle.com/beehive}attachedReminders_as_reminder1 },
{ your_{http://www.oracle.com/beehive}attachedReminders_as_reminder2 }
],
"attachedSubscriptions":[
{ your_{http://www.oracle.com/beehive}attachedSubscriptions_as_subscription0 },
{ your_{http://www.oracle.com/beehive}attachedSubscriptions_as_subscription1 },
{ your_{http://www.oracle.com/beehive}attachedSubscriptions_as_subscription2 }
],
"collabId":{ your_{http://www.oracle.com/beehive}collabId_as_beeId0 },
"createdOn":"your_{http://www.oracle.com/beehive}createdOn_as_dateTime0",
"creator":{ your_{http://www.oracle.com/beehive}creator_as_actor0 },
"deleted":your_{http://www.oracle.com/beehive}deleted_as_boolean0,
"lockHolders":[
{ your_{http://www.oracle.com/beehive}lockHolders_as_accessor0 },
{ your_{http://www.oracle.com/beehive}lockHolders_as_accessor1 },
{ your_{http://www.oracle.com/beehive}lockHolders_as_accessor2 }
],
"lockType":{ your_{http://www.oracle.com/beehive}lockType_as_lockType0 },
"lockedEntity":{ your_{http://www.oracle.com/beehive}lockedEntity_as_entity0 },
"modifiedBy":{ your_{http://www.oracle.com/beehive}modifiedBy_as_actor0 },
"modifiedOn":"your_{http://www.oracle.com/beehive}modifiedOn_as_dateTime0",
"name":"your_{http://www.oracle.com/beehive}name_as_string0",
"parent":{ your_{http://www.oracle.com/beehive}parent_as_entity0 },
"properties":{ your_{http://www.oracle.com/beehive}properties_as_collabProperties0 },
"snapshotId":"your_{http://www.oracle.com/beehive}snapshotId_as_string0",
"timeout":"your_{http://www.oracle.com/beehive}timeout_as_dateTime0"
}
XML Schema
<xs:complexType name="lock">
<xs:complexContent>
<xs:extension base="tns:entity">
<xs:sequence>
<xs:element maxOccurs="unbounded" minOccurs="0"
name="lockHolders" nillable="true" type="tns:accessor"/>
<xs:element minOccurs="0" name="lockType" type="tns:lockType"/>
<xs:element minOccurs="0" name="lockedEntity" type="tns:entity"/>
<xs:element minOccurs="0" name="properties" type="tns:collabProperties"/>
<xs:element minOccurs="0" name="timeout" type="xs:dateTime"/>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
References
The following data represents the references to lock
Referenced By Resources
Referenced By Representaions
Copyright © 2008, 2012, Oracle and/or its affiliates. All rights reserved.
Legal Notices