qidao123.com技术社区-IT企服评测·应用市场»论坛 › 软件与程序人生 › DevOps与敏捷开发 › 【LangChain4j快速入门】5分钟用Java接入AI大模型，Spri ...

【LangChain4j快速入门】5分钟用Java接入AI大模型，Spring Boot整合实战！| 附源码

[复制链接]
发表于 2025-9-23 02:18:46 | 显示全部楼层 |阅读模式
【LangChain4j快速入门】5分钟用Java接入AI大模型，Spring Boot整合实战！

媒介：当Java遇上大模型

在AI浪潮席卷环球的本日，Java开辟者怎样快速拥抱大语言模型？LangChain4j作为专为Java打造的AI开辟框架，以极简的API筹划和强盛的扩展本领，让集成ChatGPT、GPT-4o-mini等模型变得非常轻松！本文将带你通过实战代码+图文详解，5分钟完成Spring Boot与GPT-4o-mini的对接，开启你的AI应用开辟之旅！
一、情况准备：闪电战设置

1.1 添加关键依靠

在Spring Boot项目标pom.xml中加入LangChain4j核心库与OpenAI扩展：
  1. <dependency>
  2.     <groupId>dev.langchain4j</groupId>
  3.     <artifactId>langchain4j-open-ai</artifactId>
  4.     <version>1.0.0-beta3</version>
  5. </dependency>
  6. <dependency>
  7.     <groupId>dev.langchain4j</groupId>
  8.     <artifactId>langchain4j</artifactId>
  9.     <version>1.0.0-beta3</version>
  10. </dependency>
复制代码
1.2 申请密钥（零门槛！）



  • 正式情况：通过OpenAI平台获取API Key
  • 尝鲜体验：直接利用官方Demo Key（配额有限，仅支持gpt-4o-mini）
  1. // 配置类中直接使用demo密钥
  2. .baseUrl("http://langchain4j.dev/demo/openai/v1")
  3. .apiKey("demo")
复制代码


  • ⚠️如果你没有API密钥怎么办？
如果你没有本身的OpenAI API密钥，别担心。你可以暂时利用官方免费提供的演示密钥，用于演示目标。请注意，当利用演示密钥时，全部对OpenAI API的请求都需要通过官方的署理服务器，该代分析在将你的请求转发给OpenAI API之前注入真实的密钥。官方不会以任何方式收集或利用你的数据。演示密钥有配额限制，仅限于gpt-4o-mini模型，并且只应用于演示目标。
  1. OpenAiChatModel model = OpenAiChatModel.builder()
  2.     .baseUrl("http://langchain4j.dev/demo/openai/v1")
  3.     .apiKey("demo")
  4.     .modelName("gpt-4o-mini")
  5.     .build();
复制代码
1.3设置application.yml

  1. spring:
  2.   application:
  3.     name: AI
  5.   ai:
  6.     openai:
  7.       api-key: "demo"
  8.       base-url: "http://langchain4j.dev/demo/openai/v1"
复制代码
二、核心实现：3步构建AI谈天接口

2.1 模型设置（智能引擎）

  1. @Configuration
  2. public class LangChain4jConfig {
  3.     @Bean
  4.     public ChatLanguageModel chatLanguageModel() {
  5.         return OpenAiChatModel.builder()
  6.                 .baseUrl("http://langchain4j.dev/demo/openai/v1")
  7.                 .apiKey("demo") // 替换为真实KEY时移除baseUrl
  8.                 .modelName("gpt-4o-mini") // 最新轻量级模型
  9.                 .build();
  10.     }
  11. }
复制代码
关键点分析：


  • baseUrl仅在利用Demo Key时需要
  • modelName指定模型版本，保举性能优秀的gpt-4o-mini
2.2 谈天控制器（对话大脑）

  1. @RestController
  2. @RequestMapping("/ai")
  3. public class ChatController {
  4.     private final ChatLanguageModel model;
  5.     private final ChatMemory chatMemory; // 自动记忆上下文
  7.     @GetMapping(value = "/chat", produces = "text/plain;charset=utf-8")
  8.     public Mono<String> chat(@RequestParam String message) {
  9.         UserMessage userMsg = UserMessage.from("你叫小智，是一个人工智能\n" + message);
  10.         chatMemory.add(userMsg);
  11.         
  12.         AiMessage aiMsg = model.chat(chatMemory.messages()).aiMessage();
  13.         chatMemory.add(aiMsg);
  14.         
  15.         return Mono.just(aiMsg.text());
  16.     }
  17. }
