Exhibition: Unterschied zwischen den Versionen

Aus Info-Theke
Zur Navigation springen Zur Suche springen
 
(15 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 2: Zeile 2:


* [[Exhibition-Workflow]]
* [[Exhibition-Workflow]]
* [[Exhibition-RestServer]]
* [[Exhibition-MetaTool]]


= Motivation =
= Motivation =
Zeile 10: Zeile 12:
* A '''module''' is an object normally stored in one database table. Example: the module '''Users''' handles data of a user who can login to the app.
* A '''module''' is an object normally stored in one database table. Example: the module '''Users''' handles data of a user who can login to the app.
* The '''metadata''' of a module is a dart class specifying all properties of the module in a well readable form. This must be defined by the developer.
* The '''metadata''' of a module is a dart class specifying all properties of the module in a well readable form. This must be defined by the developer.
* '''basic actions''' are: '''new''' ("create"), '''edit''' ("change"), '''list''' ("show overview") and '''standard''' ("user defined")
* '''Basic actions''' are: '''create''', '''edit''' ("change"), '''list''' ("show many"), '''standard''' ("user defined") and '''delete'''.
* A '''page''' is a dialog for exactly one '''basic action''' of a module. The page name is normally the name of the basic action, but can be changed. Normally each module has the pages new, edit and list.
* A '''page''' is a dialog for exactly one '''basic action''' of a module. The page name is normally the name of the basic action, but can be changed. Normally each module has the pages new, edit and list.
* The '''restserver''' is a sub project of the dev-app to managing the data storage on a backend. See [[Exhibition-RestServer]]
* The '''rest_server''' is a sub project of the dev-app implementing a backend for managing the data storage in a MySql database. . See [[Exhibition-RestServer]]


= Installation =
= Installation =
* clone the Git project exhibition from github
* Clone the Git project exhibition from github.
* create a Flutter project (with AndroidStudio). It is important to create the dev-app as neighbour of exhibition: If the base folder of exhibition is /home/ws/flutter/exhibition the base folder of the dev-app "myapp" is /home/ws/flutter/myapp.
* Create the project files for the dev-app:
 
<syntaxhighlight lang="bash">
 
APP=myapp
= Workflow =
# precondition: the current directory is the parent of the base folder of Exhibition
We use the module "Users" as example
if [ ! -d exhibition/dart_tools ]; then
* create a metadata description: lib/meta/users_meta.dart
   echo "+++ $(pwd) is not the parent of the base folder of exhibition!"
<source lang="dart">
else
import 'module_meta_data.dart';
   exhibition/tools/InitProject $APP
 
fi
class UserMeta extends ModuleMetaData  {
</syntaxhighlight>
  static UserMeta instance = UserMeta.internal();
  UserMeta.internal() : super('Users',
    [
      PropertyMetaData('id', DataType.reference, ':primary:', 'combo'),
      PropertyMetaData('name', DataType.string, ':notnull:', '', size: 64),
      PropertyMetaData('displayName', DataType.string, ':unique:notnull:', '', size: 32),
      PropertyMetaData('email', DataType.string, ':unique:notnull:', '', size: 255),
      PropertyMetaData('role', DataType.reference, ':notnull:', ''),
      PropertyMetaData('created', DataType.datetime, '', ''),
      PropertyMetaData('createdBy', DataType.string, '', '', size: 32),
      PropertyMetaData('changed', DataType.datetime, '', ''),
      PropertyMetaData('changedBy', DataType.string, '', '', size: 32),
    ],
    tableName: 'loginusers',
  );
   factory UserMeta(){
    return instance;
   }
}
</source>

Aktuelle Version vom 23. Januar 2022, 17:05 Uhr

Links[Bearbeiten]

Motivation[Bearbeiten]

Exhibition is a Flutter framework for developing an Flutter app very quickly.

Glossary[Bearbeiten]

  • The dev-app is the Flutter application that should be developed with Exhibition.
  • A module is an object normally stored in one database table. Example: the module Users handles data of a user who can login to the app.
  • The metadata of a module is a dart class specifying all properties of the module in a well readable form. This must be defined by the developer.
  • Basic actions are: create, edit ("change"), list ("show many"), standard ("user defined") and delete.
  • A page is a dialog for exactly one basic action of a module. The page name is normally the name of the basic action, but can be changed. Normally each module has the pages new, edit and list.
  • The rest_server is a sub project of the dev-app implementing a backend for managing the data storage in a MySql database. . See Exhibition-RestServer

Installation[Bearbeiten]

  • Clone the Git project exhibition from github.
  • Create the project files for the dev-app:
APP=myapp
# precondition: the current directory is the parent of the base folder of Exhibition
if [ ! -d exhibition/dart_tools ]; then
  echo "+++ $(pwd) is not the parent of the base folder of exhibition!"
else
  exhibition/tools/InitProject $APP
fi