Skip to content

Commit 6f53e14

Browse files
committed
see the log
1 parent 6daf80a commit 6f53e14

File tree

1 file changed

+15
-16
lines changed

1 file changed

+15
-16
lines changed

README.md

+15-16
Original file line numberDiff line numberDiff line change
@@ -44,17 +44,15 @@
4444

4545
哪块要添新功能,只改某一个 package 下的东西。
4646

47-
按 class 职能分层(PBL降低了代码耦合,但带来了 package 耦合,要添新功能,需要改 model、dbHelper、view、service 等等,需要改动好几个 package 下的代码,改动的地方越多,越容易产生新问题,不是吗?
47+
PBL 降低了代码耦合,但带来了 package 耦合,要添新功能,需要改 model、dbHelper、view、service 等等,需要改动好几个 package 下的代码,改动的地方越多,越容易产生新问题,不是吗?
4848

49-
按功能分包(PBF),featureA 相关的所有东西都在 featureA 包,feature 内高内聚高度模块化,不同 feature 之间低耦合,相关的东西都放在一起,还好找。
49+
PBF 的话 featureA 相关的所有东西都在 featureA 包,feature 内高内聚、高度模块化,不同 feature 之间低耦合,相关的东西都放在一起,还好找。
5050

5151
* package 有私有作用域(package-private scope)
5252

5353
你负责开发这块功能,这个目录下所有东西都是你的。
5454

55-
PBL 的方式是把所有工具方法都放在 util 包下,小张开发新功能时候发现需要一个 xxUtil,但它又不是通用的,那应该放在哪里?没办法,按照分层原则,我们还得放在 util 包下,好像不太合适,但放在其它包更不合适,功能越来越多,util 类也越定义越多。后来小李负责开发一块功能时发现需要一个 xxUtil,同样不通用,去 util 包一看,怎么已经有了,而且还没法复用,只好放弃 xx 这个名字,改为 xxxUtil……,因为 PBL 的 package 没有私有作用域,每一个包都是 public(跨包方法调用是很平常的事情,每一个包对其它包来说都是可访问的)。
56-
57-
如果是 PBF,小张的 xxUtil 自然放在 featureA 下,小李的 xxUtil 在 featureB 下,如果觉得 util 好像是通用的,就去 util 包看看要不要把工具方法添进 xxUtil, class 命名冲突没有了。
55+
PBL 的方式是把所有工具方法都放在 util 包下,小张开发新功能时候发现需要一个 xxUtil,但它又不是通用的,那应该放在哪里?没办法,按照分层原则,我们还得放在 util 包下,好像不太合适,但放在其它包更不合适,功能越来越多,util 类也越定义越多。后来小李负责开发一块功能时发现需要一个 xxUtil,同样不通用,去 util 包一看,怎么已经有了,而且还没法复用,只好放弃 xx 这个名字,改为 xxxUtil……,因为 PBL 的 package 没有私有作用域,每一个包都是 public(跨包方法调用是很平常的事情,每一个包对其它包来说都是可访问的);如果是 PBF,小张的 xxUtil 自然放在 featureA 下,小李的 xxUtil 在 featureB 下,如果觉得 util 好像是通用的,就去 util 包看看要不要把工具方法添进 xxUtil, class 命名冲突没有了。
5856

5957
PBF 的 package 有私有作用域,featureA 不应该访问 featureB 下的任何东西(如果非访问不可,那就说明接口定义有问题)。
6058

@@ -209,7 +207,7 @@ com
209207
| `handleXX()`, `processXX()` | 对数据进行处理的方法 |
210208
| `displayXX()`, `showXX()` | 弹出提示框和提示信息,使用 display/show 为前缀标识 |
211209
| `updateXX()` | 更新数据 |
212-
| `saveXX()`, `insertXX()` | 保存或插入数据 |
210+
| `saveXX()`, `insertXX()` | 保存或插入数据 |
213211
| `resetXX()` | 重置数据 |
214212
| `clearXX()` | 清除数据 |
215213
| `removeXX()`, `deleteXX()` | 移除数据或者视图等,如 `removeView()` |
@@ -284,13 +282,13 @@ public class MyClass {
284282

285283
例如:`mFirstBook``mPrevBook``curBook`
286284

287-
| 量词列表 | 量词后缀说明 |
288-
| ------- | ----------- |
289-
| `First` | 一组变量中的第一个 |
290-
| `Last` | 一组变量中的最后一个 |
291-
| `Next` | 一组变量中的下一个 |
292-
| `Prev` | 一组变量中的上一个 |
293-
| `Cur` | 一组变量中的当前变量 |
285+
| 量词列表 | 量词后缀说明 |
286+
| ------- | ---------- |
287+
| `First` | 一组变量中的第一个 |
288+
| `Last` | 一组变量中的最后一个 |
289+
| `Next` | 一组变量中的下一个 |
290+
| `Prev` | 一组变量中的上一个 |
291+
| `Cur` | 一组变量中的当前变量 |
294292

295293

296294
##### 3.5.4 Type1(数据类型)
@@ -727,7 +725,7 @@ public Observable<Location> syncLocations() {
727725
| `fragment_music_player.xml` | 音乐片段的播放器 `类型_模块名_逻辑名称` |
728726
| `dialog_loading.xml` | 加载对话框 `类型_逻辑名称` |
729727
| `ppw_info.xml` | 信息弹窗(PopupWindow) `类型_逻辑名称` |
730-
| `item_main_song.xml` | 主页歌曲列表项 `类型_模块名_逻辑名称` |
728+
| `item_main_song.xml` | 主页歌曲列表项 `类型_模块名_逻辑名称` |
731729

732730

733731
#### 5.5 菜单资源文件(menu/)
@@ -957,6 +955,7 @@ public static byte[] bitmap2Bytes(Bitmap bitmap, CompressFormat format) {
957955
}
958956
```
959957

958+
960959
#### 8.3 块注释
961960

962961
块注释与其周围的代码在同一缩进级别。它们可以是 `/* ... */` 风格,也可以是 `// ...` 风格(**`//`后最好带一个空格**)。对于多行的 `/* ... */` 注释,后续行必须从 `*` 开始, 并且与前一行的 `*` 对齐。以下示例注释都是 OK 的。
@@ -1162,12 +1161,12 @@ AS 已帮你集成了一些注释模板,我们只需要直接使用即可,
11621161
| message | msg |
11631162
| password | pwd |
11641163
| position | pos |
1165-
| previous | pre |
1164+
| previous | prev |
11661165
| selector | sel(主要用于某一 view 多种状态,不仅包括 ListView 中的 selector,还包括按钮的 selector) |
11671166
| server | srv |
11681167
| string | str |
11691168
| temporary | tmp |
1170-
| window | wnd(win) |
1169+
| window | wnd(win) |
11711170

11721171
程序中使用单词缩写原则:不要用缩写,除非该缩写是约定俗成的。
11731172

0 commit comments

Comments
 (0)