अपने इंटरफ़ेस के हस्ताक्षर द्वारा अनुरोध वर्ग का एक उदाहरण प्राप्त करना

बहुत समय पहले नहीं, एक लेख (विषय से लिंक ) मेरे सहयोगी अलेक्जेंडर बियंडयू द्वारा हैबे पर प्रकाशित किया गया था, जिसमें QueryFactory बंडल + क्वेरी क्वेरी कक्षाओं का उपयोग करने के लिए रिपॉजिटरी का उपयोग करने से दूर जाने का वर्णन था। उसी समय, लेख में दिए गए समाधान की उपयुक्तता के बारे में टिप्पणियों में एक बहुत ही दिलचस्प बहस छिड़ गई। काफी दिलचस्प समीक्षाएं थीं, जिनमें से, कथन, QueryFactory की आवश्यकता नहीं है और एक अतिरिक्त बोझ है जो दर्द रहित जोड़, संशोधन और क्वेरी कक्षाओं को हटाने में बाधा है, विशेष रूप से उल्लेखनीय थे। इस लेख में मैं एक दृष्टिकोण दिखाना चाहता हूं जो आपको IoT कंटेनर के सक्रिय उपयोग के माध्यम से QueryFactory के आवेदन से छुटकारा पाने की अनुमति देता है। हमने अपनी हालिया परियोजनाओं में से एक में क्वेरी कक्षाओं की संरचना के साथ काम के इस संगठन का उपयोग किया था जहां कैसल.इंडर्स का उपयोग IoC के रूप में किया गया था।

दृष्टिकोण का विवरण

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

कार्यान्वयन

मान लीजिए कि हमारे पास सभी प्रश्नों के लिए एक सामान्य IQuery <,> इंटरफ़ेस है:

public interface IQuery< in TCriterion, out TResult>
where TCriterion : ICriterion
{
TResult Execute(TCriterion criterion);
}

* This source code was highlighted with Source Code Highlighter .

तदनुसार, इसका हस्ताक्षर ICriterion के विशिष्ट कार्यान्वयन द्वारा निर्धारित किया जाता है, अर्थात्। एक ऑब्जेक्ट जिसमें क्वेरी बनाने के लिए आवश्यक डेटा (मुख्य रूप से जहां फिल्टर की भविष्यवाणी होती है), साथ ही साथ लौटे परिणाम का प्रकार। इस प्रकार, यदि IQuery का एक भी कार्यान्वयन है, तो> कुछ प्रकार के जेनेरिक मापदंडों के साथ इंटरफ़ेस TCriterion और TResult, इन प्रकारों को जानकर आप इंटरफ़ेस का कार्यान्वयन प्राप्त कर सकते हैं।
नीचे WindsorInstaller वर्ग का कोड है जो एक Io कंटेनर में IQuery <,> इंटरफ़ेस के सभी कार्यान्वयन को पंजीकृत करता है।

public class WindsorInstaller : IWindsorInstaller
{
public void Install(IWindsorContainer container, IConfigurationStore store)
{
var queries = AllTypes.FromAssemblyNamed( "Domain.NHibernate" )
.BasedOn( typeof (IQuery<,>))
.WithService.FirstInterface()
.Configure(x => x.LifeStyle.Transient);

container.Register(queries);
}
}

* This source code was highlighted with Source Code Highlighter .

इस उदाहरण में, हमें IQuery <,> इंटरफ़ेस से डोमेन के सभी कार्यान्वयन मिलते हैं। उनके साथ असेंबली असेंबली में पहले प्रकार (जो, फिर से, IQuery <,> है) के कार्यान्वयन के रूप में कंटेनर में प्राप्त प्रकारों को पंजीकृत करें।
नियंत्रक में एक विशिष्ट अनुरोध के आगे उपयोग के लिए या, कहते हैं, प्रपत्र हैंडलर में, एक छोटा लेकिन बहुत महत्वपूर्ण सहायक वर्ग लिखना आवश्यक है। लेकिन इसके साथ शुरू करने के लिए, मैं इसके उपयोग का एक उदाहरण देना चाहूंगा, ताकि आप इंटरफ़ेस हस्ताक्षर द्वारा अनुरोध के कार्यान्वयन को प्राप्त करने के लिए इसके द्वारा प्रदान की गई क्षमताओं और तंत्र के प्रकटन (डेवलपर के लिए) को समझ सकें। इस उदाहरण को बुलाओ सूची 1।

