com.day.cq.dam.commons.util

Class DamLanguageUtil

java.lang.Object

com.day.cq.dam.commons.util.DamLanguageUtil

public class DamLanguageUtil
extends java.lang.Object

This class provides utility method for Language Copy used by sites

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ATTRIBUTE_ASSET_LINKS_RELATION
static java.lang.String	ATTRIBUTE_ASSET_SOURCE_RELATION
static java.lang.String	ATTRIBUTE_ASSET_UPDATE_REQUIRED
static java.lang.String	ATTRIBUTE_COLLECTION_SOURCE_LANGUAGE_COPY
static java.lang.String	ATTRIBUTE_CQ_TRANSLATION_LAST_UPDATE
static java.lang.String	CQ_LASTMODIFIED

Constructor Summary

Constructors

Constructor and Description
DamLanguageUtil()

Method Summary

Modifier and Type	Method and Description
static void	addSmartAssetUpdateFlag(Asset destinationAsset) Deprecated.
static void	addSmartAssetUpdateSource(Asset destinationAsset, java.lang.String sourcePath)
static void	afterReplacingUpdatedAsset(java.lang.String destinationPath, Session userSession, java.lang.String prefixPath, ResourceResolver resourceResolver)
static java.util.List<java.lang.String>	createLanguageCopy(ResourceResolver resourceResolver, PageManagerFactory pageManagerFactory, java.lang.String sourcePath, java.lang.String[] targetLanguageCodes) This method creates language copy of an asset/folder
static java.util.List<java.lang.String>	createLanguageCopyWithAssetRelations(ResourceResolver resourceResolver, PageManagerFactory pageManagerFactory, java.lang.String sourcePath, java.lang.String[] targetLanguageCodes) This method creates language copy of an asset/folder and its source(for example psd for jpeg).
static java.util.List<java.lang.String>	createLanguageCopyWithAssetRelationsForAsset(ResourceResolver resourceResolver, PageManagerFactory pageManagerFactory, java.lang.String sourcePath, java.lang.String[] targetLanguageCodes)
static java.util.List<java.lang.String>	createLanguageCopyWithAssetRelationsForNTFolder(ResourceResolver resourceResolver, PageManagerFactory pageManagerFactory, java.lang.String sourcePath, java.lang.String[] targetLanguageCodes)
static java.lang.String	createUpdateLanguageCopy(ResourceResolver resourceResolver, PageManagerFactory pageManagerFactory, java.lang.String sourcePath, java.lang.String targetLanguageCode, java.lang.String prefixPath) This method creates update language copy of an asset/folder
static java.lang.String	createUpdateLanguageCopyWithAssetRelations(ResourceResolver resourceResolver, PageManagerFactory pageManagerFactory, java.lang.String destinationPath, java.lang.String targetLanguageCode, java.lang.String prefixPath) This method creates temporary language copy of an asset/folder and its source(for example psd for jpeg) in case temporary asset translation is required.
static java.lang.String	findLanguageCopyPathWithAutoCreatedRoots(java.lang.String assetPath, java.lang.String languageCode, ResourceResolver resolver)
static Asset	findLanguageCopyWithAutoCreatedRoots(java.lang.String assetPath, java.lang.String languageCode, ResourceResolver resolver)
static Resource	findLanguageCopyWithAutoCreatedRootsForAssetOrNTFolder(Resource resource, java.lang.String languageCode, ResourceResolver resolver)
static java.util.ArrayList<Asset>	getAssetsFromAssociatedContent(Node contentFragmentNode, java.lang.String destinationLanguage, ResourceResolver resourceResolver)
static Language	getLanguage(java.lang.String path) Deprecated. since 6.2, use LanguageUtil instead
static Asset	getLanguageCopy(java.lang.String assetPath, java.lang.String languageCode, ResourceResolver resolver) This method returns the Language copy asset if language copy exists, for the asked locale
static java.lang.String	getLanguageDisplayName(ResourceResolver resolver, java.lang.String langCode)
static java.lang.String	getLanguageRoot(java.lang.String path) Deprecated. since 6.2, use LanguageUtil instead
static java.lang.String	getLanguageRootLocale(java.lang.String path) Returns the locale for the given path.
static java.util.Collection<Resource>	getLanguageRoots(ResourceResolver resolver, java.lang.String path) Modified version of com.day.cq.wcm.core.impl.LanguageManagerImpl for Resources Returns a collection of language root pages for the given asset.
static java.util.List<Asset>	getRelatedAssets(Resource resource, java.lang.String relationName)
static boolean	hasLanguageCopy(java.lang.String assetPath, java.lang.String languageCode, ResourceResolver resolver) This method returns true if language copy of an asset exists, for the asked locale
static boolean	isSmartAssetUpdateRequired(Asset sourceAsset, Asset destinationAsset)
static void	moveUpdatedAsset(java.lang.String sourcePath, java.lang.String destinationPath, Session userSession, PageManagerFactory pageManagerFactory, ResourceResolver resourceResolver)
static void	moveUpdatedAsset(java.lang.String sourcePath, java.lang.String destinationPath, Session userSession, PageManagerFactory pageManagerFactory, ResourceResolverFactory resolverFactory) Deprecated. since 6.2, use moveUpdatedAsset(String, String, Session, PageManagerFactory, ResourceResolver) instead
static void	replaceUpdatedAsset(java.lang.String sourcePath, java.lang.String destinationPath, Session userSession, PageManagerFactory pageManagerFactory, ResourceResolver resourceResolver)
static java.util.List<java.lang.String>	replaceWithExistingLanguageCopiesIfPossible(java.util.List<java.lang.String> paths, java.lang.String destinationLanguageCode, ResourceResolver resourceResolver) Returns a list after replacing paths with their existing language copies.

