docs(microservices) add microservices-timeout page

Author: dmitryblackwell

content/microservices/timeout.md

@@ -0,0 +1,33 @@
+### Timeout
+
+Sometimes, microservices are down or not available. For such cases, a timeout is required. If the microservice does not respond to the request within a certain time, an Exception is thrown, which can be caught and an error message will be displayed.
+
+To solve this problem you have to install [rxjs](https://github.com/ReactiveX/rxjs) package:
+
+```bash
+npm install rxjs
+```
+
+Then just add a call of timeout method to the pipe:
+
+```typescript
+@@filename()
+import { timeout } from 'rxjs/operators';
+// ...
+this.client
+      .send<TResult, TInput>(pattern, data)
+      .pipe(timeout(5000))
+      .toPromise();
+@@switch
+import { timeout } from 'rxjs/operators';
+// ...
+this.client
+      .send(pattern, data)
+      .pipe(timeout(5000))
+      .toPromise();
+```
+
+After 5 seconds, if microservice isn't responding, it will throw an error:
+```bash
+[Nest] 17544   - 05/24/2020, 8:08:27 AM   [ExceptionsHandler] Timeout has occurred +5009ms
+```

src/app/homepage/menu/menu.component.ts

@@ -153,6 +153,7 @@ export class MenuComponent implements OnInit {
         { title: 'Pipes', path: '/microservices/pipes' },
         { title: 'Guards', path: '/microservices/guards' },
         { title: 'Interceptors', path: '/microservices/interceptors' },
+        { title: 'Timeout', path: '/microservices/timeout' },
       ],
     },
     {

src/app/homepage/pages/microservices/microservices.module.ts

@@ -14,6 +14,7 @@ import { MicroservicesPipesComponent } from './pipes/pipes.component';
 import { RabbitMQComponent } from './rabbitmq/rabbitmq.component';
 import { KafkaComponent } from './kafka/kafka.component';
 import { RedisComponent } from './redis/redis.component';
+import { MicroservicesTimeoutComponent } from './timeout/timeout.component';
 
 const routes: Routes = [
   {
@@ -76,6 +77,11 @@ const routes: Routes = [
     component: CustomTransportComponent,
     data: { title: 'Custom Transport - Microservices' },
   },
+  {
+    path: 'timeout',
+    component: MicroservicesTimeoutComponent,
+    data: { title: 'Timeout - Microservices' },
+  },
 ];
 
 @NgModule({
@@ -88,6 +94,7 @@ const routes: Routes = [
     MicroservicesPipesComponent,
     MicroservicesInterceptorsComponent,
     MicroservicesGuardsComponent,
+    MicroservicesTimeoutComponent,
     MqttComponent,
     GrpcComponent,
     RabbitMQComponent,

src/app/homepage/pages/microservices/timeout/timeout.component.ts

@@ -0,0 +1,9 @@
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+import { BasePageComponent } from '../../page/page.component';
+
+@Component({
+  selector: 'app-timeout',
+  templateUrl: './timeout.component.html',
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class MicroservicesTimeoutComponent extends BasePageComponent {}