Docs For Class JavaPOCAgentManager

Class JavaPOCAgentManager

Description

AgentManager handles creating, deleting, and getting Agents and Groups.

Group is a subclass of Agent. Groups contain members. Group members are Agents or other Groups.

All implementations of OsidManager (manager) provide methods for accessing and manipulating the various objects defined in the OSID package. A manager defines an implementation of an OSID. All other OSID objects come either directly or indirectly from the manager. New instances of the OSID objects are created either directly or indirectly by the manager. Because the OSID objects are defined using interfaces, create methods must be used instead of the new operator to create instances of the OSID objects. Create methods are used both to instantiate and persist OSID objects. Using the OsidManager class to define an OSID's implementation allows the application to change OSID implementations by changing the OsidManager package name used to load an implementation. Applications developed using managers permit OSID implementation substitution without changing the application source code. As with all managers, use the OsidLoader to load an implementation of this interface.

OSID Version: 2.0

version: $Id: JavaPOCAgentManager.class.php,v 1.7 2007/09/04 20:25:36 adamfranco Exp $
license: GNU General Public License (GPL)
copyright: Copyright © 2005, Middlebury College

Located in /harmoni/core/oki2/agent/JavaPOCAgentManager.class.php (line 43)

OsidManager
   |
   --AgentManager
      |
      --JavaPOCAgentManager

Variable Summary

mixed $_javaClass

mixed $_javaClassName

Method Summary

JavaPOCAgentManager JavaPOCAgentManager (mixed $className)

object Agent createAgent (string $displayName, object Type $agentType, mixed $properties, object Properties $properties )

object Group createGroup (string $displayName, object Type $groupType, string $description, mixed $properties, object Properties $properties )

void deleteAgent (mixed $id, object Id $id )

void deleteGroup (mixed $id, object Id $id )

object Agent getAgent (mixed $id, object Id $id )

object AgentIterator getAgents ()

object AgentIterator getAgentsBySearch (object mixed $searchCriteria, mixed $agentSearchType, object Type $agentSearchType )

object AgentIterator getAgentsByType (mixed $agentType, object Type $agentType )

object TypeIterator getAgentSearchTypes ()

object TypeIterator getAgentTypes ()

object Group getGroup (mixed $id, object Id $id )

object AgentIterator getGroups ()

object AgentIterator getGroupsBySearch (object mixed $searchCriteria, mixed $groupSearchType, object Type $groupSearchType )

object AgentIterator getGroupsByType (mixed $groupType, object Type $groupType )

object TypeIterator getGroupSearchTypes ()

object TypeIterator getGroupTypes ()

object TypeIterator getPropertyTypes ()

Variables

mixed $_javaClass (line 46)

mixed $_javaClassName (line 45)

Methods

Constructor JavaPOCAgentManager (line 48)

JavaPOCAgentManager JavaPOCAgentManager (mixed $className)

createAgent (line 84)

Create an Agent with the display name, Type, and Properties specified.

All are immutable.

access: public
throws: object AgentException An exception with one of the following messages defined in org.osid.agent.AgentException may be thrown: OPERATION_FAILED, PERMISSION_DENIED, CONFIGURATION_ERROR, UNIMPLEMENTED, NULL_ARGUMENT, UNKNOWN_TYPE

object Agent createAgent (string $displayName, object Type $agentType, mixed $properties, object Properties $properties )

string $displayName
object Type $agentType
object Properties $properties

Redefinition of:

AgentManager::createAgent(): Create an Agent with the display name, Type, and Properties specified.

createGroup (line 267)

Create a Group with the display name, Type, description, and Properties specified. All but description are immutable.

access: public
throws: object AgentException An exception with one of the following messages defined in org.osid.agent.AgentException may be thrown: OPERATION_FAILED, PERMISSION_DENIED, CONFIGURATION_ERROR, UNIMPLEMENTED, NULL_ARGUMENT, UNKNOWN_TYPE

object Group createGroup (string $displayName, object Type $groupType, string $description, mixed $properties, object Properties $properties )

string $displayName
object Type $groupType
string $description
object Properties $properties

Redefinition of:

AgentManager::createGroup(): Create a Group with the display name, Type, description, and Properties specified. All but description are immutable.

deleteAgent (line 113)

Delete the Agent with the specified unique Id.

access: public
throws: object AgentException An exception with one of the following messages defined in org.osid.agent.AgentException may be thrown: OPERATION_FAILED, PERMISSION_DENIED, CONFIGURATION_ERROR, UNIMPLEMENTED, NULL_ARGUMENT, UNKNOWN_ID

void deleteAgent (mixed $id, object Id $id )

object Id $id

Redefinition of:

AgentManager::deleteAgent(): Delete the Agent with the specified unique Id.

deleteGroup (line 296)

Delete the Group with the specified unique Id.

