CSC/ECE 517 Spring 2015/oss E1504 IMV
E1504. Refactoring the Bookmark Model
This page provides a description of the Expertiza based OSS project. This team project successfully refactored the Bookmark Model by removing the duplicate code, combining the methods, improving the search function, moving Bmapping model methods to their respective class, covering dependencies associated with changed segments and adding a User Interface for using bookmarks.
Introduction to Expertiza
Expertiza is a project developed using the Ruby on Rails platform. It provides features like peer review, team assignments and submission of projects. This can be achieved by submitting code base, URL of hosted code on remote server and Wiki submissions. It is an open source application and the code can be cloned from GitHub. This application provides an efficient way to manage assignments, grades and reviews, which makes the process easier and faster when the class strength is large.
Expertiza is supported by National Science Foundation under Grant No. 0536558. Additional funding from the NCSU Learning in a Technology-Rich Environment (LITRE) program, the NCSU Faculty Center for Teaching and Learning, the NCSU STEM Initiative, and the Center for Advanced Computing and Communication.
Problem Statement
Classes involved:
bookmark.rb bmapping.rb bookmarks_controller.rb auth_controller.rb auth_helper.rb
What they do: The bookmark model and controller help in creating user specific bookmarks, which can be added to topics. Also, they provide the functionality to edit these bookmarks by the created user. These bookmarks are searchable based on users and tags.
What needs to be done: The search methods in bookmarks model are being used used in a very granular level. This led to redundancy in bookmarks search methods. These methods include search_alltags_allusers, search_fortags_allusers, search_fortags_forusers, search_alltags_forusers. Hence duplicacies in these methods are to be singled out. As we know, in ruby, the method name should specify the pseudo use of itself. Here, add_new_bookmark misleads as this is one of the CRUB method and the naming convention is not quite right. It has to be renamed to create method. Again the case of duplicates arrive. Now in the methods add_topic_bookmark, add_this_bookmark, add_bookmark . The difference between add_topic_bookmark and add_this_bookmark is that the former takes an extra input i.e. topicid. Hence these two can be moved into one method. The third method is an unnecessary repetition of the former two methods' functionality. The method name edit_this_bookmark should be renamed to edit along with updating all the dependencies corresponding to edit_this_bookmark .Lastly, add_bmapping and add_bmapping_signuptopic have to be moved to appropriate class i.e. bmapping class. This involves checking their dependencies and updating their function calls accordingly.
Changes Made
Bookmark Model
| Method Name | Changes Made | Reason For Change |
|---|---|---|
| add_this_bookmark | ---------------- | ----------- |
| add_topic_bookmark | ----------------- | -------- |
| add_bookmark | -------------- | --------- |
| search_alltags_allusers | -------------- | --------- |
| search_alltags_foruser | -------------- | --------- |
| search_fortags_allusers | -------------- | --------- |
| search_fortags_foruser | -------------- | --------- |
| add_new_bookmark | -------------- | --------- |
| edit_this_bookmark | -------------- | --------- |
| add_bmapping | -------------- | --------- |
| add_bmapping_signuptopic | -------------- | --------- |
Bookmark Controller
| Method Name | Changes Made | Reason For Change |
|---|---|---|
| create | ---------------- | ----------- |
| update | ----------------- | -------- |
| edit | -------------- | --------- |
|
destroy |
----------------- | --------- |
| --------------- | ---------- | |
| ---------- | ---------- |
Views
| Method Name | Changes Made | Reason For Change |
|---|---|---|
| bookmarks/_result.html.erb | ---------------- | ----------- |
| bookmarks/search_bookmarks.html.erb | ----------------- | -------- |
| bookmarks/view_bookmarks.html.erb | -------------- | --------- |
| bookmarks/_searchmine.html.erb | ----------------- | --------- |
| bookmarks/add_bookmark_form.html.erb | ----------------- | --------- |
| bookmarks/edit_bookmark_form.html.erb | ----------------- | --------- |
| bookmarks/managing_bookmarks.html.erb | ----------------- | --------- |
| layouts/application.html.erb | ----------------- | --------- |