griffon.core.mvc

Interface MVCGroupManager

All Superinterfaces:

MVCHandler

All Known Implementing Classes:

AbstractMVCGroupManager, DefaultMVCGroupManager, GroovyAwareMVCGroupManager

public interface MVCGroupManager
extends MVCHandler

Manages the configuration and instantiation of MVC groups.

Since:

2.0.0

Author:

Andres Almiray

Method Summary

Modifier and Type	Method and Description
void	addConfiguration(MVCGroupConfiguration configuration)
MVCGroupConfiguration	cloneMVCGroupConfiguration(java.lang.String mvcType, java.util.Map<java.lang.String,java.lang.Object> config) Clones an existing MVCGroupConfiguration, optionally overriding additional config values.
MVCGroupConfiguration	findConfiguration(java.lang.String mvcType)
<C extends GriffonController> C	findController(java.lang.String name, java.lang.Class<C> type) Finds a named controller.
MVCGroup	findGroup(java.lang.String mvcId)
<M extends GriffonModel> M	findModel(java.lang.String name, java.lang.Class<M> type) Finds a named model.
<V extends GriffonView> V	findView(java.lang.String name, java.lang.Class<V> type) Finds a named view.
GriffonApplication	getApplication()
MVCGroup	getAt(java.lang.String mvcId)
java.util.Map<java.lang.String,MVCGroupConfiguration>	getConfigurations()
<C extends GriffonController> C	getController(java.lang.String name, java.lang.Class<C> type) Finds a named controller.
java.util.Map<java.lang.String,? extends GriffonController>	getControllers() Returns all currently available controller instances, keyed by group name.
java.util.Map<java.lang.String,MVCGroup>	getGroups()
<M extends GriffonModel> M	getModel(java.lang.String name, java.lang.Class<M> type) Finds a named model.
java.util.Map<java.lang.String,? extends GriffonModel>	getModels() Returns all currently available model instances, keyed by group name.
<V extends GriffonView> V	getView(java.lang.String name, java.lang.Class<V> type) Finds a named view.
java.util.Map<java.lang.String,? extends GriffonView>	getViews() Returns all currently available view instances, keyed by group name.
void	initialize(java.util.Map<java.lang.String,MVCGroupConfiguration> configurations) Initializes this manager with the group configurations provided by the application and addons.
Context	newContext(MVCGroup parentGroup)
MVCGroup	newMVCGroup(MVCGroupConfiguration configuration, java.lang.String mvcId, java.util.Map<java.lang.String,java.lang.Object> members, MVCGroup parentGroup) Creates a new MVCGroup instance.
MVCGroupConfiguration	newMVCGroupConfiguration(java.lang.String mvcType, java.util.Map<java.lang.String,java.lang.String> members, java.util.Map<java.lang.String,java.lang.Object> config) Creates an MVCConfiguration instance with the given arguments.
void	removeConfiguration(MVCGroupConfiguration configuration)
void	removeConfiguration(java.lang.String name)

Methods inherited from interface griffon.core.mvc.MVCHandler

createMVC, createMVC, createMVC, createMVC, createMVC, createMVC, createMVC, createMVC, createMVC, createMVC, createMVC, createMVC, createMVCGroup, createMVCGroup, createMVCGroup, createMVCGroup, createMVCGroup, createMVCGroup, createMVCGroup, createMVCGroup, createMVCGroup, createMVCGroup, createMVCGroup, createMVCGroup, destroyMVCGroup, withMVC, withMVC, withMVC, withMVC, withMVC, withMVC, withMVC, withMVC, withMVC, withMVC, withMVC, withMVC, withMVCGroup, withMVCGroup, withMVCGroup, withMVCGroup, withMVCGroup, withMVCGroup, withMVCGroup, withMVCGroup, withMVCGroup, withMVCGroup, withMVCGroup, withMVCGroup

Method Detail

newMVCGroupConfiguration

@Nonnull
MVCGroupConfiguration newMVCGroupConfiguration(@Nonnull
                                                        java.lang.String mvcType,
                                                        @Nonnull
                                                        java.util.Map<java.lang.String,java.lang.String> members,
                                                        @Nonnull
                                                        java.util.Map<java.lang.String,java.lang.Object> config)

Creates an MVCConfiguration instance with the given arguments.

Parameters:

mvcType - the name of the MVC group

members - members of the group

config - additional configuration required by the group

Returns:

a ready-to-use MVCGroupConfiguration instance

cloneMVCGroupConfiguration

@Nonnull
MVCGroupConfiguration cloneMVCGroupConfiguration(@Nonnull
                                                          java.lang.String mvcType,
                                                          @Nonnull
                                                          java.util.Map<java.lang.String,java.lang.Object> config)

Clones an existing MVCGroupConfiguration, optionally overriding additional config values.

Parameters:

mvcType - the name of the configuration to clone

config - additional config parameters to be set on the configuration

Returns:

a ready-to-use MVCGroupConfiguration instance

newMVCGroup

@Nonnull
MVCGroup newMVCGroup(@Nonnull
                              MVCGroupConfiguration configuration,
                              @Nullable
                              java.lang.String mvcId,
                              @Nonnull
                              java.util.Map<java.lang.String,java.lang.Object> members,
                              @Nullable
                              MVCGroup parentGroup)

Creates a new MVCGroup instance.

Parameters:

configuration - the configuration of the group

mvcId - the id to use for the group

members - the instance members of the group

parentGroup - the parent group (if any)

Returns:

a ready-to-use MVCGroup instance

newContext

@Nonnull
Context newContext(@Nullable
                            MVCGroup parentGroup)

initialize

void initialize(@Nonnull
                java.util.Map<java.lang.String,MVCGroupConfiguration> configurations)

Initializes this manager with the group configurations provided by the application and addons.

Parameters:

configurations - available group configurations

addConfiguration

void addConfiguration(@Nonnull
                      MVCGroupConfiguration configuration)

removeConfiguration

void removeConfiguration(@Nonnull
                         MVCGroupConfiguration configuration)

removeConfiguration

void removeConfiguration(@Nonnull
                         java.lang.String name)

getConfigurations

@Nonnull
java.util.Map<java.lang.String,MVCGroupConfiguration> getConfigurations()

getGroups

@Nonnull
java.util.Map<java.lang.String,MVCGroup> getGroups()

findConfiguration

@Nonnull
MVCGroupConfiguration findConfiguration(@Nonnull
                                                 java.lang.String mvcType)

findGroup

@Nullable
MVCGroup findGroup(@Nonnull
                             java.lang.String mvcId)

getAt

@Nullable
MVCGroup getAt(@Nonnull
                         java.lang.String mvcId)

getModels

@Nonnull
java.util.Map<java.lang.String,? extends GriffonModel> getModels()

Returns all currently available model instances, keyed by group name.

Returns:

a Map of all currently instantiated models.

getViews

@Nonnull
java.util.Map<java.lang.String,? extends GriffonView> getViews()

Returns all currently available view instances, keyed by group name.

Returns:

a Map of all currently instantiated views.

getControllers

@Nonnull
java.util.Map<java.lang.String,? extends GriffonController> getControllers()

Returns all currently available controller instances, keyed by group name.

Returns:

a Map of all currently instantiated controllers.

getApplication

GriffonApplication getApplication()

getController

@Nonnull
<C extends GriffonController> C getController(@Nonnull
                                                       java.lang.String name,
                                                       @Nonnull
                                                       java.lang.Class<C> type)
                                                throws ArtifactNotFoundException

Finds a named controller.

Parameters:

name - the name of the group that holds the controller

type - the type of the controller

Returns:

the controller instance if found

Throws:

ArtifactNotFoundException - if the named controller could not be found

Since:

2.1.0

getModel

@Nonnull
<M extends GriffonModel> M getModel(@Nonnull
                                             java.lang.String name,
                                             @Nonnull
                                             java.lang.Class<M> type)
                                      throws ArtifactNotFoundException

Finds a named model.

Parameters:

name - the name of the group that holds the model

type - the type of the model

Returns:

the model instance if found

Throws:

ArtifactNotFoundException - if the named model could not be found

Since:

2.1.0

getView

@Nonnull
<V extends GriffonView> V getView(@Nonnull
                                           java.lang.String name,
                                           @Nonnull
                                           java.lang.Class<V> type)
                                    throws ArtifactNotFoundException

Finds a named view.

Parameters:

name - the name of the group that holds the view

type - the type of the view

Returns:

the view instance if found

Throws:

ArtifactNotFoundException - if the named view could not be found

Since:

2.1.0

findController

@Nullable
<C extends GriffonController> C findController(@Nonnull
                                                         java.lang.String name,
                                                         @Nonnull
                                                         java.lang.Class<C> type)

Finds a named controller.

Parameters:

name - the name of the group that holds the controller

type - the type of the controller

Returns:

the controller instance if found

Since:

2.1.0

findModel

@Nullable
<M extends GriffonModel> M findModel(@Nonnull
                                               java.lang.String name,
                                               @Nonnull
                                               java.lang.Class<M> type)

Finds a named model.

Parameters:

name - the name of the group that holds the model

type - the type of the model

Returns:

the model instance if found

Since:

2.1.0

findView

@Nullable
<V extends GriffonView> V findView(@Nonnull
                                             java.lang.String name,
                                             @Nonnull
                                             java.lang.Class<V> type)

Finds a named view.

Parameters:

name - the name of the group that holds the view

type - the type of the view

Returns:

the view instance if found

Since:

2.1.0