Em minha artigo anterior do blogEm nosso blog, analisamos os erros lançados pelos clientes da libCouchbase, como ruby, python, C e C++. Este blog se concentrará na biblioteca cliente Java para o Couchbase.
Na biblioteca do cliente Java, há exceções, não erros. Dependendo do tipo de retorno e do estado do aplicativo, diferentes exceções podem ser lançadas pelo cliente Java. Em geral, você encontrará essas exceções registradas por meio das anotações @throws ou seu IDE informará que você precisa capturá-las.
Aqui estão algumas exceções que você pode encontrar ao usar a biblioteca Java:
Todas as operações assíncronas retornam futuros e não geram uma exceção até que você bloqueie o resultado. Além de capturar a exceção, você também pode inspecionar o status do futuro e usar a função getMessage() API para obter o texto real da mensagem.
Para APIs síncronas, a biblioteca do cliente é implementada como um invólucro em torno dos métodos assíncronos. Aqui estão as exceções mais comuns lançadas pelas APIs java síncronas:
1. TimeoutException - Isso significa que a espera no futuro demorou mais do que o esperado. Por exemplo, essa exceção é lançada se get() for usado com um valor de tempo limite padrão e ele expirar. Ela também será lançada se get() for usado com um tempo limite personalizado e o tempo limite expirar.
2. CancellationException - Isso significa que a operação foi cancelada enquanto estava "em voo". Por exemplo, uma solicitação enviada por uma rede sem resposta. Isso pode ocorrer principalmente quando um nó falha. Todas as operações que estão em andamento no momento são canceladas.
3. InterruptedException- Isso significa que houve uma interrupção durante o bloqueio no futuro.
Se você estiver usando exibições em seu aplicativo com Java, poderá ver as seguintes exceções:
1. InvalidViewException - Isso significa que um nome de visualização ou documento de design inválido foi especificado. Essa exceção também é lançada se uma visualização estiver no estágio de desenvolvimento e não for implantada na produção ou se a visualização estiver em produção e o aplicativo se referir à visualização de desenvolvimento.
Para lidar com essa exceção, tente usar o parâmetro viewname correto ao chamar a visualização e certifique-se de que essa visualização esteja implantada na produção.
Se você estiver usando as APIs para verificar se seus dados são persistidos pelo Couchbase, há mais algumas exceções que você deve observar:
1. ObservedException - Isso significa que algo geral deu errado com a chamada de API e mais detalhes podem ser encontrados na mensagem de status.
2. ObservedTimeoutException - Isso significa que a chamada à API atingiu o tempo limite e você deve tentar novamente.
3. ObservedModifiedException - Isso significa que a chamada à API falhou porque o documento foi modificado nesse meio tempo. Isso indica uma condição de corrida.
Por fim, durante a inicialização do seu aplicativo com a API Java, você pode encontrar as seguintes exceções:
1. ConfigParsingException - Isso significa que a configuração atual não pode ser analisada. Você deve verificar se o arquivo de configuração está correto e tentar novamente.
Você também poderá ver outras exceções de rede se o host não estiver acessível.
Boa sorte ao criar seus aplicativos usando o cliente Java do Couchbase. Se tiver alguma dúvida, não hesite em nos perguntar na seção fóruns.