Methods inherited from class java.lang.Object

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

Field Detail

ATTRIBUTE_ASSET_LINKS_RELATION

public static final java.lang.String ATTRIBUTE_ASSET_LINKS_RELATION

See Also:

Constant Field Values

ATTRIBUTE_ASSET_SOURCE_RELATION

public static final java.lang.String ATTRIBUTE_ASSET_SOURCE_RELATION

See Also:

Constant Field Values

ATTRIBUTE_ASSET_UPDATE_REQUIRED

public static final java.lang.String ATTRIBUTE_ASSET_UPDATE_REQUIRED

See Also:

Constant Field Values

ATTRIBUTE_COLLECTION_SOURCE_LANGUAGE_COPY

public static final java.lang.String ATTRIBUTE_COLLECTION_SOURCE_LANGUAGE_COPY

See Also:

Constant Field Values

CQ_LASTMODIFIED

public static final java.lang.String CQ_LASTMODIFIED

See Also:

Constant Field Values

ATTRIBUTE_CQ_TRANSLATION_LAST_UPDATE

public static final java.lang.String ATTRIBUTE_CQ_TRANSLATION_LAST_UPDATE

See Also:

Constant Field Values

Constructor Detail

DamLanguageUtil

public DamLanguageUtil()

Method Detail

hasLanguageCopy

public static boolean hasLanguageCopy(java.lang.String assetPath,
                                      java.lang.String languageCode,
                                      ResourceResolver resolver)

This method returns true if language copy of an asset exists, for the asked locale

Parameters:

assetPath - The path of an asset for which language copy is asked

languageCode - Language for which language copy is asked

resolver - ResourceResolver

Returns:

getLanguageCopy

public static Asset getLanguageCopy(java.lang.String assetPath,
                                    java.lang.String languageCode,
                                    ResourceResolver resolver)

This method returns the Language copy asset if language copy exists, for the asked locale

Parameters:

assetPath - The path of an asset for which language copy is asked

languageCode - Language for which language copy is asked

resolver - ResourceResolver

Returns:

createLanguageCopy

public static java.util.List<java.lang.String> createLanguageCopy(ResourceResolver resourceResolver,
                                                                  PageManagerFactory pageManagerFactory,
                                                                  java.lang.String sourcePath,
                                                                  java.lang.String[] targetLanguageCodes)

This method creates language copy of an asset/folder

Parameters:

resourceResolver -

pageManagerFactory -

sourcePath - - source for creating language copy

targetLanguageCodes - - array of language codes

Returns:

getLanguageRoot

