Handling messages

Search…
Handling messages
At some point you'll want to handle messages that have been sent to your application. This can be done by creating a handler and registering it with the BusConfiguration.
The following example creates a handler for a hotel booking application 
Declare a command that models the ReserveRoom command
1
// reserve-room.ts
2
​
3
import { Command } from '@node-ts/bus-messages'
4
​
5
export class ReserveRoom extends Command {
6
  $name = 'reservations/reserve-room'
7
  $version = 0
8
  
9
  constructor (
10
    readonly roomId: string,
11
    readonly bookingId: string
12
  ) {
13
    super()
14
  }
15
}
Copied!
Create a handler that receives a command to ReserveRoom that it delegates the operation to a reservationService. 
Handlers should be kept as dumb as possible and delegate the work to dedicated services. This will help keep the messaging concerns of your application decoupled from the actual work it needs to do.
1
// reserve-room-handler.ts
2
​
3
import { handlerFor } from '@node-ts/bus-core'
4
import { ReserveRoom } from '../messages'
5
import { reservationService } from '../services'
6
​
7
export const reserveRoomHandler = handlerFor(
8
  ReserveRoom,
9
  command => reservationService.reserveRoom(command.reservation, command.bookingId)
10
)
Copied!
Register the handler with the BusConfiguration.
1
// application.ts
2
​
3
import { Bus, BusInstance } from '@node-ts/bus-core'
4
import { reserveRoomHandler } from './handlers'
5
import { ReserveRoom } from './messages'
6
​
7
let bus: BusInstance
8
const start = async () => {
9
  bus = await Bus.configure()
10
    .withHandler(reserveRoomHandler)
11
    .initialize()
12
    
13
  // Start the bus to commence processing messages
14
  await bus.start()
15
}
16
​
17
start
18
  .then(async () => bus.send(new ReserveRoom(
19
    '63a65cf0-d239-4b83-96da-f33f013db23a',
20
    '12b85a56-e929-47a8-9ac3-e87739d5d215'
21
  ))
22
  .catch(console.error)
Copied!
Installation
Shutting down cleanly
Last modified 7mo ago
Copy link