In 2021 Java celebrates its 25th anniversary. As part of this anniversary Oracle offered to register for the Java SE 11 Developer exam for only 25 dollars (22 euros). This is an interesting offer, because normally this will set you back ten times as much. So I decided to go for it and to give it a shot. This offer was valid for two months, so there was a deadline to keep me focussed on my goal. In this blog I will give you some tips to pass this exam.

Before I get to this a little bit more background on myself. I did the Java 8 OCA exam in 2017 (so four years ago). Please note that this was the OCA version. The OCA version is a lot simpler than the OCP version. It will test you on far less topics. The Java SE 11 Developer is comparable to the former OCP versions.

Because of my previous experience I already knew about the kind of questions you can expect. The questions are, to put it mildly, misleading. The exam tries to trip you up with really obscure notations and almost correct options. To give an example, does the following line compile?

public static void main (String []args) {}

All Java developers recognise this as the main entrypoint of a Java program. Most developers will frown their brows on the part between the parentheses. Normally we see one of the following:

I had never seen String []args before, but apparently it is allowed, so it does compile. Most questions contain several of these “interesting” cases.

So to pass this (or any other Java exams) you have to become a human compiler. You need to know if code will compile or not. Half of the questions have an option that says the code will not compile. 

The first question is: Where should I start? 

Tip 1 - OCP Java SE 11 Developer Complete Study Guide

I used and recommend the Oracle Certified Professional Java SE 11 Developer Complete Study Guide from Jeanne Boyarsky and Scott Selikoff. This book has around 1300 (!) pages, but it has all the information that you need. It has the depth that you need to become the aforementioned human compiler. Furthermore it is also brimming with questions to test your knowledge and sharpen your skills. 

This book also comes with an online test environment in which you can customize the kind of exam you like to do. For instance you can specify that you only want questions about exceptions or security. You can also create an exam with only x questions or one that only contains questions that you incorrectly answered in the past. A great tool to prepare effectively. 

Tip 2 - Do not underestimate the difficulty of this exam.

The exam was much more difficult than I expected when I started this adventure. It took far more time and effort than I had planned to commit to this. In the intro of this blog I mentioned passing for the OCA 8 exam. I had to study quite a lot for this exam, but leading up to the exam I was pretty confident that I would pass. For this exam I studied thrice as hard and I could not predict the outcome. So in the end I put in about 120 hours to fail at my first attempt. 😞

Tip 3 - Practice a lot (and then even more)

After spending sixty hours on studying I took my first mock exam and I failed gloriously. I only answered 40 percent of the questions correctly. The exam asks really in depth stuff, so for me just studying was not enough. I had to practice and practice to familiarize myself with all the nooks and crannies of the Java language. So I spend another sixty hours doing as many practice questions and mock exams as humanly possible. I had to do the exam twice and I barely passed it the second time. 

Tip 4 - Look at the answers before reading the rest of question

All previous tips are about preparing for the exam. The last tip will be about the exam itself. It consists of 50 questions and you have to answer them in 90 minutes. That is 108 seconds per question. That is a scary little amount of time when you have to parse 15 lines of code. Normally you start with checking if the code compiles. So you start looking for compile errors. Once you have done that you try to understand what the code does. The code will not be straight forward. There will be strange constructs in there. There will be things that do not make sense in the real world. Finally you have to find the correct answer. This is a pretty tall order to complete in 108 seconds. Actually I was not able to do it consistently. So I had to change my approach. 

I started looking at the answers before I read the question and this really sped me up. Maybe there is no answer option that says that it does not compile. So you do not have to check for compile errors. Maybe there is an answer option that says it will give a compile error at a given line. Now you can check this line for obvious errors. These are only two examples, but you can get a lot of information from the possible answers. So use this information to your advantage to get the correct answer faster. 

Thank you for reading this blog and good luck passing the exam!

The Java SE 11 Developer exam is a tough cookie. Read our 4 essential tips to help you pass the exam.

4 Tips to pass the Java SE 11 Developer exam

We schrijven allemaal wel eens code die op een later moment een punt van frustratie wordt voor onszelf, of onze collega’s. Soms copy-paste je een stuk code (dupliceren) en komt het er niet van om dit op te schonen. Of je maakt een ontwerp beslissing die in eerste instantie goed lijkt, maar waarvan later blijkt dat het een tijdrovende fout is geweest. 

In deze blog zal ik twee grote frustratiepunten beschrijven, met de focus op Java, wanneer je code probeert te veranderen: dupliceren (copy-pasten) en het onnodig koppelen (coupling) ten gevolge van overerving (inheritance). 

Het kan erg frustrerend zijn wanneer je denkt klaar te zijn met het aanbrengen van een verandering, om er dan achter te komen dat je dezelfde verandering op een tiental andere plekken in je code moet herhalen, voordat het goed zal werken. 

Tijdens het ontwerpen van een systeem, zou je altijd het DRY principe moeten volgen: Elk stukje kennis moet een enkele, eenduidige, belangrijke vertegenwoordiging hebben binnen een systeem. Echter, betekent dit niet dat elke identieke regel tekst of code een duplicaat is. Het kan ook gewoon zo zijn dat de implementatie identiek is. 

DRY gaat over het dupliceren van kennis, die onder andere voorkomt in:

Vaak vergeet men dat documentatie ook geüpdatet moet worden, samen met de veranderingen die je maakt aan je codebase. Het enige wat erger is dan geen documentatie, is verkeerde of verouderde documentatie. Verouderde documentatie kan misleidend zijn en kan je een hoop extra werk kosten. 

Commentaar, of ‘comments’, is slechts een andere vorm van duplicatie. Functies en variabelen met duidelijke namen hebben geen comments nodig. Comments binnen methodes zijn een teken dat de methode te lang is. Deze zouden opgedeeld moeten worden in aparte methodes, met duidelijk beschrijvende namen.

