de.saxsys.mvvmfx.easydi

Class MvvmfxEasyDIApplication

java.lang.Object

javafx.application.Application

de.saxsys.mvvmfx.easydi.MvvmfxEasyDIApplication

All Implemented Interfaces:

de.saxsys.mvvmfx.internal.MvvmfxApplication

public abstract class MvvmfxEasyDIApplication
extends javafx.application.Application
implements de.saxsys.mvvmfx.internal.MvvmfxApplication

This class has to be extended by the user to build a javaFX application powered by EasyDI as dependency injection library.

Please note: EasyDI only supports constructor injection. However when JavaFX bootstraps the Application constructors with arguments are not supported for the application starter class. This means that you can't inject dependencies into your application starter class directly. Instead you can use the initEasyDi(EasyDI) method for this purpose. See the following code example:

 public class MyApp extends MvvmfxEasyDIApplication {

     private Service service;

     @Override
     public void initEasyDi(EasyDI context) {
         this.service = context.getInstance(Service.class);
     }


     @Override
     public void startMvvmfx(Stage stage) {
         service.someAction(); // use the injected service

         // load your UI
     }
 }

 

Lifecycle notice. The application class goes through this lifecycle:

1. initEasyDi(EasyDI)
2. MvvmfxApplication.initMvvmfx()
3. MvvmfxApplication.startMvvmfx(Stage)
4. MvvmfxApplication.stopMvvmfx()

This means that dependencies that were obtained in the initEasyDi(EasyDI) method can be used in the MvvmfxApplication.initMvvmfx() and MvvmfxApplication.startMvvmfx(Stage) methods.

Nested Class Summary

Nested classes/interfaces inherited from class javafx.application.Application

javafx.application.Application.Parameters

Field Summary

Fields inherited from class javafx.application.Application

STYLESHEET_CASPIAN, STYLESHEET_MODENA

Constructor Summary

Constructors

Constructor and Description
MvvmfxEasyDIApplication()

Method Summary

Modifier and Type	Method and Description
void	init()
protected void	initEasyDi(eu.lestard.easydi.EasyDI context) This method is used for initialization of the EasyDI context.
void	start(javafx.stage.Stage primaryStage)
void	stop()

Methods inherited from class javafx.application.Application

getHostServices, getParameters, getUserAgentStylesheet, launch, launch, notifyPreloader, setUserAgentStylesheet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface de.saxsys.mvvmfx.internal.MvvmfxApplication

initMvvmfx, startMvvmfx, stopMvvmfx

Constructor Detail

MvvmfxEasyDIApplication

public MvvmfxEasyDIApplication()

Method Detail

start

public final void start(javafx.stage.Stage primaryStage)
                 throws Exception

Specified by:

start in class javafx.application.Application

Throws:

Exception

stop

public final void stop()
                throws Exception

Overrides:

stop in class javafx.application.Application

Throws:

Exception

init

public final void init()
                throws Exception

Overrides:

init in class javafx.application.Application

Throws:

Exception

initEasyDi

protected void initEasyDi(eu.lestard.easydi.EasyDI context)
                   throws Exception

This method is used for initialization of the EasyDI context. A typical usage is to configure custom interface bindings like EasyDI.bindInterface(Class, Class) or EasyDI.bindProvider(Class, Provider).

Additionally this method can be used to get instances of dependencies that are needed for the start process of the application (for example in the MvvmfxApplication.startMvvmfx(Stage) method).

Lifecycle notice: This method is invoked by the framework before the invokation of MvvmfxApplication.initMvvmfx() and MvvmfxApplication.startMvvmfx(Stage).

Parameters:

context - The EasyDI instance that is responsible for injecting all needed instances in the current application.

Throws:

Exception - If any error occurs while binding interfaces.