OSID Logo
OSID Specifications
dictionary package
Version 3.0.0
Release Candidate Preview
Interfaceosid.dictionary.DictionaryProxyManager
Implementsosid.OsidProxyManager
osid.dictionary.DictionaryProfile
Description

The dictionary manager provides access to dictionary sessions and provides interoperability tests for various aspects of this service. Methods in this manager support a Proxy to pass information from server environments. The sessions included in this manager are:

  • EntryRetrievalSession: a basic session for retrieving dictoonary entries
  • EntryLookupSession: a session for looking up dictionary entries
  • EntryQuerySession: a session for querying dictionary entries
  • EntrySearchSession: a session for searching for dictionary entries
  • EntryAdminSession: a session for creating, updating, and delting dictionary entries
  • EntryNotificationSession: a session for subscribing to notifications about dictionary entries
  • EntryDictionarySession: a session to look up entry to dictionary mappings
  • EntryDictionaryAssignmentSession: a session to manage entry to dictionary mappings
  • EntrySmartDictionarySession: a session to manage smart entry dictionaries
  • DictionaryLookupSession a session for looking up dictionaries
  • DictionaryQuerySession a session for querying dictionaries
  • DictionarySearchSession a session for searchin gamong dictionaries
  • DictionaryAdminSession a session creating, updating or deleting dictionaries
  • DictionaryNotificationSession: a session for subscribing to adds and changes of dictionaries
  • DictionaryHierarchySession: a session for traversing the hierarchy of dictionaries
  • DictionaryHierarchyDesignSession: a session for managing the dictionary hierarchy
MethodgetEntryRetrievalSession
Description

Gets the OsidSession used to retrieve dictionary entries.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.dictionary.EntryRetrievalSessionan EntryRetrievalSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntryRetrieval() is false
ComplianceoptionalThis method must be implemented if supportsEntryRetrieval() is true.
MethodgetEntryRetrievalSessionForDictionary
Description

Gets the OsidSession used to retrieve dictionary entries for the specified Dictionary .

Parametersosid.id.IddictionaryIdthe Id of the Dictionary to use
osid.proxy.Proxyproxya proxy
Returnosid.dictionary.EntryRetrievalSessionan EntryRetrievalSession
ErrorsNOT_FOUNDno Dictionary found by the given Id
NULL_ARGUMENT dictionaryId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntryRetrieval() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsEntryRetrieval(), supportsVisibleFederation() are true.
MethodgetEntryLookupSession
Description

Gets the OsidSession used to lookup dictionary entries.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.dictionary.EntryLookupSessionan EntryLookupSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntryLookup() is false
ComplianceoptionalThis method must be implemented if supportsEntryLookup() is true.
MethodgetEntryLookupSessionForDictionary
Description

Gets the OsidSession used to lookup dictionary entries for the specified Dictionary .

Parametersosid.id.IddictionaryIdthe Id of the Dictionary to use
osid.proxy.Proxyproxya proxy
Returnosid.dictionary.EntryLookupSessionan EntryLookupSession
ErrorsNOT_FOUNDno Dictionary found by the given Id
NULL_ARGUMENT dictionaryId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntryLookup() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsEntryLookup(), supportsVisibleFederation() are true.
MethodgetEntryQuerySession
Description

Gets the OsidSession used to query dictionary entries.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.dictionary.EntryQuerySessionan EntryQuerySession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntryQuery() is false
ComplianceoptionalThis method must be implemented if supportsEntryQuery() is true.
MethodgetEntryQuerySessionForDictionary
Description

Gets the OsidSession used to query dictionary entries for the specified Dictionary .

Parametersosid.id.IddictionaryIdthe Id of the Dictionary to use
osid.proxy.Proxyproxya proxy
Returnosid.dictionary.EntryQuerySessionan EntryQuerySession
ErrorsNOT_FOUNDno Dictionary found by the given Id
NULL_ARGUMENT dictionaryId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntryQuery() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsEntryQuery(), supportsVisibleFederation() are true.
MethodgetEntrySearchSession
Description

Gets the OsidSession used to search among dictionary entries.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.dictionary.EntrySearchSessionan EntrySearchSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntrySearch() is false
ComplianceoptionalThis method must be implemented if supportsEntrySearch() is true.
MethodgetEntrySearchSessionForDictionary
Description

Gets the OsidSession used to search among dictionary entries for the specified Dictionary .

Parametersosid.id.IddictionaryIdthe Id of the Dictionary to use
osid.proxy.Proxyproxya proxy
Returnosid.dictionary.EntrySearchSessionan EntrySearchSession
ErrorsNOT_FOUNDno Dictionary found by the given Id
NULL_ARGUMENT dictionaryId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntrySearch() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsEntrySearch(), supportsVisibleFederation() are true.
MethodgetEntryAdminSession
Description

Gets the OsidSession used to administer dictionary entries.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.dictionary.EntryAdminSessionan EntryAdminSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntryAdmin() is false
ComplianceoptionalThis method must be implemented if supportsEntryAdmin() is true.
MethodgetEntryAdminSessionForDictionary
Description

Gets the OsidSession used to administer dictionary entries for the specified Dictionary .

Parametersosid.id.IddictionaryIdthe Id of the Dictionary to use
osid.proxy.Proxyproxya proxy
Returnosid.dictionary.EntryAdminSessionan EntryAdminSession
ErrorsNOT_FOUNDno Dictionary found by the given Id
NULL_ARGUMENT dictionaryId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntryAdmin() os supportsVisibleFederration() is false
ComplianceoptionalThis method must be implemented if supportsEntryAdmin(), supportsVisibleFederation() are true.
MethodgetEntryNotificationSession
Description