Developers die niet weten wat hun teamgenoten aan het bouwen zijn, lopen het risico om vergelijkbare code te schrijven. Hierdoor dupliceren ze onbewust functionaliteit die al bestaat. Dit kan alleen worden verminderd door betere communicatie. Actieve en frequente communicatie tijdens de dagelijkse stand-ups, forums, etc. Het is dan ook verstandig om de source code en documentatie van anderen te lezen tijdens code reviews of informeel. 

En dan nu: duplicatie in code. Het is het beste om klein te beginnen met het verwijderen hiervan. Allereerst lokaliseer en verwijder je kleinere stukjes gedupliceerde code in aparte methodes. Hierdoor wordt het makkelijker om daarna de grotere stukken van gedupliceerde code te lokaliseren en verwijderen. Vergeet niet om test units te draaien na elke grote verandering, zodat je niet elke keer te veel werk moet terugdraaien. 

Verplaats gedupliceerde code van verschillende klassen, naar zijn eigen klasse.  Na het verwijderen, moet de nieuwe klasse gekoppeld worden aan de klasse die gebruikt wordt. In Java heb je twee opties:

• Optie 1:een 'has a'-relatie. De originele klassen kunnen een fractie van de nieuwe klasse krijgen als een private attribute. Dit wordt ook wel composition of delegation genoemd, omdat je functionaliteit delegeert aan componenten van een andere klasse.

• Optie 2: Een "is-a" -relatie. De originele klassen kunnen de nieuwe klasse uitbreiden.

Het belangrijkste om rekening mee te houden wanneer je een implementatieoptie kiest, is: Erfbelasting. Je moet nog een verandering maken en denkt dat je klaar bent. Maar helaas, je komt erachter dat je zojuist de code op een tiental andere plekken hebt gebroken, omdat meerdere klassen sterk met elkaar gekoppeld zijn.

Gelukkig zijn er een aantal goede methodes als het gaat om het verminderen van onnodige koppelingen. Eén daarvan is: Betaal geen erfbelasting. Inheritance/overerving is een vorm van koppeling en moet dus vermeden worden indien mogelijk. 

Waarschijnlijk is dit niet wat je geleerd hebt. Inheritance gebruiken voor gedragssamenstelling en polymorfisme is een gangbare praktijk die je in elk OOP-handboek aantreft. In de praktijk heeft het echter een aantal ernstige nadelen.

Allereerste: dit zul je je misschien niet realiseren, maar wanneer een klasse is overerft, ontstaat er koppeling tussen meerdere concrete classes. Een kind klasse is gekoppeld aan een ouder klasse, een "grootouder klasse" enzovoorts. Maar elk object dat dit kind klasse gebruikt, is ook gekoppeld aan al zijn voorouders. 

Ten tweede: in een beperkt domein is het logisch dat een auto een soort voertuig is. Maar zodra het domein waarin je werkt gecompliceerder en realistischer wordt, worden deze modellen complexer en bijna onmogelijk te vormen. Bijvoorbeeld: wat gebeurd er wanneer een auto ook een soort eigenvermogen, te verzekeren object, etc. is. In dit geval heeft de auto dus meerdere overervingen nodig. Dat is niet alleen onmogelijk in sommige talen, zoals Java, maar indien het wel mogelijk is, eindig je vaak met complexe modellen die je alleen maar hoofdpijn bezorgen. 

In plaats daarvan, kun je één van deze technieken gebruiken, zodat je nooit meer inheritance nodig hebt:

Interfaces: het implementeren van interfaces geeft je polymorfisme zonder inheritance. Deze objecten bevatten normaal gesproken geen implementatie en een klasse kan een oneindig aantal implementeren

Delegation: door het implementeren van ‘class instance’ als een attribute, kun je alle onnodige methodes van de klasse die je niet gebruikt verbergen. Hiermee verminder je grotendeels de complexiteit. Dit betekent echter wel dat je meer code zal moeten schrijven.

Mixins: het principe van een mixin is simpel. Je wil klassen en objecten kunnen uitbreiden met nieuwe functionaliteit, zonder inheritance te gebruiken. Stel dat je twee gerelateerde functies zou hebben, genaamd 'find(id)' en 'findAll()', en je wil dat meerdere klassen in staat zijn om deze functies te gebruiken. Je wil natuurlijk geen inheritance gebruiken, maar delegation voegt weer onnodige code toe. Als de taal waarin je programmeert over deze optie beschikt, zou het er ongeveer zo uitzien:

// in sudo code

mixin CommonFinders {
  def find(id){ … }
  def findAll(){ … }
}
class AccountRecord implements BasicRecord with   CommonFinders { … }

Dit is helaas niet beschikbaar in Java, maar sinds Java 8 kunnen we interfaces definiëren met (public) default methodes. Hierdoor kunnen we methodes toevoegen met implementaties aan interfaces. In Java 9 is de mogelijkheid toegevoegd om private methods in interfaces te gebruiken, wat het mogelijk maakt om schone default methods te hebben. In Java kunnen we een mixin die een interface gebruikt op de volgende manier nastreven:

// in Java 9+ code

public interface CommonFindersMixIn {
  default Record find(String id) { … }
    default Record findAll() { … }


// some private methods
// private void example () { … }
}

class AccountRecord implements   BasicRecord, CommonFindersMixin { .. }

Eén probleem blijft bestaan. Omdat private attributes nog steeds niet toegestaan zijn binnen interfaces, beperkt dit de opties die je hebt wanneer je complexe methodes schrijft. In dit geval zal je dus geen andere keuze hebben dan delegation te gebruiken en dus nog een beetje meer code te moeten schrijven. 

Duplicatie en inheritance zijn niets meer dan anti-patterns. Ze hebben voordelen op de korte termijn, maar bezorgen je uiteindelijk alleen maar problemen. Clean code is niet alleen beknopt en zonder duplicatie, maar het vergroot ook geen concrete classes tenzij dit absoluut noodzakelijk is. 

Referenties
David Thomas and Andrew Hunt (2020): The Pragmatic Programmer. 
Michael Feathers (2005): Working Effectively with Legacy Code.
Nicolo Pignatelli (2018): Inheritance Is Evil. Stop Using It. 

