Introduction In this article we will see in detail about using Angular2 with ASP.NET Core 1.0 RC2 using WEB API.
In our previous article Getting Started With ASP.NET Core 1.0 RC2 And Angular2 we have seen a few basics of Angular2 using ASP.NET Core RC2; now we will see in detail about using WEB API and Angular2 in ASP.NET Core RC2.
In this article we will see in detail how to,
- Create our ASP.NET Core 1.0 RC2 Web Application.
- Create MVC Model to add Student details.
- Create MVC Controller to return WEB API Method
- How to add TypeScript JSON Configuration File
- How to add grunt package using NPM configuration file
- How to configure Grunt File.
- Adding Dependencies to install Angular2 and all other files
- How to create our Angular2 App, boot using Type Script file.
- Creating HTML File
- How to Run the Grunt file using Visual Studio Task Runner Explorer
- Run and view our Sample.
Reference website
Prerequisites
Visual Studio 2015: You can download it from here.
ASP.NET Core 1.0 RC2: download link https://www.microsoft.com/net
https://www.microsoft.com/net/core#windows
Code Part
Step 1: Create our ASP.NET Core 1.0 Web Application.
After installing both Visual Studio 2015 and ASP.NET Core 1.0 RC2 click Start, then Programs, and select Visual Studio 2015 - Click Visual Studio 2015. Click New, then Project, select Web and select ASP.NET Core Web Application. Enter your Project Name and click OK.
Next select Web Application. If you are not hosting in the Cloud then you can uncheck the Host in the Cloud at the bottom right corner. Click OK.
Now we have,
Step 2: Creating MVC Model to return student list
We can create a model by adding a new class file in our Model Folder.
Right click the Models folder and click new Item. Select Class and enter your class name as “StudentMasters.cs”,
Now in this class we first create property variable, add student details to list, and return the list. We will be using this list in our controller.
- public class StudentMasters
- {
- public int StdID { get; set; }
- public string StdName { get; set; }
- public string Email { get; set; }
- public string Phone { get; set; }
- public string Address { get; set; }
-
-
- public StudentMasters(int ID, string Name, string email, string phone, string Addr)
- {
- StdID = ID;
- StdName = Name;
- Email = email;
- Phone = phone;
- Address = Addr;
- }
-
- public static List<StudentMasters> studetndDetails()
- {
- List<StudentMasters> listStudents = new List<StudentMasters>();
- listStudents.Add(new StudentMasters(1, "Shanu", "[email protected]", "000000", "korea"));
- listStudents.Add(new StudentMasters(2, "Afraz", "[email protected]", "0000123", "korea"));
- listStudents.Add(new StudentMasters(3, "Afreen", "[email protected]", "000643", "Seoul,Korea"));
- listStudents.Add(new StudentMasters(4, "Asha", "[email protected]", "00003455", "Madurai,India"));
- listStudents.Add(new StudentMasters(5, "Kather", "[email protected]", "000067567656", "Madurai,India"));
-
- return listStudents;
- }
- }
Step 3: Creating MVC Controller to return WEB API Method
We can create a controller by adding a new Empty API Controller in our Controller Folder.
Right click the Controller folder and Add Controller. Select Empty API Controller and give the name as “StudentMastersController”,
In the controller we return the List result as IEnumerable in our Angular2 Component we will be using this web API method to return the data and bind it in our HTML page.
- [Produces("application/json")]
- [Route("api/StudentMasters")]
- public class StudentMastersController : Controller
- {
-
- [HttpGet]
- public IEnumerable<StudentMasters> Get()
- {
- return StudentMasters.studetndDetails().ToList();
- }
- }
To test it we can run our project and copy the get method API path -- here we can see our API path for get is api/StudentMasters/.Run the program and paste the above API path to test our output.
Step 4: How to add TypeScript JSON Configuration File
The TypeScript JSON file will specify the root files and the compiler options required to compile the project .To know more about TypeScript JSON Configuration kindly visit this site
http://www.typescriptlang.org/docs/handbook/tsconfig-json.html ,
To create the TypeScript JSON file right click on your Project and Click Add new Item.
Select TypeScript JSCON Configuration File and Click ok. The File will look like below image.
Now copy the below code and replace with your config file.
- "compilerOptions": {
- "emitDecoratorMetadata": true,
- "experimentalDecorators": true,
- "module": "commonjs",
- "moduleResolution": "node",
- "noImplicitAny": false,
- "noEmitOnError": true,
- "removeComments": false,
- "target": "es5",
- "sourceMap": true
Step 5: How to add grunt package using NPM configuration file
Now we need to add a NPM Configuration File for adding a grunt package to run our java scripts.
As we have created a Web Application the NPM Configuration File will be located in our project.
By default we can’t view our NPM Configuration File. The NPM Configuration File will be in the name of “package.JSON” . To view that from the Solution Explorer click on “Show All Files”
Now open the “package.JSON” file .Now first we need to change the name to our project Solution name and add our grunt package. We can see the code here below the image.
Here we have changed the name as our Solution name and also added the grunt package.
- {
- "name": "test",
- "version": "0.0.0",
- "private": true,
- "devDependencies": {
- "grunt": "1.0.1",
- "grunt-contrib-copy": "1.0.0",
- "grunt-contrib-uglify": "1.0.1",
- "grunt-contrib-watch": "1.0.0",
- "grunt-ts": "5.5.1",
- "gulp": "3.8.11",
- "gulp-concat": "2.5.2",
- "gulp-cssmin": "0.1.7",
- "gulp-uglify": "1.2.0",
- "rimraf": "2.2.8"
- }
- }
Now save the package.json file and you should be able to see a grunt package. Under Dependencies/ the npm Folder will be first Resorted and then installed.
Restoring
All Installed
Step 6: Configure Grunt File
Grunt is used to build all our client side resources like JavaScript for our project.
First step is to add a Grunt file to our project. Right click our project and Select Grunt Configuration File and click Add.
After creating the file now we need to edit this file to load plugins, configure plugins and define tasks, Here in our Grunt file we have first loaded plugins which we have added in our npm. Using loadNpmTask here we load 'grunt-contrib-copy ,'grunt-contrib-uglify' , 'grunt-contrib-watch',
Next we configure the grunt add the app.js file in our wwwroot folder. All our Script files from Scripts folder results will be added in this app.js file. Next we need to copy all the Script files from 'node_modules/ to our local js Folder.
The watch plugin will be used to check for any changes on the JavaScript file and update app.js with all new changes.
-
-
-
-
- module.exports = function (grunt) {
- grunt.loadNpmTasks('grunt-contrib-copy');
- grunt.loadNpmTasks('grunt-contrib-uglify');
- grunt.loadNpmTasks('grunt-contrib-watch');
- grunt.loadNpmTasks('grunt-ts');
- grunt.initConfig({
- ts:
- {
- base:
- {
- src: ['Scripts/app/boot.ts', 'Scripts/app/**/*.ts'],
- outDir: 'wwwroot/app',
- tsconfig: './tsconfig.json'
- }
- },
- uglify:
- {
- my_target:
- {
- files: [{
- expand: true,
- cwd: 'wwwroot/app',
- src: ['**/*.js'],
- dest: 'wwwroot/app'
- }]
- },
- options:
- {
- sourceMap: true
- }
- },
-
- copy: {
- main: {
- files:
- [{
- expand: true,
- flatten: true,
- src: ['Scripts/js/**/*.js', 'node_modules/es6-shim/es6-shim.min.js', 'node_modules/systemjs/dist/system-polyfills.js', 'node_modules/angular2/bundles/angular2-polyfills.js', 'node_modules/systemjs/dist/system.src.js', 'node_modules/rxjs/bundles/Rx.js', 'node_modules/angular2/bundles/angular2.dev.js'],
- dest: 'wwwroot/js/',
- filter: 'isFile'
- }]
- }
- },
-
- watch: {
- scripts: {
- files: ['Scripts/**/*.js'],
- tasks: ['ts', 'uglify', 'copy']
- }
- }
- });
-
- grunt.registerTask('default', ['ts', 'uglify', 'copy', 'watch']);
- };
Step 7: Adding Dependencies to install Angular2 and all other files
We are using NPM to install our Angular2 in our web application. Open our Package.JSON file and the below dependencies.
- "dependencies": {
- "@angular/http": "2.0.0-rc.1",
- "angular2": "^2.0.0-beta.8",
- "angular2-jwt": "0.1.16",
- "angular2-meteor": "0.5.5",
- "cors": "2.7.1",
- "systemjs": "0.19.22",
- "es6-promise": "^3.0.2",
- "es6-shim": "^0.33.3",
- "reflect-metadata": "0.1.2",
- "rxjs": "5.0.0-beta.2",
- "tsd": "^0.6.5",
- "zone.js": "0.5.15"
- },
The edited Package.json file will look like the below image.
Save the file and wait for a few seconds to complete all the dependency installations.
Step 8 How to create our Angular2 App, boot using Type Script file.
Now it’s time to create our Angular2 application. First create a Folder named Scripts. Right click our project and click add new Folder and name the folder name as “Scripts”. Now we will create our TypeScript files inside this Scripts folder. To work with Angular2 we need to create 2 important TypeScript file.
- Component File where we write our Angular coding.
- Boot file: To run our component app .
Creating App TypeScript file
Right Click on Scripts folder and click on add new Item. Select TypeScript File and name the file as App.ts and click Add.
In App.ts file we have three parts:
- The import part
- Next is component part
- Next we have the class for writing our business logic.
Here we can see a simple basic one way binding example to display the welcome message in side h1 tag.Here.
import part
First we import Angular2 files to be used in our component- - here we import http for using http client in our Angular2 component and import NgFor for using the looping and binding all the student detail array values one by one, and also we are importing one more typescript export class named StudentMasters from the model file.
- import { Component, Injectable} from 'angular2/core';
- import { NgFor } from 'angular2/common';
- import {Http, Headers, Response} from 'angular2/http';
- import { StudentMasters } from './model';
- import 'rxjs/Rx';
Next is component part
In component we have selector, directives and template. Selector is to give a name for this app and in our html file we use this selector name to display in our html page. In template we write our code. In template we bind the StudentMaster details using ngFOR.The student details will be loaded in our export class where we write all our business logic and http function to load data from WEB API.
- @Component({
- selector: "my-app",
- directives: [NgFor],
- template: `
- <h1 style="color:#467813;">ASP.NET Core / Angular2 and WEB API Demo </h1>
- <hr>
- <h2>A Simple demo made by : <span style="color:#8340AF;">{{myName}} </span> </h2>
-
- <h2 style="color:#FF5733;"> Student Details retured from WEB API as JSON result </h2>
- <h3 style="color:#C70039;">
- <ul>
- <li *ngFor="let std of student">
- <code> <span *ngFor="let stdArray of generateArray(std)"> {{stdArray}} </span> </code>
- </li>
-
- </ul>
- </h3>
- `,
-
- })
Export Class
This is the main class where we do all our business logic and variable declaration to be used in our component template. In this class we have created a method named getData() and in this method we get the API method result and bind the result to the student array. In our component template we will be binding the result from this student array.
- export class AppComponent {
- student: Array<StudentMasters> = [];
- myName: string;
- constructor(public http: Http) {
- this.myName = "Shanu";
- this.getData();
- }
-
- getData() {
-
- this.http.get('api/StudentMasters')
- .map((res: Response) => res.json())
- .subscribe(
- data => { this.student = data },
- err => console.error(err),
- () => console.log('done')
-
- );
- }
-
- generateArray(obj) {
- return Object.keys(obj).map((key) => { return obj[key] });
- }
- }
Next we need to add the boot.ts file to run our app.
Creating boot TypeScript file
Right Click on Scripts folder and click on add new Item. Select TypeScript File and name the file as boot.ts and click Add.
In boot.ts file we add the below code. Here first we import the ootsrap file to load and run our app file and also we import our app component. Note -- to import our app we need to give the same class name which was given in our app typescript file and give our app path in form of’./app’ .Next we run our app by adding the app name in bootstrap as
bootstrap(myAppComponent);.
-
-
- import {bootstrap} from 'angular2/platform/browser'
- import {ROUTER_PROVIDERS} from "angular2/router";
- import {HTTP_PROVIDERS, HTTP_BINDINGS} from "angular2/http";
- import {AppComponent} from './app'
-
- bootstrap(AppComponent, [HTTP_BINDINGS, HTTP_PROVIDERS]);
Creating model TypeScript file
Right Click on Scripts folder and click on add new Item. Select TypeScript File and name the file as model.ts and click Add.
We use this model typescript file to create our Studentmasters model and declare all the public properties which we created in our MVC model.
- export class StudentMasters {
- constructor(
- public StdID: number,
- public StdName: string,
- public Email: string,
- public Phone: string,
- public Address: string
- ) { }
- }
Step 9: Creating HTML File
Next we need to create our html page to view result.To add the HTML file right click on wwwroot folder and click add new item, give the name as index.html and click Add.
In HTMl file replace the below code. Here we can see first in header part we add all the script reference files and in script we load our boot file to run our app. In the body part we display the result using the component selector name. In our app component we have given the selector name as “myapp1”. In this HTML to display the result we add a tag like this <my-app>Please wait...</my-app>
- <html>
-
- <head>
- <title>ASP.NET Core: AngularJS 2 Demo</title>
- <meta name="viewport" content="width=device-width, initial-scale=1">
-
-
- <script src="/js/es6-shim.min.js"></script>
- <script src="/js/system-polyfills.js"></script>
-
- <script src="/js/angular2-polyfills.js"></script>
- <script src="/js/system.src.js"></script>
- <script src="/js/Rx.js"></script>
- <script src="/js/angular2.dev.js"></script>
- <script src="/js/router.dev.js"></script>
- <script src="/js/http.dev.js"></script>
-
- <script>
-
- System.config
- ({
- packages:
- {
- "app":
- {
- defaultExtension: 'js'
- },
- 'lib': { defaultExtension: 'js' }
- }
- });
- System.import('app/boot').then(null, console.error.bind(console));
- </script>
- </head>
-
- <body>
-
- <my-app>Please wait...</my-app>
-
- </body>
-
- </html>
Run the Program
Here we can see all the data from WEB API has been bound to our HTML page using Angular2.