com.android.ide.common.resources

Class ResourceResolver

java.lang.Object

com.android.ide.common.rendering.api.RenderResources

com.android.ide.common.resources.ResourceResolver

public class ResourceResolver
extends com.android.ide.common.rendering.api.RenderResources

NOTE: LayoutLib tests depend on this class.

Nested Class Summary

Nested classes/interfaces inherited from class com.android.ide.common.rendering.api.RenderResources

com.android.ide.common.rendering.api.RenderResources.FrameworkResourceIdProvider, com.android.ide.common.rendering.api.RenderResources.ResourceIdProvider

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.regex.Pattern	DEVICE_DEFAULT_PATTERN
static java.lang.String	LEGACY_THEME Constant passed to setDeviceDefaults(String) to indicate the DeviceDefault styles should point to the default styles
static java.lang.String	THEME_NAME
static java.lang.String	THEME_NAME_DOT

Fields inherited from class com.android.ide.common.rendering.api.RenderResources

REFERENCE_EMPTY, REFERENCE_NULL, REFERENCE_UNDEFINED

Method Summary

Modifier and Type	Method and Description
void	applyStyle(com.android.ide.common.rendering.api.StyleResourceValue theme, boolean useAsPrimary)
void	clearStyles()
static ResourceResolver	copy(ResourceResolver original) Creates a new ResourceResolver copied from the given instance.
static ResourceResolver	create(java.util.Map<com.android.ide.common.rendering.api.ResourceNamespace,java.util.Map<com.android.resources.ResourceType,ResourceValueMap>> resources, java.lang.String themeName, boolean isProjectTheme) Creates a new ResourceResolver object.
ResourceResolver	createRecorder(java.util.List<com.android.ide.common.rendering.api.ResourceValue> lookupChain) Creates a new ResourceResolver which records all resource resolution lookups into the given list.
com.android.ide.common.rendering.api.ResourceValue	dereference(com.android.ide.common.rendering.api.ResourceValue value)
com.android.ide.common.rendering.api.ItemResourceValue	findItemInStyle(com.android.ide.common.rendering.api.StyleResourceValue style, java.lang.String attrName) Deprecated.
com.android.ide.common.rendering.api.ItemResourceValue	findItemInStyle(com.android.ide.common.rendering.api.StyleResourceValue style, java.lang.String itemName, boolean isFrameworkAttr)
java.util.List<com.android.ide.common.rendering.api.StyleResourceValue>	getAllThemes()
com.android.ide.common.rendering.api.StyleResourceValue	getDefaultTheme()
java.util.Map<com.android.resources.ResourceType,ResourceValueMap>	getFrameworkResources() Deprecated.
com.android.ide.common.rendering.api.StyleResourceValue	getParent(com.android.ide.common.rendering.api.StyleResourceValue style)
static java.lang.String	getParentName(com.android.ide.common.rendering.api.StyleResourceValue style) Computes the name of the parent style, or null if the style is a root style.
java.util.Map<com.android.resources.ResourceType,ResourceValueMap>	getProjectResources() Deprecated.
com.android.ide.common.rendering.api.StyleResourceValue	getStyle(com.android.ide.common.rendering.api.ResourceReference styleReference)
java.lang.String	getThemeName()
com.android.ide.common.rendering.api.ResourceValue	getUnresolvedResource(com.android.ide.common.rendering.api.ResourceReference reference)
boolean	isProjectTheme()
boolean	isTheme(com.android.ide.common.rendering.api.ResourceValue value, java.util.Map<com.android.ide.common.rendering.api.ResourceValue,java.lang.Boolean> cache) Returns true if the given ResourceValue represents a theme
com.android.ide.common.rendering.api.ResourceValue	resolveResValue(com.android.ide.common.rendering.api.ResourceValue resValue)
void	setDeviceDefaults(java.lang.String deviceDefaultParent) This will override the DeviceDefault styles so they point to the given parent styles (e.g.
void	setFrameworkResourceIdProvider(com.android.ide.common.rendering.api.RenderResources.FrameworkResourceIdProvider provider)
void	setFrameworkResourceIdProvider(com.android.ide.common.rendering.api.RenderResources.ResourceIdProvider provider)
void	setLibrariesIdProvider(com.android.ide.common.rendering.api.RenderResources.ResourceIdProvider provider)
void	setLogger(com.android.ide.common.rendering.api.LayoutLog logger)
boolean	themeExtends(java.lang.String parentStyle, java.lang.String themeStyle) Returns true if the given themeStyle extends the theme given by parentStyle
boolean	themeIsParentOf(com.android.ide.common.rendering.api.StyleResourceValue parentTheme, com.android.ide.common.rendering.api.StyleResourceValue childTheme)
static ResourceResolver	withValues(com.android.ide.common.rendering.api.ResourceValue... values) Creates a new ResourceResolver which contains only the given ResourceValue objects, indexed by namespace, type and name.

Methods inherited from class com.android.ide.common.rendering.api.RenderResources

findItemInTheme, findItemInTheme, findResValue, getCurrentTheme, getFrameworkResource, getProjectResource, getResolvedResource, getStyle, getTheme, resolveValue

Methods inherited from class java.lang.Object

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

Field Detail

THEME_NAME

public static final java.lang.String THEME_NAME

See Also:

Constant Field Values

THEME_NAME_DOT

public static final java.lang.String THEME_NAME_DOT

See Also:

Constant Field Values

LEGACY_THEME

public static final java.lang.String LEGACY_THEME

Constant passed to setDeviceDefaults(String) to indicate the DeviceDefault styles should point to the default styles

See Also:

Constant Field Values

DEVICE_DEFAULT_PATTERN

public static final java.util.regex.Pattern DEVICE_DEFAULT_PATTERN

Method Detail

create

public static ResourceResolver create(java.util.Map<com.android.ide.common.rendering.api.ResourceNamespace,java.util.Map<com.android.resources.ResourceType,ResourceValueMap>> resources,
                                      java.lang.String themeName,
                                      boolean isProjectTheme)

Creates a new ResourceResolver object.

Parameters:

resources - all resources.

themeName - the name of the current theme.

isProjectTheme - Is this a project theme?

Returns:

a new ResourceResolver

copy

@Nullable
public static ResourceResolver copy(@Nullable
                                              ResourceResolver original)

Creates a new ResourceResolver copied from the given instance.

Returns:

a new ResourceResolver or null if the passed instance is null

withValues

@NonNull
public static ResourceResolver withValues(@NonNull
                                                   com.android.ide.common.rendering.api.ResourceValue... values)

Creates a new ResourceResolver which contains only the given ResourceValue objects, indexed by namespace, type and name. There can be no duplicate (namespace, type, name) tuples in the input.

This method is meant for testing, where other components need to set up a simple ResourceResolver with known contents.

setDeviceDefaults

public void setDeviceDefaults(@NonNull
                              java.lang.String deviceDefaultParent)

This will override the DeviceDefault styles so they point to the given parent styles (e.g. If "Material" is passed, Theme.DeviceDefault parent will become Theme.Material). This patches all the styles (not only themes) and takes care of the light and dark variants. If LEGACY_THEME is passed, parents will be directed to the default themes (i.e. Theme).

getThemeName

public java.lang.String getThemeName()

isProjectTheme

public boolean isProjectTheme()

getProjectResources

@Deprecated
public java.util.Map<com.android.resources.ResourceType,ResourceValueMap> getProjectResources()

Deprecated.

getFrameworkResources

@Deprecated
public java.util.Map<com.android.resources.ResourceType,ResourceValueMap> getFrameworkResources()

Deprecated.

setLibrariesIdProvider

public void setLibrariesIdProvider(@NonNull
                                   com.android.ide.common.rendering.api.RenderResources.ResourceIdProvider provider)

setFrameworkResourceIdProvider

public void setFrameworkResourceIdProvider(@NonNull
                                           com.android.ide.common.rendering.api.RenderResources.ResourceIdProvider provider)

Overrides:

setFrameworkResourceIdProvider in class com.android.ide.common.rendering.api.RenderResources

setFrameworkResourceIdProvider

public void setFrameworkResourceIdProvider(@NonNull
                                           com.android.ide.common.rendering.api.RenderResources.FrameworkResourceIdProvider provider)

Overrides:

setFrameworkResourceIdProvider in class com.android.ide.common.rendering.api.RenderResources

setLogger

public void setLogger(com.android.ide.common.rendering.api.LayoutLog logger)

Overrides:

setLogger in class com.android.ide.common.rendering.api.RenderResources

getDefaultTheme

public com.android.ide.common.rendering.api.StyleResourceValue getDefaultTheme()

Overrides:

getDefaultTheme in class com.android.ide.common.rendering.api.RenderResources

applyStyle

public void applyStyle(com.android.ide.common.rendering.api.StyleResourceValue theme,
                       boolean useAsPrimary)

Overrides:

applyStyle in class com.android.ide.common.rendering.api.RenderResources

clearStyles

public void clearStyles()

Overrides:

clearStyles in class com.android.ide.common.rendering.api.RenderResources

getAllThemes

public java.util.List<com.android.ide.common.rendering.api.StyleResourceValue> getAllThemes()

Overrides:

getAllThemes in class com.android.ide.common.rendering.api.RenderResources

themeIsParentOf

public boolean themeIsParentOf(com.android.ide.common.rendering.api.StyleResourceValue parentTheme,
                               com.android.ide.common.rendering.api.StyleResourceValue childTheme)

Overrides:

themeIsParentOf in class com.android.ide.common.rendering.api.RenderResources

findItemInStyle

@Deprecated
public com.android.ide.common.rendering.api.ItemResourceValue findItemInStyle(com.android.ide.common.rendering.api.StyleResourceValue style,
                                                                                          java.lang.String attrName)

Deprecated.

Overrides:

findItemInStyle in class com.android.ide.common.rendering.api.RenderResources

findItemInStyle

public com.android.ide.common.rendering.api.ItemResourceValue findItemInStyle(com.android.ide.common.rendering.api.StyleResourceValue style,
                                                                              java.lang.String itemName,
                                                                              boolean isFrameworkAttr)

Overrides:

findItemInStyle in class com.android.ide.common.rendering.api.RenderResources

getUnresolvedResource

public com.android.ide.common.rendering.api.ResourceValue getUnresolvedResource(com.android.ide.common.rendering.api.ResourceReference reference)

Overrides:

getUnresolvedResource in class com.android.ide.common.rendering.api.RenderResources

dereference

@Nullable
public com.android.ide.common.rendering.api.ResourceValue dereference(@NonNull
                                                                                com.android.ide.common.rendering.api.ResourceValue value)

Overrides:

dereference in class com.android.ide.common.rendering.api.RenderResources

resolveResValue

public com.android.ide.common.rendering.api.ResourceValue resolveResValue(@Nullable
                                                                          com.android.ide.common.rendering.api.ResourceValue resValue)

Overrides:

resolveResValue in class com.android.ide.common.rendering.api.RenderResources

getParentName

@Nullable
public static java.lang.String getParentName(com.android.ide.common.rendering.api.StyleResourceValue style)

Computes the name of the parent style, or null if the style is a root style. You probably want to use ResolutionUtils,getParentQualifiedName(StyleResourceValue) instead

getParent

@Nullable
public com.android.ide.common.rendering.api.StyleResourceValue getParent(@NonNull
                                                                                   com.android.ide.common.rendering.api.StyleResourceValue style)

Overrides:

getParent in class com.android.ide.common.rendering.api.RenderResources

getStyle

@Nullable
public com.android.ide.common.rendering.api.StyleResourceValue getStyle(@NonNull
                                                                                  com.android.ide.common.rendering.api.ResourceReference styleReference)

Overrides:

getStyle in class com.android.ide.common.rendering.api.RenderResources

isTheme

public boolean isTheme(@NonNull
                       com.android.ide.common.rendering.api.ResourceValue value,
                       @Nullable
                       java.util.Map<com.android.ide.common.rendering.api.ResourceValue,java.lang.Boolean> cache)

Returns true if the given ResourceValue represents a theme

themeExtends

public boolean themeExtends(@NonNull
                            java.lang.String parentStyle,
                            @NonNull
                            java.lang.String themeStyle)

Returns true if the given themeStyle extends the theme given by parentStyle

createRecorder

public ResourceResolver createRecorder(java.util.List<com.android.ide.common.rendering.api.ResourceValue> lookupChain)

Creates a new ResourceResolver which records all resource resolution lookups into the given list. Note that it is the responsibility of the caller to clear/reset the list between subsequent lookup operations.

Parameters:

lookupChain - the list to write resource lookups into

Returns:

a new ResourceResolver