DEV Community

Cover image for Introduction to Semantic Accessors
Pabrick
Pabrick

Posted on • Updated on

Introduction to Semantic Accessors

We all know how amazing is the code we write. How cool it is and how well is done.
But... It is?
The best way to know if your code is easy to understand AND use is give it someone with less experience.

I realise that the huge amount of time we don't code for others, we code for ourselves.
We write code, to make things easier to us, not to others.
Because we think if we understand it the others should.
But that is not the truth.

You can't handle the trush - Scene from 'A Feew good men'

At some point in the future we will have to be that person that have to use our own code and believe me, you will forget how that was done.


Abstraction

The first step is abstract the parts of you code that you don't want others see or mess around. Think of it as if you where creating tools and you leave available the parts you want the people use.
So using public and private will be helpful.
I know that frameworks as Angular, the variables and properties are public by default, but I strongly recommend mark them as public if that is your intention.
Because you won't believe how fast code can turn unmaintainable after a few people jump in to fix some last-minute-to-production bugs.

Set public and private have an INTENTION, and someone that see that all the properties are public and/or private will think twice before leave a new property undefined.

My advice is to try to use as much as private properties as you can. Some plugins on VSCode will tell you if a property is not being use if they are private, otherwise if they are public there is no way to know if other part of the app is using them unless you specifically track them down.

Image description


Getters and Setters

Back in the old times getters and setters where part of every object you created. This practice has been in decrease in certain areas like front-end because you will have to duplicated and add extra variables for something that it will be easier if we simply set them as public. So I prefer only use setters and getters when the semantic helps.

Image description


Let's get SEMANTICS

Rick and Morty dancing

I realise that testing tools are super semantic when they come to use expressions as close as we talk. So I thought, maybe we can do the same thing on regular code.
I wanted to use the help of autocomplete tool from the IDEs, so that way we won't have to remember of enter into some code to check what is available.

So the idea is wrap the properties we want to have available in a public object named GET.

Image description

I liked so much this idea that I create another object for the flags. Wrapped in an IS object.

Image description

The last think I have to do is create a last one for the main control of my service, so I did that.

Image description


The Grand Finale

You maybe think all these are extra steps, that duplicates code, but believe me when I say that all this is worth it. Of course we have to be careful not to add extra layer to the logic that makes everything repeated but you will see the advantages when you use these classes or services from outside.

With some help form the IDEs we won't have to remember what can be used and what is available for us:

Image description

Image description


Thanks to these techniques my whole team has increase their efficiency because they don't waste time trying to identify or remember the name of the methods or variables they need.

I hope you find this useful as well.

Image description

Top comments (2)

Collapse
 
zyabxwcd profile image
Akash

Nice trick there in the semantics section. I wish I could see some more examples of how we can structure a complex app in this way.

Collapse
 
pabrick profile image
Pabrick

Hehehe, that will come on the next article! 😉
Thanks for the comment.