kamranayub / pluralsight-ravendb-4-getting-started

Pluralsight course materials for RavenDB 4: Getting Started

RavenDB 4: Getting Started Pluralsight Course

This sample code is designed to be used alongside the Pluralsight course RavenDB 4: Getting Started. You may also use it as a reference application for a RavenDB demo.

For course content corrections, see ERRATA. For changes to the code, see CHANGELOG.

Useful Resources

• http://ravendb.net - Raven website, documentation, downloads, etc.
• Google Group - Community Google group
• RavenDB Book - RavenDB 4 Deep Dive book
• RavenDB Workshops - RavenDB international in-person workshops

Prerequisites

Install the .NET Core 2.0 SDK

To edit and build the source code you will need to install at least the .NET Core 2.0 SDK. Follow the instructions for your platform.

Install RavenDB 4

You will need a local instance of RavenDB 4 running locally. Download the appropriate 4.0 version for your platform. On Windows this is a zip file you can extract anywhere.

For Docker-based installations, follow the course walkthrough or see Docker for more information.

Running the App

Just use the following commands in a project directory:

dotnet restore
dotnet watch run

On first initialization, the database will be created and seeded.

Layout

The src/xx- folders contain each of the course modules source code. The final folder is the final code that implements all the concepts covered in the course.

Each module folder has clip folders that contains the "after" code at the end of the clip. It's assumed the clip before or module before contains the starting code as if you were following along.

# The final source code
final/
# The source code at the end of module 3, clip 3
03-document-operations/03-document-store/

Codebase

The sample app is using a basic ASP.NET Core Razor Pages layout.

• Startup.cs - The main application startup logic (wires services, configuration, etc.)
• DocumentStoreHolder.cs - An example singleton service that allows the code to access the Raven document store. Initialized once on the first app request.
• Services/ - Holds the data services used in the app
  • Services/RavenTalkService.cs - The main event, this holds all the Raven data access logic
  • Services/InMemoryTalkService.cs - The in-memory data access service
• Pages/ - Holds the Razor pages and code-behind of each page
• Views/Shared/Components/ - Holds shared Razor components

I recommend using Visual Studio Code to edit and run the code.

Bugs

If you discover a bug, please open an issue. I will record issues in the CHANGELOG.

Caveats

This sample is intended to be a beginner's guide to Raven and as such does not reflect appropriate optimizations that you'd make for production use (consolidated indexes, optimized session handling, lazy queries, etc.). The intent was to prefer simple over complex for illustration and learning.

pluralsight-ravendb-4-getting-started's Issues

Course screenshot

CreateDatabaseIfNotExists

Hi, I'm working through the course but can't find the full code for the CreateDatabaseIfNotExists method. It isn't all shown on the screen and I haven't been able to find it anywhere else in the project. Can you help?

Problem with running the first example of the course

Hi!
When I'm launching the application (03 - Document Store) with dotnet run , I'm getting an exception.

Unhandled Exception: CsvHelper.ReaderException: An unexpected error occurred. ---> System.FormatException: String was not recognized as a valid DateTime. at System.DateTimeParse.Parse(String s, DateTimeFormatInfo dtfi, DateTimeStyles styles) at CsvHelper.TypeConversion.DateTimeConverter.ConvertFromString(String text, IReaderRow row, MemberMapData memberMapData) in C:\Users\narsh\Projects\CsvHelper\src\CsvHelper\TypeConversion\DateTimeConverter.cs:line 33 at lambda_method(Closure ) at CsvHelper.Expressions.RecordCreator.Create[T]() in C:\Users\narsh\Projects\CsvHelper\src\CsvHelper\Expressions\RecordCreator.cs:line 44 at CsvHelper.CsvReader.<GetRecords>d__631.MoveNext() in C:\Users\narsh\Projects\CsvHelper\src\CsvHelper\CsvReader.cs:line 1055 --- End of inner exception stack trace --- at CsvHelper.Configuration.Configuration.<>c.<.ctor>b__148_4(CsvHelperException exception) in C:\Users\narsh\Projects\CsvHelper\src\CsvHelper\Configuration\Configuration.cs:line 106

I'm using dotnet version 2.1.101