Package org.ametys.odf.tree

Class OdfClassificationHandler

java.lang.Object

org.ametys.runtime.plugin.component.AbstractLogEnabled

org.ametys.odf.tree.OdfClassificationHandler

All Implemented Interfaces:

LogEnabled, Initializable, Component, Serviceable

public class OdfClassificationHandler
extends AbstractLogEnabled
implements Component, Initializable, Serviceable

Component providing methods to retrieve ODF virtual pages, such as the ODF root, level 1 and 2 metadata names, and so on.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	OdfClassificationHandler.LevelValue	Wrapper object for a level value

Field Summary

Fields

Modifier and Type	Field	Description
protected CatalogsManager	_catalogsManager	The ODF Catalog enumeration
protected ContentTypesHelper	_contentTypesHelper	Content types helper
protected ContentTypeExtensionPoint	_cTypeEP	The content type extension point.
protected I18nUtils	_i18nUtils	The i18n utils.
protected Map<String,Map<String,OdfClassificationHandler.LevelValue>>	_levelValuesCache	Level values cache.
protected ServiceManager	_manager	Avalon service manager
protected OdfReferenceTableHelper	_odfReferenceTableHelper	Odf reference table helper
protected RootOrgUnitProvider	_orgUnitProvider	Root orgunit provider
protected AmetysObjectResolver	_resolver	The ametys object resolver.
protected WorkspaceSelector	_workspaceSelector	The workspace selector.
static String	CATALOG_ATTRIBUTE_NAME	Catalog attribute name.
protected static String	DEFAULT_LEVEL1_ATTRIBUTE	The default level 1 attribute.
protected static String	DEFAULT_LEVEL2_ATTRIBUTE	The default level 2 attribute.
static String	LEVEL1_ATTRIBUTE_NAME	First level attribute name.
static String	LEVEL2_ATTRIBUTE_NAME	Second level attribute name.
protected static List<String>	NON_ELIGIBLE_CTYPES_FOR_LEVEL	Content types that are not eligible for first and second level
static String	ROLE	The avalon role.

Constructor Summary

Constructors

Constructor	Description
OdfClassificationHandler()

Method Summary

Modifier and Type	Method	Description
private Stream<Map.Entry<String,ModelItem>>	_collectEligibleChildAttribute(ModelItemContainer modelItemContainer, boolean allowMultiple)
private String	_convertLevel2RawForContent(String levelValue)
private String	_convertLevel2RawForOrgUnit(String lang, String levelValue)
private String	_convertLevel2RawForRefTable(String metaContentType, String levelValue)
private String	_convertLevelValue2RawValue(String lang, String levelAttribute, String levelValue)	Convert a level value to the raw value
private String	_convertRaw2LevelForContent(String contentId)
private String	_convertRaw2LevelForOrgUnit(String orgUnitId)
private String	_convertRaw2LevelForRefTable(String contentId)
protected String	_convertRawValue2LevelValue(String attributePath, String rawLevelValue)	Convert the attribute raw value into a level value
private OdfClassificationHandler.LevelValue	_convertToLevelValue(String value)
private Map<String,OdfClassificationHandler.LevelValue>	_getLevelValues(String attributePath, String language)	Get the available values of a program's attribute to be used as a level in the virtual ODF page hierarchy.
private Map<String,OdfClassificationHandler.LevelValue>	_getLevelValuesForContentType(String metaContentType, String language)
private <T> Map<String,OdfClassificationHandler.LevelValue>	_getLevelValuesForEnumerator(String language, Enumerator<T> enumerator)
private Map<String,OdfClassificationHandler.LevelValue>	_getLevelValuesForOrgUnits()
private Map<String,OdfClassificationHandler.LevelValue>	_getLevelValuesForRefTable(String metaContentType, String language)
private boolean	_isModelItemEligible(ModelItem modelItem, boolean allowMultiple)
void	clearLevelValues()	Clear the cache of available values for levels used for ODF virtual pages
void	clearLevelValues(String metadataPath, String lang)	Clear the cache of available values for level
String	decodeLevelValue(String value)	Decode level value used in a URI
String	encodeLevelValue(String value)	Encode level value to be use into a URI.
Map<String,I18nizableText>	getCatalogs()	Get the ODF catalogs
Map<String,ModelItem>	getEligibleAttributesForLevel()	Get the eligible enumerated attributes for ODF page level
Map<String,ModelItem>	getEnumeratedAttributes(String programContentTypeId, boolean allowMultiple)	Get the enumerated attribute definitions for the given content type.
Map<String,OdfClassificationHandler.LevelValue>	getLevelValues(String metadata, String language)	Get the first level metadata values (with translated label).
String	getOrgunitIdFromUaiCode(String lang, String uaiCode)	Get the orgunit identifier given an uai code
List<String>	getProgramLevelRawValues(Program program, String levelAttributePath)	Get the level value of a program by extracting and transforming the raw program value at the desired attribute path
List<String>	getProgramLevelValues(Program program, String levelMetaPath)	Get the level value of a program by extracting and transforming the raw program value at the desired metadata path
AmetysObjectIterable<Program>	getPrograms(String catalog, String lang, String level1MetaPath, String level1, String level2MetaPath, String level2, String programCode, String programName, Collection<Expression> additionalExpressions)	Get a collection of programs corresponding to following parameters.
void	initialize()
boolean	isEligibleMetadataForLevel(String attributePath, boolean allowMultiple)	True if the program attribute is eligible
Map<String,Map<String,Collection<Program>>>	organizeProgramsByLevels(AmetysObjectIterable<Program> programs, String level1, String level2)	Organize passed programs by levels into a Map.
void	service(ServiceManager serviceManager)

