有点长的 Java API 设计清单

java api接口规范 java api开发接口规范 包括增删改查 下载 上传等传参 返回方式等 立即下载

点击上方“芋道源码”,选择“置顶公众号”

技术文章第一时间送达!

源码精品专栏

 

来源:http://t.cn/zOz8luI

在设计Java API的时候总是有很多不同的规范和考量。与任何复杂的事物一样,这项工作往往就是在考验我们思考的缜密程度。就像飞行员起飞前的检查清单,这张清单将帮助软件设计者在设计Java API的过程中回忆起那些明确的或者不明确的规范。本文也可以看作为“API设计指南”这篇文章的附录。

我们还准备了一些前后比对的例子来展示这个列表如何帮助你理清设计需求,找出错误,识别糟糕的设计实践以及如何寻找改进的时机。

这个清单使用了如下的语言规范:

要 – 表示必要的设计

建议 – 表示在几个最好的设计中选择一个

考虑 – 表示一个可能的设计上的改进

避免 – 表示一个设计上的缺陷

不要 – 表示一个设计上的错误

1. 包设计清单

1.1. 共通

▲1.1.1. 建议把API和实现放入不同的包

▲1.1.2. 建议把API放进上层包,而把实现放进下层包

▲1.1.3. strong>考虑把一组大型的API分拆进不同的包

▲1.1.4. 考虑把API和实现打包进不同的jar包

▲1.1.5. 避免API的实现类之间的内部依赖

▲1.1.6. 避免把API分拆了太细

▲1.1.7. 避免把公共实现类放到API的包中

▲1.1.8. 不要在调用者和实现类之间建立依赖

▲1.1.9. 不要把没有关系的API放进同一个包

