anaptecs JEAF Plattform JEAF Developer Guide

Transkript

1 anaptecs JEAF Plattform JEAF Developer Guide

2 : JEAF Framework Die technische Grundlage für Applikationen auf Basis der JEAF Plattform bildet das JEAF Framework. Dabei handelt es sich um ein leichtgewichtiges Framework, das für die Entwicklung von unternehmenskritischen Systemen konzipiert wurde. JEAF Framework Transaktionsmanagement & Persistenz Security Basisdienste JSE / JEE JEAF Generator Services & Komponenten 2013 anaptecs GmbH : 2

3 : JEAF Framework Features Einheitliches Programmiermodell für JSE und JEE auf Basis einer service- und komponentenorientierten Architektur Laufzeitumgebung für Komponenten und Services Transparente Kommunikation zwischen Services Transparentes, deklaratives Transaktionshandling Flexibles offenes Security Modell Model-Driven Software Development mit JEAF Generator Dependency und Property Injection Integration von Persistenz Frameworks auf Basis von JPA inkl. Modellierung Intelligente technische Basisdienste für Exception Handling, Tracing, Internationalisierung usw. Standard Komponenten für User Management, Scheduling und Application Level Monitoring 2013 anaptecs GmbH : 3

4 : Design Grundsätze Keep it simple Open-Source-Projekte und -Tools als Basis Trennung von technischem und fachlichen Code Basis für Business Komponenten in JEE und JSE Vereinfachung der Software-Entwicklung im JEE-Umfeld Langzeit Support für Releases (mehrere Jahre) 100% JEE kompatibel Testbarkeit von Komponenten und Subsystemen Stabilität und Performance, da das Framework speziell für die hohen Anforderungen von unternehmenskritischen Systemen konzipiert wurde Keine riesigen XML Konfigurationsdateien Entwickler sollen so gut wie möglich in ihrer Arbeit unterstützt werden 2013 anaptecs GmbH : 4

5 : Technische Basisfunktionen API Klassen für Basisdienste Alle öffentlichen Klassen und Interfaces in den Packages com.anaptecs.jeaf.fwk.core und *.core.util sind Bestandteil des API von JEAF und können uneingeschränkt verwendet werden Basisdienste Tracing, Exception-Handling, Tools Klassen, Dependency Injection, Properties ServiceChannel Transparente Kommunikation zwischen Services (JSE, JEE, Hessian Remoting), Transaktionshandling, Security Service Provider Persistence (auf Basis von Hibernate), Java Mail, Security 2013 anaptecs GmbH : 5

