README.rdoc in ns_service_pack-0.1.1 vs README.rdoc in ns_service_pack-0.1.2
- old
+ new
@@ -1,44 +1,55 @@
= ns_service_pack
- 实现REST架构(ROA)中Service层部分基础代码抽取
+ 实现REST架构(ROA)中Service层基础代码抽取
-== 功能列表:
+== 功能列表
* 支持自定义json格式的资源crud操作
* 提供全局字典常量/转换管理
* 提供数据库层-业务层字段自动转换
+* 宿主应用的发布接口管理和测试
-== TODO TASK LIST
+== TODO LIST
+
+* REST接口测试平台开发
+ 如何用get请求模拟post请求?
* 规划文档和内容调整
* 写完整测试
* index默认查询条件加入,传入条件的merge(目前已提供传入条件的精确搜索)
-* 如何用get请求模拟post请求
-#==NS Service Pack使用指南
+== 使用指南
*1 在rails3项目中使用,命令行执行:
gem install ns_service_pack
- ns_service_pack install
+ nsp install
bundle install
*2 为某资源生成有service支持的scaffold,命令行:
rake g ns:scaffold
-*3 提示:
- 常量的使用:GlobalConst.ns_statuses[key_or_value]
+*提示:
+ 常量引用和转换:GlobalConst.ns_statuses[key_or_value]
+ 内置接口: /interfaces, /mappings, /constants
-== Contributing to ns_service_pack
-
-* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
-* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
-* Fork the project
-* Start a feature/bugfix branch
-* Commit and push until you are happy with your contribution
-* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
-* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+== 项目引用0.0.x到0.1.x升级帮助(仅需四步,5~10分钟,绝对无痛哦!)
-== Copyright
+* 获取最新版本: gem install ns_service_pack
+* rails项目根目录下: nsp install && bundle install(此步检查下Gemfile,确保引用最新,或gem 'ns_service_pack', '~>0.1')
+* Models中明确引用: include FieldMapping
+* ApplicationController或!子类!中添加引用: include ControllerServicable
+= 验证是否成功?
+* 访问: http://xxx/,非生产环境会重定向到/interfaces, 点击示例中的链接(动态生成)
+= 相关背景
+* 已停止支持 nclient gem, 相关功能会融合在nsp中
+* 扩展为rails的engine,包含自己的生成器等
+* 以后有时间时,可以开发内部接口测试和性能监控平台,进行有效的集中管理和共有问题处理;对数据库层进行更好的封装
-Copyright (c) 2011 caory. See LICENSE.txt for
-further details.
+== 相关问题更新和反馈
+== 版本历史
+
+ref: CHANGELOG
+
+== Copyright
+
+Copyright (c) 2011 caory and ns. Please let me know in advance if you plan to refer this codebase. Thanks!