Dupliceer geen bestaande code en betaal geen erfbelasting

Het hebben van een native app die beschikbaar is in de Playstore (Android) en de App Store (iOS) was gevoelsmatig lange tijd een must. Ten tijde van mijn opdracht bij de Politie kwam het nieuws naar buiten dat zij stoppen met de Politie-app die je via de appstores kon downloaden.

Uit onderzoek van de Politie bleek dat de burgers en ondernemers de Politie-app te weinig gebruiken tegenover de hoeveelheid geld en energie wat het kost om de app te ontwikkelen en onderhouden. De Politie geeft aan verder te gaan op de responsive website en de andere omnichannel mogelijkheden zoals social media en chat.

Dat brengt mij bij het onderwerp of je als organisatie wel een native app moet willen en of je ook kan kijken naar alternatieven zoals een hybride of PWA (web) app. Ook als front-end consultant krijg ik regelmatig de vraag wat je nou het beste kan doen. Daarom probeer ik je in deze blog post mee te nemen in bepaalde gedachten, zodat het je op weg kan helpen om de juiste keuze te maken.

Stel je staat als organisatie op het punt om een bepaald product en/of dienst te ontwikkelen, dan kan jij jezelf een aantal vragen stellen die mogelijk relevant zijn:

Wat moeten gebruikers op hoofdlijnen kunnen doen?

Wat en met welke frequentie gaan de gebruikers ermee aan de slag?

Welke securityeisen stel ik aan mijn (native) app?

Welke performance ervaring wil ik de gebruikers geven?

Hoe (her)bruikbaar moet het zijn met andere (web)applicaties?

Wie moet het (kunnen) ontwikkelen en met welke snelheid?

Natuurlijk, dit zijn niet alle vragen die jij jezelf kunt stellen. Het geeft je echter wel handvaten om na te denken zodat je weet welke keuze je kan maken. Deze vragen kan je meten door te weten wat het verschil is tussen een native, hybride of PWA app. 

Het verschil tussen native, hybride en PWA (web) apps

Native App
Een native app ontwikkel je voor 1 specifiek platform zoals iOS of Android, welke je beschikbaar maakt voor de specifieke appstore. Je kunt gebruik maken van alle native functionaliteiten die het mobiele apparaat heeft, zoals bijvoorbeeld het op de achtergrond kunnen gebruiken van de locatiegegevens of het sturen van push notificaties. Je hebt de mogelijkheid om de beste performance te bereiken en kunt de beste design en flow experience toepassen. Daar tegenover staan de ontwikkelkosten versus het aanbod in de markt. 

Hybride app
Een hybride app is nog steeds een app die je uiteindelijk beschikbaar maakt voor de specifieke appstores. Doordat je ontwikkelt in een bepaald soort schil heb je de mogelijkheid om te bepalen of je dit doet voor iOS, Android of voor beiden. Deze schil, wat een framework is zoals bijvoorbeeld React Native, Native Script of Ionic, geeft je toegang tot een beperkt aantal mogelijkheden van het mobiele apparaat. Voorbeeld hiervan zijn de NFC-chip of het werken met offlinedata. Je bent in staat om direct voor verschillende platformen te ontwikkelen en minimale verschillen door te voeren. Uiteindelijk kan je minder bereiken dan een native app, maar wat betreft ontwikkelkosten en de techniek gebaseerde frameworks kan het voordeliger en efficiënter zijn. 

PWA (web) app
Een Progressive Web App is een applicatie die je volledig kan ontwikkelen met webtechnieken zoals HTML, CSS en Javascript. De PWA is vanuit de browser benaderbaar en te installeren. Je kunt met een PWA beperkt gebruik maken van functionaliteiten zoals de camera, offlinedata of push notificaties. Het geeft je de indruk dat je een native app aan gebruiken bent. Naast de beperkte functionaliteiten kan het ook nog eens verschillen hoe deze te gebruiken zijn per platform. Kort gezegd kan je met minimale effort een webapp ontwikkelen.

Welke techniek kies je voor je app en in welke case?

Terug naar waar ik deze blog mee begon. De Politie-app verdwijnt uit de appstores met de hierboven genoemde redenen. Naar mijn inzien klinkt dat logisch als je deze meet aan de eerdere relevante vragen en de verschillen tussen een native, hybride en web apps. Of je dan direct helemaal geen app meer hoeft te hebben, dat betwijfel ik. Zeker voor de Politie lijkt het mij dat je ook de mogelijkheid moet hebben tot het hebben van een hybride app of PWA (web) app. Met als reden dat je een groot maatschappelijk belang hebt, maar niet de volledige native ervaring nodig hebt voor de dienstverlening.

Ter afsluiting van dit blog richt ik mij op twee cases die ik wil koppelen aan een technische keuzes.

Case 1 - Tijdens een festival wil je de timetable kunnen inzien. Daarnaast wil je de bezoekers bij een bepaalde locatie een badge laten verdienen voor een gratis drankje. 

In dit voorbeeld weet ik wat gebruikers moeten kunnen doen. Hieruit maak ik op dat het beperkte doelgroep is, maar wel een brede doelgroep. Om iedereen de mogelijkheid te geven wil je voor beide platformen (iOS en Android) iets hebben staan. Je wilt wel een zo goed mogelijke performance bereiken. Daarnaast wil je gebruik maken van de locatiegegevens en offlinedata. In dit geval zou ik een hybride app als eerste willen onderzoeken.

Case 2 – Als kleine organisatie zie ik dat gebruikers regelmatig maken gebruik van een mijn omgeving en ik wil deze permanent en makkelijk beschikbaar maken.

In dit voorbeeld zie je duidelijk terugkomen dat het om een kleine organisatie gaat en dat er al een mijn omgeving is. Het zijn minimale requirements, namelijk het makkelijker en permanent beschikbaar maken. Daarom zou ik als eerste stap nemen om te kijken hoe je dit kan hergebruiken zodat je tot een webapplicatie kan komen. De simpelste manier in deze lijkt een PWA (web) app. 