@Deprecated
public static java.lang.String getLanguageRoot(java.lang.String path)

Deprecated. since 6.2, use LanguageUtil instead

Returns the language root for the given asset path by only analyzing the path names starting at the root. For this implementation, language root for dam was suffix of folder name joined by "-" ex. geometrixx-en.

Parameters:

path - path

Returns:

the language root or null if not found

getLanguage

@Deprecated
public static Language getLanguage(java.lang.String path)

Deprecated. since 6.2, use LanguageUtil instead

Returns the language for the given asset path by only analyzing the path names starting at the root. For this implementation, language root for dam was suffix of folder name joined by "-" ex. geometrixx-en.

Parameters:

path - path

Returns:

the language or null if not found

getLanguageRoots

public static java.util.Collection<Resource> getLanguageRoots(ResourceResolver resolver,
                                                              java.lang.String path)

Modified version of com.day.cq.wcm.core.impl.LanguageManagerImpl for Resources Returns a collection of language root pages for the given asset. Note that only the path names are respected for the determination of the language.

Parameters:

resolver - resource resolver

path - path of the current page

Returns:

collection of language root paths

createUpdateLanguageCopy

public static java.lang.String createUpdateLanguageCopy(ResourceResolver resourceResolver,
                                                        PageManagerFactory pageManagerFactory,
                                                        java.lang.String sourcePath,
                                                        java.lang.String targetLanguageCode,
                                                        java.lang.String prefixPath)

This method creates update language copy of an asset/folder

Parameters:

resourceResolver -

pageManagerFactory -

sourcePath - - source for creating language copy

targetLanguageCode - - destination language code

prefixPath - - Root path where language copies are created

Returns:

moveUpdatedAsset

@Deprecated
public static void moveUpdatedAsset(java.lang.String sourcePath,
                                                java.lang.String destinationPath,
                                                Session userSession,
                                                PageManagerFactory pageManagerFactory,
                                                ResourceResolverFactory resolverFactory)

Deprecated. since 6.2, use moveUpdatedAsset(String, String, Session, PageManagerFactory, ResourceResolver) instead

Parameters:

sourcePath -

destinationPath -

userSession -

pageManagerFactory -

resolverFactory -

moveUpdatedAsset

public static void moveUpdatedAsset(java.lang.String sourcePath,
                                    java.lang.String destinationPath,
                                    Session userSession,
                                    PageManagerFactory pageManagerFactory,
                                    ResourceResolver resourceResolver)

replaceUpdatedAsset

public static void replaceUpdatedAsset(java.lang.String sourcePath,
                                       java.lang.String destinationPath,
                                       Session userSession,
                                       PageManagerFactory pageManagerFactory,
                                       ResourceResolver resourceResolver)

isSmartAssetUpdateRequired

public static boolean isSmartAssetUpdateRequired(Asset sourceAsset,
                                                 Asset destinationAsset)

addSmartAssetUpdateFlag

@Deprecated
public static void addSmartAssetUpdateFlag(Asset destinationAsset)
                                                throws RepositoryException

Deprecated.

Throws:

RepositoryException

addSmartAssetUpdateSource

public static void addSmartAssetUpdateSource(Asset destinationAsset,
                                             java.lang.String sourcePath)
                                      throws RepositoryException

Throws:

RepositoryException

createLanguageCopyWithAssetRelations

public static java.util.List<java.lang.String> createLanguageCopyWithAssetRelations(ResourceResolver resourceResolver,
                                                                                    PageManagerFactory pageManagerFactory,
                                                                                    java.lang.String sourcePath,
                                                                                    java.lang.String[] targetLanguageCodes)
                                                                             throws RepositoryException

This method creates language copy of an asset/folder and its source(for example psd for jpeg). Information about language copy which triggered translation is added in case temporary asset translation is required. Finally, relations are changed with their language copies.

Parameters:

resourceResolver -

pageManagerFactory -

sourcePath - - source for creating language copy

targetLanguageCodes - - array of language codes

Returns:

list of created language copies

Throws:

RepositoryException

createLanguageCopyWithAssetRelationsForAsset

