17.5. Studio: Creating an AbstractEntity

In Exercises: OMG the ORM!, you created a new persistent class, EventCategory. We will eventually use this class to categorize events in our application. However, your application now has a fair amount of duplication across the two model classes. In this studio, you will reduce repetition (i.e. “DRY out your code”) using inheritance and abstract classes.

17.5.1. Getting Ready

In your coding-events repository, create a new branch from your exercises work. Call this branch abstract-entity-studio.

Note

On coding-events-demo, we have provided a branch called add-persistent-category to make sure you have good starter code for the studio, even if you didn’t complete the exercises.

17.5.2. Your Tasks

Let’s look at both the Event and EventCategory classes. There are four class members that are (essentially) the same in both classes:

  • The id field
  • The getId method
  • The equals method
  • The hashCode method

Note

If you have a super-sharp eye, you’ll notice that the two equals methods aren’t exactly the same. For example, the next-to-last line of this method in Event looks like this:

Event event = (Event) o;

while in EventCategory this line is slightly different;

EventCategory that = (EventCategory) o;

This minor difference will not matter in the long run, as we’ll see later.

Your objective in this studio is to reduce this repetition by creating a class that contains the duplicated/shared code, which both Event and EventCategory can inherit.

17.5.2.1. Create and Extend AbstractEntity

In the models package, create a new class named AbstractEntity. Add the abstract keyword to the class declaration. We do this because, while we want to share code across our two models, we’ll never need to create an instance of AbstractEntity. If you need a quick refresher, review our section on Inheriting from Abstraction.

Tip

This class name seems a little odd at first, but it makes sense after a brief explanation.

It is a commonly used convention in Java to prefix the name of an abstract class with Abstract, to make it obvious to other developers that they can’t create instances of the class.

Additionally, every entity class that we create will extend AbstractEntity. (Recall that an entity is a class/object that can be stored in a database.)

Finally, in the class declarations of both Event and EventCategory, extend AbstractEntity.

17.5.2.2. Move Duplicated Code Into the Superclass

Open up the Event class file. Move the 4 class members that we identified as being duplicated across both models up into AbstractEntity. Now your Event class will inherit these members rather than define them itself.

When you move the equals method up into AbstractEntity, you’ll see a compiler error on the last line (this is related to the note we made above). Let’s look at this method in detail.

22
23
24
25
26
27
28
@Override
public boolean equals(Object o) {
   if (this == o) return true;
   if (o == null || getClass() != o.getClass()) return false;
   Event event = (Event) o;
   return id == event.id;
}

The compiler error occurs on the last line, and the context menu in IntelliJ describes it for us:

'id' has private access in 'org.launchcode.codingevents.models.AbstractEntity'

What is this telling us? As written, event is an Event object, since it is the result of casting o to Event in the line above: Event event = (Event) o;. But when we reference event.id we are attempting to reference the private field id, which lives not in Event, but in AbstractEntity. This is not allowed.

This error is easy to fix; simply change the cast on the next-to-last line to convert o to an instance of AbstractEntity. And while we’re at it, let’s give the variable event a better name.

22
23
24
25
26
27
28
@Override
public boolean equals(Object o) {
   if (this == o) return true;
   if (o == null || getClass() != o.getClass()) return false;
   AbstractEntity entity = (AbstractEntity) o;
   return id == entity.id;
}

Note

The equals method works by checking the value of the identifier/primary key field id. If two objects have the same id, then they should be considered equal. Otherwise, they are not equal.

It may not be obvious that you can’t have an Event object and an EventCategory object with the same id. However, the way in which the database manages and assigns these values ensures that won’t happen.

Now in your EventCategory model, delete the four class members that are inherited from AbstractEntity. You should have NO compiler errors in your application at this point.

17.5.2.3. The @MappedSuperclass Annotation

One final step: Add the @MappedSuperclass to your AbstractEntity class.

This annotation will be discussed in more detail later. For now, you should understand that it ensures that the id values will still be stored in the event and event_category tables of the database, even though Event and EventCategory don’t have id fields in their class definition.

17.5.3. Making Sure It Works

Start up your application and make sure it all works! Be sure to add some new data and make sure you see it in the appropriate table(s).