कंट्रोलर आर्किटेक्चर: हर दिन के लिए सरल टिप्स

हर कोई जानता है कि नियंत्रकों को "पतला" होना चाहिए, लेकिन जैसे-जैसे कार्यक्षमता बढ़ती है, नियंत्रकों को साफ रखना कठिन और कठिन होता जा रहा है। हम कोड की गुणवत्ता से समझौता किए बिना अपने नियंत्रकों को यथासंभव साफ रखने के बारे में कुछ सिफारिशें देना चाहते हैं।

1. विरासत में मिले हुए स्रोतों का उपयोग करें

हम सभी नियंत्रकों को विरासत में दिए गए स्रोतों के आधार पर बनाते हैं, जो हमें सामान्य CRUD कोड से बचने की अनुमति देता है। InheritedResources :: Base से विरासत में प्राप्त नियंत्रक की घोषणा की केवल दो पंक्तियाँ, और यह संसाधन के साथ सभी मूल संचालन (प्रदर्शन / अद्यतन / हटाएं) कर सकता है! सब कुछ ठीक हो जाएगा, लेकिन अक्सर समस्याएं उत्पन्न होती हैं:

• फ़िल्टर / सॉर्ट सूची
• संग्रहों का संग्रह
• उपयोगकर्ताओं / उपयोगकर्ता समूहों के बीच पहुंच साझा करना

पहली समस्या को हल करने के लिए, आप उपयुक्त नियंत्रक विधि (इंडेक्स) को ओवरलैप कर सकते हैं और चयन के लिए आवश्यक बदलाव कर सकते हैं, लेकिन एक बहुत अधिक सुरुचिपूर्ण विधि है जो कि विरासत में मिले दस्तावेज़ों में वर्णित है, लेकिन किसी कारण से कुछ लोग इसका उपयोग करते हैं।

2. has_scope एक्सटेंशन का उपयोग करें

यह रत्न आपको मॉडल में वर्णित किसी भी स्कोप को संसाधन चयन / संसाधन संग्रह में बदलने की अनुमति देता है।
यह कैसे काम करता है? उदाहरण के लिए, हमें सभी ब्लॉग पोस्ट प्रदर्शित करने की आवश्यकता है, अर्थात फ़िल्टर ब्लॉग पोस्ट:

class PostsController < InheritedResources::Base
has_scope :by_blog, :only => :index
end

class Post < ActiveRecord::Base
belongs_to :blog
scope :by_blog, lambda{|blog_id| where (:blog_id => blog_id)}
end

* This source code was highlighted with Source Code Highlighter .

अब अनुरोध / पोस्ट के साथ? By_blog = 1, संसाधनों का संग्रह स्वचालित रूप से आईडी = 1 के साथ ब्लॉग द्वारा फ़िल्टर किया जाएगा। लेकिन यह बहुत सुंदर नहीं लगता है, इसलिए हम निम्नलिखित मार्गों में लिखेंगे:

get "blogs/:blog_id(/page/:page)(.:format)" => "posts#index" , :constraints => { :page => /\d+/ }, :defaults => { :page => 1 }
resources :posts

* This source code was highlighted with Source Code Highlighter .

और वही परिणाम URL / ब्लॉग / 1 पर प्राप्त किया जा सकता है।

यदि आपको लगातार संग्रह सॉर्ट करने की आवश्यकता है, तो आप डिफ़ॉल्ट पैरामीटर का उपयोग कर सकते हैं - फिर गुंजाइश हमेशा निर्दिष्ट डिफ़ॉल्ट मान के साथ लागू की जाएगी:

class PostsController < InheritedResources::Base
has_scope :ordered, : default => 'created_at DESC'
end

class Post < ActiveRecord::Base
scope :ordered, lambda{|field| order(field)} #
end

* This source code was highlighted with Source Code Highlighter .

इसी तरह, आप N + 1 प्रश्नों की समस्या को समाप्त कर सकते हैं:

class PostsController < InheritedResources::Base
has_scope :eager_loading, : default => 'true' , :only => :index
end

class Post < ActiveRecord::Base
scope :eager_loading, preload(:blog, :user, :tags)
scope :eager_loading2, includes(:blog, :user)
end

* This source code was highlighted with Source Code Highlighter .

यदि आपको एक साथ कई स्कोप्स निर्दिष्ट करने की आवश्यकता है, तो कुछ अतिरिक्त शर्तों की जाँच करें, या बस मॉडल में स्कोप का उत्पादन नहीं करना चाहते हैं, आप ब्लॉक में has_scope पैरामीटर सेट करते समय उन्हें सीधे निर्दिष्ट कर सकते हैं:

class PostsController > InheritedResources::Base
has_scope :blog do |controller, scope, value |
value != "all" ? scope. where (:blog_id => value ) : scope
end
end

* This source code was highlighted with Source Code Highlighter .

आप प्रोजेक्ट पृष्ठ पर has_scope के बारे में अधिक जान सकते हैं। एचएएमएल के रूप में इसका प्रभाव सुविधाओं के लिए इस्तेमाल होने में थोड़ा समय बिताना है, लेकिन फिर यह बहुत समय बचाता है।

3. पेजिंग के लिए kaminari / will_paginate का उपयोग करें

ये रत्न बहुत लोकप्रिय हैं और केवल आलसी ने इनका उपयोग नहीं किया है। वे विरासत में मिली जानकारी के साथ कैसे एकीकृत करते हैं? केमरी के साथ कोई समस्या नहीं है - यह नियंत्रक में एक सामान्य दायरे के रूप में उपयोग किया जा सकता है: पृष्ठ, पिछले उदाहरणों की तरह। लेकिन will_paginate के साथ, आपको थोड़ा सा टिंकर करना होगा, क्योंकि पेजेट विधि जो इसे प्रदान करती है वह मॉडल क्षेत्र नहीं है। लेकिन यहां एक बहुत ही सुंदर समाधान है - नियंत्रक में संग्रह विधि को ओवरराइड करना आवश्यक है:

class PostsController < InheritedResources::Base
protected
def collection
@posts ||= end_of_association_chain.paginate(:page => params [:page])
end
end

* This source code was highlighted with Source Code Highlighter .

चूंकि यह चाल बहुत बार उपयोग की जाएगी, इसलिए इसे मॉड्यूल पर ले जाया जा सकता है और अन्य नियंत्रकों में आवश्यक रूप से जोड़ा जा सकता है, लेकिन अगली बार उस पर अधिक।

4. प्रमाणीकरण और प्राधिकरण के लिए , क्रमशः डेविस और कैनकन का उपयोग करें

इस बंडल का उपयोग करते समय, आप व्यवस्थापक पैनल के लिए अलग नियंत्रक के बिना पूरी तरह से कर सकते हैं। वे आपको नियंत्रक से संसाधनों तक पहुंच के तर्क को पूरी तरह से हटाने की अनुमति देते हैं, केवल घोषणाओं को छोड़कर और एक अलग लेख के लायक है।

5. यदि संभव हो, तो मानक नियंत्रक विधियों को ओवरलैप करने से बचें।

सभी अतिरिक्त जांच, पैरामीटर सामान्यीकरण, और मानक संचालन के लिए अन्य कार्यों को पहले किया जा सकता है_फिल्टर:

class PostsController < InheritedResources::Base
before_filter lambda{ resource.user = current_user }, :only => :create
before_filter lambda { resource.thumb = nil if params [:thumb_delete] }, :only => :update
end

* This source code was highlighted with Source Code Highlighter .

6. RSS फ़ीड्स बनाने, AJAX संग्रह लोड करने आदि के लिए। अलग तरीकों का उत्पादन करने की कोई जरूरत नहीं है

आवश्यक प्रारूप में एक संग्रह का अनुरोध करने के लिए पर्याप्त है: /posts.rss और /posts.json, जबकि नियंत्रक में यह रजिस्टर करने के लिए पर्याप्त है:

class PostsController < InheritedResources::Base
respond_to :html
respond_to :rss, :json, :only => :index
end

* This source code was highlighted with Source Code Highlighter .

इसके अलावा, RSS बनाने के लिए, आपको टेम्प्लेट में पोस्ट / index.rss.बिल्डर को पंजीकृत करना होगा:

xml.instruct! :xml, :version => "1.0"
xml.rss :version => "2.0" do
xml.channel do
xml.title ""
xml.description ""
xml.link collection_url(:format => :rss)

for resource in collection
xml.item do
xml.title resource.title
xml.description "#{resource.annotation}\n#{link_to ' ...', resource_url(resource)}"
xml.pubDate resource.published_at.to_s(:rfc822)
xml.link resource_url(resource)
xml.guid resource_url(resource)
end
end
end
end

* This source code was highlighted with Source Code Highlighter .

आप निम्नलिखित jQuery कोड के साथ JSON संग्रह को संसाधित कर सकते हैं:

$( '#blog_id' ).live( 'change' , function () {
$.ajax({
url: '/posts.json' ,
dataType: 'json' ,
data: { blog_id: $( this ).val() },
success: function (json) {
var options = '' ;
for ( var i = 0; i < json.length; i++) {
options += '<option value="' + json[i].id + '">' + json[i].title + '</option>' ;
}
$( '#destination' ).html(options);
}
});
});

* This source code was highlighted with Source Code Highlighter .

इस प्रकार, लचीली कार्यक्षमता, एक REST दृष्टिकोण और कोड पारदर्शिता बनाए रखते हुए नियंत्रकों में न्यूनतम मात्रा में कोड प्राप्त करना संभव है। इन सभी सिद्धांतों को वास्तविक परियोजनाओं में लागू किया गया है और व्यवहार में खुद को अच्छी तरह से दिखाया है। कुछ आँकड़े: विकास के 10 महीनों के बाद, SmartSourcing प्रोजेक्ट में सबसे बड़ा नियंत्रक 86 लाइनें लेता है, सबसे छोटी - 2 लाइनें, लेकिन अधिकांश नियंत्रक 20 LOC से अधिक नहीं होते हैं।