Sub-Component Evaluations

This tutorial explores Evaluations and introduces Evaluators, demonstrating how they are defined and used.

This tutorial assumes you have completed the previous two tutorials. This tutorial also assumes you have downloaded and installed the Spring Framework, and have access to the library files included with the distribution.

This tutorial creates a module that conditionally renders the Site Members component on the site dashboard. If the site has a certain name the Site Members component will not be rendered.

Load the file config/alfresco/site-data/extensions/extension-modules.xml into the Eclipse editor and add the following module definition:

 
<module>
  <id>Module  (Conditionally Hide Site Members)</id>
    <components>
       <component>
          <region-id>component-1-1</region-id>
          <source-id>site/{site}/dashboard</source-id>
          <scope>page</scope>
          <sub-components>
             <sub-component id="default">
                <evaluations>
                  <evaluation id="HideIfTestSite">
                    <evaluators>
                         <evaluator type="beans.evaluator" ></evaluator>
                     </evaluators>
                      <render>false</render>
                  </evaluation>
                 </evaluations>
               </sub-component>
           </sub-components>
        </component>
    </components>
</module>

Site dashboards are similar to user dashboards in that a new configuration is created from a preset for each new site. This means you need to target your Component using the site parameter.

Attention: The Evaluator type attribute must map to a Spring bean ID defined in the application context. Therefore, you need to create this Evaluator and define it as a Spring bean.

In the Eclipse Package Explorer, right-click on the src folder and create a new package called beans.
In the beans package create a new class called SiteMembersEvaluator.
In the Package Explorer double-click the file SiteMembersEvaluator.java to load it into the Eclipse editor (if not already showing).

Replace the code currently in SiteMembersEvaluator.java, with the following content:


package beans;
import java.util.Map;
import org.springframework.extensions.surf.RequestContext;
import org.springframework.extensions.surf.extensibility.impl.
  DefaultSubComponentEvaluator;

public class SiteMembersEvaluator  extends DefaultSubComponentEvaluator
{
     public boolean evaluate(RequestContext context, Map<String, String> params)
     {
            boolean result;
            String site = context.getUriTokens().get( "site" );
            if (site ==  null )
            {
                site = context.getParameter( "site" );
             }
             result = (site !=  null && site.equals( "test-site" ));
             return result;
     }
}

Attention: At this point your code will be showing compile errors. You will need to link in the required Spring Framework libraries.

The Spring bean compares the site name with the hard-coded string "test-site" (the site URL). The returned result will be true if the site URL matches the hard-coded string, causing the evaluator to be true, thus preventing rendering of the Site Members component.

Right-click on the ShareExtensions folder in the Package Explorer and select Build Path > Configure Build Path.
Click on the Libraries tab.
Click Add External JARS...
Browse to the directory that contains the Spring Framework.
Browse to the libs sub-folder.
Select all JARs.
Click OK.
You will be returned to the ShareExtensions Properties dialog.
Click OK again.
You project will now compile cleanly, and will not show any errors.

In the Package Explorer navigate to your config folder and create the following folder hierarchy:

org/springframework/extensions/surf

In the newly created folder org/springframework/extensions/surf create a new file called spring-surf-extensibility-context.xml
Any file that fits the pattern org/springframework/extensions/surf/*-context* will get processed so that it will be included in the application context.

Ensure this file contains the following:


<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC '-//SPRING//DTD BEAN//EN' 'http://www.springframework.org/dtd/spring-beans.dtd'>
<beans>
	<bean id="beans.evaluator" class="beans.SiteMembersEvaluator" />
</beans>

This configuration file maps the Java class to the Spring Bean ID.

You now need to modify your build script to perform a few more tasks. There is Java code to compile, which requires a compile target to be added. However, you can mostly reuse what you have already. Modify your build.xml file as follows:


<?xml version="1.0" encoding="UTF-8"?>
<project default="deploy-jar">

	<!-- Set these as required -->
	<property name="spring.sdk" value="/home/tony/spring-framework-3.2.2.RELEASE/libs"/>	
	<property name="jar.deploy.dir" value="/home/tony/alfresco-5.2.0/tomcat/webapps/share/WEB-INF/lib"/>	
	<property name="jar.name" value="extension_modules.jar"/>	
		
	<property name="project.dir" value="."/>
	<property name="build.dir" value="${project.dir}/build"/>
	<property name="jar.file" value="${build.dir}/lib/${jar.name}"/>

	<target name="mkdirs">
		<mkdir dir="${build.dir}/dist" />
		<mkdir dir="${build.dir}/lib" />
	</target>
	
	<path id="class.path">
		<dirset dir="${build.dir}" />
		<fileset dir="${spring.sdk}" includes="*.jar"/>
	</path>
	
	<target name="compile">
		<mkdir dir="${build.dir}/classes" />
		<javac classpathref="class.path" srcdir="${project.dir}/src" destdir="${build.dir}/classes" />
	</target>

	<target name="package-jar" depends="compile">
		<jar destfile="${jar.file}" >
			<fileset dir="${build.dir}/classes" excludes="**/custom*,**/*Test*" includes="**/*.class" />
			<fileset dir="${project.dir}/config" includes="**/*" />
		</jar>
	</target>
	
	<target name="deploy-jar" depends="package-jar">
		<copy file="${jar.file}" todir="${jar.deploy.dir}"/> 
	</target>
	
	<target name="clean">
		<delete file="${jar.file}"/>
		<delete file="${jar.deploy.dir}/${jar.name}"/>
	</target>

</project>

Run the build script by right-clicking on the build file and selecting Run As > Ant Build. This will build and deploy the JAR file.
Restart the application server.
Log in to Share and create two new sites: Test Site and Sample Site.
As the new module has not yet been deployed, you will see the Site Members on both sites.
Now go to the Module Deployment WebScript http://localhost:8080/share/page/modules/deploy.
Deploy the new module, Module (Conditionally Hide Site Members), as described in previous tutorials.
When you refresh the dashboard pages for the Test Site and Sample Site sites, you will see that the Site Members component is displayed for Sample Site, but not for the Test Site.

Search form

Search form

You are here