Het bepalen van welke keuze je moet maken hangt af van je doelgroep, de frequentie, de requirements en de kosten. Wil je hierover een keer brainstormen, dan kan je daarover altijd contact met mij opnemen via jeroen.burgers@cinqict.nl of via mijn Linkedin-profiel.

Weet jij welke keuze je moet maken als het gaat om een native, hybride of PWA (web) app? Lees snel ons blog.

Wanneer kies je voor een native, hybride of PWA (web) app?

De afgelopen jaren heb ik in meerdere scrum teams aan verschillende projecten gewerkt. Het leek me hoog tijd om mijn kennis van het Scrum framework te bevestigen, daarom ben ik een onderzoek begonnen naar welke certificeringen er allemaal bestaan en hoe je je het beste hiervoor kunt voorbereiden. 

De eerste certificering die ik tegen kwam, was de Professional Scrum Master I (PSM I), aangeboden door de Scrum.org organisatie. Scrum.org is opgericht door Ken Schwaber, niemand minder dan de co-creator van Scrum zelf. Een goede plek om te beginnen. Scrum Alliance is een andere bekende organisatie die professionals de mogelijkheid bied om zich te certificeren. Welke je kiest is natuurlijk aan jou, maar ik koos ervoor om dit avontuur aan te gaan via de Scrum.org certificering. 

Maar is dit niet een blog over hoe je je PSD I examen kunt halen, in plaats van de PSM I? Je hebt natuurlijk helemaal gelijk. Hier alvast mijn eerste tip voor het halen van je PSD: haal eerst je PSM I. 

Voordat ik de PSD haalde, heb ik eerst het PSM I examen gedaan. Als je de twee examens vergelijkt, zijn bijna tweederde van de vragen die worden gevraagd tijdens het PSD examen, zo overgenomen uit het PSM I examen. Dus, als je de PSM I hebt behaald, heb je het grootste gedeelte van de kennis al verkregen die je nodig hebt voor je PSD examen.

Hoe behaal je de Professional Scrum Master I certificering? 

Tijdens het studeren voor het PSM I examen gebruikte ik de volgende bronnen:

The Scrum Guide:  Dit document is het hart van Scrum. Als je dit document volledig begrijpt, zul je het examen halen - en nog belangrijker - zul je Scrum begrijpen. Ik adviseer dit document te downloaden en het een paar keer goed door te lezen. Dan laat je het een week met rust en lees je het opnieuw. 

Deze gids bevat een aantal uit je hoofd te leren definities. Zorg ervoor dat je deze definities goed onthoudt, of in ieder geval weet waar je deze informatie snel kan vinden wanneer je de test aan het maken bent. De eerste 75% van je examencijfer zal namelijk bestaan uit (relatief makkelijke) vragen m.b.t. de verschillende definities die beschreven worden in de gids.

De laatste 25% van de vragen zal te maken hebben met de gedachte achter Scrum. Je zal een aantal scenario vragen krijgen en je zal moeten bepalen welke van de antwoorden het beste past binnen het Scrum framework. Dit zijn de lastige vragen. Maar, geen zorgen. Er zijn goede bronnen te vinden die je hierbij kunnen helpen. 

Open Assesments: Er zijn oefenexamens (open assessments) beschikbaar voor elke entry-level certificering. Dit zijn gratis oefenexamens waarbij je vragen krijgt die lijken op de vragen uit het daadwerkelijke examen. Het fijne hiervan is dat je deze onbeperkt overnieuw kunt doen. Elke keer dat je een oefenexamen begint, krijg je 30 willekeurige vragen uit een grotere verzameling. Elke keer is het oefenexamen dus anders. 

Als je een bepaald oefenexamen meerdere malen hebt gedaan, zal je de vragen gaan herkennen. Mijn ervaring is dat het echte examen meerdere vragen zal bevatten die je ook al bent tegengekomen tijdens het oefenexamen. Sommige vragen zullen net iets anders zijn, maar er wel veel op lijken. 

Dus als je consequent 100% kunt scoren op je oefenexamen, weet je dat je klaar bent voor het échte examen.

Online cursus: Als je daar behoefte aan hebt, kun je ook een online cursus volgen. Ikzelf heb de cursus 'Scrum Certification Prep + Scrum Master + Agile Scrum Training' door Paul Ashun gevolgd via Udemy. Zou je het examen kunnen halen na alleen deze cursus te hebben gevolgd? Nee, dat denk ik niet. Maar het heeft mij in ieder geval wel geholpen bij het maken van de oefenexamens. 

Third-party oefenexamens: De beste manier om te oefenen voor een examen, is dus om te oefenen met een oefenexamen. Nadat je alle vragen van de open assessments uit je hoofd kent, is er nog een plek waar je je hart kunt ophalen met oefeningen.

Mikhail Lapshin is een developer die zo aardig is geweest om een online quiz tool met veel oefenvragen te maken, zodat je kunt oefenen voor het Scrum examen. Dit is een geweldige plek om te oefenen en ik heb er veel baat bij gehad. 

Hoe moet je je voorbereiden voor het Professional Scrum Developer examen?

Je hebt hard geleerd en hebt je PSM I examen behaald. Gefeliciteerd! Nu ben je klaar voor de volgende stap. Als je het leuk vond om te leren voor je PSM examen, raad ik je aan om zo snel mogelijk te starten met de voorbereidingen voor je PSD examen. 

Allereerst, wanneer je net bent afgestudeerd van een Informatica (of gerelateerde) opleiding, dan zal je je het PSD examen waarschijnlijk meteen kunnen halen na het voltooien van je PSM. Dan zou ik je in ieder geval adviseren om een paar keer te oefenen met de Open Assessments, zodat je je écht zeker voelt om je PSD te gaan halen. 

Als je echter een meer praktische en minder theoretische programmeer achtergrond hebt, of als je benieuwd bent welke theorieën een centrale rol gespeeld hebben bij het creëren van het Scrum framework, dan zou ik je zeker adviseren om de volgende drie boeken te lezen:

