|
Oracle® Information Rights Management Server Java API Reference 11g Release 1 (11.1.1) E12907-01 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object
oracle.irm.engine.types.core.license.License
public class License
License type. A license defines the what you can do, with what classifications and when criteria. The criteria of a license are stored in the Criteria
property. This property contains all the data that defines the what you can do, with what classifications and when. When licenses are requested by the desktop (for example, when content is opened) additional properties on the license are altered to reflect where the license is delivered. This process is called serving a license and is processed by the serveLicenses
operation. The serving process sets additional properties on the license such as the RequestTime
, RefreshTime
and attached Device
. If the license can be refreshed from the server these properties are also recorded in persistent storage. If the same license is requested, these properties are restored and checked, to ensure the license is not already in use.
License instances can be serialized as an XML document. This XML document can also be used to recreate a License object. The following XML document shows an example License in XML form.
<?xml version="1.0" encoding="UTF-8"?>
<core:License xmlns:classifications="http://xmlns.oracle.com/irm/classifications" xmlns:core="http://xmlns.oracle.com/irm/core" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<uuid>7fabc0b0-6ece-495b-96e3-661b655b1759</uuid>
<criteria>
<storage>PERSISTENT</storage>
<delivery>SYNCHRONIZATION</delivery>
<use>PRIMARY</use>
<features>
<id>oracle.irm.generic.Open</id>
<use>IMMEDIATE</use>
<record>true</record>
</features>
<timeSpans xsi:type="core:AbsoluteTimeSpan">
<referencePoint>CURRENT</referencePoint>
<startTime>2007-08-10T12:00:00.000+01:00</startTime>
<stopTime>2007-09-10T12:00:00.000+01:00</stopTime>
</timeSpans>
<refreshPeriod>
<amount>120</amount>
<units>SECONDS</units>
</refreshPeriod>
<classifications xsi:type="core:XPathClassificationFilter">
<system>
<uuid>588403f9-9cff-4cce-88e4-e030cc57282a</uuid>
</system>
<uri>http://irm.example.com/irm_desktop</uri>
<expression>
<namespaceContexts>classifications:classifications</namespaceContexts>
<value>classifications:ContextCookie/[context[uuid='588403f9-9cff-4cce-88e4-e030cc57282a'] and itemCode='item1.sdoc']</value>
</expression>
</classifications>
<destinations xsi:type="core:XPathClassificationFilter">
<system>
<uuid>588403f9-9cff-4cce-88e4-e030cc57282a</uuid>
</system>
<uri>http://irm.example.com/irm_desktop</uri>
<expression>
<namespaceContexts>classifications:classifications</namespaceContexts>
<value>classifications:ContextCookie/context[uuid='9275e6e5-9550-4054-9a4e-618971d5aeda']</value>
</expression>
</destinations>
</criteria>
<keys>
<uuid>213f8f65-c5d1-4868-9fff-ad156daa2dd6</uuid>
</keys>
<licenseTime>2007-01-01T12:00:00.000+01:00</licenseTime>
<requestTime>2008-01-01T12:00:00.000+01:00</requestTime>
<serveUuid>9c31d850-4470-4ba4-8dac-16324156e54f</serveUuid>
<refreshTime>2009-01-01T12:00:00.000+01:00</refreshTime>
</core:License>
Nested Class Summary | |
---|---|
static class |
License.Availability Availability enumeration. |
static class |
License.ExpiryType Expiry Type enumeration. |
Constructor Summary | |
---|---|
License() No argument constructor. |
|
License(UUID uuid, LicenseCriteria criteria, KeySetRef[] keys, Date licenseTime, Date requestTime, UUID serveUuid, Date refreshTime) Constructor. |
Method Summary | |
---|---|
LicenseCriteria |
getCriteria() The license criteria. |
KeySetRef[] |
getKeys() The related key sets. |
Date |
getLicenseTime() License time. |
Date |
getRefreshTime() Refresh time. |
Date |
getRequestTime() Request time. |
UUID |
getServeUuid() Serve UUID. |
UUID |
getUuid() An unique identity for a license. |
void |
setCriteria(LicenseCriteria value) The license criteria. |
void |
setKeys(KeySetRef[] value) The related key sets. |
void |
setLicenseTime(Date value) License time. |
void |
setRefreshTime(Date value) Refresh time. |
void |
setRequestTime(Date value) Request time. |
void |
setServeUuid(UUID value) Serve UUID. |
void |
setUuid(UUID value) An unique identity for a license. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public License()
public License(UUID uuid, LicenseCriteria criteria, KeySetRef[] keys, Date licenseTime, Date requestTime, UUID serveUuid, Date refreshTime)
Method Detail |
---|
public UUID getUuid()
serveLicenses
to record where the license was delivered. Maintaining the same UUID for logically equivalent licenses is important when tracking of a license's use is important.Criteria
to change over time for the same UUID.public void setUuid(UUID value)
serveLicenses
to record where the license was delivered. Maintaining the same UUID for logically equivalent licenses is important when tracking of a license's use is important.Criteria
to change over time for the same UUID.value
- the new value for the property.public LicenseCriteria getCriteria()
public void setCriteria(LicenseCriteria value)
value
- the new value for the property.public KeySetRef[] getKeys()
public void setKeys(KeySetRef[] value)
value
- the new value for the property.public Date getLicenseTime()
public void setLicenseTime(Date value)
value
- the new value for the property.public Date getRequestTime()
public void setRequestTime(Date value)
value
- the new value for the property.public UUID getServeUuid()
public void setServeUuid(UUID value)
value
- the new value for the property.public Date getRefreshTime()
public void setRefreshTime(Date value)
value
- the new value for the property.
|
Oracle® Information Rights Management Server Java API Reference 11g Release 1 (11.1.1) E12907-01 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |