Documentation

Module Exc-Rest

ExcRestModule implements the ExcRestService.

Setup

To use ExcRestService you have to do preparations in your project.

1. Ensure that the exc-core module is included as dependency in package.json
2. Ensure that the exc-rest module is included as dependency in package.json
3. Setup app.module.ts file

import {environment} from '../environments/environment';
import {HttpClient, HttpClientModule} from '@angular/common/http';
import {ExcCoreModule} from 'exc-core';
import {ExcRestModule} from 'exc-rest';
//...

@NgModule({
declarations:[],
imports:[
  HttpClientModule
  ExcRestModule
  //...
],
entryComponents:[],
providers:[],
bootstrap: [AppComponent]
})


export class AppModule{
  env = environment
  constuctor(){
    ExcCoreModule.RegisterConfig('Environment',_self.env);
  }
  //...
}

4. Setup app.component.ts file

import {ExcCoreModule} from 'exc-core';
import {ExcRestModule} from 'exc-rest';
//...
export class AppComponent  implements OnInit{
//...
  constructor(private excRestService:ExcRestService){  
  }
}

ExcRestService

The ExcRestService is the service for standard communication with the EXCON REST Apis.

Parameter definition

• name Defines the name of the endpoint in environment.ts under Endpoints.
• pObj Defines an object for replacement of placeholders in URL
• url Defines the url generated by computedUrl
• data Defines the data that will be sent to the webservice
• conf Defines the http config used by rest call. Detailed information under this paragraph
• isbc Defines a call is a background call or not. It is used for global activity indicator. Background calls doesn't have an effect to indicator.
• fullResponse Used by delete and put. By default these methods return the fullResponse. If you use this function please manually set parameter to false. The default behavior will be set to false in future.

Config object

• MetaInfo:*object* Defines the definition for filter, paging and sorting for webservice.
• OnProgress(progress):*function* Method that could be set to get information about progress of the call.
• export:*Boolean* If set to true the call is marked as download and the webservice result is downloaded as file.

Members

Methods

Publics

All public methods have a default behavior. So the automatically triggers messages for success and error or are preprocessing data.

Method	Return	Description
computeUrl(name:string,pObj:object)	string	Gets a computed url from config and replaces placeholders with values of pObj
delete(url:string,data:any,conf:object,fullResponse:Boolean(true))	Observable	Sends an HTTP DELETE request to given URL
get(url:string,conf:object)	Observable	Sends an HTTP GET request to given URL
sget(url:string,id:string,conf:object)	Observable	Sends an HTTP GET request to given URL. The given ID is used to identify the last call of an id. So it is possible to get the last valid call. At response you can check the flag valid to only use the last answer for the given id
post(url:string,data:any,conf:object)	Observable	Sends an HTTP POST request to given URL
put(url:string,data:any,conf:object,fullResponse:Boolean(true))	Observable	Sends an HTTP PUT request to given URL
base64ToArrayBuffer(base64:string)	Uint8Array	Convert a base64 string to an arraybuffer
exportBase64(base64String:string,contentType:string,filename:string)	void	starts a download of the base64 string with given contentType and filename
exportBuffer(uInt8Array:Uint8Array,contentType:string,filename:string)	void	starts a download of the UInt8Array with given contentType and filename

Internals

Internal call shouldn't be used for default behavior. The internal methods have no default behavior.

Method	Return	Description
_deleteInternal(url:string,data:any,conf:object,isbc:Boolean)	Observable	Sends an HTTP DELETE request to given URL
_getInternal(url:string,conf:object,isbc:Boolean)	Observable	Sends an HTTP GET request to given URL
_putInternal(url:string,data:any,conf:object,isbc:Boolean)	Observable	Sends an HTTP PUT request to given URL
_postInternal(url:string,data:any,conf:object,isbc:Boolean)	Observable	Sends an HTTP POST request to given URL

get example

import {ExcCoreModule} from './exc-core.module';

const excRest = ExcCoreModule.Services().ExcRest;
// OrderList: {uid}/order/:ordID
let obs = excRest.get(excRest.computeUrl('OrderDetails',{ordID:14}),{MetaInfo:{}});
obs.subscribe(result=>{
  //doIt
})

sget example

import {ExcCoreModule} from './exc-core.module';

const excRest = ExcCoreModule.Services().ExcRest;
// OrderList: {uid}/order
let obs = excRest.sget(excRest.computeUrl('OrderList',{key:'value',fts:'full-text-search-value'}),'MagicList',{MetaInfo:{}});
obs.subscribe(result=>{
  if(result.valid)
    {
       //doIt
    }
 
})