脱线道士维克多

创建用户故事地图 (User Story Mapping) 的8个步骤

用户故事地图已经成为敏捷需求规划中的一个流行方法。用户故事地图可以将你的backlog变成一张二维地图，而不是传统的简单列表。用户故事地图可以解决以下问题让你更容易看清 backlog 的全貌为新功能筛选（grooming）和划定优先级提供了更好的工具，帮助你做出决策便于使用静默头脑风暴模式和其他协作方式来产生用户故事帮助你更好的进行迭代增量式开发，同时确保早期的发布可以验证整体架构和解决方案为传统的项目计划提供了一个更好的替代工具有助于激发讨论和管理项目范围允许你从多个维度进行项目规划，并确保不同的想法都可以得到采纳创建用户故事地图的8个步骤召集 3-5 名对产品非常熟悉的人员参与。不要互相讨论。每个人在便签纸上写下自己认为重要的所要做的事情也就是用户任务（user task），便签都会以一个动词开头，如：发送邮件、创建联系人、添加用户等。...

by Victor Jun 3, 2017

如何写好 User Story

User Story 入门对于敏捷开发来说，User Story 是开发的基础，它不同于传统的瀑布式开发方式，而是把原本需求拆成最小粒度的 Story，以方便拆分 Task，估计开发时间，领取开发任务。什么是用户故事 (User Story) 用户故事是从用户的角度来描述用户渴望得到的功能。用户故事不能够使用技术语言来描述，要使用用户可以理解的业务语言来描述。一个好的用户故事包括三个要素：角色：谁要使用这个功能。活动：需要完成什么样的功能。商业价值：为什么需要这个功能，这个功能带来什么样的价值。用户故事通常按照如下的格式来表达：英文： As a <Role>,...

by Victor Jun 2, 2017

Rails 5 Controller Tests

controller tests 不再是 unit tests Rails 5 的 controller tests 现在成了 integration tests。这意味着好多内部交互的功能都被移除了。如果你过去的项目因为某些原因撸了一大堆 controller tests，那你会发现有一大堆过去在测试代码里面用的 hacks 技巧都不能再用了。 ActionController::TestCase is deprecated...

by Victor May 15, 2017

reverse_merge 为方法设置默认参数的技巧

