org.opencms.loader
Class CmsDefaultFileNameGenerator

java.lang.Object
  org.opencms.loader.CmsDefaultFileNameGenerator

All Implemented Interfaces:

I_CmsFileNameGenerator

public class CmsDefaultFileNameGenerator
extends java.lang.Object
implements I_CmsFileNameGenerator

The default class used for generating file names either for the urlName mapping or when using a "new" operation in the context of the direct edit interface.

Since:

8.0.0

Nested Class Summary

class

CmsDefaultFileNameGenerator.CmsNumberFactory Factory to use for resolving the %(number) macro.

Field Summary

Fields inherited from interface org.opencms.loader.I_CmsFileNameGenerator

MACRO_NUMBER, NUMBER_FORMAT

Constructor Summary

CmsDefaultFileNameGenerator()

Method Summary

java.lang.String	getNewFileName(CmsObject cms, java.lang.String namePattern, int defaultDigits) Returns a new resource name based on the provided OpenCms user context and name pattern.
protected java.lang.String	getNewFileNameFromList(java.util.List<java.lang.String> fileNames, java.lang.String checkPattern, int defaultDigits) Internal method for file name generation, decoupled for testing.
java.util.Iterator<java.lang.String>	getUrlNameSequence(CmsObject cms, CmsXmlContent content, I_CmsXmlContentValue value, CmsResource sibling) This default implementation will just generate a 5 digit sequence that is appended to the resource name in case of a collision of names.

Methods inherited from class java.lang.Object

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

Constructor Detail

CmsDefaultFileNameGenerator

public CmsDefaultFileNameGenerator()

Method Detail

getNewFileName

public java.lang.String getNewFileName(CmsObject cms,
                                       java.lang.String namePattern,
                                       int defaultDigits)
                                throws CmsException

Returns a new resource name based on the provided OpenCms user context and name pattern.

The pattern in this default implementation must be a path which may contain the macro %(number). This will be replaced by the first "n" digit sequence for which the resulting file name is not already used. For example the pattern "/file_%(number).xml" would result in something like "/file_00003.xml".

Alternatively, the macro can have the form %(number:n) with n = {1...9}, for example %(number:6). In this case the default digits will be ignored and instead the digits provided as "n" will be used.

Specified by:

getNewFileName in interface I_CmsFileNameGenerator

Parameters:

cms - the current OpenCms user context

namePattern - the pattern to be used when generating the new resource name

defaultDigits - the default number of digits to use for numbering the created file names

Returns:

a new resource name based on the provided OpenCms user context and name pattern

Throws:

CmsException - in case something goes wrong

getUrlNameSequence

public java.util.Iterator<java.lang.String> getUrlNameSequence(CmsObject cms,
                                                               CmsXmlContent content,
                                                               I_CmsXmlContentValue value,
                                                               CmsResource sibling)

This default implementation will just generate a 5 digit sequence that is appended to the resource name in case of a collision of names.

Specified by:

getUrlNameSequence in interface I_CmsFileNameGenerator

Parameters:

cms - the CMS context

content - the XML content

value - the content value from which the URL name should be generated

sibling - the sibling to which the URL name should be mapped

Returns:

the sequence of URL name candidates

See Also:

I_CmsFileNameGenerator.getUrlNameSequence(org.opencms.file.CmsObject, org.opencms.xml.content.CmsXmlContent, org.opencms.xml.types.I_CmsXmlContentValue, org.opencms.file.CmsResource)

getNewFileNameFromList

protected java.lang.String getNewFileNameFromList(java.util.List<java.lang.String> fileNames,
                                                  java.lang.String checkPattern,
                                                  int defaultDigits)

Internal method for file name generation, decoupled for testing.

Parameters:

fileNames - the list of file names already existing in the folder

checkPattern - the pattern to be used when generating the new resource name

defaultDigits - the default number of digits to use for numbering the created file names

Returns:

a new resource name based on the provided OpenCms user context and name pattern