Programming on Pesches Schlauch

MicroProfile OpenAPI—Design First with Quarkus

Wed, 19 Nov 2025 00:00:00 +0000

In an earlier article on the OpenAPI design-first approach I compared openapi-generator and swagger-codegen. Now I'm revisiting the topic by adding the Quarkus OpenAPI Generator to the comparison.

MicroProfile OpenAPI—Design First

Wed, 27 Mar 2024 00:00:00 +0000

You're given the task of writing a microservice AND providing a documentation in OpenAPI format. You already know that there are two main approaches:

code-first : write the code, using OpenAPI annotations, and then generate the OpenAPI document
design-first : write the OpenAPI document (a.k.a. the openapi.yaml file) and then generate the code

This is the second article in a series and reviews the design-first approach, the code-first approach was the subject of the first article.

MicroProfile OpenAPI—Code First

Fri, 01 Dec 2023 00:00:00 +0000

You're given the task of writing a microservice AND providing a documentation in OpenAPI format. You already know that there are two main approaches:

code-first : write the code, using OpenAPI annotations, and then generate the OpenAPI document
design-first : write the OpenAPI document (a.k.a. the openapi.yaml file) and then generate the code

This article reviews the code-first approach, the design-first approach will follow in a second article at a later time.

Dizygotic Twins: Quarkus 3 and Wildfly 28

Fri, 02 Jun 2023 00:00:00 +0000

Compares Wildfly 28 and Quarkus 3 with respect to their support for Jakarta EE 10 and Microprofile 6

Sending a Hello from Mutiny in Wildfly

Mon, 15 May 2023 00:00:00 +0000

Shows how to use MicroProfile Reactive Messaging and Mutiny with Wildfly 28 and Kafka

Ryuk the Resource Reaper

Mon, 09 Jan 2023 00:00:00 +0000

Testcontainers' Ryuk container and a workaround for better collaboration with old Docker versions

envvc now on GitHub

Mon, 02 Jan 2017 12:59:50 +0100

envvc is now available on GitHub.

Merge down, copy up

Tue, 03 Jul 2007 17:06:15 +0200

If you are using any SCM that allows cheap branches (like Perforce) and are following the advices from the High-level Best Practices document, you might be interested in (or already know) Laura Wingerd's presentation Convergence vs. Divergence: Purposeful Merging with Perforce about how to converge to codelines using Merge Down, Copy Up [PDF]. I have seen it many times that a main codeline got broken because the Merge Down, Copy Up idiom was ignored.

Psion SIBO SDK

Wed, 16 May 2007 08:43:53 +0200

I'm cleaning up shelves and have got an old "SIBO SDK 2.10" which I haven't used in years. It is a Software Development Kit for 16-Bit Psion handheld computers like Psion Series 3 or Psion Workabout. If you are interested in two floppy disks and four folders of documentation, please drop me a note.

envvc

Thu, 05 Apr 2007 11:34:14 +0200

Did you ever have the need to use different versions of Microsofts Visual C++ compiler from the command line? Did you wish you wouldn't have to constantly call vcvars32.bat or change your environment (PATH, INCLUDE and LIB variables)?

In comes a little tool called envvc.exe. It sets the environment for the chosen version and then calls any chosen executable. As additional feature it verifies that you have installed the latest service pack for the chosen version.

Gratulation nach Schwarzenburg!

Wed, 07 Mar 2007 22:28:45 +0100

Wie diese Woche bekannt wurde, gewann Kaba-Gilgen AG aus Schwarzenburg nach einem sechsmonatigen Pilotbetrieb die internationale Ausschreibung der Pariser Métro (RATP), zwei Linien mit halbhohen Bahnsteigtüren (Platform Screen Doors PSD half-height, PDF) auszurüsten.

Ich gratuliere dem ADP-Team von Kaba-Gilgen für diesen Erfolg und freue mich, dass damit auch die Arbeit von Hug-Witschi den Weg nach Paris findet. Hug-Witschi hat im Auftrag von Kaba-Gilgen die Steuerung (Hardware und erste Version der Software) der einzelnen Türeinheiten entwickelt.

Solving the Santa Claus Problem with Barriers

Mon, 22 May 2006 07:34:43 +0200

There are already many solutions to the "Santa Claus Problem" by John Trono¹. It's a "problem simple to understand and yet far from easy to solve"; the author's original solution (based on semaphores) was only partly correct. The probably most known analysis of the problem was written by Mordechai Ben-Ari², who also provided solutions in Ada95 and Java. This is the original problem description:

Santa Claus sleeps in his shop up at the North Pole, and can only be wakened by either all nine reindeer being back from their year long vacation on the beaches of some tropical island in the South Pacific, or by some elves who are having some difficulties making the toys. One elf's problem is never serious enough to wake up Santa (otherwise, he may never get any sleep), so, the elves visit Santa in a group of three. When three elves are having their problems solved, any other elves wishing to visit Santa must wait for those elves to return. If Santa wakes up to find three elves waiting at his shop's door, along with the last reindeer having come back from the tropics, Santa has decided that the elves can wait until after Christmas, because it is more important to get his sleigh ready as soon as possible. (It is assumed that the reindeer don't want to leave the tropics, and therefore they stay there until the last possible moment. They might not even come back, but since Santa is footing the bill for their year in paradise... This could also explain the quickness in their delivering of presents, since the reindeer can't wait to get back to where it is warm.) The penalty for the last reindeer to arrive is that it must get Santa while the others wait in a warming hut before being harnessed to the sleigh.

