Skip navigation links

Oracle® Information Rights Management Server Java API Reference
11g Release 1 (11.1.1)

E12907-02


oracle.irm.engine.classifications.context
Interface Context

All Known Subinterfaces:
ContextInstance

public interface Context

A context. A context is used as a coarse grained way of classifying sealed documents. When content is sealed to the context classification system the sealed content contains details of the Context together with semi-unique value called the ItemCode. This information together is called the ContextCookie. Rights to access context classified content is expressed in terms of the context and optionally the item code. e.g. "john can access all content sealed against context top secret" or "mary can access only content sealed against context top secret with an item code of secrets.sdoc". A context is identified by an UUID value.

Creation

Instances of Context objects can be created using the following factory style method(s).

Context object = createContext(uuid);

Collections

Collections for Context objects can be created using the following factory method. This method creates the most appropriate collection implementation class for storing Context elements.

 Collection<Context> object = createContexts();

Consult the Uuid property for more information on how this property can relate to Context collections.

XML Serialization

Context instances can be serialized as an XML document. This XML document can also be used to recreate a Context object. The following XML document shows an example Context in XML form.

<?xml version="1.0" encoding="UTF-8"?>
<classifications:Context xmlns:classifications="http://xmlns.oracle.com/irm/classifications">
    <uuid>588403f9-9cff-4cce-88e4-e030cc57282a</uuid>
</classifications:Context>

Context instances can also be serialized by reference. A reference contains all the information needed to uniquely identify a Context without needing to serialize the complete object. The reference form of the XML document can be seen below.

<?xml version="1.0" encoding="UTF-8"?>
<classifications:ContextRef xmlns:classifications="http://xmlns.oracle.com/irm/classifications">
    <uuid>588403f9-9cff-4cce-88e4-e030cc57282a</uuid>
</classifications:ContextRef>


Method Summary
 UUID getUuid()
          Context UUID.

 

Method Detail

getUuid

UUID getUuid()
Context UUID. A globally unique UUID for the context.

Collections

This property value can be used to retrieve the object from a collection using getContextByUuid.
Returns:
the value of the property. This method will never return null.

Skip navigation links

Oracle® Information Rights Management Server Java API Reference
11g Release 1 (11.1.1)

E12907-02


Copyright © 2010, Oracle. All rights reserved.