com.google.template.soy.types.proto

Class SoyProtoValueImpl

java.lang.Object

com.google.template.soy.data.SoyAbstractValue

com.google.template.soy.types.proto.SoyProtoValueImpl

All Implemented Interfaces:

SoyMap, SoyProtoValue, SoyRecord, SoyValue, SoyValueProvider

public final class SoyProtoValueImpl
extends SoyAbstractValue
implements SoyProtoValue, SoyMap

Soy value that wraps a protocol buffer message object.

This implements SoyMap to deal with some uses that require "reflecting" over Soy proto fields. However, this usage is deprecated and will be unsupported when static type checking is used, since it doesn't work with Javascript, which does not support reflection.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoyProtoValueImpl.Builder Provides an interface for constructing a SoyProtoValueImpl.

Method Summary

Modifier and Type	Method and Description
boolean	coerceToBoolean() Coerces this value into a boolean.
String	coerceToString() Coerces this value into a string.
static SoyProtoValueImpl	create(com.google.protobuf.Message proto)
boolean	equals(Object other) Compares this value against another for equality in the sense of the '==' operator of Soy.
SoyValue	getField(String name) Deprecated.
SoyValueProvider	getFieldProvider(String name) Deprecated.
SoyValue	getItem(SoyValue key) Gets an item value of this SoyMap.
int	getItemCnt() Gets the number of items in this SoyMap.
Collection<SoyValue>	getItemKeys() Gets an iterable over all item keys in this SoyMap.
SoyValueProvider	getItemProvider(SoyValue key) Gets a provider of an item value of this SoyMap.
com.google.protobuf.Message	getProto() Returns the underlying message.
SoyValue	getProtoField(String name) Gets a value for the field for the underlying proto object.
boolean	hasField(String name) Deprecated.
int	hashCode()
boolean	hasItem(SoyValue key) Checks whether this SoyMap has an item with the given key.
void	render(LoggingAdvisingAppendable appendable) Renders this value to the given appendable.
String	toString() Returns a string that indicates the type of proto held, to assist in debugging Soy type errors.

Methods inherited from class com.google.template.soy.data.SoyAbstractValue

booleanValue, floatValue, integerValue, longValue, numberValue, render, renderAndResolve, resolve, status, stringValue

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.template.soy.data.SoyValue

booleanValue, floatValue, integerValue, longValue, numberValue, render, stringValue

Methods inherited from interface com.google.template.soy.data.SoyValueProvider

renderAndResolve, resolve, status

Method Detail

create

public static SoyProtoValueImpl create(com.google.protobuf.Message proto)

getProto

public com.google.protobuf.Message getProto()

Returns the underlying message.

Specified by:

getProto in interface SoyProtoValue

getProtoField

public SoyValue getProtoField(String name)

Description copied from interface: SoyProtoValue

Gets a value for the field for the underlying proto object. Not intended for general use.

Specified by:

getProtoField in interface SoyProtoValue

Parameters:

name - The proto field name.

Returns:

The value of the given field for the underlying proto object, or NullData if either the field does not exist or the value is not set in the underlying proto (according to the jspb semantics)

hasField

@Deprecated
public boolean hasField(String name)

Deprecated.

Description copied from interface: SoyRecord

Checks whether this SoyRecord has a field of the given name.

Specified by:

hasField in interface SoyProtoValue

Specified by:

hasField in interface SoyRecord

Parameters:

name - The field name to check.

Returns:

Whether this SoyRecord has a field of the given name.

getField

@Deprecated
public SoyValue getField(String name)

Deprecated.

Description copied from interface: SoyRecord

Gets a field value of this SoyRecord.

Specified by:

getField in interface SoyProtoValue

Specified by:

getField in interface SoyRecord

Parameters:

name - The field name to get.

Returns:

The field value for the given field name, or null if no such field name.

getFieldProvider

@Deprecated
public SoyValueProvider getFieldProvider(String name)

Deprecated.

Description copied from interface: SoyProtoValue

Proto fields are always immediately resolvable.

Specified by:

getFieldProvider in interface SoyProtoValue

Specified by:

getFieldProvider in interface SoyRecord

Parameters:

name - The field name to get.

Returns:

A provider of the field value for the given field name, or null if no such field name.

getItemCnt

public int getItemCnt()

Description copied from interface: SoyMap

Gets the number of items in this SoyMap.

Specified by:

getItemCnt in interface SoyMap

Returns:

The number of items.

getItemKeys

public Collection<SoyValue> getItemKeys()

Description copied from interface: SoyMap

Gets an iterable over all item keys in this SoyMap.

Important: Iteration order is undefined.

Specified by:

getItemKeys in interface SoyMap

Returns:

An iterable over all item keys.

hasItem

public boolean hasItem(SoyValue key)

Description copied from interface: SoyMap

Checks whether this SoyMap has an item with the given key.

Specified by:

hasItem in interface SoyMap

Parameters:

key - The item key to check.

Returns:

Whether this SoyMap has an item with the given key.

getItem

public SoyValue getItem(SoyValue key)

Description copied from interface: SoyMap

Gets an item value of this SoyMap.

Specified by:

getItem in interface SoyMap

Parameters:

key - The item key to get.

Returns:

The item value for the given item key, or null if no such item key.

getItemProvider

public SoyValueProvider getItemProvider(SoyValue key)

Description copied from interface: SoyMap

Gets a provider of an item value of this SoyMap.

Specified by:

getItemProvider in interface SoyMap

Parameters:

key - The item key to get.

Returns:

A provider of the item value for the given item key, or null if no such item key.

equals

public boolean equals(Object other)

Description copied from interface: SoyValue

Compares this value against another for equality in the sense of the '==' operator of Soy.

Specified by:

equals in interface SoyValue

Specified by:

equals in class SoyAbstractValue

Parameters:

other - The other value to compare against.

Returns:

True if this value is equal to the other in the sense of Soy.

coerceToBoolean

public boolean coerceToBoolean()

Description copied from interface: SoyValue

Coerces this value into a boolean.

Specified by:

coerceToBoolean in interface SoyValue

Returns:

This value coerced into a boolean.

coerceToString

public String coerceToString()

Description copied from interface: SoyValue

Coerces this value into a string.

Specified by:

coerceToString in interface SoyValue

Returns:

This value coerced into a string.

render

public void render(LoggingAdvisingAppendable appendable)
            throws IOException

Description copied from interface: SoyValue

Renders this value to the given appendable.

This should behave identically to appendable.append(coerceToString()) but is provided separately to allow more incremental approaches.

Specified by:

render in interface SoyValue

Parameters:

appendable - The appendable to render to.

Throws:

IOException

toString

public String toString()

Returns a string that indicates the type of proto held, to assist in debugging Soy type errors.

Overrides:

toString in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object