Package org.springframework.ai.vectorstore

Class SimpleVectorStore

java.lang.Object

org.springframework.ai.vectorstore.observation.AbstractObservationVectorStore

org.springframework.ai.vectorstore.SimpleVectorStore

All Implemented Interfaces:

Consumer<List<Document>>, DocumentWriter, VectorStore, VectorStoreRetriever

public class SimpleVectorStore
extends AbstractObservationVectorStore

A simple, in-memory implementation of the VectorStore interface.

Uses a ConcurrentHashMap to store vectors and their associated metadata. Map keys are document IDs; values are SimpleVectorStoreContent instances that encapsulate each document's text, metadata, and embedding vector.

Similarity search is performed using cosine similarity over all stored vectors. Filter expressions on document metadata are evaluated via SimpleVectorStoreFilterExpressionEvaluator.

The store can be persisted to and restored from a JSON file via the save(java.io.File) and load(java.io.File) / load(org.springframework.core.io.Resource) methods.

NOTE: This implementation is not designed for production use and should only be used for testing or demonstration purposes.

Since:

1.0.0

Author:

Raphael Yu, Dingmeng Xue, Mark Pollack, Christian Tzolov, Sebastien Deleuze, Ilayaperumal Gopinathan, Thomas Vitale, Jemin Huh, David Yu

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	SimpleVectorStore.EmbeddingMath
static final class	SimpleVectorStore.SimpleVectorStoreBuilder

Nested classes/interfaces inherited from interface org.springframework.ai.vectorstore.VectorStore

VectorStore.Builder<T extends VectorStore.Builder<T>>

Field Summary

Fields

Modifier and Type	Field	Description
protected Map<String,org.springframework.ai.vectorstore.SimpleVectorStoreContent>	store

Fields inherited from class org.springframework.ai.vectorstore.observation.AbstractObservationVectorStore

batchingStrategy, embeddingModel

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	SimpleVectorStore(SimpleVectorStore.SimpleVectorStoreBuilder builder)

Method Summary

Modifier and Type	Method	Description
static SimpleVectorStore.SimpleVectorStoreBuilder	builder(EmbeddingModel embeddingModel)	Creates an instance of SimpleVectorStore builder.
VectorStoreObservationContext.Builder	createObservationContextBuilder(String operationName)	Create a new VectorStoreObservationContext.Builder instance.
void	doAdd(List<Document> documents)	Perform the actual add operation.
void	doDelete(List<String> idList)	Perform the actual delete operation.
void	doDelete(Filter.Expression filterExpression)	Template method for concrete implementations to provide filter-based deletion logic.
List<Document>	doSimilaritySearch(SearchRequest request)	Perform the actual similarity search operation.
void	load(File file)	Deserialize the vector store content from a file in JSON format into memory.
void	load(org.springframework.core.io.Resource resource)	Deserialize the vector store content from a resource in JSON format into memory.
void	save(File file)	Serialize the vector store content into a file in JSON format.

Methods inherited from class org.springframework.ai.vectorstore.observation.AbstractObservationVectorStore

add, delete, delete, similaritySearch

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.function.Consumer

andThen

Methods inherited from interface org.springframework.ai.document.DocumentWriter

write

Methods inherited from interface org.springframework.ai.vectorstore.VectorStore

accept, delete, getName, getNativeClient

Methods inherited from interface org.springframework.ai.vectorstore.VectorStoreRetriever

similaritySearch

Field Details

store

protected Map<String,org.springframework.ai.vectorstore.SimpleVectorStoreContent> store

Constructor Details

SimpleVectorStore

protected SimpleVectorStore(SimpleVectorStore.SimpleVectorStoreBuilder builder)

Method Details

builder

public static SimpleVectorStore.SimpleVectorStoreBuilder builder(EmbeddingModel embeddingModel)

Creates an instance of SimpleVectorStore builder.

Returns:

the SimpleVectorStore builder.

doAdd

public void doAdd(List<Document> documents)

Description copied from class: AbstractObservationVectorStore

Perform the actual add operation.

Specified by:

doAdd in class AbstractObservationVectorStore

Parameters:

documents - the documents to add

doDelete

public void doDelete(List<String> idList)

Description copied from class: AbstractObservationVectorStore

Perform the actual delete operation.

Specified by:

doDelete in class AbstractObservationVectorStore

Parameters:

idList - the list of document IDs to delete

doDelete

public void doDelete(Filter.Expression filterExpression)

Description copied from class: AbstractObservationVectorStore

Template method for concrete implementations to provide filter-based deletion logic.

Overrides:

doDelete in class AbstractObservationVectorStore

Parameters:

filterExpression - Filter expression to identify documents to delete

doSimilaritySearch

public List<Document> doSimilaritySearch(SearchRequest request)

Description copied from class: AbstractObservationVectorStore

Perform the actual similarity search operation.

Specified by:

doSimilaritySearch in class AbstractObservationVectorStore

Parameters:

request - the search request

Returns:

the list of documents that match the query request conditions

save

public void save(File file)

Serialize the vector store content into a file in JSON format.

Parameters:

file - the file to save the vector store content

load

public void load(File file)

Deserialize the vector store content from a file in JSON format into memory.

Parameters:

file - the file to load the vector store content

load

public void load(org.springframework.core.io.Resource resource)

Deserialize the vector store content from a resource in JSON format into memory.

Parameters:

resource - the resource to load the vector store content

createObservationContextBuilder

public VectorStoreObservationContext.Builder createObservationContextBuilder(String operationName)

Description copied from class: AbstractObservationVectorStore

Create a new VectorStoreObservationContext.Builder instance.

Specified by:

createObservationContextBuilder in class AbstractObservationVectorStore

Parameters:

operationName - the operation name

Returns:

the observation context builder