Methods inherited from class org.ametys.runtime.plugin.component.AbstractLogEnabled

getLogger, setLogger

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ROLE

public static final String ROLE

The avalon role.

LEVEL1_ATTRIBUTE_NAME

public static final String LEVEL1_ATTRIBUTE_NAME

First level attribute name.

See Also:

Constant Field Values

LEVEL2_ATTRIBUTE_NAME

public static final String LEVEL2_ATTRIBUTE_NAME

Second level attribute name.

See Also:

Constant Field Values

CATALOG_ATTRIBUTE_NAME

public static final String CATALOG_ATTRIBUTE_NAME

Catalog attribute name.

See Also:

Constant Field Values

DEFAULT_LEVEL1_ATTRIBUTE

protected static final String DEFAULT_LEVEL1_ATTRIBUTE

The default level 1 attribute.

See Also:

Constant Field Values

DEFAULT_LEVEL2_ATTRIBUTE

protected static final String DEFAULT_LEVEL2_ATTRIBUTE

The default level 2 attribute.

See Also:

Constant Field Values

NON_ELIGIBLE_CTYPES_FOR_LEVEL

protected static final List<String> NON_ELIGIBLE_CTYPES_FOR_LEVEL

Content types that are not eligible for first and second level

_resolver

protected AmetysObjectResolver _resolver

The ametys object resolver.

_i18nUtils

protected I18nUtils _i18nUtils

The i18n utils.

_cTypeEP

protected ContentTypeExtensionPoint _cTypeEP

The content type extension point.

_catalogsManager

protected CatalogsManager _catalogsManager

The ODF Catalog enumeration

_levelValuesCache

protected Map<String,Map<String,OdfClassificationHandler.LevelValue>> _levelValuesCache

Level values cache.

_workspaceSelector

protected WorkspaceSelector _workspaceSelector

The workspace selector.

_manager

protected ServiceManager _manager

Avalon service manager

_contentTypesHelper

protected ContentTypesHelper _contentTypesHelper

Content types helper

_odfReferenceTableHelper

protected OdfReferenceTableHelper _odfReferenceTableHelper

Odf reference table helper

_orgUnitProvider

protected RootOrgUnitProvider _orgUnitProvider

Root orgunit provider

Constructor Detail

OdfClassificationHandler

public OdfClassificationHandler()

Method Detail

service

public void service(ServiceManager serviceManager)
             throws ServiceException

Specified by:

service in interface Serviceable

Throws:

ServiceException

initialize

public void initialize()
                throws Exception

Specified by:

initialize in interface Initializable

Throws:

Exception

getCatalogs

public Map<String,I18nizableText> getCatalogs()

Get the ODF catalogs

Returns:

the ODF catalogs

isEligibleMetadataForLevel

public boolean isEligibleMetadataForLevel(String attributePath,
                                          boolean allowMultiple)

True if the program attribute is eligible

Parameters:

attributePath - the attribute path

allowMultiple - true is we allow multiple attribute

Returns:

true if the program attribute is eligible

getEligibleAttributesForLevel

public Map<String,ModelItem> getEligibleAttributesForLevel()

Get the eligible enumerated attributes for ODF page level

Returns:

the eligible attributes

getEnumeratedAttributes

public Map<String,ModelItem> getEnumeratedAttributes(String programContentTypeId,
                                                           boolean allowMultiple)

Get the enumerated attribute definitions for the given content type. Attribute with enumerator or content attribute are considered as enumerated

Parameters:

programContentTypeId - The content type's id

allowMultiple - true true to allow multiple attribute

Returns:

The definitions of enumerated attributes

_collectEligibleChildAttribute

private Stream<Map.Entry<String,ModelItem>> _collectEligibleChildAttribute(ModelItemContainer modelItemContainer,
                                                                                 boolean allowMultiple)

_isModelItemEligible

private boolean _isModelItemEligible(ModelItem modelItem,
                                     boolean allowMultiple)

getProgramLevelValues

public List<String> getProgramLevelValues(Program program,
                                          String levelMetaPath)

Get the level value of a program by extracting and transforming the raw program value at the desired metadata path

Parameters:

program - The program

levelMetaPath - The desired metadata path that represent a level

Returns:

The list of final level values

getProgramLevelRawValues

public List<String> getProgramLevelRawValues(Program program,
                                             String levelAttributePath)

Get the level value of a program by extracting and transforming the raw program value at the desired attribute path

Parameters:

program - The program

levelAttributePath - The desired attribute path that represent a level

Returns:

The list of level raw value

_convertRawValue2LevelValue