var account = Query.For<Account>().With( new LoginCriterion(login));

* This source code was highlighted with Source Code Highlighter .

इस उदाहरण में, हमें इसके इंटरफ़ेस के हस्ताक्षर से एक अनुरोध प्राप्त होता है, जिसमें से हम चाहते हैं कि यह खाता इकाई को लौटाए, और इस खाते के लॉगिन से खोज करें। लॉगिन LoginCriterion के माध्यम से पारित किया है। तदनुसार, उपरोक्त कोड को अधिक पारदर्शी बनाने के लिए, मैं अनुरोध कोड को उद्धृत करता हूं जिसका उपयोग उपरोक्त उदाहरण में किया जाएगा, साथ ही साथ लॉगिन क्रिटेरियन वर्ग के लिए कोड।

public class FindAccountByLoginQuery : LinqQueryBase<Account>, IQuery<LoginCriterion, Account>
{
public FindAccountByLoginQuery(ILinqProvider linqProvider)
: base (linqProvider)
{
}

public Account Execute(LoginCriterion criterion)
{
return Query()
.SingleOrDefault(x => x.Login.ToLower() == criterion.Login.ToLower());
}
}

public class LoginCriterion : ICriterion
{
public LoginCriterion( string login)
{
Login = login;
}

public string Login { get ; set ; }
}

* This source code was highlighted with Source Code Highlighter .

अब, सहायक कोड के संबंध में, इसे दो इंटरफेस द्वारा दर्शाया गया है:

public interface IQueryBuilder
{
IQueryFor<TResult> For<TResult>();
}

public interface IQueryFor< out T>
{
T With<TCriterion>(TCriterion criterion) where TCriterion : ICriterion;

T ById( int id);

IEnumerable <T> All();
}

* This source code was highlighted with Source Code Highlighter .

... और उनके कार्यान्वयन:

public class QueryBuilder : IQueryBuilder
{
private readonly IDependencyResolver dependencyResolver;

public QueryBuilder(IDependencyResolver dependencyResolver)
{
this .dependencyResolver = dependencyResolver;
}

public IQueryFor<TResult> For<TResult>()
{
return new QueryFor<TResult>(dependencyResolver);
}

#region Nested type: QueryFor

private class QueryFor<TResult> : IQueryFor<TResult>
{
private readonly IDependencyResolver dependencyResolver;

public QueryFor(IDependencyResolver dependencyResolver)
{
this .dependencyResolver = dependencyResolver;
}

public TResult With<TCriterion>(TCriterion criterion) where TCriterion : ICriterion
{
return dependencyResolver.GetService<IQuery<TCriterion, TResult>>().Execute(criterion);
}

public TResult ById( int id)
{
return dependencyResolver.GetService<IFindByIdQuery<TResult>>().Execute( new IdCriterion(id));
}

public IEnumerable <TResult> All()
{
return dependencyResolver.GetService<IFindAllQuery<TResult>>().Execute( new EmptyCriterion());
}
}

#endregion
}

* This source code was highlighted with Source Code Highlighter .

