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

The dictionary manager provides access to dictionary sessions and provides interoperability tests for various aspects of this service. 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.

Returnosid.dictionary.EntryRetrievalSessionthe new EntryRetrievalSession
ErrorsOPERATION_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
Returnosid.dictionary.EntryRetrievalSessionan EntryRetrievalSession
ErrorsNOT_FOUNDno Dictionary found by the given Id
NULL_ARGUMENT dictionaryId is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntryRetrieval() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsEntryRetrieval() and supportsVisibleFederation() are true.
MethodgetEntryLookupSession
Description

Gets the OsidSession used to retrieve dictionary entries.

Returnosid.dictionary.EntryLookupSessionan EntryLookupSession
ErrorsOPERATION_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
Returnosid.dictionary.EntryLookupSessionan EntryLookupSession
ErrorsNOT_FOUNDno Dictionary found by the given Id
NULL_ARGUMENT dictionaryId is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntryLookup() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsEntryLookup() and supportsVisibleFederation() are true.
MethodgetEntryQuerySession
Description

Gets the OsidSession used to query dictionary entries.

Returnosid.dictionary.EntryQuerySessionan EntryQuerySession
ErrorsOPERATION_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
Returnosid.dictionary.EntryQuerySessionan EntryQuerySession
ErrorsNOT_FOUNDno Dictionary found by the given Id
NULL_ARGUMENT dictionaryId is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntryQuery() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsEntryQuery() and supportsVisibleFederation() are true.
MethodgetEntrySearchSession
Description

Gets the OsidSession used to search dictionary entries.

Returnosid.dictionary.EntrySearchSessionan EntrySearchSession
ErrorsOPERATION_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 dictionary entries for the specified Dictionary.

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

Gets the OsidSession used to administer dictionary entries.

Returnosid.dictionary.EntryAdminSessionan EntryAdminSession
ErrorsOPERATION_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
Returnosid.dictionary.EntryAdminSessionan EntryAdminSession
ErrorsNOT_FOUNDno Dictionary found by the given Id
NULL_ARGUMENT dictionaryId is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsEntryAdmin() os supportsVisibleFederration() is false
ComplianceoptionalThis method must be implemented if supportsEntryAdmin() and 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
Returnosid.dictionary.EntryNotificationSessionan EntryNotificationSession
ErrorsNULL_ARGUMENT entryReceiver 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
Returnosid.dictionary.EntryNotificationSessionan EntryNotificationSession
ErrorsNOT_FOUNDno Dictionary found by the given Id
NULL_ARGUMENT entryReceiver or dictionaryId 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.

Returnosid.dictionary.EntryDictionarySessiona EntryDictionarySession
ErrorsOPERATION_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.

Returnosid.dictionary.EntryDictionaryAssignmentSessiona EntryDictionaryAssignmentSession
ErrorsOPERATION_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
Returnosid.dictionary.EntrySmartDictionarySessiona EntrySmartDictionarySession
ErrorsNOT_FOUND dictionaryId not found
NULL_ARGUMENT dictionaryId 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.

Returnosid.dictionary.DictionaryLookupSessiona DictionaryLookupSession
ErrorsOPERATION_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.

Returnosid.dictionary.DictionaryQuerySessiona DictionaryQuerySession
ErrorsOPERATION_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 dictionaries.

Returnosid.dictionary.DictionarySearchSessiona DictionarySearchSession
ErrorsOPERATION_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

Returnosid.dictionary.DictionaryAdminSessiona DictionaryAdminSession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsDictionaryAdmin() is false
ComplianceoptionalThis method must be implemented if supportsDictionaryAdmin() is true.
MethodgetDictionaryNotificationSession
Description

Gets the OsidSession used to receive notifications of dictionary changes.

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

Gets hierarchy service for traversing the Dictionary hierarchy. A parent includes all the dictionary entries of its children.

Returnosid.dictionary.DictionaryHierarchySessiona Dictionary HierarchySession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsDictionaryHierarchyTraversal() is false
ComplianceoptionalThis method must be implemented.
MethodgetDictionaryHierarchyDesignSession
Description

Gets hierarchy service for structuring Dictionary objects.

Returnosid.dictionary.DictionaryHierarchyDesignSessiona DictionaryHierarchyDesignSession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsDictionaryHierarchyDesign() is false
ComplianceoptionalThis method must be implemented.
MethodgetDictionaryBatchManager
Description

Gets a DictionaryBatchManager.

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