Clean Code. A Handbook of Agile Software Craftsmanship - door Robert C. Martin

The Pragmatic Programmer. Your journey to mastery - door David Thomas & Andrew Hunt

Working Effectively with Legacy Code - door Michael C. Feathers

Als laatste zou je de Agile Alliance website eens moeten bezoeken. Hier kun je de Agile Glossary vinden, waarin 75 van de must know termen en definities worden beschreven voor Agile developers. Dit is een geweldige bron om na te gaan of je de theoretische achtergrond al hebt, die je nodig zult hebben voor het examen. Ook is deze tool handig om even snel iets op te zoeken, als je bepaalde termen wil dubbelchecken tijdens het examen.

In dit blog van software engineer Ian van Nieuwkoop, kun je lezen hoe je je het beste kunt voorbereiden op het Professional Scrum Developer I examen.

Tips om je Professional Scrum Developer I (PSD I) certificering te halen

We all write code which ends up frustrating us or our colleges sooner or later. Sometimes you copy-paste some code and don’t get around to tidying it up or you make a design decision which seems like a good idea at the time, but later turns out to be a time-consuming mistake. 

In this blog I’m going to describe two sources of frustration, with the focus on Java, when trying to change code: duplication and unnecessary coupling caused by inheritance. 

It can be very frustrating when you need to make a change and you think: “I am finished", only to find out that you need to make the same change in a dozen other places. 

When designing a system, you should always follow what is called the DRY (Don’t repeat yourself) principle: Every piece of knowledge must have a single, unambiguous, authoritative representation within a system. 

However, this doesn’t mean every identical line of text or code is duplication. It could just be the case that the implementation happens to be identical.   

DRY is about the duplication of knowledge; it is found in:

It’s easy to forget that documentation also needs to be updated, along with the changes you make to your codebase. The only thing worse than no documentation is wrong documentation. Out-of-date documentation is very misleading and can cost you a lot of unnecessary time. 

Comments are just another form of duplication. Functions and variables with clear names do not need comments.  Comments inside of methods are a sign the method is too large and should be split into private methods, with descriptive names. 

Developers who don’t know what their colleges are building are likely to write similar code. They end up duplicating functionality which already exists.

This can only be reduced by better communication. Active and frequent communication during the daily standup, forums etc. You should read other people’s source code and documentation, either informally or during code reviews.

Finally, duplication in code. It’s best to start small. First, by locating and extracting the smaller pieces into separate methods. Then you can more easily start locating and removing the larger pieces of duplicate code. Remembering, of course, to run unit tests after each significant change, to prevent having to roll back too many changes.

Move duplication across multiple classes, to its very own class. After extraction this new class needs to be coupled to the classes using it. In Java you basically have two options:

Option 1: A “has-a” relationship. The original classes can be given an instance of the new class as a private attribute. This is also called composition or delegation, because you delegate functionality to components of a class. 

Option 2: A “is-a" relationship. The original classes can extend the new class. 

When choosing the option to implement, the most important thing to take into consideration is: Inheritance Tax. 

You need to make another change, and again you think you’re done. However, you find out you just broke the code in a dozen other places. 

Fortunately, there are several best practices when it comes to reducing unnecessary coupling. One of which is:  Don’t pay Inheritance Tax. Inheritance is a form of coupling and therefore must be avoided if unnecessary and most the time, this is the case.

Paradoxically, this is not what you have probable been taught. Using inheritance for behavioral composition and polymorphism is a common practice you find in every OOP textbook. However, in practice it has some serious disadvantages.

Firstly, you might not directly realize this, but when a class is extended it creates coupling between multiple concrete classes. Not only is a child class coupled to a parent, the parent’s parent, and so on. But also, any object which uses this child is now not only coupled to this child, but also to all the ancestors.  

Secondly, in a limited domain, it makes sense that a Car is a kind of Vehicle. However, as soon as the domain you are working in becomes more complicated and closer to reality, these models become more complex and nearly impossible to model. For example, what happens when a Car is also a kind of Asset, InsuredItem, and so on. This needs multiple inheritance, not only isn’t that possible in some programming languages, like Java, but when available you end up with complex models that end up just causing you a headache.

Instead use one of these techniques, so that you never need to use inheritance again:

Interfaces. Implementing Interfaces give us polymorphism without inheritance. These declarations don’t normally create any code and a class can implement an unlimited number. 

Delegation. By implementing a class instance as an attribute, you can hide all the unnecessary methods of the class you aren’t using. Significantly reducing its complexity. However, this comes at the cost of writing more code.

Mixins. The basic idea of a mixin is simple: you want to be able to extend classes and objects with new functionality without using inheritance. Say you have two related functions called ‘find(id)' and ‘findAll()' and you want multiple classes to be able to use these functions. But you don’t want to use inheritance and delegation adds unnecessary code. If the language you are programming in has this feature built in, it would look something like this:

// in sudo code

mixin CommonFinders {

  def find(id){ … }

  def findAll(){ … }

}

 
class AccountRecord implements BasicRecord with   CommonFinders { … }

This isn’t available in Java. However, since Java 8 we can define Interfaces with (public) default methods. This allows us to add methods with implementations to interfaces. Java 9 added the ability to use private methods in interfaces, enabling us to have nice clean default methods. In Java we could emulate a mixin using an interface as followed:

// in Java 9+ code

public interface CommonFindersMixIn {

  default Record find(String id) { … }

    default Record findAll() { … }

 

// some private methods

// private void example () { … }

}

class AccountRecord implements   BasicRecord, CommonFindersMixin { .. }
 

One problem remains. Because private attributes are still not allowed in interfaces, this limits your options when writing complex methods. In this case you will have no choice but to use delegation and be forced to write a bit more code.

Duplication and inheritance are nothing more than anti-patterns. Practices which only have short-term advantages, but eventually end up causing more harm than good. Clean code is not only concise and void of duplication, but it also definitely doesn’t extend concrete classes unless absolutely necessary. 

