com.android.ide.common.rendering.api

Class ResourceValue

java.lang.Object

com.android.ide.common.rendering.api.ResourceValue

All Implemented Interfaces:

ResourceValueTemp

Direct Known Subclasses:

ResourceValueImpl

public class ResourceValue
extends java.lang.Object
implements ResourceValueTemp

Represents an Android resource with a name and a string value.

Field Summary

Fields

Modifier and Type	Field and Description
protected ResourceNamespace.Resolver	mNamespaceResolver

Constructor Summary

Constructors

Constructor and Description
ResourceValue(ResourceNamespace namespace, ResourceType type, java.lang.String name, java.lang.String value)
ResourceValue(ResourceNamespace namespace, ResourceType type, java.lang.String name, java.lang.String value, java.lang.String libraryName)
ResourceValue(ResourceReference reference, java.lang.String value)
ResourceValue(ResourceReference reference, java.lang.String value, java.lang.String libraryName)

Method Summary

Modifier and Type	Method and Description
ResourceReference	asReference()
boolean	equals(java.lang.Object o)
java.lang.String	getLibraryName() Returns the name of the library where this resource was found or null if it is not from a library.
java.lang.String	getName()
ResourceNamespace	getNamespace()
ResourceNamespace.Resolver	getNamespaceResolver()
java.lang.String	getRawXmlValue() Similar to getValue(), but returns the raw XML value.
ResourceReference	getReference() If this ResourceValue references another one, returns a ResourceReference to it, otherwise null.
ResourceType	getResourceType()
ResourceUrl	getResourceUrl()
java.lang.String	getValue() Returns the value of the resource, as defined in the XML.
int	hashCode()
boolean	isFramework()
boolean	isUserDefined() Returns true if the resource is user defined.
void	replaceWith(ResourceValue value) Sets the value from another resource.
void	setNamespaceLookup(ResourceNamespace.Resolver resolver) Deprecated.
void	setNamespaceResolver(ResourceNamespace.Resolver resolver) Specifies logic used to resolve namespace aliases for values that come from XML files.
void	setValue(java.lang.String value) Sets the value of the resource.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

mNamespaceResolver

@NonNull
protected ResourceNamespace.Resolver mNamespaceResolver

Constructor Detail

ResourceValue

public ResourceValue(@NonNull
                     ResourceNamespace namespace,
                     @NonNull
                     ResourceType type,
                     @NonNull
                     java.lang.String name,
                     @Nullable
                     java.lang.String value)

ResourceValue

public ResourceValue(@NonNull
                     ResourceNamespace namespace,
                     @NonNull
                     ResourceType type,
                     @NonNull
                     java.lang.String name,
                     @Nullable
                     java.lang.String value,
                     @Nullable
                     java.lang.String libraryName)

ResourceValue

public ResourceValue(@NonNull
                     ResourceReference reference,
                     @Nullable
                     java.lang.String value,
                     @Nullable
                     java.lang.String libraryName)

ResourceValue

public ResourceValue(@NonNull
                     ResourceReference reference,
                     @Nullable
                     java.lang.String value)

Method Detail

getResourceType

@NonNull
public ResourceType getResourceType()

Specified by:

getResourceType in interface ResourceValueTemp

getNamespace

@NonNull
public ResourceNamespace getNamespace()

Specified by:

getNamespace in interface ResourceValueTemp

getName

@NonNull
public java.lang.String getName()

Specified by:

getName in interface ResourceValueTemp

getLibraryName

@Nullable
public java.lang.String getLibraryName()

Returns the name of the library where this resource was found or null if it is not from a library.

Specified by:

getLibraryName in interface ResourceValueTemp

isUserDefined

public boolean isUserDefined()

Returns true if the resource is user defined.

Specified by:

isUserDefined in interface ResourceValueTemp

isFramework

public boolean isFramework()

Specified by:

isFramework in interface ResourceValueTemp

getValue

@Nullable
public java.lang.String getValue()

Returns the value of the resource, as defined in the XML. This can be null, for example for instances of StyleResourceValue.

Specified by:

getValue in interface ResourceValueTemp

asReference

@NonNull
public ResourceReference asReference()

Specified by:

asReference in interface ResourceValueTemp

getResourceUrl

@NonNull
public ResourceUrl getResourceUrl()

Specified by:

getResourceUrl in interface ResourceValueTemp

getReference

@Nullable
public ResourceReference getReference()

If this ResourceValue references another one, returns a ResourceReference to it, otherwise null.

This method should be called before inspecting the textual value (getValue()), as it handles namespaces correctly.

Specified by:

getReference in interface ResourceValueTemp

getRawXmlValue

public java.lang.String getRawXmlValue()

Similar to getValue(), but returns the raw XML value. This is usually the same as getValue, but with a few exceptions. For example, for markup strings, you can have <string name="markup">This is <b>bold</b></string>. Here, getValue() will return "This is bold" -- e.g. just the plain text flattened. However, this method will return "This is <b>bold</b>", which preserves the XML markup elements.

Specified by:

getRawXmlValue in interface ResourceValueTemp

setValue

public void setValue(@Nullable
                     java.lang.String value)

Sets the value of the resource.

Specified by:

setValue in interface ResourceValueTemp

Parameters:

value - the new value

replaceWith

public void replaceWith(@NonNull
                        ResourceValue value)

Sets the value from another resource.

Specified by:

replaceWith in interface ResourceValueTemp

Parameters:

value - the resource value

getNamespaceResolver

@NonNull
public ResourceNamespace.Resolver getNamespaceResolver()

Specified by:

getNamespaceResolver in interface ResourceValueTemp

setNamespaceResolver

public void setNamespaceResolver(@NonNull
                                 ResourceNamespace.Resolver resolver)

Specifies logic used to resolve namespace aliases for values that come from XML files.

This method is meant to be called by the XML parser that created this ResourceValue.

Specified by:

setNamespaceResolver in interface ResourceValueTemp

setNamespaceLookup

@Deprecated
public void setNamespaceLookup(@NonNull
                                           ResourceNamespace.Resolver resolver)

Deprecated.

Specified by:

setNamespaceLookup in interface ResourceValueTemp

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object