protected String _convertRawValue2LevelValue(String attributePath,
                                             String rawLevelValue)

Convert the attribute raw value into a level value

Parameters:

attributePath - The path of the attribute corresponding to the level

rawLevelValue - The raw level value

Returns:

the converted value or null if there is no level value for this raw value

_convertRaw2LevelForRefTable

private String _convertRaw2LevelForRefTable(String contentId)

_convertRaw2LevelForOrgUnit

private String _convertRaw2LevelForOrgUnit(String orgUnitId)

_convertRaw2LevelForContent

private String _convertRaw2LevelForContent(String contentId)

_convertLevel2RawForRefTable

private String _convertLevel2RawForRefTable(String metaContentType,
                                            String levelValue)

_convertLevel2RawForContent

private String _convertLevel2RawForContent(String levelValue)

clearLevelValues

public void clearLevelValues()

Clear the cache of available values for levels used for ODF virtual pages

clearLevelValues

public void clearLevelValues(String metadataPath,
                             String lang)

Clear the cache of available values for level

Parameters:

lang - the language. Can be null to clear values for all languages

metadataPath - the path of level's metadata

getLevelValues

public Map<String,OdfClassificationHandler.LevelValue> getLevelValues(String metadata,
                                                                            String language)

Get the first level metadata values (with translated label).

Parameters:

metadata - Metadata of first level

language - Lang to get

Returns:

the first level metadata values.

encodeLevelValue

public String encodeLevelValue(String value)

Encode level value to be use into a URI. Double-encode characters ':', '-' and '/'.

Parameters:

value - The raw value

Returns:

the encoded value

decodeLevelValue

public String decodeLevelValue(String value)

Decode level value used in a URI

Parameters:

value - The encoded value

Returns:

the decoded value

_getLevelValues

private Map<String,OdfClassificationHandler.LevelValue> _getLevelValues(String attributePath,
                                                                              String language)

Get the available values of a program's attribute to be used as a level in the virtual ODF page hierarchy.

Parameters:

attributePath - the attribute path.

language - the language.

Returns:

the available attribute values.

_getLevelValuesForRefTable

private Map<String,OdfClassificationHandler.LevelValue> _getLevelValuesForRefTable(String metaContentType,
                                                                                         String language)

_getLevelValuesForOrgUnits

private Map<String,OdfClassificationHandler.LevelValue> _getLevelValuesForOrgUnits()

_getLevelValuesForContentType

private Map<String,OdfClassificationHandler.LevelValue> _getLevelValuesForContentType(String metaContentType,
                                                                                            String language)

_getLevelValuesForEnumerator

private <T> Map<String,OdfClassificationHandler.LevelValue> _getLevelValuesForEnumerator(String language,
                                                                                               Enumerator<T> enumerator)
                                                                                        throws Exception

Throws:

Exception

getPrograms

public AmetysObjectIterable<Program> getPrograms(String catalog,
                                                 String lang,
                                                 String level1MetaPath,
                                                 String level1,
                                                 String level2MetaPath,
                                                 String level2,
                                                 String programCode,
                                                 String programName,
                                                 Collection<Expression> additionalExpressions)

Get a collection of programs corresponding to following parameters.

Parameters:

catalog - Name of the catalog. Can be null to get all programs matching other arguments.

lang - the content language. Can not be null.

level1MetaPath - Having a non-empty value for the metadata path

level1 - If this parameter is not null or empty and level1MetaPath too, we filter programs by the metadata level1MetaPath value of level1

level2MetaPath - Having a non-empty value for the metadata path

level2 - If this parameter is not null or empty and level2MetaPath too, we filter programs by the metadata level2MetaPath value of level2

programCode - The program's code. Can be null to get all programs matching other arguments.

programName - The program's name. Can be null to get all programs matching other arguments.

additionalExpressions - Additional expressions to add to search

Returns:

A collection of programs

getOrgunitIdFromUaiCode

public String getOrgunitIdFromUaiCode(String lang,
                                      String uaiCode)

Get the orgunit identifier given an uai code

Parameters:

lang - Language

uaiCode - The uai code

Returns:

The orgunit id or null if not found

_convertLevelValue2RawValue

private String _convertLevelValue2RawValue(String lang,
                                           String levelAttribute,
                                           String levelValue)

Convert a level value to the raw value

Parameters:

lang - The language

levelAttribute - The name of attribute holding the level

levelValue - The level value

Returns:

The raw value

_convertLevel2RawForOrgUnit

private String _convertLevel2RawForOrgUnit(String lang,
                                           String levelValue)

organizeProgramsByLevels

public Map<String,Map<String,Collection<Program>>> organizeProgramsByLevels(AmetysObjectIterable<Program> programs,
                                                                                        String level1,
                                                                                        String level2)
                                                                                 throws SAXException

Organize passed programs by levels into a Map.

Parameters:

programs - Programs to organize

level1 - Name of the metadata of first level

level2 - Name of the metadata of second level

Returns:

A Map of Map with a Collection of programs which representing the organization of programs by levels.

Throws:

SAXException - if an error occured

_convertToLevelValue

private OdfClassificationHandler.LevelValue _convertToLevelValue(String value)