api-design

首页 > TAG信息列表 > api-design

java-为什么在未实现的公共API(例如Thread.destroy())中包含未实现的方法？

我对此感到有些困惑. Java API中有一些根本没有实现的方法,例如Thread.destroy(). (我知道它尚未实现,可能是因为它容易死锁,但这不是我要解决的问题.)如果未实现,那么为什么还要在公共API中包含它呢？人们在运行时可能会调用它来导致异常,这只是一种无用的方法. 当您实现接口并且特

java-参数“仅在有意义的子类”的详细解释是什么？

从名为How to Design a Good API and Why it Matters的演示文稿中我停留在演示文稿的第25页上,其中说： Public classes should not subclass other public classes for ease of implementation 它给了我们一个例子(Java语法)： Bad: Properties extends Hashtable

javascript-集合的REST API设计自然分为子集合

我有从我的客户端应用程序发送到处理它们的服务器的请求的集合.我用此请求创建新请求 POST api/v1/requests 发送请求后,它将收到PENDING状态,经过评估后状态将变为RESOLVED.因此,我有收集请求,该请求分为2个子收集：request.pending和request.resolved.我需要一种方法来同时访问它

api – chrome的随机内容下载时间很长？

我们有一个随机获取高内容下载时间的API,它在firefox中运行良好,只需几毫秒.响应大小为20kb未压缩和4kb压缩.使用curl,同样的请求也可以正常工作. 我们尝试过的事情： >禁用If-None-Match标头以禁用浏览器的缓存响应. >尝试各种按压(gzip,deflate,br).>禁用压缩.>禁用所有Chrome扩展

java – 为什么原始Stream没有收集(收集器)？

我正在为新手程序员编写一个库,所以我试图保持API尽可能干净. 我的库需要做的一件事就是对大量的int或long进行一些复杂的计算.我的用户需要从中计算这些值所需的大量场景和业务对象,因此我认为最好的方法是使用流来允许用户将业务对象映射到IntStream或LongStream,然后计算收集器

java – Spring REST重用嵌套的requstmapping

我们有一个REST API,用于一些评论.目前,最有趣的URI是： GET /products/1/comments // get all comments of product 1 GET /products/1/comments/5 // get the 5th comment of product 1 GET /products/1/comments/5/user // get the user of the 5th c

Java – 没有泛型的Idiot-Proof迭代的API设计

当您为代码库设计API时,您希望它易于使用,并且难以使用.理想情况下,你希望它是白痴证明. 您可能还希望使其与无法处理泛型的旧系统兼容,例如.Net 1.1和Java 1.4.但是你不希望从较新的代码中使用它会很麻烦. 我想知道以一种类型安全的方式使事物易于迭代的最佳方法…记住你不能使用

php – 如何在微服务环境中处理文件上传？

我正在尝试决定如何,何时以及在何处处理来自用户的上传文件.我们正处于MicroService环境(PHP Linux)中,以便在未来几个月内部署新系统.一个关键组件是传入文件. 目前正如我所看到的那样有三种选择(可能还有更多我尚未意识到的).它们如下： (1) [CLIENT:file] -> [GATEWAY API

在java对象中进行构造函数更改时的最佳实践

我有一个类,其中根据新的api集成添加了许多参数. 例如,早些时候我有一个包含4个参数的类： Integer a; String b; Map<String, String> c; List<Integer> e. 所以构造函数是： public SampleClass(Integer a, String b, Map<String, String

Java中的未绑定泛型返回类型

我正在玩有关构建Java API的一些想法,今天我花了一些时间思考这段代码： public <T> T getField1(Class<?> type, Class<T> retvalType, String fieldName) { Object retval = ...; // boring reflection code - value could be dog, could be duck return retvalType.cast(retv

java – 将接口的返回值限制为实现类的范围

我正在编写一个小型库,我有一些接口提供了一个返回值应该在指定范围内的方法.我如何明确禁止实现此方法的库的用户返回不在此范围内的值？像这样的东西： //Library interface FavoriteNumber { //returned value must lie between 0 and 10 double whatsYourFavoriteNumber

java – REST API设计在同一请求中将JSON数据和文件发送到api

我在现有应用程序之上创建REST API.其中一个功能包括json数据以及用户上传的文件. 我不确定如何将相同请求中的文件AND json数据发送到REST API？我有json部分工作,我测试使用curl： curl -XPOST http://localhost:8080/myapp/foo -d '{"mydata": { "name": "somename", "gen

java – 为什么Object类有Thread方法？

参见英文答案 > Why are wait() and notify() declared in Java’s Object class? 9个为什么Object类有与线程相关的方法,比如wait(),notify(),notifyAll()？我们需要扩展Thread或实现Runnable,以便为类提

java – Wrapper的parseXXX()用于签名二进制误解

我们以Byte.parseByte()为例,作为包装器的一个parseXXX(). 从parseByte(String s, int radix)'s JavaDoc开始： Parses the string argument as a signed byte in the radix specified by the second argument. 但是,如果radix = 2,则不完全正确.换句话说,-127的二进制文字是10

php – 从Laravel Jobs返回数据

我正在为Laravel移动应用程序开发API. 方法将向其他API发出请求,组合和过滤数据,更改其结构等. 应用程序的要求之一是响应时间不超过30秒,或者根本不响应.所以,我必须尽可能多地重复请求.我试图通过Laravel Queues实现这一点,并且目前在我的Job类中有类似的东西： private $apiActio

javascript – Kotlin中的平台常见类是什么？

我想用Kotlin定义客户端和服务器之间的接口. 目前,Kotlin可用于3个平台：Java,Android,Web(JS). 我可以在所有这些平台上使用哪些Kotlin内置类？我希望在kotlin-stdlib和kotlin-stdlib-js之间有一些共同的库依赖,但找不到一个. 另一方面,我设法创建了可在所有3个平台上使用的以下界面：