Microservice Spring Boot vs. Wildfly Swarm

Spring Boot vs. Wildfly Swarm

Dnes bude post trošku krátký, ale přesto si myslím, že bude zajímavý. Na jednom známém blogu jsem objevil srovnání dvou projektů, které lze využít na mikroslužby v Java světě. Jedná se o Wildfly Swarm a Spring Boot. Aktuálně se rozhoduji, který z těchto projektů využít.

Oba projekty přistupují k možnosti vytváření mikroslužeb obdobně (generátor pom.xm). Na internetu lze najít spoustu návodů jak vytvářet služby v obou projektech.

V mém projektu bude mikroslužba přistupovat k více službám různými protokoly (poslání souboru, WS, smtp). Takže v dalším článku možná porovnám oba projekty na možnosti integrace z okolnímy systémy a službami.

Článek je k dispozici zde.

• Wildfly Swarm generátor
• Spring Boot generáror
• Spring Boot
• Wildfly Swarm

Enterprise Architect scripting

Enteprise Architect skriptování

Dnes bych chtěl napsat pár řádků o Enterprise Architectu (Sparx Systems) a jeho možnostech skriptování. Tento nástroj je všude velmi rozšířený, protože umožnuje udržovat kompletní dokumentaci o vývoji. Pro vytváření lze využít standardní UML diagramy, ale lze využít i jiné modely například pro business procesy BPMN diagramy. V nových verzích EA je již integrována možnost vytvářet i grafické návrhy obrazovek, takže lze kompletní dokumentaci k projektu udržet na jednom místě.

To co se mí dále líbí je možnost ukládat projekty do databáze (Oracle, MySQL) a sdílet tak projekty napříč firmou bez nutnosti ukládání na sdílený disk. EA lze dnes provozovat jak na OS Windows, tak i na jiných platformách (Linux). V dnešní době mi nejvíce chybí automatické generování dokumentace z projektů, tak abych tuto činnost mohl dát na starost nějakému periodickému scheduleru. Z EA lze generovat HTML dokumentaci, ale absence automatizace je na škodu.

Mým cílem zde není popisovat EA, ale spíše ukázat možnosti skriptování, které EA nabízí.

Využití skriptování

• Vytváření a úprava modelů
• Vyhledávání v modelech
• Import/Export dat z/do modelu

Modely v EA můžete vytvářet ručně, můžete je generovat například ze zdrojových kódů nebo pomocí pluginu. Někdy ovšem potřebujete provést úpravy v projektech, které se jednoduše nedají dělat pomocí ručního zásahu, případně potřebujete naimportovat struktury, na které nelze využít standardní nástroje. V tomto případě vám může pomoci skriptování.

Typy skriptů

EA nabízí několik možností vytváření různých typů skriptů – podporuje VBScript, JScript nebo Javascript. Protože standardně moje pracovní stanice běží na linuxu (v korporátním prostředí je to občas problematické), začal jsem používat Javascript. Je to i z toho důvodu, že jsem si již několik aplikací napsal pomocí Javascript frameworků. Javascript, JScript a VBScript mají stejné možnosti využití API Enterprise Architectu. Nejvíce jsou zdokumentované skripty u JScript a VBScript. U Javascriptu je dokumentace méně, nicméně je možnost inspirovat se z těchto skriptů.

V případě, že otevřete portlet Scripting, zobrazí se vám základní nabídka skriptů, které je ideální na začátku si vyzkoušet. Skripty mohou běžet ve standartním režimu, případně je lze spouštět v Debug režimu.

První skript v Javascriptu

1. Otevřete Enterprise Architect a otevřete si Scripting Window

2. Vytvořte si skupinu například Test scripts

   

3. Vytvořte si například skript hello-world

   

4. Do funkce main napište Session.. Uvidíte, že se vám objeví nápověda

   

5. Dopište funkci Output s textem a spuťte.

   

Několik doporučení

Udržování skriptů

Doporučuji skripty udržovat v nějakém verzovacím nástroji. Ideální je znovupoužitelné funkce rozdělit do vlastních knihoven, které si poté můžete načítat do jednotlivých skriptů (DRY - Don’t Repeat Yourself). Příklad knihovny, která udržuje konstanty.

!INC Local Scripts.EAConstants-JScript

Nápověda při vytváření skriptů

Lze využí oficiální dokumentaci Object modelu Enterprise Architectu. Nicméně tato dokumentace není úplně přehledná a spousta informací zde není uvedeno, nebo není úplně jasná. Při vytváření skriptů je Enterprise architect schopný napovídat v případě, že ví o jaký objekt se jedná. V případě že chcete vědět jaké funkce můžete zavolat na daném objektu, můžete provést náslegdující operaci.

var currentModel as EA.Package
var currentDiagram as EA.Diagram
var currentElement as EA.Element
var currentConnector as EA.Connector

Poté se vám bude automaticky zobrazovat nápověda při zadání currentModel..

Logování

Při logování můžete využít Session.Ouput, který vypíše vstup na standartní vstup. Doporučuji využívat přímo logování, které je v základní knihovně k dispozici v Enterprise Architectu. Ukázka použití logování je například v mé ukázce skriptu zde..

!INC Local Scripts.EAConstants-JScript
!INC EAScriptLib.JScript-Logging

//DEBUG LEVEL
var LOGLEVEL = LOGLEVEL_DEBUG
//INFO LEVEL
// var LOGLEVEL = LOGVEL_INFO
function main()
{
  LOGDebug("Debug")
  LOGInfo("Info")
}
main()

Volbou úrovně logování (LOGLEVEL_DEBUG, LOGLEVEL_INFO) poté můžete měnit množství událostí, které se budou zobrazovat ve výstupu.

Práce se soubory

Velmi často je potřeba pracovat se soubory (načítat vstupy, případně ukládat výstupy) a poté je možnost využít objekty, kterými Enteprise Architect umožnuje pracovat se soubory.

!INC Local Scripts.EAConstants-JScript
!INC EAScriptLib.JScript-Logging

//DEBUG LEVEL
var LOGLEVEL = LOGLEVEL_DEBUG
//INFO LEVEL
// var LOGLEVEL = LOGVEL_INFO
function main()
{

    var fs = new COMObject("Scripting.FileSystemObject")
    var f = fs.GetFile(FILE_NAME)
    var ts = f.OpenAsTextStream(FILE_READ)
    var strline = null
    var lineNumber = 0

    while (!ts.AtEndOfStream) {
        strLine = ts.ReadLine()
        LOGDebug(strLine)
        lineNumber++
    }

    LOGInfo("The file " +FILE_NAME +" has " +lineNumber+" lines")
}
main()

Automatický layout diagramu

V případě že generujete velké množství elementů do diagramu nebo více diagramů, můžete pomocí skritpu zavolat operaci na automatické uspořádání elementů v diagramu. Elementy se poté v diagramu uspořádají podle zvoleného typu.

    !INC Local Scripts.EAConstants-JScript
    .
    .
    .
    .	
    //Auto layout
    Repository.GetProjectInterface().LayoutDiagramEx (resultDiagram.DiagramGUID, lsLayoutDirectionRight, 67, 40, 20, true)

Elektronická kniha

Pro začátek doporučuji použít knihu od Thomas Kiliana „Scripting Enterprise Architect“. Jsou zde vysvětleny základní práce s různými objekty jako Element, Diagram, Connector, konfigurace atributů, vytváření package nebo modelů.

Links

• Ukázkové příklady skriptů
• Odkaz na skripting v EA
• Enterprise Architect Object model

První příspěvek!

Můj první post pomocí Jekyll nástroje! Konečně jsem se po roce přemlouvání dostal k tomu, že jsem vytvořil svůj vlastní blog . Chtěl bych zde sdílet zajímavé informace ze světa ve kterém pracuji. Dnes to bude pouze krátký post, ale rád bych jednou za čas (týden, měsíc) vložil zajímavý příspěvek o technologiích se kterými pracuji a třeba vám některé informace ušetří tu hromadu času, kterou jsem nad některými věcmi trávil.