References
David Thomas and Andrew Hunt (2020): The Pragmatic Programmer. 
Michael Feathers (2005): Working Effectively with Legacy Code.
Nicolo Pignatelli (2018): Inheritance Is Evil. Stop Using It. 

Don't Repeat Yourself and Don’t Pay Inheritance Tax

Why reinvent the wheel, when you can save yourself some time by using some vendor library, open source or even libraries that come bundled with the platform you are using? 

Using existing libraries is often easier and quicker. However, if you are not careful you can end up in a mess with code which is:  

Difficult to change. Leveraging third-party APIs leaves you with code which often looks like it is nothing but repeated calls to someone else’s library. Frequently resulting in your code being tightly knotted with the library’s.  

Difficult to test. Use of someone else’s code lulls you into a false sense of security. You end up thinking that you don’t need tests. After all, we aren’t doing anything significant, just calling some methods here and there. And before you know, the code has continued to grow and you are now left with something that isn’t simple anymore. It’s a patchwork of untestable code that no one wants to touch.

Help your future self and colleges and start wrapping third-party APIs.

“Wrapping third-party APIs is a best practice.” — Robert C. Martin

When you wrap a third-party API, you minimize your dependencies upon it. You are able to more easily move to a different library or mock out third-party calls when you are testing your own code.

You are not tied to a particular vendor’s API design choices. You can define an API that you feel comfortable with. 

Systems littered with library calls are harder to deal with than homegrown systems. First, it's hard to see how to improve the structure, because all you see are API calls. Most things that can give you a hint at a design is hidden in an external library. Secondly, you don’t own the API. You can’t rename anything to make them clearer. You can’t hide or add extra methods. 

Uncle Bob goes as far as advising you to wrap internal platform classes, like the Java Collection Map class. This may be a little much in most cases. 

So, you are refactoring code not implementing wrappers, how do you do this safely? Michael Feathers, in his book ‘Working Effectively with Legacy Code’, describes two methods:

Skin and Wrap. When refactoring existing code, this is the safest method to use.   

You start by making an interface which mirrors the existing API as closely as possible. Most IDEs come with build-in options for extracting interfaces from classes. 

You can now choose to preserve the signatures of the original API. First, you create wrappers for each one of the external library classes used in your code. These wrappers can delegate to the real API in production and point to mock objects when testing. (Code Snippet 1 & 2.) 

You may recognise this as the Decorator-pattern. If the third-party class contains too many methods, which you simply don’t need, you can skip creating the interface. Just wrap by passing the library class as a parameter to the constructor of your wrapper. (Code Snippet 3.)

After swapping out the third-party class for your own, you are left with code which is more loosely coupled and easier to test (using mock objects). 

 //   Example class to be wrapped 
class API{
    public void doSomething(){ /*implementation*/ }
  // … more methods 
}

//Wrapping using the Decorator Pattern
interface API {
  void   doSomething();

}

//Example wrapped class
class CustomAPI extends API{
    private API api;

    public CustomAPI(API api){
     this.api = api; 
    }  

    public void doSomething(){
    //add new functionality here
      this.api.doSomething();  
    //or here without breaking   previous code 
  }
  //other methods
} 

//Example wrapped class, but not so decorator-ish
class CustomAPI{
    private API api;

    public CustomAPI(API api){
     this.api = api; 
    }  
    public void doSomething(){
    //add new functionality here
      this.api.doSomething();  
    //or here without breaking   previous code 
  }
  //other methods
}

Responsibility-Based. However, when working with complex APIs with multiple classes containing dozens of methods it soon becomes unmanageable. 

Basically, you start designing your own API based on the functions you are using. And then wrap your new methods nicely in classes based on their responsibilities. Most likely, you will combine multiple third-party classes, or use the same third-party class in multiple custom classes. 

Of course, when you wrap a class, your new methods should only return standard Java classes or your own custom classes.

When moving code around, you want to separate the external libraries API from your custom logic. This is because you don’t want to test the third-party library. It has already been tried and tested. Also, you want your business logic to be library agnostic. Any major future changes to the third-party library, should at most only affect your custom API classes. 

By slowly extracting larger pieces of code into smaller methods, it makes the code easier to understand. When you locate custom logic, extract it to a new utility class. As soon as you feel like you have finished grouping functions together, you can more easily refactor and rename your utility classes to better reflect their functionality.

/*
*Example of custom designed Interfaces. They only accept standard or your own designed *parameters.

*/
public interface ContentEngine {
 CETask getTaskObject(String id);
 // etc.
} 

public interface CETask {
  //getters
  String getAttribute();
  //setters
  void setAttribute(String value);
  //more complex commands
  void doSomethingNeat();
  //etc
}

/*
*In this example Domain, ObjectStore, Factory and Connection belong to 
*a third-party library.
/* 
public class ContentEngineImp implements ContentEngine { 
    private ObjectStore objectstore;
     
    public ContentEngine(Connection connection, String defaultObjectStoreName) {
        Domain domain = Factory.Domain.getInstance(connection, null);
        this.objectstore = 
          Factory.ObjectStore.getInstance(domain, defaultObjectStoreName);
    }
    
    public CETask getTaskObject(String id){
      Task task = Factory.Query.findObject(this.objectStore, id);
      return new CETask(task);
    }

  // … more custom API methods
}

/*
*Task is a third-party Class.
*/
public class CETaskImp implements CETask {
  private String attribute;
 
  public CETaskImp(Task task){
    this.attribute = this.parse(task.getSomething());
  }
  
  protected String getAttributeImp(String attribute){
    return doSomethingWith(attribute);
   }    
  
  public String getAttribute(){
    return getAttributeImp(this.attribute); 
   }
  
  // … more custom API methods
}

Wrapping third-party libraries is definitely a good practice to follow. It may cost you some extra time, but in the long run you are left with a system which is easier and faster to change.

References
Robert Martin (2009). Clean Code. A Handbook of Agile Software Craftmanship.
David Thomas and Andrew Hunt (2020). The Pragmatic Programmer. 
Michael Feathers (2005). Working Effectively with Legacy Code. 

Working with third-party libraries and what to do when you find yourself in a mess

