JSON Codec

JSON Codec (커스텀 JSON 직렬화)

LangChain4j는 "tools"와 "structured output" 기능이 쓰는 내부 JSON 직렬화기를 내장하고 있어요(기본값은 Jackson). 대부분의 경우 기본 직렬화기로 충분해요. 다만 일부 환경에서는 기본 Jackson 직렬화기가 다른 의존성 때문에 오류를 일으킬 수 있어요. 예를 들어 Jetbrains/IntelliJ 플러그인 개발자들이 그런 경우를 겪었어요.

자체 JSON 직렬화기(일명 JSON Codec)를 제공해야 한다면 다음 단계를 따르면 돼요.

  1. 프로젝트에 dev.langchain4j.spi.json.JsonCodecFactory 구현을 만든다

예를 들어 팩토리 클래스가 example.MyJsonCodecFactory라고 해 볼게요. LangChain4j가 내부적으로 쓰는 기본 코덱인 dev.langchain4j.internal.JacksonJsonCodec를 확인하고 필요에 맞게 변형할 수 있어요.

  1. SPI 프로바이더 설정 파일을 추가한다

리소스 폴더(예: src/main/resources)에 META-INF/services 폴더를 만들고 dev.langchain4j.spi.json.JsonCodecFactory라는 파일을 생성해요. 파일 내용은 팩토리 구현의 FQDN이어야 해요. 예시에서는 이렇게 하면 돼요.

example.MyJsonCodecFactory

출처: 공식문서 - JSON Codec

주의사항

dev.langchain4j.spi.json.JsonCodecFactory는 LangChain4j에서 내부용으로 표시돼 있어요. 이 접근 방식은 커스텀 JSON Codec이 확실히 필요한 환경에서만 써야 해요.

LangChain4j가 Jackson 2 대신 Jackson 3을 쓰게 하고 싶다면 아래 절차는 필요 없어요. 의존성 하나만 추가하면 끝나요(Jackson 3 문서 참고).

더 알아보기