dmake Stories

Mon, 17 Apr 2006 17:16:14 +0200

At work, we started using dmake in 1991 (or even earlier) for building the firmware for the Vending Machine Controller Euro'90. The firmware consisted mostly of PL/M and C code and the compilers suffered from the DOS limitation of 127 characters per command line. Dennis Vadura's dmake 3.70 (hosted by the University of Waterloo and available as DOS version) featured the $(mktmp ) macro that let me create any needed temporary config and response files.

Tiger and Realpolitik

Mon, 23 May 2005 21:01:19 +0200

Even before I upgraded to OS X 10.4 (Tiger), I got the report that the Save File dialog in Realpolitik crashes. Now I have applied a quick'n'dirty fix for the next couple of days for all Tiger users and released Realpolitik 1.7.0 Alpha 2 earlier than planned.

Currently I'm revamping the dialogs known to Mac developers as Navigation Services. Already done in Alpha 2 is the Open File dialog:

From the users perspective you have now a working type pop-up, where you can choose Realpolitik Files (.dpy files and files created by Realpolitik), Text Files or just any document.

Back from Oxford

Mon, 25 Apr 2005 19:54:47 +0200

The four days at the ACCU Conference in Oxford are over. Except Günter nobody seems to have blogged the C++ track.

Apart from the discussions and presentations what should go into the next C++ standard (called C++0x and scheduled for 2009), one of the big topics was concurrency and a new awareness that some new ideas are needed. Herb Sutter presented the points of his recent DDJ article. As an example for an exercise simple to understand and yet far from easy to solve he mentioned the Santa Claus Problem:

Realpolitik for OS X

Tue, 15 Mar 2005 22:36:28 +0100

After much carbonizing by Ben Hines and some polishing by me a new Realpolitik Release is available on Sourceforge, the first release for OS X.

The release version Realpolitik 1.7.0 Alpha1 is not yet stable (hence Alpha 1), there are still some known (and probably many more unknown) errors like selection and redrawing problems with the orders window, but with some care (backup your .dpy files!) it should be usable.

Parallel to the Mac version a new Windows version is out. It's called Alpha too, but should be as stable as the old releases. The only major change for the windows version is the switch from Mindvision Installer VISE to the NSIS installer. VISE was once free for shareware developers, but is not anymore. And NSIS looks at least as good as VISE, is open source and has CVS-friendly plain text configuration files.

El Niño Drawing

Fri, 10 Dec 2004 13:08:31 +0100

Every year after christmas the El Niño Cup takes place. It is a tournament where the result is less important than exercising and having fun. There is a team day, where every team plays Volleyball, Basketball and Unihockey, and a single day, where the disciplines are Badminton, Table Tennis and Archery.

Last year I wrote a program to ease the drawing. It is a fairly complex problem:

Every participant must have six matches, two for every discipline, against members of its category (men, women, mixed...)
There should be not two matches against the same adversary (except if the category has less than 7 players)
Between two matches there should be a break of at least the duration of one match

This year I enhanced the program some more. The amount of tweaking the program output by hand is now almost zero. Just some games remained to be exchanged to satisfy the at-least-one-break condition.

Python für Kids auf dem Macintosh

Tue, 05 Oct 2004 20:08:13 +0200

Im Gegensatz zu PCs ist bei OS X Python bereits vorinstalliert. Leider fehlt jedoch ausgerechnet IDLE, so dass trotzdem noch etwas zu tun bleibt.

Installationsanleitung für IDLE (von PythonMac FAQ abgekupfert)

Tcl/Tk Aqua herunterladen und installieren
MacPython herunterladen und installieren (für OS X 10.3 sind das die MacPython Panther Addons)
Das Programm PackageManager im Ordner /Programme/MacPython-2.3 starten
Im PackageManager _tkinter installieren

"Neue" Division

Damit IDLE sich so benimmt wie im Buch beschrieben (vgl. Anhang D im Buch), muss noch eine Datei leicht verändert werden.

Python IDLE with "new" division on OS X

Tue, 05 Oct 2004 20:08:13 +0200

(Deutscher Text siehe separater Artikel)

K got the book Python für Kids. To enable him to use the book on OS X, I wanted to setup the Python environment on the Mac as on the PC: Install IDLE and, to hide the differences between integer and floating point math, configure to use the new division.

Installing IDLE on OS X 10.3 is easy with MacPython. IDLE comes as bundle, ready to be launched with the mouse from the Finder. But for using the new division without the need for from __future__ import division, IDLE must be started with options. How to embed these options in the IDLE.app bundle?