com.android.builder.symbols

Class SymbolTable

java.lang.Object

com.android.builder.symbols.SymbolTable

public abstract class SymbolTable
extends java.lang.Object

List of symbols identifying resources in an Android application. Symbol tables do not only exist for applications: they can be used for other building blocks for applications, such as libraries or atoms.

A symbol table keeps a list of instances of Symbol, each one with a unique pair class / name. Tables have one main attribute: a package name. This should be unique and are used to generate the R.java file.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SymbolTable.Builder Builder that creates a symbol table.

Constructor Summary

Constructors

Constructor and Description
SymbolTable()

Method Summary

Modifier and Type	Method and Description
static SymbolTable.Builder	builder() Creates a new builder to create a SymbolTable.
SymbolTable	filter(SymbolTable table) Produces a subset of this symbol table that has the symbols with resource type / name defined in filter.
abstract com.google.common.collect.ImmutableTable<com.android.resources.ResourceType,java.lang.String,Symbol>	getSymbols()
abstract java.lang.String	getTablePackage() Returns the table package.
static SymbolTable	merge(java.util.List<SymbolTable> tables) Merges a list of tables into a single table.
SymbolTable	merge(SymbolTable m) Short for merging this and m.
SymbolTable	rename(java.lang.String tablePackage) Builds a new symbol table that has the same symbols as this one, but was renamed with the given package.

Methods inherited from class java.lang.Object

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

Constructor Detail

SymbolTable

public SymbolTable()

Method Detail

getTablePackage

@NonNull
public abstract java.lang.String getTablePackage()

Returns the table package. See class description.

getSymbols

@NonNull
public abstract com.google.common.collect.ImmutableTable<com.android.resources.ResourceType,java.lang.String,Symbol> getSymbols()

filter

@NonNull
public SymbolTable filter(@NonNull
                                   SymbolTable table)

Produces a subset of this symbol table that has the symbols with resource type / name defined in filter. In other words, a symbol s will exist in the result if and only if s exists in this and there is a symbol s1 in table such that s.resourceType == s1.resourceType && s.name == s1.name.

Parameters:

table - the filter table

Returns:

the filter result; this table will have the same name and package as this one

merge

@NonNull
public SymbolTable merge(@NonNull
                                  SymbolTable m)

Short for merging this and m.

Parameters:

m - the table to add to this

Returns:

the result of merging this with m

rename

@NonNull
public SymbolTable rename(@NonNull
                                   java.lang.String tablePackage)

Builds a new symbol table that has the same symbols as this one, but was renamed with the given package.

Parameters:

tablePackage - the table package

Returns:

the new renamed symbol table

merge

@NonNull
public static SymbolTable merge(@NonNull
                                         java.util.List<SymbolTable> tables)

Merges a list of tables into a single table. The merge is order-sensitive: when multiple symbols with the same class / name exist in multiple tables, the first one will be used.

Parameters:

tables - the tables to merge

Returns:

the table with the result of the merge; this table will have the package of the first table in tables, or the default one if there are no tables in tables

builder

@NonNull
public static SymbolTable.Builder builder()

Creates a new builder to create a SymbolTable.

Returns:

a builder