access: public
throws: object AgentException An exception with one of the following messages defined in org.osid.agent.AgentException may be thrown: OPERATION_FAILED, PERMISSION_DENIED, CONFIGURATION_ERROR, UNIMPLEMENTED, NULL_ARGUMENT, UNKNOWN_ID

void deleteGroup (mixed $id, object Id $id )

object Id $id

Redefinition of:

AgentManager::deleteGroup(): Delete the Group with the specified unique Id.

getAgent (line 144)

Get the Agent with the specified unique Id. Getting an Agent by name is not supported since names are not guaranteed to be unique.

access: public
throws: object AgentException An exception with one of the following messages defined in org.osid.agent.AgentException may be thrown: OPERATION_FAILED, PERMISSION_DENIED, CONFIGURATION_ERROR, UNIMPLEMENTED, NULL_ARGUMENT, UNKNOWN_ID

object Agent getAgent (mixed $id, object Id $id )

object Id $id

Redefinition of:

AgentManager::getAgent(): Get the Agent with the specified unique Id. Getting an Agent by name is not supported since names are not guaranteed to be unique.

getAgents (line 173)

Get all the Agents. The returned iterator provides access to the Agents one at a time. Iterators have a method hasNextAgent() which returns

true

if there is an Agent available and a method nextAgent() which returns the next Agent.

access: public
throws: object AgentException An exception with one of the following messages defined in org.osid.agent.AgentException may be thrown: OPERATION_FAILED, PERMISSION_DENIED, CONFIGURATION_ERROR, UNIMPLEMENTED

object AgentIterator getAgents ()

Redefinition of:

AgentManager::getAgents()

Get all the Agents. The returned iterator provides access to the Agents one at a time. Iterators have a method hasNextAgent() which returns

true

if there is an Agent available and a method nextAgent() which returns the next Agent.

getAgentsBySearch (line 509)

Get all the Agents with the specified search criteria and search Type.

access: public
throws: object AgentException An exception with one of the following messages defined in org.osid.agent.AgentException may be thrown: OPERATION_FAILED, PERMISSION_DENIED, CONFIGURATION_ERROR, UNIMPLEMENTED, NULL_ARGUMENT, UNKNOWN_TYPE

object AgentIterator getAgentsBySearch (object mixed $searchCriteria, mixed $agentSearchType, object Type $agentSearchType )

object mixed $searchCriteria: (original type: java.io.Serializable)
object Type $agentSearchType

Redefinition of:

AgentManager::getAgentsBySearch(): Get all the Agents with the specified search criteria and search Type.

getAgentsByType (line 417)

Get all the Agents of the specified Type.

access: public
throws: object AgentException An exception with one of the following messages defined in org.osid.agent.AgentException may be thrown: OPERATION_FAILED, PERMISSION_DENIED, CONFIGURATION_ERROR, UNIMPLEMENTED, NULL_ARGUMENT, UNKNOWN_TYPE

object AgentIterator getAgentsByType (mixed $agentType, object Type $agentType )

object Type $agentType

Redefinition of:

AgentManager::getAgentsByType(): Get all the Agents of the specified Type.

getAgentSearchTypes (line 477)

Get all the agent search Types supported by this implementation.

access: public
throws: object AgentException An exception with one of the following messages defined in org.osid.agent.AgentException may be thrown: OPERATION_FAILED, PERMISSION_DENIED, CONFIGURATION_ERROR, UNIMPLEMENTED, NULL_ARGUMENT, UNKNOWN_TYPE

object TypeIterator getAgentSearchTypes ()

Redefinition of:

AgentManager::getAgentSearchTypes(): Get all the agent search Types supported by this implementation.

getAgentTypes (line 202)

Get all the agent Types. The returned iterator provides access to the agent Types from this implementation one at a time. Iterators have a method hasNext() which returns true if there is an agent Type available and a method next() which returns the next agent Type.

access: public
throws: object AgentException An exception with one of the following messages defined in org.osid.agent.AgentException may be thrown: OPERATION_FAILED, PERMISSION_DENIED, CONFIGURATION_ERROR, UNIMPLEMENTED

object TypeIterator getAgentTypes ()

Redefinition of:

AgentManager::getAgentTypes(): Get all the agent Types. The returned iterator provides access to the agent Types from this implementation one at a time. Iterators have a method hasNext() which returns true if there is an agent Type available and a method next() which returns the next agent Type.

getGroup (line 327)

Gets the Group with the specified unique Id. Getting a Group by name is not supported since names are not guaranteed to be unique.

access: public
throws: object AgentException An exception with one of the following messages defined in org.osid.agent.AgentException may be thrown: OPERATION_FAILED, PERMISSION_DENIED, CONFIGURATION_ERROR, UNIMPLEMENTED, NULL_ARGUMENT, UNKNOWN_ID

object Group getGroup (mixed $id, object Id $id )

object Id $id

Redefinition of:

AgentManager::getGroup(): Gets the Group with the specified unique Id. Getting a Group by name is not supported since names are not guaranteed to be unique.

getGroups (line 357)

Get all the Groups. Note since Groups subclass Agents, we are returning

an AgentIterator and there is no GroupIterator. the returned iterator provides access to the Groups one at a time. Iterators have a method hasNextAgent() which returns true if there is a Group available and a method nextAgent() which returns the next Group.

access: public
throws: object AgentException An exception with one of the following messages defined in org.osid.agent.AgentException may be thrown: OPERATION_FAILED, PERMISSION_DENIED, CONFIGURATION_ERROR, UNIMPLEMENTED

object AgentIterator getGroups ()

Redefinition of:

AgentManager::getGroups(): Get all the Groups. Note since Groups subclass Agents, we are returning

getGroupsBySearch (line 570)

Get all the groups with the specified search criteria and search Type.

access: public
throws: object AgentException An exception with one of the following messages defined in org.osid.agent.AgentException may be thrown: OPERATION_FAILED, PERMISSION_DENIED, CONFIGURATION_ERROR, UNIMPLEMENTED, NULL_ARGUMENT, UNKNOWN_TYPE

object AgentIterator getGroupsBySearch (object mixed $searchCriteria, mixed $groupSearchType, object Type $groupSearchType )

object mixed $searchCriteria: (original type: java.io.Serializable)
object Type $groupSearchType

Redefinition of:

AgentManager::getGroupsBySearch(): Get all the groups with the specified search criteria and search Type.

getGroupsByType (line 448)

Get all the Groups of the specified Type.

access: public
throws: object AgentException An exception with one of the following messages defined in org.osid.agent.AgentException may be thrown: OPERATION_FAILED, PERMISSION_DENIED, CONFIGURATION_ERROR, UNIMPLEMENTED, NULL_ARGUMENT, UNKNOWN_TYPE

object AgentIterator getGroupsByType (mixed $groupType, object Type $groupType )

object Type $groupType

Redefinition of:

AgentManager::getGroupsByType(): Get all the Groups of the specified Type.

getGroupSearchTypes (line 538)

Get all the group search types supported by this implementation.

access: public
throws: object AgentException An exception with one of the following messages defined in org.osid.agent.AgentException may be thrown: OPERATION_FAILED, PERMISSION_DENIED, CONFIGURATION_ERROR, UNIMPLEMENTED, NULL_ARGUMENT, UNKNOWN_TYPE

object TypeIterator getGroupSearchTypes ()

Redefinition of:

AgentManager::getGroupSearchTypes(): Get all the group search types supported by this implementation.

getGroupTypes (line 386)

Get all the group Types. The returned iterator provides access to the group Types from this implementation one at a time. Iterators have a method hasNext() which returns true if there is a group Type available and a method next() which returns the next group Type.

access: public
throws: object AgentException An exception with one of the following messages defined in org.osid.agent.AgentException may be thrown: OPERATION_FAILED, PERMISSION_DENIED, CONFIGURATION_ERROR, UNIMPLEMENTED

object TypeIterator getGroupTypes ()

Redefinition of:

AgentManager::getGroupTypes(): Get all the group Types. The returned iterator provides access to the group Types from this implementation one at a time. Iterators have a method hasNext() which returns true if there is a group Type available and a method next() which returns the next group Type.

getPropertyTypes (line 232)

Get all the property Types. The returned iterator provides access to

the property Types from this implementation one at a time. Iterators have a method hasNext() which returns true if there is another property Type available and a method next() which returns the next property Type.

access: public
throws: object AgentException An exception with one of the following messages defined in org.osid.agent.AgentException may be thrown: OPERATION_FAILED, PERMISSION_DENIED, CONFIGURATION_ERROR, UNIMPLEMENTED

object TypeIterator getPropertyTypes ()

Redefinition of:

AgentManager::getPropertyTypes(): Get all the property Types. The returned iterator provides access to

Inherited Methods

Inherited From AgentManager

AgentManager::createAgent()
AgentManager::createGroup()
AgentManager::deleteAgent()
AgentManager::deleteGroup()
AgentManager::getAgent()
AgentManager::getAgents()
AgentManager::getAgentsBySearch()
AgentManager::getAgentsByType()
AgentManager::getAgentSearchTypes()
AgentManager::getAgentTypes()
AgentManager::getGroup()
AgentManager::getGroups()
AgentManager::getGroupsBySearch()
AgentManager::getGroupsByType()
AgentManager::getGroupSearchTypes()
AgentManager::getGroupTypes()
AgentManager::getPropertyTypes()

Inherited From OsidManager

OsidManager::assignConfiguration()
OsidManager::assignOsidContext()
OsidManager::getOsidContext()
OsidManager::osidVersion_2_0()

Documentation generated on Wed, 19 Sep 2007 10:24:45 -0400 by phpDocumentor 1.3.0RC3