6 : JEAF Lifecycle Manager Aktuell unterstützte Laufzeitumgebungen JEE Application (EAR) (JBoss, WebSphere) JEE Application Client JSE JUnit Servlet Container (Tomcat) Hessian Client (JS Bootstrapping / Initialisierung von Komponenten, Services und Service Providern Bevor Komponenten, Services und Service Provider verwendet werden können, müssen diese initialisiert werden. In Abhängigkeit von der Umgebung existieren hierfür unterschiedliche Mechanismen Step 1: Initialisierung der Framework internen Dienste Step 2: Initialisierung von Service-Providern, Komponenten und Services, Ermittlung von Remote Services Step 3: Dependency Injection 2013 anaptecs GmbH : 6

7 : Funktionsweise JEAF Service Channel 2013 anaptecs GmbH : 7

8 : JEAF und JEE 2013 anaptecs GmbH : 8

9 : Architekturmodell Lifecycle Manager und Service Channel Dienen zur Entkopplung von Laufzeitumgebung und stellen folgende Dienste zur Verfügung: Kommunikation zwischen Services Transaktionshandling Security Initialisierung von Komponenten Dependency und Property Injection Unterschiedliche Implementierungen für verschiedene Einsatzszenarien (JEE, JSE, Remote Kommunikationsprotkolle) Komponenten und Services Mit Hilfe von Komponenten und Services erfolgt die Implementierung der Business Logik. Für allgemeine Aufgaben stehen bereits Standard Komponenten zur Verfügung Service Provider Service Provider dienen zur Implementierung / Anbindung von technischen Diensten z.b. Messaging, Caching-Lösungen 2013 anaptecs GmbH : 9

10 : JEAF Services und Service Objekte 2013 anaptecs GmbH : 10

11 : JEAF Komponenten 2013 anaptecs GmbH : 11

12 : Dependency und Property Injection Standardmechansimus Dependencies werden aufgrund der Abhängigkeiten im UML Modell entsprechend generiert und durch JEAF bei der Initialisierung gesetzt Properties werden ebenfalls bereits im UML Modell beschrieben und entsprechenden Zugriffsmethoden generiert Properties sind sind dynamisch und können ohne Anpassungen am Code zu Laufzeit geändert werden (Dynamic Properties) Automatische Injection bei Service Implementierungen, Service Providern, Domain und Persistenten Objekten Erweiterungsmöglichkeiten Für Klassen die nicht durch JEAF erzeugt oder initialisiert werden, kann auch ein eigener Mechanismus implementiert werden JEAF.injectDependencies( ) 2013 anaptecs GmbH : 12

13 : Dependency und Property Injection 2013 anaptecs GmbH : 13

14 : Domänen Objekte 2013 anaptecs GmbH : 14

15 : Persistente Objekte 2013 anaptecs GmbH : 15

16 : Domänen Objekte 2013 anaptecs GmbH : 16

17 : Persistente Objekte 2013 anaptecs GmbH : 17

18 : Object Mapping Object Mapping kann im Modell definiert werden und erspart so die mühsame Umwandlung von z.b. Service Objekten in persistente Objekte und umgekehrt 2013 anaptecs GmbH : 18

19 : Hibernate Anbindung Unterstützung für Hibernate 3 und 4 Einsatz in JEE und JSE OR-Mapping erfolgt im UML Modell Persistente Klasse werden vollständig generiert inkl. korrektem Beziehungshandling und vollständigem OR-Mapping Unterstützung für 1:1, 1:n und m:n Beziehungen (uni- und bidirektional) Konstanten für SQL Statements werden generiert Vereinfachung JPA API Vergabe von Objekt-IDs ohne Zugriff auf DB OID-Mechanismus Einfache Verteilung von Daten in unterschiedliche Schema, da keine Sequenzen benötigt werden JDBC Worker 2013 anaptecs GmbH : 19

20 : JEAF Security Security & User Management Deklarative Security Flexibles und dynamisches Berechtigungskonzept mit Hilfe von Rollen und Kompetenzen (1 Compentence-Type pro Service Operation) Modellierung von Rollen im UML Modell. XML File mit Rollen und Berechtigungen wird generiert Datenbank-basierte Verwaltung von User, Rollen und Berechtigungen Abbildung von Organisationsstrukturen Daten-bezogene Berechtigungen Erweiterbar um eigene Berechtigungsprüfungen JAAS Login Module (JEE und JSE) Authorization und User Import Tool 2013 anaptecs GmbH : 20

21 : JEAF Security 2013 anaptecs GmbH : 21

22 : JEAF Basisdienste Basisdienste Tracing und Internationalisierung Tools (Strings, Collections, Date, RegExp, Serialization, XML, Reflection, Files, Locale, Web) Dependency Injection Services Session Management & Kontext Management Interceptoren Application & Version Info Zugriff Zugriff erfolgt über die statischen Methoden von com.anaptecs.jeaf.fwk.core.jeaf 2013 anaptecs GmbH : 22

23 : Konfiguration von JEAF Wo erfolgt die Konfiguration von JEAF? Alle Konfigurationen erfolgen in den JEAF Properties (Default = JEAF.properties) Name lässt sich über System-Property jeaf.properties beliebig anpassen Was kann / muss alles konfiguriert werden? Lifecycle Manager und Service Channel (inkl. Remoting) Component Factories (Komonenten, die gestartet werden sollen) Service Provider Factories (Service Provider, die verwendet werden sollen) Scheduling Interceptoren Components Properties Provider (Auflösung von Properties von Komponenten) Locale Provider (Provider zur Ermittlung der User-spezifischen Sprache) 2013 anaptecs GmbH : 23

24 : Internationalisierung Alle Texte und Meldungen werden in einem Message Repository mehrsprachig abgelegt Die Pflege der Texte erfolgt in XML Files Für jede Message wird aufgrund des XML Files eine Klasse mit entsprechende Konstanten generiert Über die generierten Konstanten können die Messages im Code referenziert werden. Um die Anzeige der Meldungen in der korrekten Sprache für den User kümmert sich JEAF Ermittlung der Sprache kann über unterschiedliche Locale Provider gesteuert werden Java Klassen LocalizedObject, MessageID und ErrorCode im Package com.anaptecs.jeaf.fwk.core LocalizedObject.toString(...) MessageRepository.getMessage(...) 2013 anaptecs GmbH : 24

25 : Exception Handling Exception Handling Trennung in Application und System Exceptions Application Exceptions beschreiben fachliche Probleme und sind checked Exceptions System Exceptions beschreiben technische Probleme und sind uncheck Exceptions Pro Service sollte eine Application und eine System Exception definiert werden. Fehlerfälle können anhand eines Error-Codes identifiziert werden. Dieser ist obligatorisch. Java Klassen ApplicationException und SystemException im Package com.anaptecs.jeaf.fwk.core 2013 anaptecs GmbH : 25

26 : Check / Assertions und Tracing Checks und Assertions Dienen u.a. zur Prüfung von Eingabeparametern Assertions werden bei internen Überprüfungen angewendet Checks werden bei Parametern an öffentlichen Schnittstellen verwendet, jedoch nicht als Mechanismus für fachliche Prüfungen gedacht *.core.assert.* und *.core.check.* Tracing Automatisch verfügbar bei Service-Implementierungen, Domain und Business Objekten Zugriff über JEAF.getTrace(...) oder JEAF.getCurrentTrace() Injection Pro Komponente wird ein Logger verwendet Traces können über Message-IDs ebenfalls im Code lokalisiert werden Tracing ist Aufsatz auf Apache Commons Logging, daher kann tatsächliches Tracing Framework ausgetauscht werden (meist wird Log4J verwendet) 2013 anaptecs GmbH : 26

27 : Validierung von Objekten Funktionsweise JEAF unter scheidet zwischen object-based Constraints und cascading Constraints Object-based Constraints beziehen sich auf einzelnen Attribute einer Klasse oder eine Kombination davon Spanning Constraints beziehen sich auf Geflecht von Objekten (übergreifend) Ergebnis eines Constraint-Checks ist eine Liste von FailureMessages. Dabei wird zwischen Errors und Warnings unterschieden Java Klassen Verifiable, VerificationResult und ConstraintViolationException im Package *.jeaf.core 2013 anaptecs GmbH : 27

28 : Zugriff auf Properties Klasse ResourceAccessProvider ermöglicht einfachen Zugriff auf Properties Zugriffe sind typsafe Es existieren unterschiedliche Implementierungen für unterschiedliche Environments SystemProperties ResourceBundle Component Properties Properties von Komponenten können sowohl aus Property-File als auch aus DB gelesen werden. Konfiguration erfolgt über die JEAF Properties 2013 anaptecs GmbH : 28

29 : JEAF Kontexte Konzept Kontexte können dazu verwendet werden Objekte zu speichern. Kontexte werden durch JEAF entsprechend ihrem Scope isoliert und verwaltet. Alle Objekte z.b. Service Impls, Domänen und Business Objekte können auf den Kontext zugreifen Session Context Objekte bleiben gesamte User Session erhalten (ähnlich zu http Session). Kontext pro User sichtbar Request Context* Objekte sind an den aktuelle Request unabhängig von Transaktionsgrenzen gekoppelt Transaction Context Objekte sind an die aktuelle Transaktion gekoppelt. Kontext ist nur Transaktionslokal sichtbar Service Invocation Context Objekte sind an den aktuellen Service-Call gekopplet. Kontext ist nur innerhalb eines Service-Calls sichtbar. Zwei inneinander verschachtelte Service-Calls haben zwei Kontexte 2013 anaptecs GmbH : 29

30 : Interceptoren, Listener, Service Channel Interceptor Interceptoren werden vor und nach einem Service Call aufgerufen. Interceptoren können global oder pro Service definiert werden Service Invocation Listener Listener wird über das Beenden eines Service Calls benachrichtigt. Er kann nur programmatisch über den Service Invocation Context gesetzt werden Transaction Listener Transaction Listener werden global konfiguriert und werden vor dem Start und direkt vor dem Commit benachrichtigt 2013 anaptecs GmbH : 30

31 : JEAF Components System Management & Monitoring Überwachung des Zustands von Services Alle Services verfügen über entsprechende Checks Anpassung von Dynamic Properties zur Laufzeit Laufzeitanalyse von Service Calls Management Web Application Scheduling Einmaliges und zyklisches Scheduling von Services Speicherung von Tasks erfolgt in DB Support für Clustering Überwachung der Ausführung über Management Web Application* User Management siehe JEAF Security 2013 anaptecs GmbH : 31

32 : System Management & Monitoring 2013 anaptecs GmbH : 32

33 : Zusammenfassung JEAF Framework Leichtgewichtiges Framework speziell für den Einsatz in unternehmenskritischen Systemen entwickelt Business Komponenten können unverändert in JEE und JSE Umgebung eingesetzt werden Model-Driven Software Development / JEAF Generator Generierung von Services, Service- und Domänen-Objekten und Persistenz mit JEAF Generator auf Basis des UML Modells Transparente Kommunikation zwischen Services (Service-Channel) Nutzt etablierte Open-Source Frameworks (z.b. Hibernate, Log4J) Intelligente technische Basisdienste für Exception Handling, Tracing, Internationalisierung usw. plus Dependency und Property Injection Beinhaltet bereits diverse konfigurierbare Standard Komponenten (Application Management & Monitoring, User Management, Scheduling, Security) Langzeit-Support für Releases

34 : Kontakt Weiterführende Informationen sind über die Website verfügbar Whitepaper Download Dokumentation / API Ansprechpartner anaptecs GmbH Burgstr Reutlingen Deutschland anaptecs GmbH Altisbergstrasse Biberist Schweiz Support jeaf-support@anaptecs.de Skype: jeaf-support 2011 anaptecs GmbH : 34

35 : Allgemeine Infos Skype: jeaf-support 2013 anaptecs GmbH : 35