Fts4

public Fts4(
    @NonNull String tokenizer,
    @NonNull String[] tokenizerArgs,
    @NonNull KClass<@NonNull ?> contentEntity,
    @NonNull String languageId,
    @NonNull FtsOptions.MatchInfo matchInfo,
    @NonNull String[] notIndexed,
    @NonNull int[] prefix,
    @NonNull FtsOptions.Order order
)

public final @NonNull KClass<@NonNull ?> getContentEntity()

The external content entity who's mapping table will be used as content for the FTS table.

Declaring this value makes the mapping FTS table of this entity operate in "external content" mode. In such mode the FTS table does not store its own content but instead uses the data in the entity mapped table defined in this value. This option allows FTS4 to forego storing the text being indexed which can be used to achieve significant space savings.

In "external mode" the content table and the FTS table need to be synced. Room will create the necessary triggers to keep the tables in sync. Therefore, all write operations should be performed against the content entity table and not the FTS table.

The content sync triggers created by Room will be removed before migrations are executed and are re-created once migrations are complete. This prevents the triggers from interfering with migrations but means that if data needs to be migrated then write operations might need to be done in both the FTS and content tables.

See the External Content FTS4 Tables documentation for details.

public final @NonNull String getLanguageId()

The column name to be used as 'languageid'.

Allows the FTS4 extension to use the defined column name to specify the language stored in each row. When this is defined a field of type INTEGER with the same name must exist in the class.

FTS queries are affected by defining this option, see the languageid= option documentation for details.

public final @NonNull FtsOptions.MatchInfo getMatchInfo()

The FTS version used to store text matching information.

The default value is MatchInfo.FTS4. Disk space consumption can be reduced by setting this option to FTS3, see the matchinfo= option documentation for details.

public final @NonNull String[] getNotIndexed()

The list of column names on the FTS table that won't be indexed.

For details, see the notindexed= option documentation.

public final @NonNull FtsOptions.Order getOrder()

The preferred 'rowid' order of the FTS table.

The default value is Order.ASC. If many queries are run against the FTS table use ORDER BY row DESC then it may improve performance to set this option to Order.DESC, enabling the FTS module to store its data in a way that optimizes returning results in descending order by rowid.

public final @NonNull int[] getPrefix()

The list of prefix sizes to index.

For details, the prefix= option documentation.

public final @NonNull String getTokenizer()

The tokenizer to be used in the FTS table.

The default value is FtsOptions.TOKENIZER_SIMPLE. Tokenizer arguments can be defined with tokenizerArgs.

If a custom tokenizer is used, the tokenizer and its arguments are not verified at compile time.

For details, see SQLite tokernizers documentation

public final @NonNull String[] getTokenizerArgs()

Optional arguments to configure the defined tokenizer.

Tokenizer arguments consist of an argument name, followed by an "=" character, followed by the option value. For example, separators=. defines the dot character as an additional separator when using the FtsOptions.TOKENIZER_UNICODE61 tokenizer.

The available arguments that can be defined depend on the tokenizer defined, see the SQLite tokenizers documentation for details.