Merge pull request #4 from j-AIWG/add-langchain4j-articles

add articles on langchain4j

Author: LizeRaes

educational-resource/docs/10-genai/30-using-llms-in-code/30-frameworks/10-langchain4j/20-langchain4j-deepdive-with-code.md

@@ -4,7 +4,7 @@ sidebar_position: 10
 hide_title: true
 
 level: beginner
-status: missing
+status: published
 visibility: public
 
 # OPTIONAL TAGS:
@@ -15,10 +15,59 @@ visibility: public
 programming-language: "Java"  # or others
 ---
 
-:::note ⚠️ This article is still missing
-This content has not been written yet. Help us create it!
-:::
+# LangChain4j
 
-# Frameworks
+LangChain4j is one of the two popular Java libraries for easy interaction with LLMs.
 
-Help us write this landing page
+<img src="/java-ai-resource/img/10-genai/30-using-llms-in-code/30-frameworks/langchain4j_logo.png" alt="LangChain4j Logo" style={{width: '30%', display: 'block', margin: 'auto'}} />
+
+<br />
+
+Calling a model is as simple as:
+
+```java
+ChatLanguageModel model = OpenAiChatModel.builder()
+    .apiKey("your key")
+    .modelName("gpt-4o-mini")
+    .build();
+
+String answer = model.generate("Hello, how are you?");
+System.out.println(answer);
+```
+
+And creating an app where the LLM generates Java objects (output parsing), can call tools, has a memory and access to extra context (RAG) would be as simple as:
+
+```java
+interface CustomerAssistant {
+    @SystemMessage("You are a helpful customer service assistant")
+    @UserMessage("You create a stepwise plan for the user that submitted: {{message}}")
+    List<String> assist(@MemoryId String customerId, String message);
+}
+
+CustomerAssistant assistant = AiServices.builder(CustomerAssistant.class)
+    .chatLanguageModel(model)
+    .chatMemory(MessageWindowChatMemory.withMaxMessages(10))
+    .retrievalAugmentor(DefaultRetrievalAugmentor.builder()
+        .contentRetriever(serviceTermsEmbeddingStoreRetriever)
+        .build())
+    .tools(new BookingManagementTools())
+    .build();
+```
+
+LangChain4j is framework-agnostic: it works standalone (vanilla) and has strong integrations with **Quarkus**, **Spring Boot**, and integrations with **Micronaut** for example.
+
+You can watch an engaging overview of most features in our [LangChain4j overview video](https://www.youtube.com/watch?v=BD1MSLbs9KE).
+
+Read through our [deep dive article](./20-langchain4j-deepdive-with-code.md) to see code examples of these and more advanced features.
+
+Or get your hands dirty and go through our comprehensive, self-explanatory [code tutorial repository](https://github.com/langchain4j/langchain4j-examples/tree/main/tutorials), which includes special folders for [Spring Boot examples](https://github.com/langchain4j/langchain4j-examples/tree/main/spring-boot-example) and [RAG examples](https://github.com/langchain4j/langchain4j-examples/tree/main/rag-examples).
+
+For supported model providers, check out our [model integrations documentation](https://docs.langchain4j.dev/integrations/language-models/), which covers all popular commercial providers like OpenAI's GPT models, Google's Gemini, Anthropic's Claude, etc., as well as local models via Ollama, JLama, and others.
+
+For embedding store integrations, see our [embedding store documentation](https://docs.langchain4j.dev/integrations/embedding-stores/).
+
+You'll find ample examples of how to use each of these features in our [main examples repository](https://github.com/langchain4j/langchain4j-examples).
+
+---
+
+*Written by Lize Raes*

educational-resource/docs/10-genai/30-using-llms-in-code/30-frameworks/10-langchain4j/index.md

@@ -88,6 +88,8 @@ n_10_genai_30_using_llms_in_code_30_frameworks_10_langchain4j["LangChain4j ☕
 n_10_genai_30_using_llms_in_code_30_frameworks --> n_10_genai_30_using_llms_in_code_30_frameworks_10_langchain4j
 n_10_genai_30_using_llms_in_code_30_frameworks_10_langchain4j_10_langchain4j_doc_md["🔗 Langchain4j Documentation ☕️"]
 n_10_genai_30_using_llms_in_code_30_frameworks_10_langchain4j --> n_10_genai_30_using_llms_in_code_30_frameworks_10_langchain4j_10_langchain4j_doc_md
+n_10_genai_30_using_llms_in_code_30_frameworks_10_langchain4j_20_langchain4j_deepdive_with_code_md["Langchain4j Deep Dive with Code ☕️"]
+n_10_genai_30_using_llms_in_code_30_frameworks_10_langchain4j --> n_10_genai_30_using_llms_in_code_30_frameworks_10_langchain4j_20_langchain4j_deepdive_with_code_md
 n_10_genai_40_inference["Inference"]
 n_10_genai --> n_10_genai_40_inference
 n_10_genai_40_inference_10_local_md["Local"]
@@ -262,6 +264,7 @@ click n_10_genai_30_using_llms_in_code_30_frameworks "/java-ai-resource/docs/gen
 click n_10_genai_30_using_llms_in_code_30_frameworks_20_springai_md "/java-ai-resource/docs/genai/using-llms-in-code/frameworks/springai"
 click n_10_genai_30_using_llms_in_code_30_frameworks_10_langchain4j "/java-ai-resource/docs/genai/using-llms-in-code/frameworks/langchain4j"
 click n_10_genai_30_using_llms_in_code_30_frameworks_10_langchain4j_10_langchain4j_doc_md "/java-ai-resource/docs/genai/using-llms-in-code/frameworks/langchain4j/langchain4j-doc"
+click n_10_genai_30_using_llms_in_code_30_frameworks_10_langchain4j_20_langchain4j_deepdive_with_code_md "/java-ai-resource/docs/genai/using-llms-in-code/frameworks/langchain4j/langchain4j-deepdive-with-code"
 click n_10_genai_40_inference "/java-ai-resource/docs/genai/inference"
 click n_10_genai_40_inference_10_local_md "/java-ai-resource/docs/genai/inference/local"
 click n_10_genai_40_inference_20_cloud_md "/java-ai-resource/docs/genai/inference/cloud"
@@ -415,146 +418,148 @@ classDef custom35 fill:#fff2e6;
 class n_10_genai_30_using_llms_in_code_30_frameworks custom35;
 classDef custom36 fill:#e6ffe6;
 class n_10_genai_30_using_llms_in_code_30_frameworks_20_springai_md custom36;
-classDef custom37 fill:#e6ffe6;
+classDef custom37 fill:#d0f0c0,stroke:green,stroke-width:4px,stroke-dasharray:0;
 class n_10_genai_30_using_llms_in_code_30_frameworks_10_langchain4j custom37;
 classDef custom38 fill:#b3d9ff,stroke:green,stroke-width:4px,stroke-dasharray:0;
 class n_10_genai_30_using_llms_in_code_30_frameworks_10_langchain4j_10_langchain4j_doc_md custom38;
-classDef custom39 fill:#ffe6e6;
-class n_10_genai_40_inference custom39;
-classDef custom40 fill:#fff2e6;
-class n_10_genai_40_inference_10_local_md custom40;
+classDef custom39 fill:#b3d9ff,stroke:yellow,stroke-width:4px,stroke-dasharray:0;
+class n_10_genai_30_using_llms_in_code_30_frameworks_10_langchain4j_20_langchain4j_deepdive_with_code_md custom39;
+classDef custom40 fill:#ffe6e6;
+class n_10_genai_40_inference custom40;
 classDef custom41 fill:#fff2e6;
-class n_10_genai_40_inference_20_cloud_md custom41;
-classDef custom42 fill:#f0e6ff;
-class n_20_ml custom42;
-classDef custom43 fill:#ffe6e6;
-class n_20_ml_10_fundamentals_md custom43;
+class n_10_genai_40_inference_10_local_md custom41;
+classDef custom42 fill:#fff2e6;
+class n_10_genai_40_inference_20_cloud_md custom42;
+classDef custom43 fill:#f0e6ff;
+class n_20_ml custom43;
 classDef custom44 fill:#ffe6e6;
-class n_20_ml_50_gpu_md custom44;
-classDef custom45 fill:#ffcccc,stroke:green,stroke-width:4px,stroke-dasharray:0;
-class n_20_ml_20_architectures custom45;
-classDef custom46 fill:#fff2e6;
-class n_20_ml_20_architectures_10_supervised_learning_md custom46;
+class n_20_ml_10_fundamentals_md custom44;
+classDef custom45 fill:#ffe6e6;
+class n_20_ml_50_gpu_md custom45;
+classDef custom46 fill:#ffcccc,stroke:green,stroke-width:4px,stroke-dasharray:0;
+class n_20_ml_20_architectures custom46;
 classDef custom47 fill:#fff2e6;
-class n_20_ml_20_architectures_20_unsupervised_learning_md custom47;
+class n_20_ml_20_architectures_10_supervised_learning_md custom47;
 classDef custom48 fill:#fff2e6;
-class n_20_ml_20_architectures_30_reinforcement_learning_md custom48;
+class n_20_ml_20_architectures_20_unsupervised_learning_md custom48;
 classDef custom49 fill:#fff2e6;
-class n_20_ml_20_architectures_40_generative_models_md custom49;
+class n_20_ml_20_architectures_30_reinforcement_learning_md custom49;
 classDef custom50 fill:#fff2e6;
-class n_20_ml_20_architectures_50_foundation_transformer_md custom50;
-classDef custom51 fill:#ffe6e6;
-class n_20_ml_30_training custom51;
-classDef custom52 fill:#fff2e6;
-class n_20_ml_30_training_10_basics_md custom52;
+class n_20_ml_20_architectures_40_generative_models_md custom50;
+classDef custom51 fill:#fff2e6;
+class n_20_ml_20_architectures_50_foundation_transformer_md custom51;
+classDef custom52 fill:#ffe6e6;
+class n_20_ml_30_training custom52;
 classDef custom53 fill:#fff2e6;
-class n_20_ml_30_training_20_data_prep_md custom53;
+class n_20_ml_30_training_10_basics_md custom53;
 classDef custom54 fill:#fff2e6;
-class n_20_ml_30_training_30_finetuning_md custom54;
+class n_20_ml_30_training_20_data_prep_md custom54;
 classDef custom55 fill:#fff2e6;
-class n_20_ml_30_training_40_evaluation_md custom55;
-classDef custom56 fill:#ffe6e6;
-class n_20_ml_40_frameworks custom56;
-classDef custom57 fill:#fff2e6;
-class n_20_ml_40_frameworks_10_deepnetts_md custom57;
+class n_20_ml_30_training_30_finetuning_md custom55;
+classDef custom56 fill:#fff2e6;
+class n_20_ml_30_training_40_evaluation_md custom56;
+classDef custom57 fill:#ffe6e6;
+class n_20_ml_40_frameworks custom57;
 classDef custom58 fill:#fff2e6;
-class n_20_ml_40_frameworks_20_deeplearning4j_md custom58;
+class n_20_ml_40_frameworks_10_deepnetts_md custom58;
 classDef custom59 fill:#fff2e6;
-class n_20_ml_40_frameworks_30_djl_md custom59;
+class n_20_ml_40_frameworks_20_deeplearning4j_md custom59;
 classDef custom60 fill:#fff2e6;
-class n_20_ml_40_frameworks_40_project_babylon_md custom60;
-classDef custom61 fill:#f0e6ff;
-class n_30_agentic_ai custom61;
-classDef custom62 fill:#ffe6e6;
-class n_30_agentic_ai_10_patterns_md custom62;
+class n_20_ml_40_frameworks_30_djl_md custom60;
+classDef custom61 fill:#fff2e6;
+class n_20_ml_40_frameworks_40_project_babylon_md custom61;
+classDef custom62 fill:#f0e6ff;
+class n_30_agentic_ai custom62;
 classDef custom63 fill:#ffe6e6;
-class n_30_agentic_ai_30_applications_md custom63;
+class n_30_agentic_ai_10_patterns_md custom63;
 classDef custom64 fill:#ffe6e6;
-class n_30_agentic_ai_20_frameworks custom64;
-classDef custom65 fill:#fff2e6;
-class n_30_agentic_ai_20_frameworks_10_adk_md custom65;
+class n_30_agentic_ai_30_applications_md custom64;
+classDef custom65 fill:#ffe6e6;
+class n_30_agentic_ai_20_frameworks custom65;
 classDef custom66 fill:#fff2e6;
-class n_30_agentic_ai_20_frameworks_20_langgraph4j_md custom66;
+class n_30_agentic_ai_20_frameworks_10_adk_md custom66;
 classDef custom67 fill:#fff2e6;
-class n_30_agentic_ai_20_frameworks_30_jai_workflow_md custom67;
+class n_30_agentic_ai_20_frameworks_20_langgraph4j_md custom67;
 classDef custom68 fill:#fff2e6;
-class n_30_agentic_ai_20_frameworks_40_a2a_protocol_md custom68;
-classDef custom69 fill:#f0e6ff;
-class n_40_ai_assisted_coding custom69;
-classDef custom70 fill:#ffe6e6;
-class n_40_ai_assisted_coding_10_coding_tools custom70;
-classDef custom71 fill:#fff2e6;
-class n_40_ai_assisted_coding_10_coding_tools_10_cursor_md custom71;
+class n_30_agentic_ai_20_frameworks_30_jai_workflow_md custom68;
+classDef custom69 fill:#fff2e6;
+class n_30_agentic_ai_20_frameworks_40_a2a_protocol_md custom69;
+classDef custom70 fill:#f0e6ff;
+class n_40_ai_assisted_coding custom70;
+classDef custom71 fill:#ffe6e6;
+class n_40_ai_assisted_coding_10_coding_tools custom71;
 classDef custom72 fill:#fff2e6;
-class n_40_ai_assisted_coding_10_coding_tools_20_windsurf_md custom72;
+class n_40_ai_assisted_coding_10_coding_tools_10_cursor_md custom72;
 classDef custom73 fill:#fff2e6;
-class n_40_ai_assisted_coding_10_coding_tools_30_qodo_md custom73;
-classDef custom74 fill:#ffe6e6;
-class n_40_ai_assisted_coding_20_productivity custom74;
-classDef custom75 fill:#fff2e6;
-class n_40_ai_assisted_coding_20_productivity_10_naboo_md custom75;
-classDef custom76 fill:#f0e6ff;
-class n_50_ethics custom76;
-classDef custom77 fill:#ffe6e6;
-class n_50_ethics_10_ethical_ai custom77;
+class n_40_ai_assisted_coding_10_coding_tools_20_windsurf_md custom73;
+classDef custom74 fill:#fff2e6;
+class n_40_ai_assisted_coding_10_coding_tools_30_qodo_md custom74;
+classDef custom75 fill:#ffe6e6;
+class n_40_ai_assisted_coding_20_productivity custom75;
+classDef custom76 fill:#fff2e6;
+class n_40_ai_assisted_coding_20_productivity_10_naboo_md custom76;
+classDef custom77 fill:#f0e6ff;
+class n_50_ethics custom77;
 classDef custom78 fill:#ffe6e6;
-class n_50_ethics_20_legislation custom78;
+class n_50_ethics_10_ethical_ai custom78;
 classDef custom79 fill:#ffe6e6;
-class n_50_ethics_30_security custom79;
-classDef custom80 fill:#f0e6ff;
-class n_60_domain_use_cases custom80;
-classDef custom81 fill:#ffe6e6;
-class n_60_domain_use_cases_10_finance_md custom81;
+class n_50_ethics_20_legislation custom79;
+classDef custom80 fill:#ffe6e6;
+class n_50_ethics_30_security custom80;
+classDef custom81 fill:#f0e6ff;
+class n_60_domain_use_cases custom81;
 classDef custom82 fill:#ffe6e6;
-class n_60_domain_use_cases_20_healthcare_md custom82;
+class n_60_domain_use_cases_10_finance_md custom82;
 classDef custom83 fill:#ffe6e6;
-class n_60_domain_use_cases_30_accessibility_md custom83;
+class n_60_domain_use_cases_20_healthcare_md custom83;
 classDef custom84 fill:#ffe6e6;
-class n_60_domain_use_cases_40_scientific_research_md custom84;
+class n_60_domain_use_cases_30_accessibility_md custom84;
 classDef custom85 fill:#ffe6e6;
-class n_60_domain_use_cases_50_education_md custom85;
+class n_60_domain_use_cases_40_scientific_research_md custom85;
 classDef custom86 fill:#ffe6e6;
-class n_60_domain_use_cases_60_ecommerce_md custom86;
+class n_60_domain_use_cases_50_education_md custom86;
 classDef custom87 fill:#ffe6e6;
-class n_60_domain_use_cases_70_legal_md custom87;
-classDef custom88 fill:#f0e6ff;
-class n_70_learning_paths custom88;
-classDef custom89 fill:#ffcccc,stroke:green,stroke-width:4px,stroke-dasharray:0;
-class n_70_learning_paths_10_new_to_java_for_ai custom89;
-classDef custom90 fill:#fff2e6;
-class n_70_learning_paths_10_new_to_java_for_ai_10_welcome_md custom90;
+class n_60_domain_use_cases_60_ecommerce_md custom87;
+classDef custom88 fill:#ffe6e6;
+class n_60_domain_use_cases_70_legal_md custom88;
+classDef custom89 fill:#f0e6ff;
+class n_70_learning_paths custom89;
+classDef custom90 fill:#ffcccc,stroke:green,stroke-width:4px,stroke-dasharray:0;
+class n_70_learning_paths_10_new_to_java_for_ai custom90;
 classDef custom91 fill:#fff2e6;
-class n_70_learning_paths_10_new_to_java_for_ai_20_link_40_ai_assisted_coding_10_coding_tools_md custom91;
+class n_70_learning_paths_10_new_to_java_for_ai_10_welcome_md custom91;
 classDef custom92 fill:#fff2e6;
-class n_70_learning_paths_10_new_to_java_for_ai_30_link_10_genai_30_using_llms_in_code_30_frameworks_10_langchain4j_md custom92;
+class n_70_learning_paths_10_new_to_java_for_ai_20_link_40_ai_assisted_coding_10_coding_tools_md custom92;
 classDef custom93 fill:#fff2e6;
-class n_70_learning_paths_10_new_to_java_for_ai_40_your_first_bot_md custom93;
+class n_70_learning_paths_10_new_to_java_for_ai_30_link_10_genai_30_using_llms_in_code_30_frameworks_10_langchain4j_md custom93;
 classDef custom94 fill:#fff2e6;
-class n_70_learning_paths_10_new_to_java_for_ai_50_add_memory_md custom94;
+class n_70_learning_paths_10_new_to_java_for_ai_40_your_first_bot_md custom94;
 classDef custom95 fill:#fff2e6;
-class n_70_learning_paths_10_new_to_java_for_ai_60_link_10_genai_30_using_llms_in_code_20_functionality_30_tool_calling_10_overview_md custom95;
+class n_70_learning_paths_10_new_to_java_for_ai_50_add_memory_md custom95;
 classDef custom96 fill:#fff2e6;
-class n_70_learning_paths_10_new_to_java_for_ai_70_deploy_md custom96;
+class n_70_learning_paths_10_new_to_java_for_ai_60_link_10_genai_30_using_llms_in_code_20_functionality_30_tool_calling_10_overview_md custom96;
 classDef custom97 fill:#fff2e6;
-class n_70_learning_paths_10_new_to_java_for_ai_80_optional_java_tricks_md custom97;
+class n_70_learning_paths_10_new_to_java_for_ai_70_deploy_md custom97;
 classDef custom98 fill:#fff2e6;
-class n_70_learning_paths_10_new_to_java_for_ai_90_now_what_md custom98;
-classDef custom99 fill:#ffcccc,stroke:yellow,stroke-width:4px,stroke-dasharray:0;
-class n_70_learning_paths_20_finetune_your_first_model custom99;
-classDef custom100 fill:#ffcccc,stroke:green,stroke-width:4px,stroke-dasharray:0;
-class n_70_learning_paths_30_new_to_java custom100;
+class n_70_learning_paths_10_new_to_java_for_ai_80_optional_java_tricks_md custom98;
+classDef custom99 fill:#fff2e6;
+class n_70_learning_paths_10_new_to_java_for_ai_90_now_what_md custom99;
+classDef custom100 fill:#ffcccc,stroke:yellow,stroke-width:4px,stroke-dasharray:0;
+class n_70_learning_paths_20_finetune_your_first_model custom100;
 classDef custom101 fill:#ffcccc,stroke:green,stroke-width:4px,stroke-dasharray:0;
-class n_70_learning_paths_40_new_to_ai custom101;
+class n_70_learning_paths_30_new_to_java custom101;
 classDef custom102 fill:#ffcccc,stroke:green,stroke-width:4px,stroke-dasharray:0;
-class n_70_learning_paths_50_new_to_ml custom102;
-classDef custom103 fill:#ffcccc,stroke:yellow,stroke-width:4px,stroke-dasharray:0;
-class n_70_learning_paths_60_training_first_model custom103;
+class n_70_learning_paths_40_new_to_ai custom102;
+classDef custom103 fill:#ffcccc,stroke:green,stroke-width:4px,stroke-dasharray:0;
+class n_70_learning_paths_50_new_to_ml custom103;
 classDef custom104 fill:#ffcccc,stroke:yellow,stroke-width:4px,stroke-dasharray:0;
-class n_70_learning_paths_70_building_first_ai_app custom104;
+class n_70_learning_paths_60_training_first_model custom104;
 classDef custom105 fill:#ffcccc,stroke:yellow,stroke-width:4px,stroke-dasharray:0;
-class n_70_learning_paths_80_langchain4j_tutorial custom105;
+class n_70_learning_paths_70_building_first_ai_app custom105;
 classDef custom106 fill:#ffcccc,stroke:yellow,stroke-width:4px,stroke-dasharray:0;
-class n_70_learning_paths_90_spring_ai_tutorial custom106;
+class n_70_learning_paths_80_langchain4j_tutorial custom106;
+classDef custom107 fill:#ffcccc,stroke:yellow,stroke-width:4px,stroke-dasharray:0;
+class n_70_learning_paths_90_spring_ai_tutorial custom107;
 linkStyle default interpolate basis
 ```