Modules

A module, in Serinus, is a class that extends the Module class and is used to organize the application into cohesive blocks of functionality.

Modules can import other modules, controllers, providers, and middlewares, and export providers to other modules.

Every Serinus application has at least one module, the root module, which is the entry point of the application and it can be used to create the graph of dependencies in the application.

TIP

While in a small application you might want to use only the root, modules are highly recommended to organize your application in a scalable way and to define a clear boundary between the different parts of your application.

The Module abstract class exposes the following properties:

Property	Description
imports	A list of Modules you want to import in the current module.
controllers	A list of Controllers you want to include in the module.
providers	A list of Providers you want to include in the module.
middlewares	A list of Middlewares you want to include in the module.
exports	A list of Providers you want to export to other modules.

Shared Modules

Modules can be shared between different modules because Serinus treats them as singletons. This means that the same instance of a module is shared between all the modules that import it.

Dynamic Modules

Modules can also use the registerAsync method to register controllers, providers, and other modules dynamically. This is useful when you need to perform asynchronous operations to register the components of the module.

For example if you need to initialize the database connection before registering the providers.

import 'package:serinus/serinus.dart';

class AppModule extends Module {
  AppModule();

  @override
  Future<Module> registerAsync(ApplicationConfig config) async {
    // Register controllers, providers, and other modules asynchronously
  }
}

Example

Here is an example of a module that imports another module, registers a controller, a provider, and a middleware, and exports the provider.

import 'package:serinus/serinus.dart';

class AppModule extends Module {
  AppModule(): super(
    imports: [AuthModule()],
    controllers: [AppController()],
    providers: [AppService()],
    middlewares: [LoggerMiddleware()],
    exports: [AppService],
  );
}