During the past few years, I have worked in several scrum teams on different projects. Thinking the time was right to validate my knowledge of the Scrum framework, I set about researching what certifications were available and how you need to prepare. 

The first certification I came across was the Professional Scrum Master I (PSM I) which is made available by the Scrum.org organization.  Scrum.org was founded by Ken Schwaber, no one less than a co-creator of Scrum. A good place to start. Scrum Alliance is another well-known organization which offers professionals a way of getting certified. Which one you choose is up to you, but I chose the Scrum.org certification route.

But isn’t this blog about passing the Professional Scrum Developer (PSD I) exam, not the PSM? Yes, you are correct. However, my first tip for passing the PSD is: first pass the PSM I. 

Before I took the PSD, I studied and passed the PSM I exam. When comparing the two exams nearly two-thirds of the questions asked during the PSD are copy-pasted from the PSM I.  So, if you have already comfortably passed the PSM I, you have already mastered the majority of the knowledge needed to pass. 

So how do you pass the Professional Scrum Master I Certification? 

When studying for the PSM I exam I used the following resources:

The Scrum Guide.  This document is the heart of Scrum. If you fully understand this document you will pass the exam, and more importantly you will understand Scrum. I recommend downloading this and reading it a few times. Then put it away for a week, and then read it again. 

The guide contains a few learn by heart definitions. Make sure you memorize these definitions, or at least know where you can find this information quickly when taking the test. The first 75% of your exam grade will be made up of relatively simple questions related to the different definitions defined in the guide. 

The final 25% of the questions will be related to the ‘spirit’ of Scrum.  You will be given several scenario questions and you will have to determine which answer best fits within the Scrum framework. These are the hard questions. But don’t worry there are ample resources out there to help you.

Open Assessments. There is an open assessment (practice exam) for every entry-level certification. These are free of charge practice exams; whose questions closely mirror the real exam. The great thing is, that you can take them an unlimited number of times. Every time you start an assessment you will get 30 randomly selected questions from a larger pool. 

After completing the assessment a few times, you will start recognizing questions.  From experience I can tell you that the real exam will have several questions directly taken from this pool, and some more which are really only slightly different. 

So, if you can consistently score 100% when taking the open assessments, you will be ready to take the exam.

Online courses. If you want, you can also follow an online course. Myself, I followed the ‘Scrum Certification Prep + Scrum Master + Agile Scrum Training' by Paul Ashun, course via Udemy.  Would I be able to pass the exam after solely following this course? No, I don’t think so. But it did help me when doing the Open Assessments. 

Third-party Practice Exams. The best way to practice for an exam is to practice with mock exams. After, you know all the Open Assessment question by heart, there is one more place where you can find plenty of mock exam questions: https://mlapshin.com/index.php/scrum-quizzes/.

Mikhail Lapshin is a developer who has been so kind enough to have created an online quiz tool and repository for practicing for a Scrum exam. This is a great place to practice and it helped me a lot.

How to prepare for the Professional Scrum Developer Exam?

So now you have studied for the PSM I and you have passed. Congratulations! Now you are ready for the next few steps. If you enjoyed studying for the PSM, then I will recommend quickly continuing with the preparations for the PSD. 

Firstly, if you are fresh out of college and you majored in Software Engineering, most likely you will be able to pass the PSD straight after completing the PSM I. At most, I would recommend you practicing with the PSD Open Assessment questions, and after you feel confident go for it.

However, if you have a more practical and less theoretical programming background, or you are curious what kind of theoretical works are at the heart of the Scrum framework, then I can highly recommend the following three books:

Clean Code. A Handbook of Agile Software Craftsmanship by Robert C. Martin.

The Pragmatic Programmer. your journey to mastery by David Thomas and Andrew Hunt.

Working Effectively with Legacy Code by Michael C. Feathers.

Finally, you should visit the Agile Alliance website. On their website you can find the Agile Glossary.  Here you will find the 75 must know terms and their definitions for Agile developers. This is a great resource for checking if you already have the theoretical background for the exam, or to use as a quick lookup, if you need to double-check certain terminology used during the exam.

After following these steps, you shouldn’t have any difficulty passing your Professional Scrum Developer Exam. Good luck!

In this blog by software engineer Ian van Nieuwkoop, you will read how to prepare yourself for the Professional Scrum Developer I certification exam.

Tips for passing your Professional Scrum Developer I (PSD I) Certification

In de wondere wereld van frontend technieken zijn er nog zoveel dingen om nader te onderzoeken. In afwachting van mijn screening voor de opdracht bij de Politie besloot ik om een nieuwe website te maken voor CINQ. En nu – medio oktober – staat deze eindelijk live. In dit blog deel ik graag mijn ervaring over – met name – Next.js. Dat is namelijk precies waar je nu naar kijkt.

Na het zien van de eerste proof of concept raakte collega Marc Jacobs geïnteresseerd in mijn positieve wil. Samen besloten wij te brainstormen om tot een plan van aanpak te komen om toe te werken naar wat voor ons een succesvolle website zou zijn. 

Woorden als specialisten in Data, DevOps en Development vormen de basis voor ons verhaal, gevolgd door sociale IT’ers. Tijdens het ontwerpen en ontwikkelen van de website stond verschillende kenmerken constant centraal: de unit’s, events, vacatures en blogs. Ons doel was duidelijk.

Voor ik deze vraag ga beantwoorden is het interessant om te weten wat Next.js is. Zij omschrijven zichzelf als een React Framework voor Productie waarmee je met simpele handelingen een applicatie van A tot Z kan ontwikkelen en in productie kan zetten. Je krijgt hierbij toffe mogelijkheden, wat je kan zien als builts-in functionaliteiten, om een hybride en server side rendered applicatie te bouwen met minimale configuratie.

