Bu proje web veya mobil uygulamaların kullanacağı bir web servistir. Kodlanırken aşağıdaki teknolojiler ve araçlar kullanılmıştır.
- .Net 5.0 Doc & Download
- Asp.Net Core Web Api Doc
- Entity Framework Core Code First Tutorial & Doc
- Redis Distrubuted Cache Doc & Download
- Docker Container Doc & Download
- Fluent Validation Doc
- xUnit Unit Test Tool Doc
- Swagger - Swaschbuckle
- Moq Framework Doc
- Microsoft SQL Server 2017 Express Edition
- Visual Studio 2019 IDE
Projeyi kullanmak için aşağıdaki teknolojilere ve araçlara zorunlu ihtiyaç duyulmaktadır.
- Git VCS Download
- .Net 5+ SDK (Software Development Kit) Download
- Docker Download
- Microsoft SQL Server 2017+ Download
Projeyi kullanmak için aşağıdaki teknolojiler ve araçlar tavsiye edilmektedir.
- Visual Studio 2019 Community Edition Download
Yukarıdaki maddeler tamam ise projeyi çalıştırmak için sırasıyla şu adımlar izlenmelidir.
- Powershell veya terminal ekranı açalım.
- Docker kurulu olduğu için aşağıdaki kodu çalıştırarak Redis container ayağa kaldırmış oluyoruz.
- Kod
docker run -p 6380:6379 --name some-redis -d redis
- Docker aracılığı ile son sürüm bir Redis container çalıştırmış oluyoruz. Bu kod redis image dosyası bilgisayarda yok ise indirmektedir. Çalıştırdığımız Redis container varsayılan olarak 6379 portunu kullanmaktadır. Yukarıdaki kod ile bir Redis containerı dışarıya 6380 portundan açmaktayız.
- Projeyi kendi bilgisayarını indirmek için git cli kullanacağız. Bir terminal ekranı açtıktan sonra aşağıdaki kodu çalıştırıyoruz.
cd your_local_project_direct
- Bu kod ile projeyi indirmek istediğimiz dosya dizinine geçiyoruz. Terminal ekranında aşağıdaki kodu çalıştırarak projeyi indirmiş oluyoruz.
git clone https://github.com/Filiphasan/RiseConsulting_ContactApp.git
- İndirdiğimiz projeyi Visual Studio ile açmak için ContactApp.sln dosyasına çift tıklıyoruz. Eğer VS Code gibi bir editör kullanmak istiyorsak projenin bulunduğudizinde terminal açıp
code .
kodunu çalıştırıyoruz. - Visual Studio ile açtığımız zaman Visual Studio proje için gerekli dll vb. dosyaları otomatik indirmektedir. Emin olmak için Solution Explorer ekranında ContactApp.sln dosyasına sağ tıklayıp önce Clean Solution ve ardından Rebuil Solution diyebilirsiniz.
- Projede migration yapısı kurulu olduğu için veri tabanını oluşturmak için SQL Server ihtiyaç duyulmaktadır. .Net CLI kullanarak veri tabanını oluşturacağız.
- Bunun için ContactApp.API dizinine gitmeliyiz. Bu dizinde bir teminal ekranı açıp aşağıdaki kodu girmeliyiz.
dotnet ef
kodu ile aşağıdaki benzer bir çıktı almıyor isek dotnet ef aracı kurulu değildir. Kurmak için bu kodu girmek gerekiyor.dotnet tool install --global dotnet-ef
_/\__
---==/ \\
___ ___ |. \|\
| __|| __| | ) \\\
| _| | _| \_/ | //|\\
|___||_| / \\\/\\
Entity Framework Core .NET Command-line Tools 2.1.3-rtm-32065
<Usage documentation follows, not shown.>
- Benzer çıktıaldıysak proje içerisinde ContactApp.API dizininde bulunan
appsetting.json
dosyasındaki ConnectionStrings altındaki SqlServer bağlantı adresini kendi bilgisayarınıza uygun şekilde değiştirmelisiniz. - Her şey tamam ise ContactApp.API dizininde açtığımız terminalde
dotnet ef database update
komutunu çalıştırarak veri tabanını oluşturuyoruz. - Eğer projeyi VS Code ile açtıysak
dotnet build
komutunu terminalde çalıştırmalıyız. Gerekli paketler yüklenecektir. - Veri tabanı oluşturduk. Projeyi Visual Studio kullanarak çalıştırmak için ContactApp.API seçili olarak Debug modda IIS Express butonu ile çalıştırıyoruz.
Postman API Testi için json dosyası indir
This project is a web service that will be used by web or mobile applications. The following technologies and tools were used while coding.
- .Net 5.0 Doc & Download
- Asp.Net Core Web Api Doc
- Entity Framework Core Code First Tutorial & Doc
- Redis Distrubuted Cache Doc & Download
- Docker Container Doc & Download
- Fluent Validation Doc
- xUnit Unit Test Tool Doc
- Swagger - Swaschbuckle
- Moq Framework Doc
- Microsoft SQL Server 2017 Express Edition
- Visual Studio 2019 IDE
The following technologies and tools are required to use the project.
- Git VCS Download
- .Net 5+ SDK (Software Development Kit) Download
- Docker Download
- Microsoft SQL Server 2017+ Download
The following technologies and tools are recommended for using the project.
- Visual Studio 2019 Community Edition Download
If the above items are OK, the following steps should be followed to run the project.
- Open Powershell or Terminal Screen.
- Since Docker is installed, we run the code below and get the Redis container up.
- Code
docker run -p 6380:6379 --name some-redis -d redis
- We are running a latest version of Redis container via Docker. This code downloads the redis image file if it is not available on the computer. The Redis container we run uses port 6379 by default. With the code above, we open a Redis container from port 6380.
- We will use git cli to download the project on own computer. After opening a terminal screen, we run the following code.
cd your_local_project_direct
- With this code, we move to the file directory where we want to download the project. By running the code below on the terminal screen, we download the project.
git clone https://github.com/Filiphasan/RiseConsulting_ContactApp.git
- Double-click the ContactApp.sln file to open the downloaded project with Visual Studio. If we want to use an editor like VS Code, we open a terminal in the project directory and run the
code .
- When we open it with Visual Studio, the necessary dll for the Visual Studio project etc. It downloads files automatically. To be sure, you can right-click the ContactApp.sln file on the Solution Explorer screen and select Clean Solution and then Rebuil Solution.
- Since the migration structure is installed in the project, SQL Server is needed to create the database. We will create the database using the .Net CLI.
- For this we have to go to the ContactApp.API directory. In this directory, we need to open a terminal screen and enter the following code.
- If we do not get an output similar to the one below with the
dotnet ef
code, the dotnet ef tool is not installed. You need to enter this code to install.dotnet tool install --global dotnet-ef
_/\__
---==/ \\
___ ___ |. \|\
| __|| __| | ) \\\
| _| | _| \_/ | //|\\
|___||_| / \\\/\\
Entity Framework Core .NET Command-line Tools 2.1.3-rtm-32065
<Usage documentation follows, not shown.>
- If we have a similar output, you should change the SqlServer connection address under ConnectionStrings in the
appsetting.json
file in the ContactApp.API directory in the project to suit your own computer. - If everything is ok, we create the database by running the
dotnet ef database update
command in the terminal we opened in the ContactApp.API directory. - f we opened the project with VS Code, we should run the
dotnet build
command in the terminal. Required packages will be installed. - We created a database. To run the project using Visual Studio, we run it in Debug mode with the IIS Express button with ContactApp.API selected.
Json file for Postman API Test Download