वास्तव में, हमारे दृष्टिकोण को लागू करने के लिए, हम खुद को एक एकल इंटरफ़ेस तक सीमित कर सकते हैं, लेकिन फिर हमें स्पष्ट रूप से एक सामान्य पैरामीटर को निर्दिष्ट करना होगा जैसे कि ICriterion के कार्यान्वयन, जो IQueryBuilder इंटरफ़ेस को बोझ कर देगा। संकेतित कार्यान्वयन के साथ, केवल अनुरोध से लौटाए गए मूल्य का प्रकार स्पष्ट रूप से इंगित किया गया है। क्वेरी उदाहरण सीधे IoC कंटेनर से प्राप्त किया जाता है और QueryFor <> वर्ग द्वारा निष्पादित किया जाता है। यह आंतरिक ASP.NET MVC3, ID dependencyResolver द्वारा प्रदान किए गए IoC कंटेनर के लिए इंटरफ़ेस का उपयोग करता है। हमारे मामले में, परिणामस्वरूप, कंटेनर के सभी अनुरोधों को कैसल. विंडसर को सौंप दिया जाएगा।
QueryBuilder का उपयोग करने की मुख्य विशेषताओं में से एक इसे IQueryBuilder इंटरफ़ेस के कार्यान्वयन के रूप में IoC कंटेनर में पंजीकृत करना है। कंस्ट्रक्टर में निर्भरता के इंजेक्शन के कारण, साथ ही ऑब्जेक्ट्स के सभी सार्वजनिक गुणों के लिए ASP.NET MVC3 में लागू कार्यान्वयन प्रतिस्थापन तंत्र, जिनके प्रकार कंटेनर में पंजीकृत हैं, यदि ऑब्जेक्ट उदाहरण स्वयं कंटेनर से भी प्राप्त होता है, तो निम्न संभव हो जाता है (सार उदाहरण, UnitOfWork उद्घाटन कोड छोड़े गए)।

public class AccountController : Controller
{
public IQueryBuilder Query { get ; set ; }

public ActionResult Index( string login)
{
var account = Query.For<Account>().With( new LoginCriterion(login));

// -
}
}

* This source code was highlighted with Source Code Highlighter .

निष्कर्ष

यह दृष्टिकोण हमें न केवल QueryFactory से छुटकारा पाने की अनुमति देता है, जो क्वेरी कक्षाओं को दर्दरहित बनाने, बदलने और हटाने का काम करता है, बल्कि हमें जहां यह उपयोग किया जाता है, उसके संदर्भ में किसी क्वेरी की अवधारणा को पूरी तरह से अनदेखा करने की अनुमति देता है। मैं भी "वास्तविक" अनुरोध प्राप्त करने के लिए इस तरह के एक तंत्र को कॉल करेगा, क्योंकि वह दो प्रमुख अवधारणाओं के साथ काम करता है जो CQS दृष्टिकोण के संदर्भ में क्वेरी से संबंधित हैं: ये इनपुट चयन मानदंड और रिटर्न परिणाम हैं। ऐसा लगता है कि ICriterion के विभिन्न कार्यान्वयन कोड को "अव्यवस्था" कर सकते हैं, लेकिन वास्तव में ऐसा नहीं है, क्योंकि उन्हें विभिन्न अनुरोधों के लिए पुन: उपयोग किया जा सकता है।
एक इंटरफ़ेस हस्ताक्षर के आधार पर कार्यान्वयन प्राप्त करने के लिए एक समान दृष्टिकोण का उपयोग न केवल प्रश्नों के लिए किया जा सकता है, बल्कि अन्य सामान्य इंटरफेस के कार्यान्वयन के लिए भी किया जा सकता है, खासकर अगर इनमें से बहुत सारे कार्यान्वयन हैं और / या उनकी रचना अक्सर परिवर्तनों के अधीन है। उदाहरण के लिए, टीमें (CQS दृष्टिकोण से) समान वस्तुओं के रूप में काम कर सकती हैं।

मैं टिप्पणियों में एक अच्छी चर्चा की उम्मीद करता हूं और इस दृष्टिकोण के बारे में रचनात्मक प्रस्तावों के लिए तत्पर हूं। यदि आपके पास इस लेख में वर्तनी और विराम चिह्न पर टिप्पणियां हैं, तो कृपया उन्हें निजी संदेशों के माध्यम से लिखें।