Feature: New Form Factory and Form Annotations
Goal: Development
Developer: Hengsin, Matheus Marcelino
Description
- Implement a new form factory base class that's backed by Map and Lambda functional object.
- Add org.idempiere.ui.zk.annotation.Form annotation and factory base class that discover and register classes with Form annotation.
Usage
With following form class:
public class MyTestForm implements IFormController {
private CustomForm form;
public MyTestForm() {
form = new CustomForm();
}
@Override
public ADForm getForm() {
return form;
}
}
Developer can use one of the following approach:
1. At plugin Activator start method, register the process class.
public void start(BundleContext context) throws Exception {
IMappedFormFactory mappedFactory = Extensions.getMappedFormFactory();
mappedFactory.addMapping(MyTestForm.class.getName(), () -> new MyTestForm().getForm());
}
2. Create an osgi component, at the bind method for IMappedFormFactory service component.
public void bindService(IMappedFormFactory factory) {
factory.addMapping(MyTestForm.class.getName(), () -> new MyTestForm().getForm());
}
3. Create a subclass of MappedFormFactory, register as IFormFactory service (DO NOT register as IMappedFormFactory service).
public class MyFactory extends MappedFormFactory {
public MyFactory() {
addMapping(MyTestForm.class.getName(), () -> new MyTestForm().getForm());
}
}
4. IDEMPIERE-5012 added scan(BundleContext context, String... packages) method to IMappedFormFactory and MappedFormFactory. Developer can call that at plugin Activator start method to register form classes with org.idempiere.ui.zk.annotation.Form annotation.
public void start(BundleContext context) throws Exception {
//replace org.idempiere.test.form with package name of your form classes
Extensions.getMappedFormFactory().scan(context, "org.idempiere.test.process");
}
Annotations
1. org.idempiere.ui.zk.annotation.Form annotation with optional name parameter. A form class is always register to its fully qualify class name and the name parameter allow developer to add an alternate register name for the form class.
2. Plugin should either use the method 4 above or create a new OSGi component that extends the AnnotationBasedFormFactory class (usually with @Component(immediate = true, service = IFormFactory.class, property = {"service.ranking:Integer=1"}) component annotation).
@org.idempiere.ui.zk.annotation.Form(name = "org.compiere.apps.form.VAllocation")
public class WAllocation extends Allocation implements IFormController, EventListener<Event>, WTableModelListener, ValueChangeListener {
...
}
Technical Info: IDEMPIERE-4773, IDEMPIERE-5012