复制代码
  1. package org.example.ai.config;
  3. import dev.langchain4j.memory.ChatMemory;
  4. import dev.langchain4j.memory.chat.MessageWindowChatMemory;
  5. import dev.langchain4j.store.memory.chat.ChatMemoryStore;
  6. import dev.langchain4j.store.memory.chat.InMemoryChatMemoryStore;
  7. import org.springframework.context.annotation.Bean;
  8. import org.springframework.context.annotation.Configuration;
  10. @Configuration
  11. public class CommonConfiguration {
  13.     /**
  14.      * 定义一个基于消息数量限制的 ChatMemory Bean
  15.      */
  16.     @Bean
  17.     public ChatMemory messageWindowChatMemory(ChatMemoryStore chatMemoryStore) {
  18.         return MessageWindowChatMemory.builder()
  19.                 .id("session-1") // 会话 ID
  20.                 .maxMessages(10) // 最大消息数量
  21.                 .chatMemoryStore(chatMemoryStore) // 持久化存储
  22.                 .build();
  23.     }
  25.     /**
  26.      * 定义一个简单的内存存储实现
  27.      */
  28.     @Bean
  29.     public ChatMemoryStore inMemoryChatMemoryStore() {
  30.         return new InMemoryChatMemoryStore();
  31.     }
  32. }
复制代码
亮点功能：


  • ChatMemory自动维护对话上下文
  • 逼迫UTF-8编码解决中文乱码
  • 相应式编程支持（Mono）


三、效果验证：你的第一个AI接口

启动应用后访问：
  1. http://localhost:8080/ai/chat?message=讲个程序员笑话
复制代码
预期相应：
  1. 好的，主人！为什么程序员总把万圣节和圣诞节搞混？
  2. 因为 Oct 31 == Dec 25！（Octal 31 = Decimal 25）
复制代码

