Scoping Configurations

Here’s how to scope a configuration:

  1. Set the scope in the configuration interface.

  2. Enable the configuration for scoped retrieval by creating a configuration bean declaration.

Step 1: Setting the Configuration Scope

Use the @ExtendedObjectClassDefinition annotation to specify the configuration’s scope. The scope you choose must match how the configuration object is retrieved through the configuration provider. Pass one of these valid scope options to @ExtendedObjectClassDefinition:

Scope.SYSTEM: for system scope Scope.COMPANY: for virtual instance scope Scope.GROUP: for site scope Scope.PORTLET_INSTANCE: for the portlet instance scope

Here is an example:

    category = "dynamic-data-mapping",
    scope = ExtendedObjectClassDefinition.Scope.GROUP
    id = "
    localization = "content/Language", 
    name = "ddm-form-web-configuration-name"

public interface DDMFormWebConfiguration {

Step 2: Enabling the Configuration for Scoped Retrieval

To create a configuration bean declaration:

  1. Register the configuration class by implementing ConfigurationBeanDeclaration.

    public class JournalGroupServiceConfigurationBeanDeclaration
        implements ConfigurationBeanDeclaration {
  2. This class has one method that returns the class of the configuration interface you created. It enables the system to keep track of configuration changes as they happen, making requests for the configuration very fast.

    public Class<?> getConfigurationBeanClass() {
        return JournalGroupServiceConfiguration.class;

That’s all there is to it. Now the configuration is scoped and supports scoped retrieval via ConfigurationProvider. See the next section for details on retrieval.

« Categorizing the ConfigurationReading Scoped Configuration Values »
¿Fue útil este artículo?
Usuarios a los que les pareció útil: 0 de 2