Package ch.ivyteam.ivy.cm

Interface IContentManagementSystem

All Superinterfaces:
ContentManagementSystem, ch.ivyteam.ivy.cm.IContentManagementEntity
public interface IContentManagementSystem extends ContentManagementSystem, ch.ivyteam.ivy.cm.IContentManagementEntity
The Ivy Content Management System (CMS). The CMS is a container for various types of content. Content can be put in the CMS as name-tuple pairs where as a tuple consists of a value in the configured languages of the CMS.
API:
This is a public API.

  • Method Details

    • getName

      @Deprecated(since="9.3", forRemoval=true) default String getName()
      Deprecated, for removal: This API element is subject to removal in a future version.
      the name of the cms is always the same (cms).
      API:
      This public API is available in Java.

    • getDescription

      @Deprecated(since="9.3", forRemoval=true) default String getDescription()
      Deprecated, for removal: This API element is subject to removal in a future version.
      not supported anymore. always returns empty string.
      API:
      This public API is available in Java.

    • addSupportedLanguage

      @Deprecated(since="9.3", forRemoval=true) default void addSupportedLanguage(Locale language)
      Deprecated, for removal: This API element is subject to removal in a future version.
      useless. all languages are supported by any cms. calling this method has no effect.
      API:
      This public API is available in Java.

    • removeSupportedLanguage

      @Deprecated(since="9.3", forRemoval=true) default void removeSupportedLanguage(Locale language)
      Deprecated, for removal: This API element is subject to removal in a future version.
      useless. all languages are supported by any cms. calling this method has no effect.
      API:
      This public API is available in Java.

    • isSupportedLanguage

      @Deprecated(since="9.3", forRemoval=true) default boolean isSupportedLanguage(Locale language)
      Deprecated, for removal: This API element is subject to removal in a future version.
      useless. all languages are supported by any cms.
      API:
      This public API is available in Java.

    • getDefaultLanguage

      @Deprecated(since="9.3", forRemoval=true) default Locale getDefaultLanguage()
      Deprecated, for removal: This API element is subject to removal in a future version.
      not supported anymore. always returns null;
      API:
      This public API is available in Java.

    • setDefaultLanguage

      @Deprecated(since="9.3", forRemoval=true) default void setDefaultLanguage(Locale defaultLanguage)
      Deprecated, for removal: This API element is subject to removal in a future version.
      not supported anymore. calling this method has no effect.
      API:
      This public API is available in Java.

    • setDefaultPageLayout

      @Deprecated(since="9.3", forRemoval=true) default void setDefaultPageLayout(IContentObject defaultLayout)
      Deprecated, for removal: This API element is subject to removal in a future version.
      not supported anymore. calling this method has no effect.
      API:
      This public API is available in Java.

    • setDefaultPageStyleSheet

      @Deprecated(since="9.3", forRemoval=true) default void setDefaultPageStyleSheet(IContentObject defaultStyleSheet)
      Deprecated, for removal: This API element is subject to removal in a future version.
      not supported anymore. calling this method has no effect.
      API:
      This public API is available in Java.

    • getDefaultPageLayout

      @Deprecated(since="9.3", forRemoval=true) default IContentObject getDefaultPageLayout()
      Deprecated, for removal: This API element is subject to removal in a future version.
      not supported anymore. always returns null.
      API:
      This public API is available in Java.

    • getDefaultPageStyleSheet

      @Deprecated(since="9.3", forRemoval=true) default IContentObject getDefaultPageStyleSheet()
      Deprecated, for removal: This API element is subject to removal in a future version.
      not supported anymore. always returns null.
      API:
      This public API is available in Java.

    • findContentObject

      @Deprecated(since="9.4", forRemoval=true) IContentObject findContentObject(String uri)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Use ivy.cm.findObject(String) instead
      Migration Example: ivy.cms.findContentObject("/my/content") ==> ivy.cm.findObject("/my/content").orElse(null)
      API:
      This public API is available in Java.

    • getContentObject

      @Deprecated(since="9.4", forRemoval=true) default IContentObject getContentObject(String uri)
      Deprecated, for removal: This API element is subject to removal in a future version.
      use ContentManagementSystem.get(String)
      API:
      This public API is available in Java.

    • findContentObjectValue

      @Deprecated(since="9.4", forRemoval=true) default IContentObjectValue findContentObjectValue(String uri, Locale language)
      Deprecated, for removal: This API element is subject to removal in a future version.
      use ivy.cm.findValue(String) instead
      Migration Example: ivy.cms.findContentObjectValue("/my/content", Locale.ENGLISH) ==> ivy.cm.findValue("/my/content").resolve(Locale.ENGLISH).orElse(null)
      API:
      This public API is available in Java.

    • getContentObjectValue

      @Deprecated(since="9.4", forRemoval=true) default IContentObjectValue getContentObjectValue(String uri, Locale language)
      Deprecated, for removal: This API element is subject to removal in a future version.
      use ContentManagementSystem.get(String), ContentObject.value() and ContentObjectValueAccessor.get(Locale) instead
      Migration Example: ivy.cms.getContentObjectValue("/my/content", Locale.ENGLISH) ==> ivy.cm.findValue("/my/content").resolve(Locale.ENGLISH).orElse(null)
      API:
      This public API is available in Java.

    • getContentObject

      @Deprecated(since="9.3", forRemoval=true) default IContentObject getContentObject(Object key)
      Deprecated, for removal: This API element is subject to removal in a future version.
      not supported anymore. always returns null.
      API:
      This public API is available in Java.

    • co

      String co(String uri, List<Object> formatObjects)

      Returns the value of the ContentObject at the given URI in the currently active language. The value is rendered as a String, according to the context and to the type of the value. The placeholders ({0}, {1}, etc.) in the content object value will be replaced by the specified formatObjects. The result is dependent on the availability of renderers in the current context and may be the empty String if the value could not be rendered correcly.

      The search scope is the current case's project or - if not available - this cms'es project and all of it's required projects. If the given uri can not be resolved then the empty String will be returned.

      This method never returns null.

      Parameters:
      uri - the uri of the ContentObject to retrieve
      formatObjects - The objects that will be used to replace the placeholders in the content object value. E.g. {0} will be replaced by the first object in the specified list, {1} with the second object and so on.
      Returns:
      rendered String of ContentObjectValue with given uri in current language or the empty String (never null)
      API:
      This public API is available in Java.

    • coLocale

      String coLocale(String uri, Locale locale)

      Returns the value of the ContentObject in the given language. The value is rendered as a String, according to the context and to the type of the value. The result is dependent on the availability of renderers in the current context and may be the empty String if the value could not be rendered correctly.

      The search scope is the current case's project or - if not available - this cms'es project and all of it's required projects. If the given uri can not be resolved then the empty String will be returned.

      This method returns never null.

      Parameters:
      uri - the uri of the ContentObject to retrieve
      locale - the preferred language for the value
      Returns:
      rendered String of ContentObjectValue with given uri in current language or the empty String (never null)
      Since:
      6.4.0
      API:
      This public API is available in Java.

    • coLocale

      String coLocale(String uri, String locale)

      Returns the value of the ContentObject in the given language. The value is rendered as a String, according to the context and to the type of the value. The result is dependent on the availability of renderers in the current context and may be the empty String if the value could not be rendered correctly.

      The search scope is the current case's project or - if not available - this cms'es project and all of it's required projects. If the given uri can not be resolved then the empty String will be returned.

      This method returns never null.

      Parameters:
      uri - the uri of the ContentObject to retrieve
      locale - the preferred language for the value. E.g. 'de_DE', 'de_CH', 'fr' or 'en'.
      Returns:
      rendered String of ContentObjectValue with given uri in current language or the empty String (never null)
      Since:
      6.4.0
      API:
      This public API is available in Java.

    • co

      String co(String uri)
      Returns the value of the content object with the given URI in the currently active language. The value is rendered as a string. See findContentObject(String) to learn how the value is resolved.
      Parameters:
      uri - cms uri
      Returns:
      content as string
      API:
      This public API is available in Java.

    • cr

      String cr(String uri)
      Returns a reference to the content object with the given URI. See findContentObject(String) to learn how the reference is resolved.
      Parameters:
      uri - the uri of the content object to get a reference of
      Returns:
      reference
      API:
      This public API is available in Java.

    • getIdentifier

      @Deprecated(since="9.3", forRemoval=true) default Object getIdentifier()
      Deprecated, for removal: This API element is subject to removal in a future version.
      not supported anymore. always returns null.
      API:
      This public API is available in Java.

    • getContentObjectForKey

      @Deprecated(since="9.3", forRemoval=true) default IContentObject getContentObjectForKey(Object key)
      Deprecated, for removal: This API element is subject to removal in a future version.
      not supported anymore. always returns null.
      API:
      This public API is available in Java.

    • getRootContentObject

      @Deprecated(since="9.4", forRemoval=true) default IContentObject getRootContentObject()
      Deprecated, for removal: This API element is subject to removal in a future version.
      use ContentManagementSystem.root()
      API:
      This public API is available in Java.