加入前端代码
  1. <!DOCTYPE html>
  2. <html lang="zh-CN">
  3. <head>
  4.     <meta charset="UTF-8">
  5.     <meta name="viewport" content="width=device-width, initial-scale=1.0">
  6.     <title>小智AI助手</title>
  7.     <script src="https://unpkg.com/vue@3/dist/vue.global.js"></script>
  8.     <style>
  9.         /* 现代聊天界面样式 */
  10.         :root {
  11.             --primary: #4CAF50;
  12.             --bg: #f5f5f5;
  13.             --user-bg: #e3f2fd;
  14.             --ai-bg: #ffffff;
  15.         }
  17.         body {
  18.             margin: 0;
  19.             font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
  20.             background: var(--bg);
  21.         }
  23.         .chat-container {
  24.             max-width: 800px;
  25.             margin: 20px auto;
  26.             border-radius: 12px;
  27.             box-shadow: 0 2px 15px rgba(0,0,0,0.1);
  28.             background: white;
  29.             height: 90vh;
  30.             display: flex;
  31.             flex-direction: column;
  32.         }
  34.         .messages {
  35.             flex: 1;
  36.             overflow-y: auto;
  37.             padding: 20px;
  38.             display: flex;
  39.             flex-direction: column;
  40.             gap: 15px;
  41.         }
  43.         .message {
  44.             max-width: 70%;
  45.             padding: 12px 16px;
  46.             border-radius: 18px;
  47.             animation: fadeIn 0.3s ease;
  48.         }
  50.         .user-message {
  51.             background: var(--user-bg);
  52.             align-self: flex-end;
  53.             border-bottom-right-radius: 4px;
  54.         }
  56.         .ai-message {
  57.             background: var(--ai-bg);
  58.             align-self: flex-start;
  59.             border-bottom-left-radius: 4px;
  60.             box-shadow: 0 2px 4px rgba(0,0,0,0.05);
  61.         }
  63.         .loading-dots {
  64.             display: inline-block;
  65.             font-size: 24px;
  66.         }
  67.         .loading-dots::after {
  68.             content: '...';
  69.             animation: dots 1.5s infinite;
  70.         }
  72.         .input-area {
  73.             padding: 20px;
  74.             border-top: 1px solid #eee;
  75.             display: flex;
  76.             gap: 10px;
  77.         }
  79.         input {
  80.             flex: 1;
  81.             padding: 12px;
  82.             border: 1px solid #ddd;
  83.             border-radius: 25px;
  84.             font-size: 16px;
  85.             outline: none;
  86.             transition: 0.3s;
  87.         }
  88.         input:focus {
  89.             border-color: var(--primary);
  90.             box-shadow: 0 0 0 3px rgba(76,175,80,0.1);
  91.         }
  93.         button {
  94.             padding: 12px 24px;
  95.             background: var(--primary);
  96.             border: none;
  97.             border-radius: 25px;
  98.             color: white;
  99.             cursor: pointer;
  100.             transition: 0.3s;
  101.         }
  102.         button:disabled {
  103.             opacity: 0.7;
  104.             cursor: not-allowed;
  105.         }
  107.         @keyframes dots {
  108.             0%, 20% { content: '.'; }
  109.             40% { content: '..'; }
  110.             60%, 100% { content: '...'; }
  111.         }
  113.         @keyframes fadeIn {
  114.             from { opacity: 0; transform: translateY(10px); }
  115.             to { opacity: 1; transform: translateY(0); }
  116.         }
  117.     </style>
  118. </head>
  119. <body>
  120. <div id="app">
  121.     <div class="chat-container">
  122.         <div class="messages">
  123.             <div v-for="(msg, index) in messages"
  124.                  :key="index"
  125.                  :class="['message', msg.role === 'user' ? 'user-message' : 'ai-message']">
  126.                 {{ msg.content }}
  127.             </div>
  128.             <div v-if="loading" class="message ai-message">
  129.                 <span class="loading-dots"></span>
  130.             </div>
  131.         </div>
  132.         <div class="input-area">
  133.             <input
  134.                     v-model="inputMessage"
  135.                     @keyup.enter="sendMessage"
  136.                     placeholder="和小智聊天吧～"
  137.                     :disabled="loading"
  138.             >
  139.             <button @click="sendMessage" :disabled="!inputMessage || loading">
  140.                 {{ loading ? '思考中' : '发送' }}
  141.             </button>
  142.         </div>
  143.     </div>
  144. </div>
  146. <script>
  147.     const { createApp } = Vue;
  149.     createApp({
  150.         data() {
  151.             return {
  152.                 messages: [],
  153.                 inputMessage: '',
  154.                 loading: false
  155.             }
  156.         },
  157.         methods: {
  158.             async sendMessage() {
  159.                 if (!this.inputMessage.trim() || this.loading) return;
  161.                 const userMessage = this.inputMessage;
  162.                 this.messages.push({ role: 'user', content: userMessage });
  163.                 this.inputMessage = '';
  164.                 this.loading = true;
  166.                 try {
  167.                     const response = await fetch(`/ai/chat?message=${encodeURIComponent(userMessage)}`);
  168.                     const text = await response.text();
  169.                     this.messages.push({ role: 'assistant', content: text });
  170.                 } catch (error) {
  171.                     this.messages.push({
  172.                         role: 'assistant',
  173.                         content: '哎呀，小智暂时无法连接，请稍后再试～'
  174.                     });
  175.                 } finally {
  176.                     this.loading = false;
  177.                     this.scrollToBottom();
  178.                 }
  179.             },
  180.             scrollToBottom() {
  181.                 this.$nextTick(() => {
  182.                     const container = document.querySelector('.messages');
  183.                     container.scrollTop = container.scrollHeight;
  184.                 });
  185.             }
  186.         },
  187.         mounted() {
  188.             // 初始欢迎语
  189.             this.messages.push({
  190.                 role: 'assistant',
  191.                 content: '你好！我是小智，有什么可以帮您的？'
  192.             });
  193.         }
  194.     }).mount('#app');
  195. </script>
  196. </body>
  197. </html>
复制代码
完备代码
  1. package org.example.ai.config;
  3. import dev.langchain4j.model.chat.ChatLanguageModel;
  4. import dev.langchain4j.model.openai.OpenAiChatModel;
  5. import org.springframework.context.annotation.Bean;
  6. import org.springframework.context.annotation.Configuration;
  8. @Configuration
  9. public class LangChain4jConfig {
  11.     @Bean
  12.     public ChatLanguageModel chatLanguageModel() {
  13.         return OpenAiChatModel.builder()
  14.                 .baseUrl("http://langchain4j.dev/demo/openai/v1")
  15.                 .apiKey("demo")
  16.                 .modelName("gpt-4o-mini")
  17.                 .build();
  18.     }
  19. }
