Package com.day.cq.dam.scene7.api

Interface S7ConfigResolver

@ProviderType public interface S7ConfigResolver
Provides access to the Scene7 cloud configuration

  • Field Details

  • Method Details

    • getS7ConfigReaderResolver

      ResourceResolver getS7ConfigReaderResolver()
      Returns:
      *new* ResourceResolver able to read Scene7 Configurations. WARNING: caller is responsible to close it!

    • getS7Config

      S7Config getS7Config(ResourceResolver resourceResolver, String email, String password, String region)
      Returns a S7Config with the corresponding parameters applied.
      Parameters:
      resourceResolver - - resource resolver to access Scene7 configuration
      email - - scene7 account name used for connect to Scene7 server
      password - - scene7 account password used for connect to Scene7 server
      region - - scene7 server region
      Returns:
      the S7Config that match provided username, password and region

    • getS7Config

      S7Config getS7Config(ResourceResolver resourceResolver, String configPath)
      Returns the S7Config generated from the configPath
      Parameters:
      resourceResolver - - resource resolver to access Scene7 configuration
      configPath - - path to the target s7 cloud configPath settings
      Returns:
      S7Config referenced by passed in configPath, return null if cannot get s7Config

    • getSharedS7Config

      S7Config getSharedS7Config(ResourceResolver resourceResolver, S7Config s7Config)
      Returns a copy of the given S7Config pointing to the shared company
      Parameters:
      resourceResolver - - resource resolver to access Scene7 configuration
      s7Config - - config to copy from
      Returns:
      an s7Config configured for the shared company

    • getS7Configurations

      @Deprecated List<S7Config> getS7Configurations(ResourceResolver resourceResolver, String configRootPath)
      Deprecated.
      Returns all the S7 configurations loaded from the children of a given root path. It's deprecated from AEM6.4 due to 0DT change, this can only be used for retrieving old configuration under /etc use getS7Configurations(ResourceResolver resourceResolver) instead
      Parameters:
      resourceResolver - - resource resolver to access Scene7 configuration
      configRootPath - - root path where the configurations will be loaded from
      Returns:
      list of S7Config configurations

    • getS7Configurations

      List<S7Config> getS7Configurations(ResourceResolver resourceResolver)
      Returns all the S7 configurations, include both old configuration(under /etc) and new configuration after 0DT change(under /conf)
      Parameters:
      resourceResolver - - resource resolver to access Scene7 configuration
      Returns:
      list of S7Config configurations

    • getDefaultS7Config

      @Deprecated S7Config getDefaultS7Config(ResourceResolver resourceResolver, String configRootPath)
      Deprecated.
      Returns default S7 configuration Deprecated after 0DT chagne in AEM6.4, use the getDefaultS7Config(ResourceResolver resourceResolver) instead
      Parameters:
      resourceResolver - - resource resolver to access Scene7 configuration
      configRootPath - - root path where the configurations will be loaded from
      Returns:
      default S7Config configuration object

    • getDefaultS7Config

      S7Config getDefaultS7Config(ResourceResolver resourceResolver)
      Returns default S7 configuration If run under DMS7 mode, return DMS7 configuration, otherwise, return S7Connect configuration
      Parameters:
      resourceResolver - - resource resolver to access Scene7 configuration
      Returns:
      default S7Config configuration object

    • getDefaultS7Config

      @Deprecated S7Config getDefaultS7Config()
      Deprecated.
      WARNING: this method embeds the new ResourceResolver into returned S7Config instance! Caller is responsible to call S7Config.close(), or use getDefaultS7Config(ResourceResolver) instead.
      Returns default S7 configuration, resolved using the S7 config service user If run under DMS7 mode, return DMS7 configuration, otherwise, return S7Connect configuration
      Returns:
      default S7Config configuration object

    • getS7ConfigForResource

      S7Config getS7ConfigForResource(ResourceResolver resourceResolver, Resource resource)
      Retrieves the Scene7 configuration associated with a DAM asset resource by successively analysing the resource and then its parents. If no S7Config is found this method returns default configuration instead.
      Parameters:
      resourceResolver - - resource resolver to access Scene7 configuration
      resource - - a DAM asset resource
      Returns:
      the associated Scene7 configuration or default configuration, null if no configuration and no default configuration found

    • getS7ConfigForResource

      S7Config getS7ConfigForResource(ResourceResolver resourceResolver, Resource resource, boolean ignoreSelectiveSync)
      Retrieves the Scene7 configuration associated with a DAM asset resource by successively analysing the resource and then its parents. If no S7Config is found this method returns default configuration instead.
      Parameters:
      resourceResolver - - resource resolver to access Scene7 configuration
      resource - - a DAM asset resource
      ignoreSelectiveSync - - ignore selective sync and return default config
      Returns:
      the associated Scene7 configuration or default configuration, null if no configuration and no default configuration found

    • getS7ConfigForResource

      @Deprecated S7Config getS7ConfigForResource(Resource resource)
      Deprecated.
      this method returns unreadable config! Use getS7ConfigForResource(ResourceResolver, Resource) instead.
      Retrieves the Scene7 configuration associated with a DAM asset resource by successively analysing the resource and then its parents. If no S7Config is found this method returns null.
      Parameters:
      resource - a DAM asset resource
      Returns:
      the associated Scene7 configuration; null if no configuration is found

    • getS7ConfigForImageUrl

      @Deprecated S7Config getS7ConfigForImageUrl(ResourceResolver resourceResolver, String imageUrl)
      Deprecated.
      this method is broken
      Retrieves the Scene7 configuration associated with an image server URL. Returns null if no S7Config is found.
      Parameters:
      resourceResolver - resource resolver to access Scene7 configuration
      imageUrl - the image server URL
      Returns:
      return associated Scene7 configuration; null if no configuration is found

    • getS7ConfigForAssetPath

      S7Config getS7ConfigForAssetPath(ResourceResolver resourceResolver, String assetPath)
      Retrieves the Scene7 configuration associated with asset by content path when Scene7 metadata is not available
      Parameters:
      resourceResolver - resource resolver to access Scene7 configuration
      assetPath - the asset content path
      Returns:
      associated Scene7 configuration; null if no configuration is found

    • getS7ConfigForRootId

      S7Config getS7ConfigForRootId(ResourceResolver resourceResolver, String rootId)
      Looks up scene7 configuration for the specified root id (company name?)
      Parameters:
      resourceResolver - resource resolver to access Scene7 configuration
      rootId - catalog root id
      Returns:
      S7Config object that corresponds to the specified rootId or null if none found.

    • getS7ConfigPathForResource

      String getS7ConfigPathForResource(ResourceResolver resolver, Resource resource)
      Retrieves the Scene7 configuration path associated with a DAM asset resource by successively analysing the resource and then its parents. If no S7Config is found this method returns null.
      Parameters:
      resolver - resource resolver associated with user session
      resource - a DAM asset resource
      Returns:
      the associated Scene7 configuration path; null if no configuration is found

    • getS7ConfigPathForImageUrl

      String getS7ConfigPathForImageUrl(ResourceResolver resolver, String domain, String companyName)
      Retrieves the Scene7 configuration associated with an image server URL. Returns null if no S7Config is found.
      Parameters:
      resolver - resource resolver associated with user session
      domain - delivery domain associated with configuration
      companyName - companyName associated with configuration
      Returns:
      return associated Scene7 configuration path; null if no configuration is found

    • parseDomainAndCompanyNameForUrl

      Map<String,String> parseDomainAndCompanyNameForUrl(String imageUrl)
      Helper method to extract domain and company information related to an image url
      Parameters:
      imageUrl - image url embedding the domain and company information
      Returns:
      return a map with keys 'domain' and 'companyName' if available

    • getS7ConfigPathForAssetPath

      String getS7ConfigPathForAssetPath(ResourceResolver resolver, String assetPath)
      Retrieves the Scene7 configuration associated with an asset path. Returns null if no S7Config is found.
      Parameters:
      resolver - resource resolver associated with user session
      assetPath - asset path associated with configuration
      Returns:
      return associated Scene7 configuration path; null if no configuration is found

    • isDMS7Enabled

      Boolean isDMS7Enabled()
      Temporary method for checking if DMS7 feature is enalbed
      Returns:
      return if the DMS7 mode is enabled

    • setPreviewServerTokenForS7Config

      void setPreviewServerTokenForS7Config(String token, S7Config s7config)
      Sets the preview server jwt token and expirty for Scene7 configuration provided
      Parameters:
      token - String containing JWT token
      s7config - Scene7Config for which token has to be set

    • fetchPreviewServerToken

      String fetchPreviewServerToken(S7Config s7Config)
      Fetch the preview server token for Scene7 configuration provided
      Parameters:
      s7Config - Scene7Config for which token has to be fetched
      Returns:
      return previewServerToken if it is unexpired