什么是好的接口?我们总是在用一些模式或者理论来定位它,然而更多的时候,我们应该采取换位思考的模式来定义接口,也就是说你站在用你的接口的那些人的角度去看问题,或者你来使用你的接口,凭此它的可靠性,扩展性和可用性,如果连你都觉得接口不够清晰,你又如何说服别人用呢?举个例子
情景:Web上要显示某个类别下所有的用户列表。用户切换不同的类别(以下拉框的形式),界面将显示此类别下的所有用户信息(以列表的形式)
接口:List<User> getUserList(List<Type> type) throws Exception
问题:设计人员根本没有考虑使用者的感受,如果你来调用接口,你更希望传递的是某一个Type,而不是列表!当然从代码的角度将一个对象转换成为List是非常简单的事情(Arrays.asList), jdk就有现成的,可是你怎么看都用着非常的别扭,似乎这个方法根本就不是为你准备的,而且可以想象你很担心返回的结果。从实现者的角度,他也会很难受,因为他需要些更多的代码去排除参数的合法与合理性,这是得不偿失呀!
解决:很简单,拆成两个方法
List<User> getUserList(Type type) throws Exception;
List<User> getUserList<List<Type> type> throws Exception;
这样是不是看起来舒服多了?既考虑到了不用的用户,接口也变得更具有亲和力,你说呢?
分享到:
相关推荐
《换位思考》教案是教育者们精心设计的课程,旨在引导学生深入理解并熟练运用这一技巧。通过一系列的教学活动,学生们将有机会体验不同的视角,并在实际生活中应用换位思考,提升自己的交际能力与社会适应性。 课程...
1. 换位思考:换位思考是一种重要的思维方式,它要求我们设身处地地站在他人的角度去理解和感受问题。在“人”字形游戏中,虽然越南公司的学员不会汉字,但这个游戏旨在展示如何从他人的视角考虑问题。当我们尝试从...
主题班会-换位思考,律己宽人[宣贯].ppt
最后,我们要认识到,换位思考并不是一种简单的技巧,而是一种需要持续修炼和实践的能力。它需要我们不断地在不同的生活场景中练习,从微小的日常互动到重大的人生决策,都能体现出换位思考的价值和力量。通过这样的...
医院开展“假如我是一名患者”换位思考大讨论心得体会参考.doc
【换位思考与小事做起】在管理中的应用 在日常工作中,换位思考是一种非常重要的思维...在实际工作中,我们应该积极学习和实践这种思维方式,让换位思考成为我们日常工作的一部分,从而实现个人成长与团队发展的双赢。
教案中的活动设计富有创意,紧紧围绕着换位思考这一核心理念。首先,热身游戏——抓手指,让学生们在轻松愉快的氛围中,体会到快速反应与策略选择的重要性,从而为后续的活动内容打下基础。紧接着,通过独特的盲人与...
总结来说,本课内容主要围绕宽容的价值、实践宽容的原则以及换位思考在人际交往中的应用展开,旨在培养学生的同理心和道德素养,促进社会和谐共生。通过理论学习和情境分析,让学生理解并践行这些核心价值观,以实现...
6. 处理误会:面对误会,我们应该采取理性和平和的态度,如选项B所述,通过换位思考和相互尊重来解决问题,而不是据理力争或忍气吞声。 7. 换位思考的应用:选项A表示在不理解他人时尝试理解,是换位思考的体现;...
本教学设计围绕“八年级政治上册 第9课 第二框”的主题——“换位思考 与人为善”,旨在帮助学生理解并实践“己所不欲,勿施于人”的原则,培养他们的同理心、宽容与尊重他人的品质。通过课堂活动和案例分析,促进...
【描述】: 本内容主要探讨了"己所不欲,勿施于人"这一道德原则及其在日常生活中的应用,通过实例阐述了换位思考的重要性,以及如何培养学生的理解和同情心。 【标签】: 换位思考, 人为善, 己所不欲勿施于人, 教育, ...
本文档是关于八年级政治课程“换位思考与人为善”的教学设计,主要涉及以下几个核心知识点: 1. **“己所不欲,勿施于人”**:这是儒家伦理思想的一个重要原则,意指不应将自己的不希望遭遇的事情强加给别人。在...
通过这样的教案设计,学生不仅能学习到换位思考的理论知识,还能在课堂活动中体验和实践这一能力,从而在日常生活中更好地理解和接纳他人,营造和谐的人际氛围。这不仅有助于学生的个人成长,也符合人教新课标版的...
在此理念的指导下,教师在教学设计中必须摆脱传统教学中的“以教师为中心”的模式,转而采用“换位思考”的策略,即站在学生的角度思考问题,以学生为中心,深入了解学生的心理和认知结构。 在进行教学设计时,教师...
换位思考不是一个自然而然发生的过程,因为人们往往习惯于从自己的立场出发,以自己的经历和标准来衡量和判断他人。然而,只有当我们放下自我,试图真正站在他人的立场上思考,才能做到真正的理解和接纳。无论是在...
在当今社会,换位思考已经成为了一种必需的技能,无论是在工作中,学习中还是在日常生活中,它的重要性都日益凸显。换位思考,顾名思义,是一种设身处地为他人着想的思维方式,它要求我们站在别人的立场上去思考问题...
1. **课程内容**:本课属于八年级政治上册第四单元《交往艺术新思维》的第九课《心有他人天地宽》,主要探讨的是“换位思考”和“与人为善”的概念,旨在提升学生的道德素养和社会交往能力。 2. **教材分析**:...
1. **面向对象编程(OOP)**:Java是一种典型的面向对象编程语言,它鼓励我们将程序设计为相互协作的对象集合。在这个“动物换位”的场景中,我们可能会创建不同的动物类,如Dog、Cat等,每个类都有其特定的行为和...
换位思考追求双赢.pptx
- 在遇到他人做出可能对自己不利的行为时,如随手扔垃圾,我们应该思考他们可能的动机,如缺乏环保意识,而不是立即谴责。 - 对于拾金不昧的环卫工人,他们的善良行为体现了“己所不欲,勿施于人”的精神,值得...