复制代码
  1. package org.example.ai.config;
  3. import dev.langchain4j.memory.ChatMemory;
  4. import dev.langchain4j.memory.chat.MessageWindowChatMemory;
  5. import dev.langchain4j.store.memory.chat.ChatMemoryStore;
  6. import dev.langchain4j.store.memory.chat.InMemoryChatMemoryStore;
  7. import org.springframework.context.annotation.Bean;
  8. import org.springframework.context.annotation.Configuration;
  10. @Configuration
  11. public class CommonConfiguration {
  13.     /**
  14.      * 定义一个基于消息数量限制的 ChatMemory Bean
  15.      */
  16.     @Bean
  17.     public ChatMemory messageWindowChatMemory(ChatMemoryStore chatMemoryStore) {
  18.         return MessageWindowChatMemory.builder()
  19.                 .id("session-1") // 会话 ID
  20.                 .maxMessages(10) // 最大消息数量
  21.                 .chatMemoryStore(chatMemoryStore) // 持久化存储
  22.                 .build();
  23.     }
  25.     /**
  26.      * 定义一个简单的内存存储实现
  27.      */
  28.     @Bean
  29.     public ChatMemoryStore inMemoryChatMemoryStore() {
  30.         return new InMemoryChatMemoryStore();
  31.     }
  32. }
复制代码
  1. package org.example.ai.controller;
  3. import dev.langchain4j.data.message.AiMessage;
  4. import dev.langchain4j.data.message.UserMessage;
  5. import dev.langchain4j.memory.ChatMemory;
  6. import dev.langchain4j.model.chat.ChatLanguageModel;
  7. import lombok.RequiredArgsConstructor;
  8. import org.springframework.web.bind.annotation.*;
  9. import reactor.core.publisher.Mono;
  11. @RestController
  12. @RequestMapping("/ai")
  13. @RequiredArgsConstructor
  14. public class ChatController {
  16.     private final ChatLanguageModel chatLanguageModel;
  17.     private final ChatMemory chatMemory;
  19.     @RequestMapping (value = "/chat", produces = "text/plain;charset=utf-8")
  20.     public Mono<String> chat(@RequestParam(required = false, defaultValue = "") String message) {
  21.         UserMessage userMessage = UserMessage.from("你叫小智，是一个人工智能\n" + message);
  22.         chatMemory.add(userMessage);
  24.         AiMessage aiMessage = chatLanguageModel.chat(chatMemory.messages()).aiMessage();
  25.         chatMemory.add(aiMessage);
  27.         return Mono.just(aiMessage.text());
  28.     }
  29. }
复制代码

四、生产级优化发起


  • 密钥安全：通过application.yml设置，制止硬编码
    1. langchain4j:
    2.   openai:
    3.     api-key: ${OPENAI_API_KEY}
    复制代码
  • 限流降级：集成Resilience4j实现请求限流
  • 性能监控监控：通过Micrometer对接Prometheus
  • 上下文管理：利用PersistentChatMemory实现对话长期化
总结：为什么选择LangChain4j？

通过本文实战，我们体验到了：
✅ 极简集成：5行代码对接GPT-4o-mini
✅ 开箱即用：自动影象管理、流式相应支持
✅ 生态丰富：支持20+模型厂商，轻松切换
✅ Spring Boot友爱：自动设置+依靠注入
下一步探索：


  • 实验AI服务(Assistant API)实现复杂逻辑
  • 结合Embedding实现RAG知识库
  • 利用Tools API让模型调用外部服务
立刻访问LangChain4j官网开启你的AI应用开辟之旅！如果你在实践过程中碰到任何题目，欢迎在品评区留言交换~

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
继续阅读请点击广告

本帖子中包含更多资源

您需要 登录 才可以下载或查看，没有账号？立即注册

×
回复

使用道具 举报

返回列表

美丽的神话
+ 我要发帖
×
登录参与点评抽奖，加入IT实名职场社区
去登录
快速回复 返回顶部 返回列表