Dat klinkt als een kind kan de was doen, maar dan? Er waren redenen om de oude CINQ-website te vervangen, bijvoorbeeld dat deze niet makkelijk door onszelf was aan te passen, het op de mobiel beter kon werken en dat wij graag ons verhaal nog beter zouden willen vertellen. Wij hebben voldoende specialisten in huis om - ook voor onszelf - mooie dingen te ontwikkelen. Hoe mooi zou het dan zijn als wij zelf onze eigen website zouden ontwikkelen en onderhouden? Met deze voorkennis, natuurlijk ook in afweging van vele andere aspecten als bijvoorbeeld Next.js of NuxtJS, besloot ik om te kiezen voor Next.js in combinatie met Prismic CMS.

Toen ik eenmaal begon met het ontwikkelen van de website in Next.js was natuurlijk alles nieuw voor mij. Waar begin je dan? Gelukkig heeft Next.js een duidelijke documentatie. Om een snelle start te maken heb ik ervoor gekozen om te beginnen met een ‘bootstrap’ van Next.js via commando: 

Door de afgelopen jaren heen ben ik gewend om al in componenten te denken, omdat je dit bij alle frameworks wel op een bepaalde manier gebruikt. Waar je normaal vanuit een router pagina of module iets doet, heb je dit bij Next.js onder een folder pages. Bij de bootstrap installatie krijg je de onderstaande folder structuur.

├── pages             # folder voor alle pagina's
│   ├── api           # folder voor alle serverless functies
│   _app.js           # overal document voor je applicatie
│   index.js          # index.js verwijst naar / van de applicatie
├── public            # folder voor alle assets
├── styles            # folder voor styles
│   global.css        # globale style (voor bv. body tag)
│   Home.module.css   # module style voor homepage

Bij het ontwikkelen van een Next.js applicatie zijn er twee belangrijke folders, dit zijn pages en pages/api. In de folder pages zet je alle pagina’s die de applicatie kent. Je kan dit zien als een soort van router structuur. In de folder pages/api zet je alle API endpoints die je als Node.js serverless functie kan gebruiken. In de praktijk voor de CINQ-website hebben wij daarom pagina’s als bijvoorbeeld: pages/index.js, pages/contact.js pages/[uid].js en pages/blog/[id].js Deze pagina’s verwijzen naar de homepage (/), de contact pagina (/contact), een willekeurige content pagina waar geen andere pagina voor is (/data) en een blog artikel (/blog/toffe-developer-ervaring). Voor wat betreft de serverless API endpoints moet je denken aan het ophalen van meer artikelen voor de blogpagina of het versturen van het contactformulier.

Als je eenmaal een pagina hebt aangemaakt in de pages directory, dan is de volgende stap om data op te halen en componenten te gaan ontwikkelen. Voor het ophalen van data en de manier van renderen heeft Next.js verschillende implementaties. Met getStaticProps() kan je ervoor zorgen dat een pagina bij het builden van de applicatie wordt gemaakt, dit heet dan static site generation. Deze wordt dan voor elk request gebruikt. Daarnaast heb je ook een server-side rendered variant, dit gebruik je door de methode getServerSideProps(). De laatstgenoemde is wel langzamer dan de static variant, want deze doet bij elk request het opnieuw opbouwen van de pagina. Voor ons geldt voor de meeste pagina’s het laatste.

Mijn collega Marc wilde graag de website zelf kunnen beheren. Prismic is een Headless CMS dat uitstekend te combineren is het met het gebruik van Next.js. Je kunt in Prismic een aantal content types definiëren, dit resulteerde bijvoorbeeld in types als een blogpagina, een content pagina, een medewerker, een review of een vacaturepagina. Deze types werden er zo op gericht dat je dacht vanuit het componenten niveau wat wij in de applicatie kennen.

Om je een voorbeeld te geven hebben wij in Prismic een content pagina type. Stel wij hebben de pagina over Development. Deze bestaat nu uit een intro header, een intro content, kernwaarden met logo’s, vacatures en blogs. In Prismic heb ik het zo ingericht dat je deze blokken kan invullen, wijzigen van volgorde of het juist aanvullen van informatie met een tag. Zo zie je bij de vacatures alleen de vacature voor development, evenals bij de blogs dat je alleen de blogs zie over development. Kijk je naar de homepage zie je weer alle vacatures en blogs.

Wellicht vraag jij af hoe ik vervolgens de koppeling heb gelegd tussen Next.js en Prismic. Vanuit de Next.js pagina heb ik in getServerSideProps() een functie geschreven die de data ophaalt vanuit Prismic. Dit doe ik aan de hand van het type pagina. Nadat ik deze informatie heb opgehaald, stuur ik deze properties als JSON terug naar de pagina. Vervolgens laat ik door een soort van beslisboom de juiste componenten in de juiste volgorde zien. Dit betekent ook dat ik dus herbruikbare componenten heb ontwikkeld. Zo zijn componenten als bijvoorbeeld de intro tekst - in de code noem ik dit hero content- gebruikt voor de content pagina’s, maar ook voor pagina’s zoals dit blog artikel.

Samenvattend kom je steeds terug bij de kernwaarden die wij onszelf eerder hebben gesteld. Zowel bij de pagina’s, als de componenten als de inrichting van het Prismic CMS zie je deze terug. Hierdoor hebben wij een dynamische website, voorzien van herbruikbare componenten en slim gebruik van het CMS. Bij lange na heb ik natuurlijk niet alle toepassingen en keuzes over Next.js, Prismic of zelfs het in productie nemen via Vercel in dit blog kunnen toelichten. Mocht je naar aanleiding van dit blog een deep dive willen, dan kan je daarover altijd contact met mij opnemen via jeroen.burgers@cinqict.nl of via mijn Linkedin-profiel. 

Hoe maak je een succesvolle website of applicatie met Next.js en Prismic? Lees onze ervaring.

De nieuwe CINQ website: Geslaagde combinatie van Next.js met Prismic CMS

In de afgelopen periode heeft zich een vrij nieuwe techniek zich aangediend genaamd WebAssembly. Wat kunnen wij ermee en wat zou het kunnen veranderen?

Verslaat WebAssembly het gewaardeerde JavaScript? Lees het blog op de CINQ website.

Onze laatste blogs over Development