1. 项目概述
在Java生态中开发AI应用一直是个痛点,传统方式需要手动处理HTTP请求、管理对话历史、实现知识库检索等功能,代码冗长且难以维护。LangChain4j作为Java版的LangChain框架,彻底改变了这一局面。它让开发者能够像编写普通业务代码一样轻松集成AI能力,大幅提升了开发效率。
我在最近的一个企业级项目中,成功将LangChain4j集成到若依(RuoYi)单体应用中,实现了包括多轮对话、流式输出、RAG知识库等在内的五大核心AI功能。整个过程让我深刻体会到LangChain4j的强大之处——它通过声明式接口和自动化组件管理,将复杂的AI功能简化为几行代码就能实现的服务。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 为什么选择LangChain4j
2.1 传统方式的痛点
在没有框架支持的情况下,Java开发者通常需要手动编写HTTP客户端代码来调用AI服务。这不仅代码量大,而且难以维护。以调用OpenAI为例,传统方式需要:
java复制public String chat(String message) {
// 手动构建请求体
String requestBody = """
{
"model": "gpt-4",
"messages": [
{"role": "user", "content": "%s"}
]
}
""".formatted(message);
// 手动发HTTP请求
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.openai.com/v1/chat/completions"))
.header("Authorization", "Bearer " + apiKey)
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(requestBody))
.build();
// 手动解析响应
HttpResponse<String> response = client.send(request, ...);
JSONObject json = JSON.parseObject(response.body());
return json.getJSONArray("choices")
.getJSONObject(0)
.getJSONObject("message")
.getString("content");
}
这种方式存在诸多问题:
- 每次调用都要重复编写HTTP请求代码
- 没有内置的对话历史管理
- 缺乏知识库检索能力
- 切换AI模型需要重构大量代码
- 难以实现流式输出等高级功能
2.2 LangChain4j的优势
LangChain4j通过声明式接口和自动化组件管理,完美解决了上述问题。使用LangChain4j,同样的功能可以简化为:
java复制@AiService
public interface CustomerAssistant {
@SystemMessage("你是若依系统的智能客服,请用中文回答用户问题")
String chat(@MemoryId String userId, @UserMessage String message);
}
// 使用
@Autowired
CustomerAssistant assistant;
String reply = assistant.chat("user123", "如何重置密码?");
LangChain4j会自动处理:
- HTTP请求的发送和响应解析
- 对话历史的管理
- 模型切换的适配
- 高级功能的实现
3. 环境准备与集成
3.1 版本要求
在开始集成前,需要确保开发环境满足以下要求:
| 环境 | 要求 |
|---|---|
| JDK | 17+ (LangChain4j 1.x最低要求) |
| Spring Boot | 2.7.x或3.x |
| LangChain4j | 1.12.2 |
| 若依单体 | 3.8.x |
注意:若依默认使用JDK 8,而LangChain4j 1.x需要JDK 17+。如果无法升级JDK,可以使用LangChain4j 0.36.x版本(支持JDK 8)。
3.2 依赖配置
在若依单体的pom.xml中添加以下依赖:
xml复制<!-- LangChain4j BOM(统一版本管理) -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>dev.langchain4j</groupId>
<artifactId>langchain4j-bom</artifactId>
<version>1.12.2</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<!-- LangChain4j核心 -->
<dependency>
<groupId>dev.langchain4j</groupId>
<artifactId>langchain4j-spring-boot-starter</artifactId>
<version>1.12.2-beta22</version>
</dependency>
<!-- 使用OpenAI -->
<dependency>
<groupId>dev.langchain4j</groupId>
<artifactId>langchain4j-open-ai-spring-boot-st