▲1.1.10. 不要把API和SPI(service provider interface)放进一个包(注:两者不同可以查看这个页面http://stackoverflow.com/questions/2954372/difference-between-spi-and-api)

▲1.1.11. 不要移动或者重命名一个已经发布的公共API

1.2. 命名

▲1.2.1. (一级)包名以公司(或者组织)的根命名空间来命名

▲1.2.2. 使用一个稳定的产品名称或者一个产品系列的名称作为包的二级名称

▲1.2.3. 使用API名称作为包名的(三级名称)结尾

▲1.2.4. 考虑把仅包含实现的包的名称中包含”internal”这个词(注:似乎“impl”更常见一些)

▲1.2.5. 避免使用组合起来的名称

▲1.2.6. 避免包名和包内的类名使用同样的名称

▲1.2.7. 避免在包名称中使用“api”这个词

▲1.2.8. 不要使用营销,计划,组织单元(部门)和地理名称

▲1.2.9. 不要在包名中使用大写字母

1.3. 文档

▲1.3.1. 为每一个包提供一个package.html

▲1.3.2. 遵循标准的javadoc的规范

▲1.3.3. 在API的开始处用一句短小的话来概括(描述)

▲1.3.4. 提供足够多的细节来帮助判断是否需要使用和如何使用该API

▲1.3.5. 指出该API的入口(主要的类或者方法)

▲1.3.6. 包含覆盖主要的,基本功能演示的样例代码

▲1.3.7. 包含一个指向开发者指南的超链接

▲1.3.8. 包含一个指向手册的超链接

▲1.3.9. 指出相关的API集合

▲1.3.10. 包含API的版本号

▲1.3.11. 用@deprecated标记出不再使用的API版本

▲1.3.12. 考虑添加一个版权声明

▲1.3.13. 避免过长的包概述

▲1.3.14. 不要在发布的javadoc中包含实现相关的包

2. 类型设计清单(这里的“类型”个人理解为一组Api)

2.1. 共通

▲2.1.1. 确保每种(设计的)类型都有单一明确的目的

▲2.1.2. 确保每种类型代表了(业务)领域的概念,而不是为了(技术上)的抽象

▲2.1.3. 限制类型的总数量

▲2.1.4. 限制类型的大小

▲2.1.5. 设计相关的类型时保持和原有的类型的一致性

▲2.1.6. 建议为多种public的类型提供多种(private)的实现

▲2.1.7. 建议接口的实现类和继承关系的类应该在行为上保持一致性

▲2.1.8. 建议用抽象类而不是接口解耦Api的实现

▲2.1.9. 建议使用枚举而不是常量

▲2.1.10. 考虑使用泛型

▲2.1.11. 考虑在泛型参数上增加约束

▲2.1.12. 考虑使用接口来实现多继承的效果

▲2.1.13. 避免为使用者的扩展(需求)进行设计

▲2.1.14. 避免深度的继承层次

▲2.1.15. 不要使用public内嵌的类型

▲2.1.16. 不要申明public和protected的变量

▲2.1.17. 不要把实现的继承关系暴露给使用者

2.2. 命名

▲2.2.1. 使用名词或者名词词组

▲2.2.2. 使用PascalCasing(驼峰命名法的别称详见http://en.wikipedia.org/wiki/CamelCase)

▲2.2.3. 缩写仅第一个首字母大写

▲2.2.4. 为类型的实际作用使用精确的名称命名

▲2.2.5. 为最常用的类型准备最短最容易记忆的名称

▲2.2.6. 所有异常都以“Exception”结尾

▲2.2.7. 使用名词的单数(比如用Color而不用Colors)来命名枚举类型

▲2.2.8. 考虑较长的名称

▲2.2.9. 考虑派生类用基类的名称结尾

▲2.2.10. 考虑为抽象类名称使用“Abstract”开头

▲2.2.11. 避免使用缩略语

▲2.2.12. 避免太通用的名词

▲2.2.13. 避免同义词

▲2.2.14. 避免在相关的Api中使用类型的名称

▲2.2.15. 不要使用仅大小写不同的名称

▲2.2.16. 不要使用前缀

▲2.2.17. 不要以“I”作为接口的名称开头

▲2.2.18. 不要(重复)使用Java核心包中的名称

2.3. 类

▲2.3.1. 最小化实现使用的依赖

▲2.3.2. 先列出public方法

▲2.3.3. 申明实现方法为private(这里是笔误吗?)

▲2.3.4. 为一个public抽象类定义至少一个public的shi

▲2.3.5. 为基本的使用情况提供足够的缺省实现

▲2.3.6. 设计基本上不变的类

▲2.3.7. 把无状态,访问器,扩展(mutator个人理解为多种参数形式的方法)方法集合到一起

▲2.3.8. 把扩展方法的数量控制到最少

▲2.3.9. 考虑设计一个默认的无参的构造方法

▲2.3.10. 考虑重写equal,hashCode方法

▲2.3.11. 考虑实现Comparable接口

▲2.3.12. 考虑实现Serializable接口

▲2.3.13. 考虑使类可以容易的扩展

▲2.3.14. 考虑申明类为final

▲2.3.15. 考虑为类的实例化提供一个public的构造方法

▲2.3.16. 考虑使用自定义的类型来增强类的不可变性

▲2.3.17. 考虑设计不可变的类

▲2.3.18. 避免静态类

▲2.3.19. 避免使用Cloneable

▲2.3.20. 不要向静态类中添加实例duixi

▲2.3.21. 不要为使用者不应扩展的public抽象类提供public的构造方法

▲2.3.22. 不要滥用初始化

2.4. 接口

▲2.4.1. 为每一个public接口提供至少一个实现类

▲2.4.2. 为每一个public接口设计至少一个消费方法

▲2.4.3. 不要对一个已经发布的public接口添加新的方法

▲2.4.4. 不要使用标记接口(标记接口详见http://en.wikipedia.org/wiki/Marker_interface_pattern)

▲2.4.5. 不要把public接口设计成常量的容器(这个实在很常见啊……)

2.5. 枚举

▲2.5.1. 考虑为枚举类型指定一个0值(“NONE”或者“Unspecialized”等等)

▲2.5.2. 避免只有一个值的枚举

▲2.5.3. 不要使用枚举实现开放式的值集合

▲2.5.4. 不要为将来可能增加的值设计枚举

▲2.5.5. 不要为已经发布的版本增加新的枚举值

2.6. 异常

▲2.6.1. 确保自定义的异常可以被序列化

▲2.6.2. 考虑为每种类型定义一个不同的异常

▲2.6.3. 考虑为代码访问提供更多的异常信息

▲2.6.4. 避免深层的异常继承

▲2.6.5. 不要从Exception和RuntimeException以外的类派生自定义异常

▲2.6.6. 不要直接从Throwable派生异常

▲2.6.7. 不要在异常信息内包含敏感信息

2.7. 文档

▲2.7.1. 为每种类型(的Api)配上概述

▲2.7.2. 遵循标准Javadoc的约定

▲2.7.3. 每种类型开头以一句短小的话概述

▲2.7.4. 为是否使用以及如何使用该类型提供足够的细节来帮助做决定

▲2.7.5. 解释如何实例化一个类型

▲2.7.6. 为一个类型的主要的使用情景提供样例代码

▲2.7.7. 包含指向到开发指南的链接

▲2.7.8. 包含指向手册的链接

▲2.7.9. 显示相关的类型

▲2.7.10. 用@deprecated标签申明过时的类型

▲2.7.11. 文档类具有不可变性

▲2.7.12. 避免冗长的类概述

▲2.7.13. 不要为私有方法生成Javadoc

3. 方法设计清单

3.1. 共通

▲3.1.1. 确保每个方法实现一个目的

▲3.1.2. 确保相关的方法都是一个粒度级别的

▲3.1.3. 确保没有混合调用方法的公共代码

▲3.1.4. 使所有方法的调用具有原子性(原子性:http://jiangyongyuan.iteye.com/blog/364010)

▲3.1.5. 设计protected方法时要像public方法一样慎重

▲3.1.6. 限制扩展方法的数量

▲3.1.7. 设计扩展方法需要具有较强的稳定性

▲3.1.8. 建议为一系列重载的方法设计一个泛型的方法

▲3.1.9. 考虑使用泛型方法

▲3.1.10. 考虑设计方法对,即两个方法的作用是相反的

▲3.1.11. 避免“helper”方法

▲3.1.12. 避免长时间执行的方法

▲3.1.13. 避免调用者在普通使用中需要手动写循环

▲3.1.14. 避免可选的参数影响方法的行为

▲3.1.15. 避免不可重复调用的方法

▲3.1.16. 不要删除一个已经发布的方法

▲3.1.17. 不要在没有提供替换方法前把一个已经发布的方法标记为过时

▲3.1.18. 不要修改一个已经发布的方法的签名

▲3.1.19. 不要修改一个已经发布的方法的可观测行为(也许指的是输出之类)

▲3.1.20. 不要增加一个已经发布方法的调用条件

▲3.1.21. 不要减少一个已经发布方法的调用结果

▲3.1.22. 不要为已经发布的public接口新增方法

▲3.1.23. 不要为已经发布的Api新增重载

3.2. 命名

▲3.2.1. 用给力的,有表达力的动词作为名称起始

▲3.2.2. 使用驼峰命名法(好奇怪,前面写的是PascalNaming)

▲3.2.3. 为JavaBean的私有属性预留“get”“set”“is”等访问方法

▲3.2.4. 使用对调用者熟悉的词语

▲3.2.5. 尽量使用英语口语

▲3.2.6. 避免使用缩略语

▲3.2.7. 避免使用一般的动词

▲3.2.8. 避免同义词

▲3.2.9. 不要使用“黑话”

▲3.2.10. 不要依靠参数的名称和类型判断方法的意义

3.3. 参数

▲3.3.1. 为参数选择最合适的类型

▲3.3.2. 在相关方法的调用中对参数为null值的处理保持一致性

▲3.3.3. 在相关方法中参数的名称,类型和顺序需要保持一致

▲3.3.4. 在参数列表中把输出的参数放到输入参数之后

▲3.3.5. 为重载的方法省略常用的默认参数以提供一个较短的参数列表

▲3.3.6. 在无关的类型中为相同语义的操作提供重载方法

▲3.3.7. 建议使用接口而不是具体类作为参数

▲3.3.8. 建议使用集合而不是数组作为参数和返回值

▲3.3.9. 建议使用一般集合而不是原始(无类型)集合

▲3.3.10. 建议使用枚举而不是Boolean或者Integer作为参数

▲3.3.11. 建议把单个的参数放到集合或者数组参数之前

▲3.3.12. 建议把自定义类型的参数放大Java标准类型参数之前

▲3.3.13. 建议把对象类型的参数方法值类型的参数之前

▲3.3.14. 建议使用接口而不是具体类作为返回值

▲3.3.15. 建议把空的集合而不是null作为返回值

▲3.3.16. 建议把返回值设计成可以作为其他方法的合法输入参数

▲3.3.17. 考虑为不可变参数设计一个副本

▲3.3.18. 考虑在内部存储弱引用的对象

▲3.3.19. 避免参数数量变更

▲3.3.20. 避免参数长度太长(超过3个)

▲3.3.21. 避免连续的同类型的参数

▲3.3.22. 避免用作输出或者输入输出的参数

▲3.3.23. 避免方法重载

▲3.3.24. 避免参数类型暴露实现细节

▲3.3.25. 避免boolean参数

▲3.3.26. 避免返回null

▲3.3.27. 除了Java核心Api,避免把类型作为不相关的Api的返回值

▲3.3.28. 避免把可变的内部对象作为返回值来引用

▲3.3.29. 不要把预先设置的常量作为整型值参数使用

▲3.3.30. 不要为将来的(扩展设计)考虑预留参数

▲3.3.31. 不要在重载方法中改变参数的名称的顺序

3.4. 异常处理

▲3.4.1. 只有在异常情况下才抛出异常

▲3.4.2. 只需要为可恢复的错误抛出已确认的异常

▲3.4.3. 为了通知Api使用错误而抛出运行时异常

▲3.4.4. 在适当的抽象层次抛出异常

▲3.4.5. 进行运行时预置条件的检查

▲3.4.6. 为一个被不能为null的参数抛出空指针异常

▲3.4.7. 为一个除为null以外异常值的参数排除非法参数异常

▲3.4.8. 为一个错误上下文环境中的方法调用抛出非法状态异常

▲3.4.9. 在错误信息中显示出参数的预置条件

▲3.4.10. 确保失败的方法调用不会产生单向的后果

▲3.4.11. 为回调方法中的禁止使用的Api提供运行时检查

▲3.4.12. 建议优先使用Java标准异常

▲3.4.13. 建议提供抛出异常的条件的查询方法

3.5. 重写

▲3.5.1. 使用@Override注解

▲3.5.2. 维持或弱化预置条件

▲3.5.3. 维持或者加强后置条件(不好翻译,大概output+effect的意思)

▲3.5.4. 维持或者加强不可变性

▲3.5.5. 不要抛出新增的运行时异常

▲3.5.6. 不要更改方法的类型(无状态,访问器或者扩展方法等)

3.6. 构造方法

▲3.6.1. 最小化构造方法中的工作

▲3.6.2. 为所有的属性设置合理的默认值

▲3.6.3. 仅把构造方法的参数作为一种设置参数的快捷方法

▲3.6.4. 校验构造方法的参数

▲3.6.5. 以参数相应的属性为其命名

▲3.6.6. 当提供了多个构造方法时,遵循指南对其进行重载

▲3.6.7. 建议使用构造方法而不是静态的工厂方法

▲3.6.8. 考虑使用无参的构造方法

▲3.6.9. 如果不是总需要新的实例,考虑使用静态的工厂方法

▲3.6.10. 如果你需要在运行时决定一个合适的类型,考虑使用静态的工厂方法

▲3.6.11. 如果你需要访问外部的资源,考虑使用静态的工厂方法

▲3.6.12. 当面临非常多的参数的时候,考虑使用生成器(builder)

▲3.6.13. 当需要回避直接实例化类的时候使用考虑private的构造函数

▲3.6.14. 避免创建非必需的对象

▲3.6.15. 避免finalizer

▲3.6.16. 不要从无参的构造方法中抛出异常

▲3.6.17. 不要向一个已经发布的类中添加显示的构造方法

3.7. Setters和getters

▲3.7.1. 以get开头命名一个返回值不为boolean的访问属性的方法

▲3.7.2. 以is,can开头命名一个返回值为boolean的访问属性的方法

▲3.7.3. 以set开头命名一个更新本地变量的方法

▲3.7.4. 校验setter方法的参数

▲3.7.5. 最小化getter和setter方法的工作

▲3.7.6. 考虑从一个getter方法中返回不可变的集合

▲3.7.7. 考虑实现一个private接口的集合替代public的集合属性

▲3.7.8. 考虑只读的属性

▲3.7.9. 设置可变类型的属性时考虑Defensive Copy(Defensive Copy详见:http://www.javapractices.com/topic/TopicAction.doId=15)

▲3.7.10. 当返回可变类型的属性时考虑Defensive Copy

▲3.7.11. getter方法避免返回数组

▲3.7.12. 避免根据方法内信息无法完成的校验

▲3.7.13. 不要从getter方法中抛出异常

▲3.7.14. 不要设计只能set的属性方法(仅有public的setter而没有public的getter)

▲3.7.15. 不要依赖属性设置的顺序

3.8. 回调

▲3.8.1. 设计时使用最严密的预置条件

▲3.8.2. 设计时使用最弱的后置条件

▲3.8.3. 考虑传递引用对象的方法中把回调接口作为第一个参数

▲3.8.4. 避免有返回值的回调方法

3.9. 文档

▲3.9.1. 为每个方法提供Javadoc注释

▲3.9.2. 遵循标准的Javadoc约定

▲3.9.3. 每个方法以一句短小的话作为概述

▲3.9.4. 申明相关的方法

▲3.9.5. 用@deprecated标签申明过时的类型

▲3.9.6. 显示所有过时方法的替换方法

▲3.9.7. 避免冗长的zhus

▲3.9.8. 包含常用的使用模式

▲3.9.9. (如果允许的话)包含null值的确切含义

▲3.9.10. 包含方法的类型(无状态,访问器或者扩展)

▲3.9.11. 包含方法的预置条件

▲3.9.12. 包含算法实现的性能特征

▲3.9.13. 包含远程方法调用

▲3.9.14. 包含访问外部资源的方法

▲3.9.15. 包含哪些API可以在回调中使用

▲3.9.16. 考虑为了描述方法的行为而包含单元测试



欢迎加入我的知识星球,一起探讨架构,交流源码。加入方式,长按下方二维码噢:

已在知识星球更新源码解析如下:

  • 《精尽 Dubbo 源码解析系列》69 篇。

  • 《精尽 Netty 源码解析系列》61 篇。

  • 《精尽 Spring 源码解析系列》35 篇。

  • 《精尽 Spring MVC 源码解析系列》24 篇。

  • 《精尽 MyBatis 源码解析系列》34 篇。

  • 《数据库实体设计》17 篇。

目前在知识星球更新了《Dubbo 源码解析》目录如下:

01. 调试环境搭建
02. 项目结构一览
03. 配置 Configuration
04. 核心流程一览

05. 拓展机制 SPI

06. 线程池

07. 服务暴露 Export

08. 服务引用 Refer

09. 注册中心 Registry

10. 动态编译 Compile

11. 动态代理 Proxy

12. 服务调用 Invoke

13. 调用特性 

14. 过滤器 Filter

15. NIO 服务器

16. P2P 服务器

17. HTTP 服务器

18. 序列化 Serialization

19. 集群容错 Cluster

20. 优雅停机

21. 日志适配

22. 状态检查

23. 监控中心 Monitor

24. 管理中心 Admin

25. 运维命令 QOS

26. 链路追踪 Tracing

... 一共 69+ 篇

目前在知识星球更新了《Netty 源码解析》目录如下:

01. 调试环境搭建
02. NIO 基础
03. Netty 简介
04. 启动 Bootstrap

05. 事件轮询 EventLoop

06. 通道管道 ChannelPipeline

07. 通道 Channel

08. 字节缓冲区 ByteBuf

09. 通道处理器 ChannelHandler

10. 编解码 Codec

11. 工具类 Util

... 一共 61+ 篇

目前在知识星球更新了《数据库实体设计》目录如下:

01. 商品模块
02. 交易模块
03. 营销模块
04. 公用模块

... 一共 17+ 篇

目前在知识星球更新了《Spring 源码解析》目录如下:

01. 调试环境搭建
02. IoC Resource 定位
03. IoC BeanDefinition 载入

04. IoC BeanDefinition 注册

05. IoC Bean 获取

06. IoC Bean 生命周期

... 一共 35+ 篇

目前在知识星球更新了《Spring MVC 源码解析》目录如下:

01. Spring MVC 面试题
02. Spring MVC 学习指南
03. 调试环境搭建
04. 容器的初始化
05. 组件一览
06. 请求处理一览
07. HandlerMapping 组件
08. HandlerAdapter 组件
09. HandlerExceptionResolver 组件
10. RequestToViewNameTranslator 组件
11. LocaleResolver 组件
12. ThemeResolver 组件
13. ViewResolver 组件

14. MultipartResolver 组件

15. FlashMapManager 组件

... 一共 24+ 篇

目前在知识星球更新了《MyBatis 源码解析》目录如下:

01. 调试环境搭建
02. 项目结构一览
03. MyBatis 面试题合集

04. MyBatis 学习资料合集

05. MyBatis 初始化

06. SQL 初始化

07. SQL 执行

08. 插件体系

09. Spring 集成

... 一共 34+ 篇

源码不易↓↓↓↓↓

点赞支持老艿艿↓↓

用户存续期价值评估CLV(二) BG/NBD Model python模拟 BG/NBD Model …继续 想象每一个客户有两个硬币,一个“Buy Coin"控制客户购买的概率;一个"Die Coin"控制客户流失、不再购买的概率。 前面假设了客户的交易次数服从泊松过程: 在一年中的每个月,客户都以抛硬币的方式来决定是否购买。我们所观察到的购买次数取决与泊松分布的参数 ????。 %matplotlib inline import numpy as np impor... 阅读详情

相关推荐

一文搞定3D卷积

在讨论卷积核的时候,是不把channel维加进去的 核 = 一个可以滑动的窗口 窗口内不同位置数据之间的权值共享 3D卷积,卷积核会在3个方向上运动,那么卷积核的运动需要有三个自由度(一小块立方体,在一个大面包块内3个方向上滑动 2D卷积,卷积核只在2个方向上运动,因此只有两个自由度(一小片纸,在一大张纸内2个方向上滑动 1D卷积,卷积核只在1个方向上运动,因此只有一个自由度(一条滑窗,在一大长线上1个方向上滑动 一个卷积核运算一次 得到一个输出值 以上讨论了单个卷积核,接下来考虑多通道,一个卷积核对应一

njuptalex的博客 3万+

java接口开发规范

java开发规范

qq_41604890的博客 3083

LobeHub开源AI应用平台:从部署到定制的全栈实践指南

在现代AI应用开发领域,大语言模型(LLM)的集成与部署是核心技术挑战之一。其原理在于通过API或本地化部署,将预训练模型的强大能力封装为可调用的服务。这项技术的核心价值在于极大地降低了AI应用的开发门槛,使开发者能够快速构建智能对话、内容生成等场景的应用。随着模型即服务(MaaS)模式的普及,一个关键痛点是如何高效地管理多模型、设计友好的用户界面并实现功能扩展。这正是开源项目LobeHub所聚焦的领域,它通过提供可插拔的架构和配置驱动的低代码理念,解决了AI能力落地的“最后一公里”问题。本文将结合Dock

weixin_27210125的博客 758

11 Java接口(语法、规范、微观&宏观接口)

Java接口:语法、规范、微观&宏观接口

yinying293的博客 782

【Qt开发教程】网络代理QNetworkProxy类详解及实战应用

QNetworkProxy 提供了一种灵活而强大的方式来配置和管理网络代理,通过设置代理类型、主机、端口和认证信息,可以使应用程序的所有网络请求通过代理服务器进行。结合 QNetworkProxyFactory 可以实现动态代理选择和自动配置,提高应用的网络通信能力和安全性。在实际应用中,通过合理设置代理、处理代理认证和错误情况,可以确保应用程序在复杂的网络环境中稳定运行,为用户提供可靠的网络访问体验。

科技改变人类,技术成就未来 1543

〔重庆理工大学〕计算机组成原理课设报告--16位单周期CPU设计

本课程设计的实验平台为Altera Quartus II 软件和Altera Cyclone V Starter 工具箱。(1)Cyclone V是Altera FPGAs家族的一类,它面向低功耗应用。Cyclone V GX 5CGXFC5C6F27C7N 芯片有不同的转换器,按钮,LED灯,七段显示器,HDMI接口,SD卡读卡器以及其他链接等。Cyclone V GX 5CGXFC5C6F27C7N是Starter工具箱的重要组件。(2)测试台包含在测设备(DUT)和用于仿真的模拟输入。

Pretty Boy Fox的博客 1068

Java API接口开发规范

Java API接口开发规范

bjzhang75的博客 4269

EMB电子机械制动执行器五大核心部件选型解析

本文介绍了EMB电子机械制动执行器五大核心部件的选型方案:采用无刷直流电机作为驱动源,兼具高扭矩和快速响应特性;选用滚珠丝杠传动机构,实现高效旋转-直线转换;行星齿轮减速器满足紧凑空间内的增扭需求;QT450-QT550材质的钳体确保刚度要求;应变片式压力传感器实现夹紧力精确测量。各部件选型综合考虑了性能、可靠性和空间限制,为EMB系统设计提供了完整解决方案。

m0_59012156的博客 1759

Java基础-接口的使用规范

接口使用规范

qq_58422479的博客 1916

汽车LIN总线(3) -- 协议层:帧的类型

主要介绍LIN协议层中帧的类型,介绍中加入一点自己的理解(带下划线的是,其余是官方资料)。

晴朗luo的博客 890

网表导入virtuoso后发现pg pin忘记connect_pg_net/globalNetConnect怎么办?

数模混合项目中经常需要一些需要到virtuoso去连接的线,比如IO上的pg和一些信号线,除了在pr工作中设置skip route之外还需要做好net的赋值,告诉工具虽然我没在物理上有连接,但是实际上应该连什么net,这部分提现在网表里。在Default Net Name中也填写net name,因为这个net需要做global操作,即在顶层定义这个net,所以需要在net name后加个!打开schematic,删除指定cell pin所接net的label。

m0_61544122的博客 973

Java API 设计清单 « 友好的API

转自:http://dongxi.net/b14gn 在设计Java API的时候总是有很多不同的规范和考量。与任何复杂的事物一样,这项工作往往就是在考验我们思考的缜密程度。就像飞行员起飞前的检查清单,这张清单将帮助软件设计者在设计Java API的过程中回忆起那些明确的或者不明确的规范。本文也可以看作为“API设计指南”这篇文章的附录。 我们还准备了一些前后比对的例子来展示这个列...

WEBCODE 110

2.0 电子凸轮 西门子1500电子凸轮使用研究1

本文研究了S7-1500T电子凸轮同步控制技术,通过仿真实验得出以下结论:1)通过比例系数可调整凸轮曲线形状;2)解除同步需调用从轴其他运动指令;3)详细阐述了凸轮同步的5个实施步骤。重点分析了三种同步类型(主值距离同步、动态参数同步和直接同步)的特点及应用场景,并探讨了缩放系数、偏移量等参数对凸轮曲线的影响。同时介绍了凸轮应用模式及常见异常处理方法,为工程应用提供了重要参考。

qq_34047402的博客 811

Java API 设计清单

在设计Java API的时候总是有很多不同的规范和考量。与任何复杂的事物一样,这项工作往往就是在考验我们思考的缜密程度。就像飞行员起飞前的检查清单,这张清单将帮助软件设计者在设计Java API的过程中回忆起那些明确的或者不明确的规范。本文也可以看作为“API设计指南”这篇文章的附录。 我们还准备了一些前后比对的例子来展示这个列表如何帮助你理清设计需求,找出错误,识别糟糕的设计实践以及如何寻

我以我名,行我道! 895

lwip-2.0.3

lwip是瑞典计算机科学院(SICS)的Adam Dunkels 开发的一个小型开源的TCP/IP协议栈。实现的重点是在保持TCP协议主要功能的基础上减少对RAM 的占用。

RU DOS版、EFI版32bit/64bit BIOS常用工具

DOS版、EFI版的RU工具,可用来查看IO、MEM、PCI、SMBIOS等资源。亲测在EFI SHELL下可用。

Java API设计清单

在设计Java API的时候总是有很多不同的规范和考量。与任何复杂的事物一样,这项工作往往就是在考验我们思考的缜密程度。就像飞行员起飞前的检查清单,这张清单将帮助软件设计者在设计Java API的过程中回忆起那些明确的或者不明确的规范。本文也可以看作为“API设计指南”这篇文章的附录。 我们还准备了一些前后比对的例子来展示这个列表如何帮助你理清设计需求,找出错误,识别糟糕的设计实践以及...

青年IT男 273

霍尼韦尔SoftMaster使用说明

霍尼韦尔SoftMaster使用说明

(转)Java API设计清单

转自: 伯乐在线 Java API设计清单 英文原文 TheAmiableAPI     在设计Java API的时候总是有很多不同的规范和考量。与任何复杂的事物一样,这项工作往往就是在考验我们思考的缜密程度。就像飞行员起飞前的检查清单,这张清单将帮助软件设计者在设计Java API的过程中回忆起那些明确的或者不明确的规范。本文也可以看作为“API设计指南”这篇文章的附录。   我们还准...

weixin_34290000的博客 118

数学建模模型总结

这是本人在两年内准备参加数学建模竞赛搜集到的模型资料,已经经过了本人的筛选和整理,希望能够对准备参加数学建模竞赛的学弟学妹们提供一些帮助!

API及接口清单

API及接口清单

kelly_yun的博客 1921
上一篇: 你应该如何正确健壮后端服务?
下一篇: 是什么使你留在你的公司
公众号-芋道源码
博客等级 码龄10年 1639粉丝 377原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值