Gets an EntryNotificationSession which is responsible for subscribing to entry changes within a default Dictionary.

Parametersosid.dictionary.EntryReceiverentryReceiverthe notification callback
osid.proxy.Proxyproxya proxy
Returnosid.dictionary.EntryNotificationSessionan EntryNotificationSession
ErrorsNULL_ARGUMENT entryReceiver or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntryNotification() is false
ComplianceoptionalThis method must be implemented if supportsEntryNotification() is true.
MethodgetEntryNotificationSessionForDictionary
Description

Gets an EntryNotificationSession which is responsible for subscribing to entry changes for a specified Dictionary.

Parametersosid.dictionary.EntryReceiverentryReceiverthe notification callback
osid.id.IddictionaryIdthe Id of the Dictionary to use
osid.proxy.Proxyproxya proxy
Returnosid.dictionary.EntryNotificationSessionan EntryNotificationSession
ErrorsNOT_FOUNDno Dictionary found by the given Id
NULL_ARGUMENT entryReceiver, dictionaryId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntryNotification() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsEntryNotification() and supportsVisibleFederation() are true.
MethodgetEntryDictionarySession
Description

Gets the session for retrieving entry to dictionary mappings.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.dictionary.EntryDictionarySessiona EntryDictionarySession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntryDictionary() is false
ComplianceoptionalThis method must be implemented if supportsEntryDictionary() is true.
MethodgetEntryDictionaryAssignmentSession
Description

Gets the session for assigning entry to dictionary mappings.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.dictionary.EntryDictionaryAssignmentSessiona EntryDictionaryAssignmentSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntryDictionaryAssignment() is false
ComplianceoptionalThis method must be implemented if supportsEntryDictionaryAssignment() is true.
MethodgetEntrySmartDictionarySession
Description

Gets the session for managing dynamic entry dictionarys.

Parametersosid.id.IddictionaryIdthe Id of the dictionary
osid.proxy.Proxyproxya proxy
Returnosid.dictionary.EntrySmartDictionarySessiona EntrySmartDictionarySession
ErrorsNOT_FOUND dictionaryId not found
NULL_ARGUMENT dictionaryId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntrySmartDictionary() is false
ComplianceoptionalThis method must be implemented if supportsEntrySmartDictionary() is true.
MethodgetDictionaryLookupSession
Description

Gets the OsidSession used to lookup dictionaries.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.dictionary.DictionaryLookupSessiona DictionaryLookupSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsDictionaryLookup() is false
ComplianceoptionalThis method must be implemented if supportsDictionaryLookup() and supportsVisibleFederation() are true.
MethodgetDictionaryQuerySession
Description

Gets the OsidSession used to query dictionaries.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.dictionary.DictionaryQuerySessiona DictionaryQuerySession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsDictionaryQuery() is false
ComplianceoptionalThis method must be implemented if supportsDictionaryQuery() and supportsVisibleFederation() are true.
MethodgetDictionarySearchSession
Description

Gets the OsidSession used to search for dictionaries.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.dictionary.DictionarySearchSessiona DictionarySearchSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsDictionarySearch() is false
ComplianceoptionalThis method must be implemented if supportsDictionarySearch() and supportsVisibleFederation() are true.
MethodgetDictionaryAdminSession
Description

Gets the OsidSession used to administer dictionaries.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.dictionary.DictionaryAdminSessiona DictionaryAdminSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsDictionaryAdmin() is false
ComplianceoptionalThis method must be implemented if supportsDictionaryAdmin() is true.
MethodgetDictionaryNotificationSession
Description

Gets the OsidSession used to subscribe to notifications of new, updated or deleted dictionaries dictionaries.

Parametersosid.dictionary.DictionaryReceiverdictionaryReceiverthe notification callback
osid.proxy.Proxyproxya proxy
Returnosid.dictionary.DictionaryNotificationSessiona DictionaryNotificationSession
ErrorsNULL_ARGUMENT dictionaryReceiver or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsDictionaryNotification() is false
ComplianceoptionalThis method must be implemented if supportsDictionaryNotification() is true.
MethodgetDictionaryHierarchySession
Description

Gets the hierarchy traversing the Dictionary hierarchy. The parent includes all dictionary elements of its children.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.dictionary.DictionaryHierarchySessiona DictionaryHierarchySession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILED unable to complete request
UNIMPLEMENTED supportsDictionaryHierarchy() is false
ComplianceoptionalThis method must be implemented if supportsDictionaryHierarchyTraversal() is true.
MethodgetDictionaryHierarchyDesignSession
Description

Gets the hierarchy managing the Dictionary hierarchy. The parent includes all dictionary elements of its children.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.dictionary.DictionaryHierarchyDesignSessiona DictionaryHierarchyDesignSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILED unable to complete request
UNIMPLEMENTED supportsDictionaryHierarchyDesign() is false
ComplianceoptionalThis method must be implemented if supportsDictionaryHierarchyDesign() is true.
MethodgetDictionaryBatchProxyManager
Description

Gets a DictionaryBatchProxyManager.

Returnosid.dictionary.batch.DictionaryBatchProxyManagera DictionaryBatchProxyManager
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsDictionaryBatch() is false
ComplianceoptionalThis method must be implemented.