api-design相关内容

Cocoa中缺少什么?

如果你可以添加任何东西到Cocoa,它会是什么?有没有任何功能,主要或次要,你会说在Cocoa丢失。 解决方案 可能有一个轮子,你必须一遍又一遍地发明 内置的正则表达式支持(a RegexKit )将极为方便。 NSRegularExpression在iOS 4.0+上可用,但在Mac OS X上仍然不可用。 从大文本逐步读取NSString对象的简单方法文件,而不将整个东西加 ..
发布时间:2016-12-07 00:09:46 移动开发

什么时候应该创建我们自己的java异常类?

从良好的设计/实践的角度来看,我们应该何时创建和使用自定义的java异常类,而不是在java中预先定义的那些? 我看到几乎没有,或者甚至没有创建自定义异常类,他们努力总是使用本机Java异常。另一方面,有一些应用程序为一切定义了自定义例外。 最佳做法是什么? 谢谢! 解决方案 从 ..
发布时间:2016-11-23 13:01:28 Java开发

私有类函数vs未命名的命名空间中的函数

我发现自己,我倾向于没有私人类函数。如果可能,所有候选人私人类函数,而不是我把未命名的命名空间,并传递所有必要的信息作为函数参数。我没有一个健全的解释为什么我这样做,但至少它看起来更自然地对我。因此,我需要在头文件中显示更少的内部细节。 你的意见是什么 - 是正确的做法吗? 只是说不,并隐藏cpp文件中的私有。 如果我将在一个大型c ++项目上开始新的项目,我将强制使用PIMPL ..
发布时间:2016-10-17 09:06:35 C/C++开发

什么是DSL的中/流利的接口点