先来看一下 hash 的 merge 方法。 h1 = { "a" => 100, "b" => 200 } h2 = { "b" =>...

by Victor May 12, 2017

Mocking in Ruby with Minitest

在做单元测试的时候，如果要测试的方法需要引用外部依赖的对象，比如：发送邮件，网络通讯，记录Log, 文件系统之类的。而我们没法控制这些外部依赖的对象。为了解决这个问题，我们需要用到 Stub 和 Mock 来模拟这些外部依赖的对象。基本概念 Dummies dummy 是最简单的概念。当我们在写测试的时候，为了避免 ArgumentError 错误，需要给方法传递一些并不真实使用的对象，通常都是使用 Object.new 来模拟。 Stub stub 跟 dummy 很像，但是 stub...

by Victor May 12, 2017

Best way to set a header to all tests using MiniTest

在使用 Rails 构件 API 应用的时候，通常会把用户的 token 放在 request.header 中。在测试时候，我们可以通过下面的方式，给所有的 controller test 文件都加上 token # test/lib/custom_header_setup.rb module CustomHeaderSetup def before_setup super...

by Victor May 8, 2017

Rename a method in Ruby: alias_method and remove_method

一个子类继承自父类，并且重载了父类的一个实例方法，想让子类的实例对象访问父类中的原方法：假设有如下代码： class Animal def speak puts "..." end end class Cat < Animal def speak puts "Mew..." end end...

by Victor May 5, 2017

Effective Ruby 2 - 类、对象和模块（下）

类、对象和模块 11 通过在模块中嵌入代码来创建命名空间通过在模块中嵌入代码来创建命名空间让命名空间结构和目录结构相同如果创建命名空间的模块已经定义过，可以在类定义中直接使用模块和类路径分隔符 class Notebooks::Binding 如果使用时可能出现歧义，可使用 :: 来限定定级常量，比如 ::Array 一个典型的应用场景是，现在入口源文件中定义了命名空间模块，随后加载所有剩下的源文件。下面也是一个可能会遇到的坑。根据词法作用域，initialize 方法中的 Array 实际上找到的是 Cluster::Array。 module Cluster...

by Victor Nov 6, 2016

Effective Ruby 2 - 类、对象和模块（上）

类、对象和模块 06 了解 Ruby 如何构建继承体系对象是变量的容器。这些变量被称为实例变量并代表了一个对象的状态。类是方法和常量的容器。这些方法被称为实例方法并代表了类的所有实例对象的行为。超类 superclass 就是父类的别名。类是 Class 的实例，模块是 Module 的实例。模块没有 new 方法。单例类 singleton class...

by Victor Nov 1, 2016

Effective Ruby 1 - 让自己熟悉 Ruby

让自己熟悉 Ruby 01 理解 Ruby 中的 True 除了 false 和 nil 外所有的值都表示真值如果你需要区分 false 和 nil，可以使用 nil? 方法或 == 操作符并将...

by Victor Oct 30, 2016

Mac下载神器aria2

一直在刷过固件的路由器上使用 aria2，最近因为某些原因只能在自己电脑上使用 aria2，所以简单总结下。简介下载网盘资源速度快，轻量多线程，还能下载 bt。安装 ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" < /dev/null 2> /dev/null brew install aria2 配置和使用...

by Victor Oct 7, 2016

How To Change The View Path Of A Controller In Rails

多个控制器共享模板根据 Rails 的建议，应该把 shared 模板放在 view/application 目录下，但是你也可以选择另外一个方案。比如，我们想在另外一个控制器，使用 app/views/posts 的模板。 class UserPostsController def self.controller_path "posts" # change path from...

by Victor Sep 26, 2016

Ruby 中的 eval 与 binding

内部函数 The Kernel module is included by class Object, so its methods are available in every Ruby object. 严格说来 Ruby...

by Victor Sep 19, 2016

也可以不用 Figaro

配置文件基础我们在项目中总会遇到一些不希望泄漏的配置信息，比如你的短信服务商提供的 API KEY 之类的。最简单的做法是把这些值通过环境变量的方式传递进来，比如 API_KEY=xxxx rails s，在项目的任何地方都可以直接 ENV['API_KEY']。而当环境变量多了一些的时候，就可以把这些放在 .zshrc 之类的地方。另外一种做法是自己建立一个 YML 配置文件注意不能提交到版本库。 echo /config/application.yml >> .gitignore...

by Victor Sep 18, 2016

How to DRY Your Rails Routes

工作中经常会遇到一些资源之间要共享路由，就像 controller 和 model 的 concern 文件夹一样，Rails 4 开始对 routes 也提供了 concern 功能，而且用起来很简单。 concern :printable do member do post :print...

by Victor Sep 11, 2016

使用工具提高 Rails 代码质量

每个人都可能用正确的风格写出质量低下的代码，这其中可能包括：重复的代码，它们可能存在于同一个类或不同类中不一致或没有标识性的对象、变量或方法命名过长的代码段让人费解的布尔表达式过于复杂的逻辑判断对象错误地暴露其内部状态遭废弃但没有删除的类或方法对这些检查，仅靠工具可能就不够了。重构这些代码，需要我们先写测试，然后提 PR，找个人来帮我们 Review 这部分代码。重构一个系统时，应该从引入工具开始。 CSS 无用代码检测 Dead Weight 可以检测你的项目中有哪些 CSS 选择器几乎从不使用，这样你可以安全的删除这些无用的样式。尴尬的是，这个...

by Victor Sep 8, 2016

Creating staging and other environments in Rails

Rails 默认有三种环境 development、testing 和 production。有时我们需要一个 staging 环境。比如你在本地或者产品机器上想要运行一个和 production 略有不同的环境，大部分都一样只是数据库不同。这时最好的办法是单独建一套 staging 环境，你需要做的是如下几步：创建一个新的 config/environments/YOUR_ENVIRONMENT.rb 文件在 config/database.yml 配置新的数据库源在 config/secrets.yml...

by Victor Aug 25, 2016

Turbolinks 5

简介 Turbolinks 让 Web 应用页面之间的导航变得更快。你不需要引入一个客户端的 JavaScript 框架就能得到单页应用的性能。你只需要和过去一样在服务器端渲染 HTML，然后在上面加几个超链接。当用户点击该链接的时候，Turbolinks 自动获取页面，替换掉 <body>，合并 <head>, 减少页面载入的时间。功能自动提高页面导航的性能。不需要指定哪个链接或哪部分页面需要被替换。不需要服务端提供额外的支持。服务端仍然渲染整个 HTML 页面，而不是返回局部模板或 JSON。尊重 Web...

by Victor Aug 15, 2016

Skipping Validations in Ruby On Rails

当模型划分的足够好的时候，下面的技术应该用不上。 Skip All Validations def create @product = Product.new(product_params) if @product.save(validate: false) redirect_to products_path, notice: "#{@product.name} has been created." else...

by Victor Aug 10, 2016

Rails 的锁机制

并发数据库管理系统（DBMS）中的并发控制的任务是确保在多个事务同时存取数据库中同一数据时不破坏事务的隔离性和统一性以及数据库的统一性。只要有资源的争用就少不了使用各种锁，包括关系数据库中使用的悲观锁和乐观锁，本文主要讲我们日常开发中很大可能会用到的两种锁。常见的并发冲突丢失更新：一个事务的更新覆盖了其它事务的更新结果，就是所谓的更新丢失。例如：用户 A 把值从 6 改为 2，用户 B 把值从 2 改为 6，则用户 A 丢失了他的更新。脏读：当一个事务读取其它完成一半事务的记录时，就会发生脏读取。例如：用户...

by Victor Aug 9, 2016

Handling Exceptions

默认情况下，当代码遇到意外情况时 Rails 会在产品环境渲染 public 文件夹下面的静态文件。我们也可以自定义这一过程。基本 # config/environments/development.rb config.consider_all_requests_local = false # config/application.rb config.action_dispatch.rescue_responses["TaxonomiesController::Forbidden"] = :forbidden class TaxonomiesController <...

by Victor Aug 1, 2016

CentOS 7 服务器配置

关于如何配置 ssh 和 sshd 的问题，请找 Blog 中的相关文章，这里不再敖述。 root 执行语言问题 vi /etc/environment LANG=en_US.utf-8 LC_ALL=en_US.utf-8 欢迎界面利用工具可以生成一些欢迎字体，放在 /etc/motd 就行。...

by Victor Jun 20, 2016

Gemfile 中版本号的说明

source 'https://rubygems.org' gem 'rails', '>= 5.0.0.beta4', '< 5.1' gem 'sqlite3' gem 'puma', '~> 3.0' gem 'sass-rails', '~> 5.0' gem 'uglifier',...

by Victor May 18, 2016

在 Mac 上使用 PlantUML 画 UML

什么是 PlantUML PlantUML 是一个画图脚本语言，用它可以快速地画出各种 UML 图，时序图、流程图、用例图、状态图、组件图什么的。安装我最近一年主力编辑器是 Atom，所以下面的演示方案也是基于 Atom brew install graphviz brew install plantuml apm install language-plantuml apm...

by Victor Apr 5, 2016

UML 类图学习小结

类图是使用频率最高的 UML 图之一。类图的作用有：用于描述系统中所包含的类以及它们之间的相互关系帮助人们简化对系统的理解是系统分析和设计阶段的重要产物是系统编码和测试的重要模型依据类类 Class 封装了数据和行为，是面向对象的重要组成部分，它是具有相同属性、操作、关系的对象集合的总称。一个类可以有多种职责，设计得好的类一般只有一种职责在定义类的时候，将类的职责分解成为类的属性（数据职责）和方法（行为职责）类将被实例化成对象 Object，对象对应于某个具体的事物，是类的实例 Instance 在系统分析与设计阶段，类通常可以分为三种，分别是实体类 Entity Class、控制类...