1.3.2. Parameters

Value-param

See example of the below value-param:


<component>
    <key>org.exoplatform.portal.config.UserACL</key>
    <type>org.exoplatform.portal.config.UserACL</type>
    <init-params>
        ...
        <value-param>
            <name>access.control.workspace</name>
            <description>groups with memberships that have the right to access the User Control Workspace</description>
            <value>*:/platform/administrators,*:/organization/management/executive-board</value>
        </value-param>
        ...
    </init-params>
</component>

The UserACL class accesses to the value-param in its constructor.

package org.exoplatform.portal.config;

public class UserACL {
  public UserACL(InitParams params) {
    UserACLMetaData md = new UserACLMetaData();
    ValueParam accessControlWorkspaceParam = params.getValueParam("access.control.workspace");
    if(accessControlWorkspaceParam != null) md.setAccessControlWorkspace(accessControlWorkspaceParam.getValue());
...

Properties-param

Properties are name-value pairs. Both the name and the value are Java Strings.

Here is an example of Hibernate configuration:


<component>
    <key>org.exoplatform.services.database.HibernateService</key>
    <type>org.exoplatform.services.database.impl.HibernateServiceImpl</type>
    <init-params>
        <properties-param>
            <name>hibernate.properties</name>
            <description>Default Hibernate Service</description>
            <property name="hibernate.show_sql" value="false"/>
            <property name="hibernate.cglib.use_reflection_optimizer" value="true"/>
            <property name="hibernate.connection.url" value="jdbc:hsqldb:file:../temp/data/exodb"/>
            <property name="hibernate.connection.driver_class" value="org.hsqldb.jdbcDriver"/>
            ...
        </properties-param>
    </init-params>
</component>

In org.exoplatform.services.database.impl.HibernateServiceImpl, you will find that the name "hibernate.properties" of the properties-param is used to access the properties.

package org.exoplatform.services.database.impl;


public class HibernateServiceImpl implements HibernateService, ComponentRequestLifecycle {
  public HibernateServiceImpl(InitParams initParams, CacheService cacheService) {
    PropertiesParam param = initParams.getPropertiesParam("hibernate.properties");
...
}

Object-param

Let's have a look at the configuration of the LDAP service. You do not need to know LDAP, because only parameters are discussed here.


<component>
    <key>org.exoplatform.services.ldap.LDAPService</key>
    <type>org.exoplatform.services.ldap.impl.LDAPServiceImpl</type>
    <init-params>
        <object-param>
            <name>ldap.config</name>
            <description>Default ldap config</description>
            <object type="org.exoplatform.services.ldap.impl.LDAPConnectionConfig">
                <field  name="providerURL"><string>ldaps://10.0.0.3:636</string></field>
                <field  name="rootdn"><string>CN=Administrator,CN=Users,DC=exoplatform,DC=org</string></field>
                <field  name="password"><string>exo</string></field>
                <field  name="version"><string>3</string></field>
                <field  name="minConnection"><int>5</int></field>
                <field  name="maxConnection"><int>10</int></field>
                <field  name="referralMode"><string>ignore</string></field>
                <field  name="serverName"><string>active.directory</string></field>
            </object>
        </object-param>
    </init-params>
</component>

You see here an object-param is being used to pass the parameters inside an object (actually a java bean). It consists of a name, a description and exactly one object. The object defines the type and a number of fields.

Here you see how the service accesses the object:

package org.exoplatform.services.ldap.impl;


public class LDAPServiceImpl implements LDAPService {
...
  public LDAPServiceImpl(InitParams params) {
    LDAPConnectionConfig config = (LDAPConnectionConfig) params.getObjectParam("ldap.config")
                                                               .getObject();
...

The passed object is LDAPConnectionConfig which is a classic java bean. It contains all fields and also the appropriate getters and setters (not listed here). You also can provide default values. The container creates a new instance of your bean and calls all setters whose values are configured in the configuration file.

package org.exoplatform.services.ldap.impl;


public class LDAPConnectionConfig {
  private String providerURL        = "ldap://127.0.0.1:389";
  private String rootdn;
  private String password;                                  
  private String version;                                   
  private String authenticationType = "simple";
  private String serverName         = "default";
  private int    minConnection;
  private int    maxConnection;
  private String referralMode       = "follow";
...

You see that the types (String, int) of the fields in the configuration correspond with the bean. Take a short glance at the kernel_1_0.xsd file to discover more simple types: string, int, long, boolean, date, double.

Also, have a look at a test resource of the types: object.xml.

Collection

You also can use Java collections to configure your service. See this file for an example. This file defines a default user organization (users, groups, memberships/roles) of your portal. They use component-plugins which are explained later. You will see that object-param are used again.

There are two collections:

  • The first collection is an ArrayList. This ArrayList contains only one value, but there could be more. The only value is an object which defines the field of the NewUserConfig$JoinGroup bean.

  • The second collection is a HashSet that is a set of strings.


<component-plugin>
    <name>new.user.event.listener</name>
    <set-method>addListenerPlugin</set-method>
    <type>org.exoplatform.services.organization.impl.NewUserEventListener</type>
    <description>this listener assign group and membership to a new created user</description>
    <init-params>
        <object-param>
            <name>configuration</name>
            <description>description</description>
            <object type="org.exoplatform.services.organization.impl.NewUserConfig">
                <field  name="group">
                <collection type="java.util.ArrayList">
                <value>
                <object type="org.exoplatform.services.organization.impl.NewUserConfig$JoinGroup">
                <field  name="groupId"><string>/platform/users</string></field>
                <field  name="membership"><string>member</string></field>
                </object>
                </value>               
                </collection>
                </field>
                <field  name="ignoredUser">
                    <collection type="java.util.HashSet">
                    <value><string>root</string></value>
                    <value><string>john</string></value>
                    <value><string>marry</string></value>
                    <value><string>demo</string></value>
                    <value><string>james</string></value>
                    </collection>
                </field>
            </object>
        </object-param>
    </init-params>
</component-plugin>

Let's look at the org.exoplatform.services.organization.impl.NewUserConfig bean:

public class NewUserConfig {

  private List    role;
  private List    group;
  private HashSet ignoredUser;
  ...
  public void setIgnoredUser(String user) {
    ignoredUser.add(user);
  ...
  static public class JoinGroup {
    public String  groupId;
    public String  membership;
  ...
}

You see the values of the HashSet are set one by one by the container, and it's the responsibility of the bean to add these values to its HashSet.

The JoinGroup object is just an inner class and implements a bean of its own. It can be accessed like any other inner class using NewUserConfig.JoinGroup.

Copyright ©. All rights reserved. eXo Platform SAS
blog comments powered byDisqus