nopCommerce Dokumentace

Organizace zdrojového kódu

Tento dokument je vývojářským průvodcem strukturou solution nopCommerce a má pomoci novým vývojářům seznámit se se zdrojovým kódem. Především je nopCommerce open-source aplikace, takže si ji můžete zdarma stáhnout z GitHubu. Projekty a složky jsou uvedeny v pořadí, v jakém jsou seřazeny ve Visual Studiu. Doporučujeme otevřít si solution nopCommerce ve Visual Studiu a při čtení tohoto dokumentu si prohlížet projekty a soubory.

Organizace zdrojového kódu

Většina projektů, adresářů a souborů je pojmenována tak, abyste si mohli udělat hrubou představu o jejich účelu. Například se ani nemusíte dívat dovnitř projektu Nop.Plugin.Payments.PayPalStandard, abyste uhodli, co dělá.

\Libraries\Nop.Core

Projekt Nop.Core obsahuje sadu základních tříd nopCommerce, jako je cache, události, pomocné třídy (helpers) a business objekty (například entity Order a Customer).

\Libraries\Nop.Data

Projekt Nop.Data obsahuje sadu tříd a funkcí pro čtení z databáze nebo jiného úložiště dat a zápis do nich. Knihovna Nop.Data pomáhá oddělit logiku přístupu k datům od vašich business objektů. nopCommerce používá přístup Code-First knihovny Linq2DB. Code-First umožňuje vývojáři definovat entity ve zdrojovém kódu (všechny základní entity jsou definovány v projektu Nop.Core) a poté pomocí Linq2DB a FluentMigrator vygenerovat databázi z tříd C#. Proto se tomu říká Code-First. Své objekty pak můžete dotazovat pomocí LINQ, který se na pozadí překládá do SQL a spouští se nad databází. nopCommerce používá Fluent API k plnému přizpůsobení mapování perzistence.

\Libraries\Nop.Services

Tento projekt obsahuje sadu základních služeb, business logiku, validace nebo výpočty související s daty, je-li to potřeba. Někdo tomu říká Business Access Layer (BAL).

Projekty ve složce solution \Plugins\

Plugins je složka solution ve Visual Studiu, která obsahuje projekty pluginů. Fyzicky se nachází v kořeni vaší solution. DLL knihovny pluginů se však automaticky kopírují do adresáře \Presentation\Nop.Web\Plugins, který se používá pro již nasazené pluginy, protože výstupní cesty sestavení všech pluginů jsou nastaveny na ..\..\Presentation\Nop.Web\Plugins\{Group}.{Name}. To umožňuje, aby pluginy obsahovaly některé externí soubory, například statický obsah (soubory CSS nebo JS), aniž by bylo nutné kopírovat soubory mezi projekty, aby bylo možné projekt spustit.

\Presentation\Nop.Web

Nop.Web je projekt webové aplikace MVC, prezentační vrstva veřejné části obchodu, která obsahuje i administraci zahrnutou jako oblast (area). Pokud jste dosud ASP.NET nepoužívali, další informace naleznete zde. Toto je aplikace, kterou spouštíte. Jde o spouštěcí projekt aplikace.

\Presentation\Nop.Web.Framework

Nop.Web.Framework je projekt knihovny tříd obsahující některé společné prezentační prvky pro projekt Nop.Web.

\Test\Nop.Tests

Nop.Tests je projekt knihovny tříd obsahující některé společné testovací třídy a pomocné třídy pro ostatní testovací projekty. Sám žádné testy neobsahuje. Více o UNIT testování v nopCommerce si přečtěte v následujícím článku: UNIT testování.

\Nop.Core.Tests

Nop.Core.Tests je testovací projekt pro projekt Nop.Core.

\Nop.Services.Tests

Nop.Services.Tests je testovací projekt pro projekt Nop.Services.

\Nop.Web.Tests

Nop.Web.Tests je testovací projekt pro projekty prezentační vrstvy.

Výukové materiály