예외와 오류 처리
SDK가 던지는 예외는 모두Revolution\Copilot\Exceptions 네임스페이스에 있습니다. 발생 방식은 두 가지로, 세션 실행 결과에 보관되었다가 throw()로 던져지는 것과 RPC 호출 등에서 그 자리에서 던져지는 것이 있습니다.
세션 오류와 타임아웃
sendAndWait()와 Copilot::run()에서는 세션 오류나 타임아웃이 그 자리에서 던져지지 않습니다. 대신 반환된 SessionEvent에 예외가 보관됩니다. Laravel의 Http나 Process와 마찬가지로 throw()를 호출하면 보관된 예외가 던져집니다. 오류가 없으면 throw()는 아무것도 하지 않으므로 메서드를 계속 체이닝할 수 있습니다.
failed()와 successful()을 사용합니다. 자세한 내용은 SessionEvent를 참조하세요.
SessionTimeoutException
session.idle(응답 완료)을 기다리다 타임아웃되면 보관됩니다. 타임아웃은 sendAndWait()의 timeout 인수로 지정합니다. 생략하면 copilot.timeout 설정값(기본값 60초)이 사용됩니다.
SessionErrorException
세션이SESSION_ERROR 이벤트로 오류를 반환하면 보관됩니다. 메시지에는 런타임이 반환한 오류 내용이 포함됩니다.
JsonRpcException
RPC 호출에 대해 CLI가 JSON-RPC 오류를 반환하면 즉시 던져집니다. JSON-RPC 오류 코드는code 속성에서, 오류에 첨부된 데이터는 data 속성에서 읽습니다.
SessionFsSqliteTransactionFailure
SessionFs의 SQLite 프로바이더를 구현할 때 사용하는 예외입니다. 포착하는 것이 아니라, 프로바이더의transaction()에서 던져 실패를 어떻게 분류할지 런타임에 알립니다. 분류는 errorClass로 지정합니다.
Fatal(기본값): 복구할 수 없는 실패BusyOrLocked: SQLite가 커밋 전에 BUSY/LOCKED를 반환하고 트랜잭션이 롤백된 경우에만 사용PostCommitAmbiguous: 커밋 후의 결과를 판단할 수 없음
transaction()에서 던진 그 밖의 예외는 fatal로 보고됩니다.