{% extends '../../base.html.twig' %} {% block body %}
{% include '../../../documentation/navbar.html.twig' with { 'route' : nodefony.route } %}

{{ "Dependency Injections" | trans() }}

A Dependency Injections service is an entity that can manage instance of services in application .
.

Nodefony don't manage Dependency Injections like symfony2 framework but is inspired

You can see here :

Location Services:

You can find or add service in bundle repository under services directory . 

$ ls -l src/nodefony/bundles/hello-bundle

          drwxr-xr-x    4 cci  staff     128 27 mar 15:13 Command
          drwxr-xr-x    3 cci  staff      96 27 mar 15:13 Entity
          drwxr-xr-x    6 cci  staff     192 27 mar 15:13 Resources
          drwxr-xr-x    3 cci  staff      96 27 mar 15:13 build
          drwxr-xr-x    3 cci  staff      96 27 mar 15:13 controller
          drwxr-xr-x    3 cci  staff      96 27 mar 15:13 doc
          -rw-r--r--    1 cci  staff     642 27 mar 15:13 helloBundle.js
          drwxr-xr-x  646 cci  staff   20672 27 mar 15:14 node_modules
          -rw-r--r--    1 cci  staff  297699 27 mar 15:14 package-lock.json
          -rw-r--r--    1 cci  staff    1274 27 mar 15:14 package.json
          -rw-r--r--    1 cci  staff       1 27 mar 15:13 readme.md
          drwxr-xr-x    3 cci  staff      96 27 mar 15:13 
services

          drwxr-xr-x    2 cci  staff      64 27 mar 15:13 src
          drwxr-xr-x    3 cci  staff      96 27 mar 15:13 tests

Autoloader :

The core autoloader nodefony load all files in this directory which match with '...Service.js'

Interpreter :

The core autoloader nodefony interpret the javascript code in an extended global context.
You can find namespace nodefony in the global context .

Class Service :

The name of file must finish by '...Service.js' example : nameService.js


          const tab = [1,2,3,4];
          const myFuntion = function(){
          	return tab ;
          }

          /*
           *	Class service name
           *	constructor
           */
          module.exports = class name extends nodefony.Service {

          	/*
           	*	constructor  service
           	*/
          	constructor (kernel, injection2){
                  super("nameService", kernel.container, kernel.notificationsCenter);
                  this.injection2 = injection2 ;
          	};

          	/*
           	*	Method  service
           	*/
          	runTask (domain){
              console.log(domain);
          	};
          };

Configuration Injection Service :

Now the injection service can manage this service to instanciate this, and inject dependencies ( kernel, injection2 ...).

Ressources/config/services.js

          module.exports = {
            name: {
              class: nodefony.services.name,
              arguments: ["@kernel", "@injection2"],
              calls: [{
                method: "runTask",
                arguments: [kernel.domain]
              }]
            }
          };

Example Services bundle core http :

File Services :

The name of file must finish by '...Service.js' example : nameService.js
Exemple http-bundle : 

$ ll http-bundle/services

          ├── kernel
          │   └── httpKernelService.js
          ├── servers
          │   ├── httpService.js
          │   ├── httpsService.js
          │   ├── webSocketSecureService.js
          │   └── websocketService.js
          ├── sessions
          │   └── sessionsService.js
          ├── staticFiles
          │   ├── staticService.js
          │   └── staticsService.js.old
          └── upload
              └── uploadService.js

Configuration Injection :

Exemple httpBundle : services.js 

module.exports = {
            serverStatics: {
              class: nodefony.services.serverStatics,
              arguments: ["@container"]
            },
            httpKernel: {
              class: nodefony.services.httpKernel,
              arguments: ["@container", "@serverStatics"]
            },
            httpServer: {
              class: nodefony.services.httpServer,
              arguments: ["@httpKernel"]
            },
            httpsServer: {
              class: nodefony.services.httpsServer,
              arguments: ["@httpKernel"]
            },
            websocketServer: {
              class: nodefony.services.websocketServer,
              arguments: ["@httpKernel"]
            },
            websocketServerSecure: {
              class: nodefony.services.websocketServerSecure,
              arguments: ["@httpKernel"]
            },
            sessions: {
              class: nodefony.services.sessions,
              arguments: ["@httpKernel"]
            },
            upload: {
              class: nodefony.services.upload,
              arguments: ["@httpKernel"]
            },
            sockjs: {
              class: nodefony.services.sockjs,
              arguments: ["@httpKernel", "@httpServer", "@httpsServer"]
            },
          };

Starting Log :

When starting all service are registred in Global Container : 

Thu Mar 28 2019 11:45:38 DEBUG KERNEL :  REGISTER BUNDLE : http
          Thu Mar 28 2019 11:45:38 DEBUG BUNDLE http : Register Service : httpKernel
          Thu Mar 28 2019 11:45:38 DEBUG BUNDLE http : Register Service : requestClient
          Thu Mar 28 2019 11:45:38 DEBUG BUNDLE http : Register Service : httpServer
          Thu Mar 28 2019 11:45:38 DEBUG BUNDLE http : Register Service : httpsServer
          Thu Mar 28 2019 11:45:38 DEBUG BUNDLE http : Register Service : sockjs
          Thu Mar 28 2019 11:45:38 DEBUG BUNDLE http : Register Service : serverStatics
          Thu Mar 28 2019 11:45:38 DEBUG BUNDLE http : Register Service : websocketServerSecure
          Thu Mar 28 2019 11:45:38 DEBUG BUNDLE http : Register Service : websocketServer
          Thu Mar 28 2019 11:45:38 DEBUG BUNDLE http : Register Service : sessions
          Thu Mar 28 2019 11:45:38 DEBUG BUNDLE http : Register Service : upload
          Thu Mar 28 2019 11:45:38 DEBUG SERVICE KERNEL READER : HTTP SERVICE LOAD FILE :nodefony-starter/node_modules/@nodefony/http-bundle/Resources/config/services.js
          Thu Mar 28 2019 11:45:38 DEBUG SERVICE SERVER STATICS  : STARTED
          Thu Mar 28 2019 11:45:38 DEBUG SERVICE HTTP KERNEL  : STARTED
          Thu Mar 28 2019 11:45:38 DEBUG SERVICE SERVER HTTP  : STARTED
          Thu Mar 28 2019 11:45:38 DEBUG SERVICE SERVER HTTPS  : STARTED
          Thu Mar 28 2019 11:45:38 DEBUG SERVICE SERVER WEBSOCKET  : STARTED
          Thu Mar 28 2019 11:45:38 DEBUG SERVICE SERVER WEBSOCKET SECURE  : STARTED
          Thu Mar 28 2019 11:45:38 DEBUG SERVICE SESSIONS  : STARTED
          Thu Mar 28 2019 11:45:38 DEBUG HTTP UPLOAD : STARTED
          Thu Mar 28 2019 11:45:38 DEBUG SERVICE sockjs  : STARTED
          Thu Mar 28 2019 11:45:38 DEBUG SERVICE requestClient  : STARTED

Services Usage :

Get service in controller:

To use service you must pass by Services Container :
Example to use service in action controller :
The controller core have get method to find a service 

footerAction (){
            // get sessions service
            
let sessionService = this.get("sessions");


            // get translation  service
            let translateService = this.get("translation");
            let langs = translateService.getLangs();
            let locale = translateService.getLocale();

          	...
          }
{% endblock %}