Deprecated API
Contents
-
Terminally Deprecated ElementsElementDescriptionUse the constructor with suppliers for Tika components if you intend to use this parser for multiple files and specify whether to include metadata or not.Use the constructor with suppliers for Tika components if you intend to use this parser for multiple files.This class has been moved to the `langchain4j-guardrails` module and will be removed in a future release. * Add a dependency on `dev.langchain4j:langchain4j-guardrails` and use the class from that module instead.use
DefaultMcpClient.Builder.toolResultConverter(McpToolResultConverter), which does not expose Jackson types. Setting both is rejected with anIllegalArgumentException.useDefaultMcpToolResultConverterinstead, which does not expose Jackson types.useMcpLogMessage(McpLogLevel, String, Object), which does not expose Jackson types.useMcpLogMessage.fromMap(Map), which does not expose Jackson types.useMcpException.withErrorData(int, String, String), which does not expose Jackson types.useMcpToolResultConverter, which does not expose Jackson types.useMcpProgressNotification.fromMap(Map), which does not expose Jackson types.useDockerMcpTransport.sendMessage(McpCallContext)instead, which does not expose Jackson types.useDockerMcpTransport.sendMessage(McpClientMessage)instead, which does not expose Jackson types.useDockerMcpTransport.sendRequest(McpCallContext)instead, which does not expose Jackson types.useDockerMcpTransport.sendRequest(McpClientMessage)instead, which does not expose Jackson types.useDockerMcpTransport.sendInitializeRequest(McpInitializeRequest)instead, which does not expose Jackson types.useStreamableHttpMcpTransport.sendMessage(McpCallContext)instead, which does not expose Jackson types.useStreamableHttpMcpTransport.sendMessage(McpClientMessage)instead, which does not expose Jackson types.useStreamableHttpMcpTransport.sendRequest(McpCallContext)instead, which does not expose Jackson types.useStreamableHttpMcpTransport.sendRequest(McpClientMessage)instead, which does not expose Jackson types.useStreamableHttpMcpTransport.sendInitializeRequest(McpInitializeRequest)instead, which does not expose Jackson types.useMcpOperationHandler.onMessage(String)instead, which does not expose Jackson types.useMcpOperationHandler.expectResponse(Long, CompletableFuture)instead, which does not expose Jackson types.implementMcpTransport.sendMessage(McpCallContext)instead, which is named for what MCP calls it. This default throws; it does not delegate, because two mutually-delegating defaults would recurse.implementMcpTransport.sendMessage(McpClientMessage)instead, which is named for what MCP calls it. This default throws; it does not delegate, because two mutually-delegating defaults would recurse.implementMcpTransport.sendRequest(McpCallContext)instead, which does not expose Jackson types. This default throws; it does not delegate, because two mutually-delegating defaults would recurse.implementMcpTransport.sendRequest(McpClientMessage)instead, which does not expose Jackson types. This default throws; it does not delegate, because two mutually-delegating defaults would recurse.implementMcpTransport.sendInitializeRequest(McpInitializeRequest)instead, which does not expose Jackson types. This default throws; it does not delegate, because two mutually-delegating defaults would recurse.useStdioMcpTransport.sendMessage(McpCallContext)instead, which does not expose Jackson types.useStdioMcpTransport.sendMessage(McpClientMessage)instead, which does not expose Jackson types.useStdioMcpTransport.sendRequest(McpCallContext)instead, which does not expose Jackson types.useStdioMcpTransport.sendRequest(McpClientMessage)instead, which does not expose Jackson types.useStdioMcpTransport.sendInitializeRequest(McpInitializeRequest)instead, which does not expose Jackson types.useWebSocketMcpTransport.sendMessage(McpCallContext)instead, which does not expose Jackson types.useWebSocketMcpTransport.sendMessage(McpClientMessage)instead, which does not expose Jackson types.useWebSocketMcpTransport.sendRequest(McpCallContext)instead, which does not expose Jackson types.useWebSocketMcpTransport.sendRequest(McpClientMessage)instead, which does not expose Jackson types.useWebSocketMcpTransport.sendInitializeRequest(McpInitializeRequest)instead, which does not expose Jackson types.This method is not supported on the official MCP registry anymore.useMcpMeta.publisherProvided(), which does not expose Jackson types.This field was removed in the 2025-09-29 version of the schema.This field was moved to the McpOfficialMeta object in schema version 2025-09-29please useAnthropicTool(Builder)insteadPlease usebuilder()instead, and explicitly set the model name and, if necessary, other parameters.Please usebuilder()instead, and explicitly set the model name and, if necessary, other parameters.Please useOpenAiChatModelfrom thelangchain4j-open-aimodule instead:ChatModel model = OpenAiChatModel.builder() .apiKey(System.getenv("HF_API_KEY")) .baseUrl("https://router.huggingface.co/v1") .modelName("HuggingFaceTB/SmolLM3-3B:hf-inference") .build();Please useOpenAiChatModelfrom thelangchain4j-open-aimodule instead:ChatModel model = OpenAiChatModel.builder() .apiKey(System.getenv("HF_API_KEY")) .baseUrl("https://router.huggingface.co/v1") .modelName("HuggingFaceTB/SmolLM3-3B:hf-inference") .build();useEmbeddingRequestfromlangchain4j-open-aimodule insteaduseEmbeddingResponsefromlangchain4j-open-aimodule insteadDo not use anymore, uselangchain4j-open-aimodule insteadDo not use anymore, uselangchain4j-open-aimodule insteadDo not use anymore, uselangchain4j-open-aimodule insteaduseOpenAiEmbeddingModelfromlangchain4j-open-aimodule insteadPlease usebuilder()instead, and explicitly set the baseUrl and, if necessary, other parameters. The default value for baseUrl will be removed in future releases!please useVertexAiGeminiChatModel(VertexAiGeminiChatModelBuilder)insteadplease useVertexAiGeminiStreamingChatModel(VertexAiGeminiStreamingChatModelBuilder)insteadPlease useVertexAiChatModel(Builder)insteadPlease useVertexAiEmbeddingModel(Builder)insteadOnly works with the V1 API, use theChromaEmbeddingStore(Builder)constructor instead.UseAbstractElasticsearchEmbeddingStore.fullTextSearchMatches(FullTextSearchRequest)instead. It returns the same text segments, but also the Elasticsearch document ID and the relevance score of each match.UseAbstractElasticsearchEmbeddingStore.fullTextSearchMatches(FullTextSearchRequest)instead. It also applies themaxResults,minScoreandfilterof the request.UseElasticsearchConfiguration.fullTextSearch(ElasticsearchClient, String, FullTextSearchRequest)instead. It also applies themaxResults,minScoreandfilterof the request.dev.langchain4j.store.embedding.elasticsearch.ElasticsearchEmbeddingStore.Builder.dimension(Integer) dimension is not used anymore.In favor ofEmbeddingVectorto avoid naming collisions
-
Deprecated InterfacesInterfaceDescriptionuse
McpToolResultConverter, which does not expose Jackson types.Do not use anymore, uselangchain4j-open-aimodule instead
-
Deprecated ClassesClassDescriptionThis class has been moved to the `langchain4j-guardrails` module and will be removed in a future release. * Add a dependency on `dev.langchain4j:langchain4j-guardrails` and use the class from that module instead.use
DefaultMcpToolResultConverterinstead, which does not expose Jackson types.Please useOpenAiChatModelfrom thelangchain4j-open-aimodule instead:ChatModel model = OpenAiChatModel.builder() .apiKey(System.getenv("HF_API_KEY")) .baseUrl("https://router.huggingface.co/v1") .modelName("HuggingFaceTB/SmolLM3-3B:hf-inference") .build();Please useOpenAiChatModelfrom thelangchain4j-open-aimodule instead:ChatModel model = OpenAiChatModel.builder() .apiKey(System.getenv("HF_API_KEY")) .baseUrl("https://router.huggingface.co/v1") .modelName("HuggingFaceTB/SmolLM3-3B:hf-inference") .build();useEmbeddingRequestfromlangchain4j-open-aimodule insteaduseEmbeddingResponsefromlangchain4j-open-aimodule insteadDo not use anymore, uselangchain4j-open-aimodule insteadDo not use anymore, uselangchain4j-open-aimodule insteaduseOpenAiEmbeddingModelfromlangchain4j-open-aimodule instead
-
Deprecated Annotation Interfaces
-
Deprecated MethodsMethodDescriptionUse
AgentBuilder.maxToolCallingRoundTrips(int)instead.useDefaultMcpClient.Builder.toolResultConverter(McpToolResultConverter), which does not expose Jackson types. Setting both is rejected with anIllegalArgumentException.useMcpLogMessage.fromMap(Map), which does not expose Jackson types.Roots are deprecated in MCP protocol version 2026-07-28. This method throwsUnsupportedOperationExceptionwhen the modern protocol is in use.UseMcpClient.subscribeToResources(List)for MCP 2026-07-28 and later. ThrowsUnsupportedOperationExceptionwhen using the modern protocol.UseMcpClient.unsubscribeFromResources(long)for MCP 2026-07-28 and later. ThrowsUnsupportedOperationExceptionwhen using the modern protocol.useMcpProgressNotification.fromMap(Map), which does not expose Jackson types.misspelled method name, useDockerMcpTransport.Builder.dockerTlsVerify(Boolean)instead.useDockerMcpTransport.sendMessage(McpCallContext)instead, which does not expose Jackson types.useDockerMcpTransport.sendMessage(McpClientMessage)instead, which does not expose Jackson types.useDockerMcpTransport.sendRequest(McpCallContext)instead, which does not expose Jackson types.useDockerMcpTransport.sendRequest(McpClientMessage)instead, which does not expose Jackson types.useDockerMcpTransport.sendInitializeRequest(McpInitializeRequest)instead, which does not expose Jackson types.useStreamableHttpMcpTransport.sendMessage(McpCallContext)instead, which does not expose Jackson types.useStreamableHttpMcpTransport.sendMessage(McpClientMessage)instead, which does not expose Jackson types.useStreamableHttpMcpTransport.sendRequest(McpCallContext)instead, which does not expose Jackson types.useStreamableHttpMcpTransport.sendRequest(McpClientMessage)instead, which does not expose Jackson types.useStreamableHttpMcpTransport.sendInitializeRequest(McpInitializeRequest)instead, which does not expose Jackson types.useMcpOperationHandler.onMessage(String)instead, which does not expose Jackson types.useMcpOperationHandler.expectResponse(Long, CompletableFuture)instead, which does not expose Jackson types.implementMcpTransport.sendMessage(McpCallContext)instead, which is named for what MCP calls it. This default throws; it does not delegate, because two mutually-delegating defaults would recurse.implementMcpTransport.sendMessage(McpClientMessage)instead, which is named for what MCP calls it. This default throws; it does not delegate, because two mutually-delegating defaults would recurse.implementMcpTransport.sendRequest(McpCallContext)instead, which does not expose Jackson types. This default throws; it does not delegate, because two mutually-delegating defaults would recurse.implementMcpTransport.sendRequest(McpClientMessage)instead, which does not expose Jackson types. This default throws; it does not delegate, because two mutually-delegating defaults would recurse.implementMcpTransport.sendInitializeRequest(McpInitializeRequest)instead, which does not expose Jackson types. This default throws; it does not delegate, because two mutually-delegating defaults would recurse.useStdioMcpTransport.sendMessage(McpCallContext)instead, which does not expose Jackson types.useStdioMcpTransport.sendMessage(McpClientMessage)instead, which does not expose Jackson types.useStdioMcpTransport.sendRequest(McpCallContext)instead, which does not expose Jackson types.useStdioMcpTransport.sendRequest(McpClientMessage)instead, which does not expose Jackson types.useStdioMcpTransport.sendInitializeRequest(McpInitializeRequest)instead, which does not expose Jackson types.useWebSocketMcpTransport.sendMessage(McpCallContext)instead, which does not expose Jackson types.useWebSocketMcpTransport.sendMessage(McpClientMessage)instead, which does not expose Jackson types.useWebSocketMcpTransport.sendRequest(McpCallContext)instead, which does not expose Jackson types.useWebSocketMcpTransport.sendRequest(McpClientMessage)instead, which does not expose Jackson types.useWebSocketMcpTransport.sendInitializeRequest(McpInitializeRequest)instead, which does not expose Jackson types.This method is not supported on the official MCP registry anymore.useMcpMeta.publisherProvided(), which does not expose Jackson types.This field was removed in the 2025-09-29 version of the schema.This field was moved to the McpOfficialMeta object in schema version 2025-09-29Please usebuilder()instead, and explicitly set the model name and, if necessary, other parameters.Proxy configuration viaproxy(...)is no longer supported since the migration to the langchain4j HttpClient abstraction. Passing a non-null proxy will cause anUnsupportedOperationExceptionwhen the model is built. To configure a proxy, supply a customHttpClientBuilderviaCohereScoringModel.CohereScoringModelBuilder.httpClientBuilder(HttpClientBuilder)instead.Please usebuilder()instead, and explicitly set the model name and, if necessary, other parameters.Functions are deprecated by OpenAI, useOpenAiUtils.toTools(Collection, boolean)insteadPlease usebuilder()instead, and explicitly set the baseUrl and, if necessary, other parameters. The default value for baseUrl will be removed in future releases!UseAiServices.maxToolCallingRoundTrips(int)instead.useAiServices.tools(List)instead in order to specifyReturnBehavioruseAiServiceTool.returnBehavior()insteadPlease setToolErrorContext.Builder.invocationContext(InvocationContext)insteadPlease useToolExecution.Builder.result(ToolExecutionResult)insteaduseToolProviderResult.aiServiceTools()to get tool'sReturnBehavioruseToolProviderResult.aiServiceTools()insteaduseToolService.returnBehavior(String)insteadUseToolService.maxToolCallingRoundTrips()instead.UseToolService.maxToolCallingRoundTrips(int)instead.useToolService.toolProviders()insteaduseToolServiceContext.Builder.returnBehaviors(Map)insteaduseToolServiceContext.Builder.effectiveTools(List)insteaduseToolServiceContext.returnBehavior(String)insteaduseToolServiceContext.effectiveTools()insteadPlease useToolServiceResult.aggregateResponse()instead for clarityUseAbstractElasticsearchEmbeddingStore.fullTextSearchMatches(FullTextSearchRequest)instead. It returns the same text segments, but also the Elasticsearch document ID and the relevance score of each match.UseAbstractElasticsearchEmbeddingStore.fullTextSearchMatches(FullTextSearchRequest)instead. It also applies themaxResults,minScoreandfilterof the request.UseElasticsearchConfiguration.fullTextSearch(ElasticsearchClient, String, FullTextSearchRequest)instead. It also applies themaxResults,minScoreandfilterof the request.dev.langchain4j.store.embedding.elasticsearch.ElasticsearchEmbeddingStore.Builder.dimension(Integer) dimension is not used anymore.
-
Deprecated ConstructorsConstructorDescriptionUse the constructor with suppliers for Tika components if you intend to use this parser for multiple files and specify whether to include metadata or not.Use the constructor with suppliers for Tika components if you intend to use this parser for multiple files.use
McpLogMessage(McpLogLevel, String, Object), which does not expose Jackson types.useMcpException.withErrorData(int, String, String), which does not expose Jackson types.please useAnthropicTool(Builder)insteadplease useAnthropicToolSchema(Builder)insteadplease useVertexAiGeminiChatModel(VertexAiGeminiChatModelBuilder)insteadplease useVertexAiGeminiStreamingChatModel(VertexAiGeminiStreamingChatModelBuilder)insteadPlease useVertexAiChatModel(Builder)insteadPlease useVertexAiEmbeddingModel(Builder)insteaduseToolServiceContext(Builder)insteadPlease useToolServiceResult(Builder)insteadOnly works with the V1 API, use theChromaEmbeddingStore(Builder)constructor instead.
-
Deprecated Enum ConstantsEnum ConstantDescriptionDALL-E models have been deprecated by OpenAI. Use
OpenAiImageModelName.GPT_IMAGE_1or other GPT image models instead.DALL-E models have been deprecated by OpenAI. UseOpenAiImageModelName.GPT_IMAGE_1or other GPT image models instead.