我最近看一个关于直播如何建立一个流畅的DSL ,然后我不得不承认,我不“不懂为什么人们会用这种方式(至少给出的例子)的原因。 网上直播呈现的图像缩放类,允许你指定一个输入图像,调整其大小和(使用C#)将其保存到使用以下语法一个输出文件: 仪分级机=新仪(); sizer.FromImage(inputImage的) .ToLocation(outputImage) .Reduc ..
发布时间:2016-09-22 19:58:21 C#/.NET

是区分哪些资源根据用户凭证REST风格和良好的URI设计返回API终点?

重要提示 这个问题的重点是哪些资源返回根据API端点区分的谁认证的,例如爱丽丝获取资源A和B返回,Bob得到资源X和Y 是不会关于区分资源的重新presentation回来了。 所有端点返回资源的JSON重新presentations。 preface 请考虑以下三个潜在的API端点设计中,一个用户的所有返回的事情资源。 的端点A 的 GET /东西 如果对&LT认证证书; u ..
发布时间:2016-07-25 19:28:06 ASP .NET

它是有用的总是返回一个承诺

我使用蓝鸟设计围绕http服务一些API的NodeJS包装。 许多在此包装的功能是异步的,所以它是一个很大的意义,从这些实现返回承诺。 我的同事已在项目上工作了几天,现在和有趣的格局正在形成,他也是从返回同步实现功能的承诺。 例如: 函数parseArray(的someArray){ VAR的结果; //同步实现 返回Promise.resolve(结果); } ..
发布时间:2016-07-21 09:41:36 前端开发

如果一个异步API不断抛出同步?

我正在写一个JavaScript函数,使得HTTP请求并返回结果的承诺(但这个问题同样适用于基于回调的实现)。 如果我立即,对于函数提供的参数是无效的,应功能罚球同步,还是应该返回一个拒绝承诺(或者,如果你$ P知道$ PFER,与错误实例)调用回调? 如何重要的是它是一个异步函数应该的总是的行为以异步的方式,特别是对错误条件?是否确定罚球如果你知道程序是不是在合适的状态异步操作继续进行? ..
发布时间:2016-07-21 09:12:34 前端开发

什么是黄金标准API的网站? Twitter的,Flickr,Facebook的等

今天看来像有两类API,用于网站。 的API允许网站的功能进行扩展,如Facebook,MySpace的,等等这些API似乎是非常多样的。 的API,允许像Twitter的,Flickr等现有的网站功能,这些都声称是基于REST的互动,但在现实中只是“数据通过HTTP”。 如果你正在创建一个网站,允许两个功能扩展和交互以外什么现有的API,你会作为参考模型使用? 解决方案 ..
发布时间:2016-07-13 20:20:16 ASP .NET

独立于平台的工具,用于创建API文档/建议

开发平台上独立API文档存在什么工具? 我在设计提出的API的过程,要在结构化和易于修改的方式来写文档。很多我见过的答案基本上是“建在特定语言的文档工具的使用”,但因为我是从“顶层”设计的API,而不是实现它,这不是那么有用。我在寻找一个CMS的API文档 我已经看到了一些建议使用PBWiki或合流,但我不相信,一个普通的维基是最好的选择,虽然版本控制方面很不错。 在理论上,一个Drupal ..
发布时间:2016-05-23 22:17:54 其他开发

在C ++中的错误处理/错误日志记录库/应用程序组合

我遇到了以下问题频繁模式历年来: 我在写复杂的code对于由一个独立的应用程序,也是核心的库版本,人们可以从其他应用程序内部使用的包。 这两个用户与核心库中创建自己的应用程序和presumably的人很可能都在批处理模式下运行(离线,脚本,远程,和/或命令行),如以及交互。 库/应用​​程序需要复杂而庞大的运行时输入并有可能出现各种错误似的输出,包括严重的错误信息,输入语法警告, ..
发布时间:2016-05-23 22:01:29 C/C++开发

它是在C使用一个枚举参数的公共API函数是个好主意?

我设计一个C API除其他外必须提供一种方法来设置一些双值选项。为了确定我用下面的枚举的选项: 的typedef枚举 { OptionA, OptionB, ... } 选项; 这是个好主意,用选项作为一个公共的API函数的参数类型: INT set_option(选件选择,双值); 或者是更好地使用 INT 而不是: INT set_option(INT选择,双 ..
发布时间:2016-05-22 22:15:13 其他开发

无论是通过一个ID或一个RESTful API鼻涕虫确定项目

我目前正在设计一个API和我来到跨一个小问题: 一个RESTful API的URL应该怎么样子时,你应该能够通过任何一个ID或蛞蝓,以确定一个项目? 我能想到的三个选项: GET /项目/<&ID GT; GET /项目/<&塞GT; 这要求蛞蝓和ID是可区别的,其不一定在这种情况下,给定的。我不认为这个问题一个干净的解决方案,除了你做这样的事情: GET /项目/ ID ..
发布时间:2016-05-22 21:12:04 其他开发

GB英文或美国英语?

如果你有一个API,你是一个高度国际化的观众总部位于英国的开发商,应您的API是 setColour() 或的setColor() (举一个字作为一个简单的例子。) 总部位于英国的工程师往往很注重保护他们的'正确'的拼写,但可以说美国的拼写是在国际市场上更“标准”。 我想问题是什么关系呢?难道开发商在其他语言环境符合GB拼写斗争,或者是它通常很明显是什么意思的东西呢? 如果这一切是美国 ..
发布时间:2016-05-22 20:49:03 其他开发

当一个API过度设计?

我鄙视与过度设计的API,不要让简单的事情变得简单的工作。尽管如此,我工作的一个开放源码库设计API,我开始觉得我掉进陷阱过度设计。我真的不能告诉是肯定的,因为当然,我写的混账东西,所以它的工作原理是比较明显,我比任何人都。什么是从开发人员的角度来看一些警告迹象表明,你的API可能会被过度设计? 解决方案 “什么是从开发人员的角度来看,你的API可能会被过度设计一些警示标志?” 没有用例 ..
发布时间:2016-05-22 20:48:06 其他开发

从更清晰的Bigcommerce响应

能的Bigcommerce改变他们的API响应更清晰,当一个程序试图发布一个已经存在的货? 在张贴出货量的Bigcommerce,如果产品已经存在,那么您会收到以下错误消息。 <?XML版本=“1.0”&GT?; <错误> <错误> <状态> 400℃/状态> <消息>该场'量'是无效< ..
发布时间:2016-05-22 20:37:12 其他开发

C#泛型:如果T是一个返回类型,可以将它也是无效?我怎么能这些接口组合在一起?

我有以下的接口,使用返回回调类型T的泛型参数... 公共接口IDoWork< T> { ŧ的DoWork(); } 不过我也有下面的接口为好,但因为它返回void也不会调用回调。公共接口IDoWork { 无效的DoWork(); } 我可以结合这两个接口,并使用运行逻辑判断的区别?我该怎么做? 解决方案 不幸的是,它们不能合并。 您可以在框架中看到这一点 ..
发布时间:2016-05-22 20:13:28 C#/.NET

API的设计和jQuery

我经常听到的jQuery取得了一些可怜的API的决定。虽然jQuery是不是我喜爱的图书馆是我最常使用图书馆,我觉得很难在API的设计指出了具体的错误或它如何能得到改善。 什么jQuery的API的一部分可能已经做得比较好,如何可能它已经实施的不同和为什么将不同的实现会更好? 问题延伸到两个低水平个别细节的API和高层次细节的API 。我们只谈论API中的缺陷而不是在图书馆的高层设计/目的的缺 ..
发布时间:2016-05-22 19:28:30 前端开发