Oracle Beehive
  Oracle® Beehive RESTful Web Services API Reference
  Release 2 (2.0.1.7)
  E16658-04

Contents

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

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

Inherits From

Applied Markers

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

Usage Resource Method
Response Lock Read
Response Lock Update

Referenced By Representaions