org.eclipse.higgins.idas.api
Interface IContextFactory

All Superinterfaces:

org.eclipse.higgins.configuration.api.IConfigurableComponent

public interface IContextFactory

extends org.eclipse.higgins.configuration.api.IConfigurableComponent

As defined at http://spwiki.editme.com/ContextProvider#ContextFactory, This interface is implemented by IdAS context providers so that their IContext instances may be instantiated.

TODO (Arch)(Doc): Talk about what's required to make this work -- how factories are registered and referenced in the Higgins system.

TODO (Doc): Finish commenting methods.

Method Summary

IContext	createContext(IContextId contextID) Using a context ID, creates an instance of IContext and returns it.
Iterator	getContexts(String filter)
String	getName()
String	getPolicy() Returns the policy in effect for this Context Factory.
void	setPolicy(String policy) Sets the policy for for this Context Factory.

Methods inherited from interface org.eclipse.higgins.configuration.api.IConfigurableComponent

configure

Method Detail

getName

public String getName()
               throws IdASException

Throws:

IdASException

getContexts

public Iterator getContexts(String filter)
                     throws IdASException

Parameters:

filter - Format TBD

Returns:

An Iterator of URIs. The set of Context References of Contexts which have been created by this Context Factory

Throws:

IdASException

createContext

public IContext createContext(IContextId contextID)
                       throws IdASException

Using a context ID, creates an instance of IContext and returns it.

Parameters:

contextID - context ID specifying the Context to create.

Returns:

An IContext instance appropriate for the context ID.

Throws:

IdASException

getPolicy

public String getPolicy()
                 throws IdASException

Returns the policy in effect for this Context Factory.

Returns:

Format is WS-Policy / WS-SecurityPolicy

Throws:

IdASException - TODO (Arch)(Doc): Describe format in more detail. Give examples.

setPolicy

public void setPolicy(String policy)
               throws IdASException

Sets the policy for for this Context Factory.

Parameters:

policy - Format is WS-Policy / WS-SecurityPolicy

Throws:

IdASException - TODO (Arch)(Doc): Describe format in more detail. Give examples.