WebResourceIntegration (Atlassian Plugins

```
public interface WebResourceIntegration
```
The integration points between the Web Resource layer, and specific applications (eg JIRA, Confluence).

See Also:

DefaultPageBuilderService(WebResourceIntegration, com.atlassian.webresource.api.assembler.WebResourceAssemblerFactory), DefaultWebResourceAssemblerFactory(PluginResourceLocator), WebResourceManagerImpl(PluginResourceLocator, WebResourceIntegration, WebResourceUrlProvider)

Method Summary

All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods
Modifier and Type	Method and Description
`Set<String>`	`allowedCondition1Keys()` Works together with `forbidCondition1AndTransformer1` and temporarily allows for given set of plugins to have legacy stuff.
`Set<String>`	`allowedTransform1Keys()` Works together with `forbidCondition1AndTransformer1` and temporarily allows for given set of plugins to have legacy stuff.
`default boolean`	`forbidCondition1AndTransformer1()` If enabled and there's at leas one Condition1 or Transformer1 Web Resource will throw an error and stop working.
`String`	`getBaseUrl()` Returns the base URL for this application.
`String`	`getBaseUrl(UrlMode urlMode)` Returns the base URL for this application in either relative or absolute format, depending on the value of `urlMode`.
`default BigPipeConfiguration`	`getBigPipeConfiguration()`
`CDNStrategy`	`getCDNStrategy()` Returns the CDNStrategy for serving resources via CDN.
`com.atlassian.sal.api.features.DarkFeatureManager`	`getDarkFeatureManager()` Used to separate the WRM from the details of how products deal with system properties
`com.atlassian.event.api.EventPublisher`	`getEventPublisher()` Applications must implement this method to get access to the analytic event publisher
`String`	`getHostApplicationVersion()` The version number of the host application, for example "7.0.0-OD-07" or "5.6".
`String`	`getI18nRawText(Locale locale, String key)` Retrieve the unformatted message text associated with this key.
`String`	`getI18nStateHash()` The locale hash that should be inserted into static resource urls for the current request, if appropriate.
`String`	`getI18nText(Locale locale, String key)` Retrieve the message text associated with this key.
`Locale`	`getLocale()`
`com.atlassian.plugin.PluginAccessor`	`getPluginAccessor()` Applications must implement this method to get access to the application's PluginAccessor
`com.atlassian.plugin.event.PluginEventManager`	`getPluginEventManager()` Deprecated. since v3.3.2
`Map<String,Object>`	`getRequestCache()` This must be a thread-local cache that will be accessible from both the page, and the decorator
`default String`	`getResourceUrlPrefix()` Represents the resource URL prefix used to construct URLs to resources.
`String`	`getStaticResourceLocale()` Deprecated. since 3.5.22 - This method includes current locale in URL hash which is unnecessary since it's already in a query parameter. The current behaviour causes unnecessary cache misses of pre-baked resources since it'll only work for instances with the same locale in which the pre-baker ran. Use `getI18nStateHash()` instead.
`String`	`getSuperBatchVersion()` This version number is used for caching URL generation, and needs to be incremented every time the contents of the superbatch may have changed.
`Iterable<Locale>`	`getSupportedLocales()`
`default List<CompleteWebResourceKey>`	`getSyncWebResourceKeys()` Synchronous resources will be inlined in the HTML response when `WebResourceSet.writeHtmlTags(Writer, com.atlassian.webresource.api.UrlMode)` gets called.
`String`	`getSystemBuildNumber()` Represents the last time the system was updated.
`default String`	`getSystemCounter()` Deprecated. since 5.0 implement `getResourceUrlPrefix()` instead
`File`	`getTemporaryDirectory()` A reference to the temporary directory the application want the plugin system to use.
`default boolean`	`isCompiledResourceEnabled()` Returns whether "compiled resources" are enabled.
`default boolean`	`isCtCdnMappingEnabled()` Checks if CT-CDN is enable at this moment.
`default boolean`	`isDeferJsAttributeEnabled()` Deprecated. since 5.0.0, use ResourcePriority.DEFER instead
`default boolean`	`isIncrementalCacheEnabled()` If incremental cache should be used.
`default void`	`rebuildResourceUrlPrefix()` Triggers product-side URL prefix recalculation.
`default boolean`	`usePluginInstallTimeInsteadOfTheVersionForSnapshotPlugins()` If true the plugin install time will be used instead of the plugin version for the SNAPSHOT plugins.

- Method Detail
  - getPluginAccessor
```
com.atlassian.plugin.PluginAccessor getPluginAccessor()
```
    Applications must implement this method to get access to the application's PluginAccessor
  - getPluginEventManager
```
@Deprecated
com.atlassian.plugin.event.PluginEventManager getPluginEventManager()
```
    Deprecated. since v3.3.2
    
    Applications must implement this method to get access to the application's PluginEventManager
    
    Since:
    
    3.1.1
  - getRequestCache
```
Map<String,Object> getRequestCache()
```
    This must be a thread-local cache that will be accessible from both the page, and the decorator
  - getSystemCounter
```
@Deprecated
default String getSystemCounter()
```
    Deprecated. since 5.0 implement getResourceUrlPrefix() instead
    
    Represents the unique string for this system, which when updated will flush the cache.
    
    Returns:
    
    A string representing the count
  - getResourceUrlPrefix
```
default String getResourceUrlPrefix()
```
    Represents the resource URL prefix used to construct URLs to resources. A correctly constructed prefix should change when the content served under that URL changes. Some examples of configuration items that should result in the URL prefix getting changed: Look and Feel update in Jira (reason: this has impact on the generated CSS files), CDN URL change (reason: absolute link to the CDN is stored in the CSS files).
    
    Returns:
    
    A string used as resource URL prefix
  - rebuildResourceUrlPrefix
```
default void rebuildResourceUrlPrefix()
```
    Triggers product-side URL prefix recalculation.
    
    Since:
    
    4.2.7, 4.3.2
    
    See Also:
    
    getSystemCounter(), getResourceUrlPrefix()
  - getSystemBuildNumber
```
String getSystemBuildNumber()
```
    Represents the last time the system was updated. This is generally obtained from BuildUtils or similar.
  - getHostApplicationVersion
```
String getHostApplicationVersion()
```
    The version number of the host application, for example "7.0.0-OD-07" or "5.6". It is intended to identify if two instances of an application are the same version (the versions of plugins are checked separately). This differs from getSystemBuildNumber(), which does not necessarily change when the application changes (at least in JIRA this represents the database build number, not the application version number).
    
    Since:
    
    3.4.7
  - getBaseUrl
```
String getBaseUrl()
```
    Returns the base URL for this application. This method may return either an absolute or a relative URL. Implementations are free to determine which mode to use based on any criteria of their choosing. For example, an implementation may choose to return a relative URL if it detects that it is running in the context of an HTTP request, and an absolute URL if it detects that it is not. Or it may choose to always return an absolute URL, or always return a relative URL. Callers should only use this method when they are sure that either an absolute or a relative URL will be appropriate, and should not rely on any particular observed behavior regarding how this value is interpreted, which may vary across different implementations.
    In general, the behavior of this method should be equivalent to calling getBaseUrl(UrlMode) with a urlMode value of UrlMode.AUTO.
    
    Returns:
    
    the string value of the base URL of this application
  - getBaseUrl
```
String getBaseUrl(UrlMode urlMode)
```
    Returns the base URL for this application in either relative or absolute format, depending on the value of urlMode.
    If urlMode == {@link UrlMode#ABSOLUTE}, this method returns an absolute URL, with URL scheme, hostname, port (if non-standard for the scheme), and context path.
    If urlMode == {@link UrlMode#RELATIVE}, this method returns a relative URL containing just the context path.
    If urlMode == {@link UrlMode#AUTO}, this method may return either an absolute or a relative URL. Implementations are free to determine which mode to use based on any criteria of their choosing. For example, an implementation may choose to return a relative URL if it detects that it is running in the context of an HTTP request, and an absolute URL if it detects that it is not. Or it may choose to always return an absolute URL, or always return a relative URL. Callers should only use WebResourceManager.UrlMode#AUTO when they are sure that either an absolute or a relative URL will be appropriate, and should not rely on any particular observed behavior regarding how this value is interpreted, which may vary across different implementations.
    
    Parameters:
    
    urlMode - specifies whether to use absolute URLs, relative URLs, or allow the concrete implementation to decide
    
    Returns:
    
    the string value of the base URL of this application
    
    Since:
    
    2.3.0
  - getSuperBatchVersion
```
String getSuperBatchVersion()
```
    This version number is used for caching URL generation, and needs to be incremented every time the contents of the superbatch may have changed. Practically this means updating every time the plugin system state changes
    
    Returns:
    
    a version number
  - getStaticResourceLocale
```
@Deprecated
String getStaticResourceLocale()
```
    Deprecated. since 3.5.22 - This method includes current locale in URL hash which is unnecessary since it's already in a query parameter. The current behaviour causes unnecessary cache misses of pre-baked resources since it'll only work for instances with the same locale in which the pre-baker ran. Use getI18nStateHash() instead.
    
    The locale identifier that should be inserted into static resource urls for the current request, if appropriate.
    
    Returns:
    
    null if the url should not have a locale component
  - getI18nStateHash
```
String getI18nStateHash()
```
    The locale hash that should be inserted into static resource urls for the current request, if appropriate. This method should return the hash for i18n-contributing plugins without the current locale attached to it.
    
    Returns:
    
    null if the url should not have a locale component.
    
    Since:
    
    3.5.22
  - getTemporaryDirectory
```
File getTemporaryDirectory()
```
    A reference to the temporary directory the application want the plugin system to use. The temporary directory can be cleared at any time by the application and can be used by the plugin system to cache things like batches or other things that can easily be re-generated. It is recommended that this directory be /apphome/tmp/webresources. The plugin system can delete any or all files it sees fit that exists under this directory at any time. The directory does not need to exist.
    
    Returns:
    
    a File reference to the temporary directory. This can not return null.
    
    Since:
    
    2.9.0
  - getCDNStrategy
```
CDNStrategy getCDNStrategy()
```
    Returns the CDNStrategy for serving resources via CDN. This may return null, in which case no resources should be served via CDN.
    
    Returns:
    
    CDN strategy
  - getLocale
```
Locale getLocale()
```
    Returns:
    
    the current user's locale. Must return a default locale if none is found.
  - getSupportedLocales
```
Iterable<Locale> getSupportedLocales()
```
    Returns:
    
    the set of locales supported by this application. Used to pre-bake resources.
    
    Since:
    
    3.4.7
  - getI18nRawText
```
String getI18nRawText(Locale locale,
                      String key)
```
    Retrieve the unformatted message text associated with this key.
    
    Parameters:
    
    locale - locale in which to look up keys
    
    key - key for the i18ned message
    
    Returns:
    
    the unformatted message text if key is found for the given locale, otherwise returns key itself.
  - getI18nText
```
String getI18nText(Locale locale,
                   String key)
```
    Retrieve the message text associated with this key.
    
    Parameters:
    
    locale - locale in which to look up keys
    
    key - key for the i18ned message
    
    Returns:
    
    the message text if key is found for the given locale, otherwise returns key itself.
  - allowedCondition1Keys
```
Set<String> allowedCondition1Keys()
```
    Works together with `forbidCondition1AndTransformer1` and temporarily allows for given set of plugins to have legacy stuff. Eventually when all plugins will be updated it will ratchet down to an empty list and will be removed.
    
    Since:
    
    3.3.0
  - allowedTransform1Keys
```
Set<String> allowedTransform1Keys()
```
    Works together with `forbidCondition1AndTransformer1` and temporarily allows for given set of plugins to have legacy stuff. Eventually when all plugins will be updated it will ratchet down to an empty list and will be removed.
    
    Since:
    
    3.3.0
  - forbidCondition1AndTransformer1
```
default boolean forbidCondition1AndTransformer1()
```
    If enabled and there's at leas one Condition1 or Transformer1 Web Resource will throw an error and stop working. Should be enabled in on-demand only.
    
    Since:
    
    3.3.0
  - isIncrementalCacheEnabled
```
default boolean isIncrementalCacheEnabled()
```
    If incremental cache should be used. It's the experimental feature that potentially could slow down the instance and should be disabled by default.
    Please note that if it's enabled the size of the cache should be big enough. It caches the transformed content of the individual JS / CSS files, and there are lots of such files. The size defined by `plugin.webresource.incrementalcache.size` system property.
    See https://extranet.atlassian.com/display/~apetrushin/Incremental+build+Cache+for+Context+Batch for details.
    
    Since:
    
    3.4.0
  - isDeferJsAttributeEnabled
```
@Deprecated
default boolean isDeferJsAttributeEnabled()
```
    Deprecated. since 5.0.0, use ResourcePriority.DEFER instead
    
    CONFDEV-35445 Should WRM enable the defer attribute in its JS tags? Experimental Api
    
    Since:
    
    3.4.0
  - getBigPipeConfiguration
```
default BigPipeConfiguration getBigPipeConfiguration()
```
  - getSyncWebResourceKeys
```
@ExperimentalApi
default List<CompleteWebResourceKey> getSyncWebResourceKeys()
```
    Synchronous resources will be inlined in the HTML response when WebResourceSet.writeHtmlTags(Writer, com.atlassian.webresource.api.UrlMode) gets called. For example, analytics or AMD loader should be available for every other scripts. Important note. Only JS files will be taken from specified web-resources and other types of resources will be ignored. Warning will be logged in such case. Any dependencies of specified web-resources will be also treated as sync and will be included before those web-resources so be careful. It's guaranteed that sync web-resources will be included only once, hence they will be also excluded from other batches.
    
    Returns:
    
    list of complete resource keys
    
    Since:
    
    3.5.27
  - usePluginInstallTimeInsteadOfTheVersionForSnapshotPlugins
```
default boolean usePluginInstallTimeInsteadOfTheVersionForSnapshotPlugins()
```
    If true the plugin install time will be used instead of the plugin version for the SNAPSHOT plugins. The plugin version is used when building the cache hash for URLs. for details see https://ecosystem.atlassian.net/browse/PLUGWEB-304
    It's needed to simplify development and flush the cache when updated SNAPSHOT plugin installed.
    
    Since:
    
    3.5.9
  - isCtCdnMappingEnabled
```
default boolean isCtCdnMappingEnabled()
```
    Checks if CT-CDN is enable at this moment. Use this to disable this feature in case of problems.
    
    Returns:
    
    "True" enables CT-CDN and "false" disabled it at runtime.
  - isCompiledResourceEnabled
```
default boolean isCompiledResourceEnabled()
```
    Returns whether "compiled resources" are enabled. This will cause WRM to look for a 'compiledLocation' property on a downloadable web resource. If the property is present, and this method returns true, then WRM will serve the resource located on the path provided by 'compiledLocation' instead of at the path provided by 'location'.
  - getEventPublisher
```
@Nonnull
com.atlassian.event.api.EventPublisher getEventPublisher()
```
    Applications must implement this method to get access to the analytic event publisher
    
    Since:
    
    5.2.0
  - getDarkFeatureManager
```
@Nonnull
com.atlassian.sal.api.features.DarkFeatureManager getDarkFeatureManager()
```
    Used to separate the WRM from the details of how products deal with system properties
    
    Since:
    
    5.2.0

Interface WebResourceIntegration

Method Summary

Method Detail

getPluginAccessor

getPluginEventManager

getRequestCache

getSystemCounter

getResourceUrlPrefix

rebuildResourceUrlPrefix

getSystemBuildNumber

getHostApplicationVersion

getBaseUrl

getBaseUrl

getSuperBatchVersion

getStaticResourceLocale

getI18nStateHash

getTemporaryDirectory

getCDNStrategy

getLocale

getSupportedLocales

getI18nRawText

getI18nText

allowedCondition1Keys

allowedTransform1Keys

forbidCondition1AndTransformer1

isIncrementalCacheEnabled

isDeferJsAttributeEnabled

getBigPipeConfiguration

getSyncWebResourceKeys

usePluginInstallTimeInsteadOfTheVersionForSnapshotPlugins

isCtCdnMappingEnabled

isCompiledResourceEnabled

getEventPublisher

getDarkFeatureManager