Package com.altibase.document.exception

Class AltibaseQueryException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
com.altibase.document.exception.AltibaseRuntimeException
com.altibase.document.exception.AltibaseQueryException
All Implemented Interfaces:
Serializable
public class AltibaseQueryException extends AltibaseRuntimeException
MongoDB 스타일의 쿼리를 SQL로 변환하거나 실행하는 과정에서 발생하는 예외를 나타낸다.

이 예외는 주로 MongoQueryTranslator가 사용자의 필터(filter) 문서를 파싱할 때 발생하며, "QUERY_ERROR"라는 고정된 에러 코드를 가진다.

주요 발생 시나리오:

  • 지원하지 않는 MongoDB 연산자(operator)를 사용했을 때 (예: $where)
  • 연산자의 값으로 잘못된 타입이나 구조의 데이터를 제공했을 때 (예: $in: "not-an-array")
  • 쿼리 필터의 JSON 구조가 문법적으로 잘못되었을 때
See Also:

  • Constructor Details

    • AltibaseQueryException

      public AltibaseQueryException(String aMessage)
      지정된 상세 메시지를 사용하여 AltibaseQueryException을 생성한다.
      Parameters:
      aMessage - 예외에 대한 상세 메시지 (나중에 Throwable.getMessage()로 조회 가능).

    • AltibaseQueryException

      public AltibaseQueryException(String aMessage, Throwable aCause)
      지정된 상세 메시지와 원인(cause)을 사용하여 AltibaseQueryException을 생성한다.

      쿼리 변환 중 발생한 내부 예외(예: ClassCastException)를 감싸서 더 구체적인 컨텍스트를 제공하고자 할 때 이 생성자를 사용한다.

      Parameters:
      aMessage - 예외에 대한 상세 메시지 (나중에 Throwable.getMessage()로 조회 가능).
      aCause - 이 예외의 원인이 되는 예외 (나중에 Throwable.getCause()로 조회 가능). null 값이 허용되며, 이는 원인이 없거나 알 수 없음을 의미한다.