public static java.util.List<java.lang.String> createLanguageCopyWithAssetRelationsForAsset(ResourceResolver resourceResolver,
                                                                                            PageManagerFactory pageManagerFactory,
                                                                                            java.lang.String sourcePath,
                                                                                            java.lang.String[] targetLanguageCodes)
                                                                                     throws RepositoryException

Throws:

RepositoryException

createLanguageCopyWithAssetRelationsForNTFolder

public static java.util.List<java.lang.String> createLanguageCopyWithAssetRelationsForNTFolder(ResourceResolver resourceResolver,
                                                                                               PageManagerFactory pageManagerFactory,
                                                                                               java.lang.String sourcePath,
                                                                                               java.lang.String[] targetLanguageCodes)
                                                                                        throws RepositoryException

Throws:

RepositoryException

getRelatedAssets

public static java.util.List<Asset> getRelatedAssets(Resource resource,
                                                     java.lang.String relationName)

createUpdateLanguageCopyWithAssetRelations

public static java.lang.String createUpdateLanguageCopyWithAssetRelations(ResourceResolver resourceResolver,
                                                                          PageManagerFactory pageManagerFactory,
                                                                          java.lang.String destinationPath,
                                                                          java.lang.String targetLanguageCode,
                                                                          java.lang.String prefixPath)
                                                                   throws RepositoryException

This method creates temporary language copy of an asset/folder and its source(for example psd for jpeg) in case temporary asset translation is required. Finally, relations are changed with their temporary copies.

Parameters:

resourceResolver -

pageManagerFactory -

destinationPath - - source for creating language copy

targetLanguageCode - - destination language code

prefixPath - - Root path where language copies are created

Returns:

created variant temporary language copy path if created, otherwise returns destinationPath

Throws:

RepositoryException

findLanguageCopyPathWithAutoCreatedRoots

public static java.lang.String findLanguageCopyPathWithAutoCreatedRoots(java.lang.String assetPath,
                                                                        java.lang.String languageCode,
                                                                        ResourceResolver resolver)

findLanguageCopyWithAutoCreatedRootsForAssetOrNTFolder

public static Resource findLanguageCopyWithAutoCreatedRootsForAssetOrNTFolder(Resource resource,
                                                                              java.lang.String languageCode,
                                                                              ResourceResolver resolver)
                                                                       throws RepositoryException

Throws:

RepositoryException

findLanguageCopyWithAutoCreatedRoots

public static Asset findLanguageCopyWithAutoCreatedRoots(java.lang.String assetPath,
                                                         java.lang.String languageCode,
                                                         ResourceResolver resolver)

afterReplacingUpdatedAsset

public static void afterReplacingUpdatedAsset(java.lang.String destinationPath,
                                              Session userSession,
                                              java.lang.String prefixPath,
                                              ResourceResolver resourceResolver)
                                       throws RepositoryException

Throws:

RepositoryException

getLanguageRootLocale

public static java.lang.String getLanguageRootLocale(java.lang.String path)

Returns the locale for the given path. Supports language root structures /<root>/\<path>lt;Language>_\<Country> and /\<root>lt;path>lt;Language>

Parameters:

path -

Returns:

locale or null in case any supported locale does not exist in the given path

getLanguageDisplayName

public static java.lang.String getLanguageDisplayName(ResourceResolver resolver,
                                                      java.lang.String langCode)

replaceWithExistingLanguageCopiesIfPossible

public static java.util.List<java.lang.String> replaceWithExistingLanguageCopiesIfPossible(java.util.List<java.lang.String> paths,
                                                                                           java.lang.String destinationLanguageCode,
                                                                                           ResourceResolver resourceResolver)

Returns a list after replacing paths with their existing language copies. If a language copy of a path does not exist, the path is retained in the returned list.

Parameters:

paths - The list of paths whose language copy has to be replaced

destinationLanguageCode - language code of destination language copy

resourceResolver -

Returns:

a list after replacing paths with their existing language copies.

getAssetsFromAssociatedContent

public static java.util.ArrayList<Asset> getAssetsFromAssociatedContent(Node contentFragmentNode,
                                                                        java.lang.String destinationLanguage,
                                                                        ResourceResolver resourceResolver)
                                                                 throws RepositoryException

Throws:

RepositoryException