Perguntas com a marcação «api-design»

Por exemplo, você executa uma solicitação GET, users/9mas não há usuário com o ID nº 9. Qual é o melhor código de resposta? 200 OK 202 Aceito 204 Sem Conteúdo 400 Solicitação incorreta 404 não encontrado

332 rest  http  api-design 

Tanto quanto posso dizer, cada recurso individual deve ter apenas um caminho canônico . Portanto, no exemplo a seguir, quais seriam os bons padrões de URL? Tomemos como exemplo uma representação restante das empresas. Neste exemplo hipotético, cada empresa possui 0 ou mais departamentos e cada departamento possui 0 ou …

301 rest  api-design 

Eu adoraria alguma ajuda para lidar com um caso estranho com uma API paginada que estou construindo. Como muitas APIs, esta pagina grandes resultados. Se você consultar / foos, obterá 100 resultados (por exemplo, foo # 1-100) e um link para / foos? Page = 2, que deve retornar foo …

288 rest  pagination  api-design 

Diferentemente dos C # IEnumerable, em que um pipeline de execução pode ser executado quantas vezes quisermos, em Java, um fluxo pode ser 'iterado' apenas uma vez. Qualquer chamada para uma operação do terminal fecha o fluxo, tornando-o inutilizável. Esse 'recurso' tira muito poder. Imagino que o motivo disso não …

239 java  java-8  java-stream  api-design 

Lembre-se de que tenho um entendimento rudimentar do REST. Digamos que eu tenho este URL: http://api.animals.com/v1/dogs/1/ E agora, quero fazer o servidor fazer o cachorro latir. Somente o servidor sabe como fazer isso. Digamos que eu queira executá-lo em um trabalho CRON que faça o cachorro latir a cada 10 …

142 api  rest  url  api-design  restful-architecture 

Quero tornar minha API RESTful muito previsível. Qual é a melhor prática para decidir quando fazer uma segmentação de dados usando o URI em vez de usar parâmetros de consulta. Faz sentido para mim que os parâmetros do sistema que suportam paginação, classificação e agrupamento estejam após o '?' Mas …

141 rest  spring-mvc  restful-url  restful-architecture  api-design 

de acordo com a documentação, o método String.valueOf(Object obj)retorna: se o argumento for null, uma sequência igual a "null"; caso contrário, o valor de obj.toString()é retornado. Mas como é que quando eu tento fazer isso: System.out.println("String.valueOf(null) = " + String.valueOf(null)); joga NPE em vez disso? (tente você mesmo se não …

127 java  null  nullpointerexception  overloading  api-design 

O seguinte código gera NullPointerException: int num = Integer.getInteger("123"); Meu compilador está invocando getIntegerem null, pois é estático? Isso não faz sentido! O que está acontecendo?

106 java  integer  nullpointerexception  api-design  autoboxing 

Se você tem uma API e é um desenvolvedor baseado no Reino Unido com um público altamente internacional, sua API deve ser setColour() ou setColor() (Para tomar uma palavra como um exemplo simples.) Os engenheiros do Reino Unido costumam ser bastante defensivos quanto à sua grafia "correta", mas pode-se argumentar …

93 api  naming-conventions  api-design