This project contains an implementation of ASP.NET Core REST API backend for ReactJS Comments tutorial. In this example you will see how easily you can integrate Single-page apps implemented using ReactJS with SQL Server 2016 or Azure SQL Database using ASP.NET Core and JSON functions that are available in SQL Server 2016.

About this sample
Before you begin
Run this sample
Sample details
Disclaimers
Related links

About this sample

Applies to: SQL Server 2016 (or higher), Azure SQL Database
Key features: FOR JSON clause in SQL Server 2016/Azure SQL Database.
Programming Language: JavaScript/ReactJS, C#, Transact-SQL
Authors: Jovan Popovic

Before you begin

To run this sample, you need the following prerequisites.

Software prerequisites:

SQL Server 2016 (or higher) or an Azure SQL Database
Visual Studio 2015 Update 3 (or higher) or Visual Studio Code Editor with the ASP.NET Core 1.0 (or higher)

Azure prerequisites:

Permission to create an Azure SQL Database

Run this sample

Create a database on SQL Server 2016 or Azure SQL Database.
From SQL Server Management Studio or Sql Server Data Tools connect to your SQL Server 2016 or Azure SQL database and execute sql-scripts/setup.sql script that will create and populate Comments table.
From Visual Studio 2015, open the CommentsReactApp.xproj file from the root directory. Restore packages using right-click menu on the project in Visual Studio and by choosing Restore Packages item. As an alternative, you may run dotnet restore from the command line (from the root folder of application).
Add a connection string in appsettings.json or appsettings.development.json file. An example of the content of appsettings.development.json is shown in the following configuration:

{
  "ConnectionStrings": {
    "CommentsDb": "Server=.;Database=CommentsDb;Integrated Security=true"
  }
}

If your database is hosted on Azure you can add something like:

{
  "ConnectionStrings": {
    "CommentsDb": "Server=<<SERVER>>.database.windows.net;Database=CommentsDb;User Id=<<USER>>;Password=<<PASSWORD>>"
  }
}

Build and run sample

Run the sample app using F5 or Ctrl+F5 in Visual Studio 2015, or using dotnet run executed in the command prompt of the project root folder.
Open /index.html Url to get all comments from database,
Add new comment using the form below the list of comments.

Sample details

This sample application shows how to create REST API service is used as beckend for ReactJS app. Front-end code stored in wwwroot folder is unmodified Facebook's ReactJS sample comments app. ASP.NET Core Web API is used to implement REST Service called by Comments front-end app. Service uses FOR JSON clause that is available in SQL Server 2016 and Azure SQL Database.

Disclaimers

The code included in this sample is not intended demonstrate some general guidance and architectural patterns for web development. It contains minimal code required to create REST API, and it does not use some patterns such as Repository. Sample uses built-in ASP.NET Core Dependency Injection mechanism; however, this is not prerequisite. You can easily modify this code to fit the architecture of your application.

You can find more information about the components that are used in this sample on these locations:

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

License

These samples and templates are all licensed under the MIT license. See the license.txt file in the root.

Questions

Email questions to: [sqlserversamples@microsoft.com](mailto: sqlserversamples@microsoft.com).

README.md

ASP.NET Core REST Web API that uses SQL/JSON functionalities

Contents