api - Java 开发 App 接口中关于 url 和入参名称规范的问题

Question

现在公司用开发给前端用的接口，语言是Java，现在想定开发规范，然后有些纠结的地方：

一个是接口的名称，之前用的的驼峰的形式，比如myTopic，但是看网上推荐的有my_topic，更容易辨识，或者推荐比较多的my-topic，看到说法是比前一种输入起来更方便。

还有个入参的问题，比如一个接口接受的参数是分页的页数，之前也是习惯性的驼峰的pageNum，但看很多公司，比如支付宝的接受参数都是page_num这种。

想问下大家以上两个问题一般用的是那种或推荐哪种？

Answer 1

Chaque entreprise a des méthodes d'écriture différentes, et même différentes équipes au sein d'une entreprise auront des méthodes d'écriture différentes.

Mais il y a toujours une façon d'écrire qui est correcte la plupart du temps, et c'est la bosse.

La méthode d'écriture du chameau a également été vérifiée par des expériences. Elle est la plus simple à reconnaître et la vitesse de reconnaissance est rapide. Vous pouvez lire l'étude sur la lisibilité à dos de chameau ici

Answer 2

Personnellement, je pense que la soi-disant spécification est votre accord sur les parties avant et arrière Une fois que l'accord est conclu et qu'il peut répondre aux besoins, alors cet accord est votre spécification.

Answer 3

Le premier type
https://img.hacpai.com/file/2...

Answer 4

Il n'y a pas de réponse standard à la question de style. Les cas peuvent être trouvés dans les trois méthodes que vous avez répertoriées.

J'utilise personnellement la méthode de soulignement page_num, qui est plus lisible et utilise des lettres minuscules, qui est plus adaptée aux url/uri.

Answer 5

Il est recommandé d'utiliser la conception d'URL de Douban http://www.prower.cn/interact...