Archive
I’m dropping Camel Case convention
I was watching a video about BDD and decided to try the technique with an exercise. What is happening is that I’m starting to question the Camel Case convention. After a couple of lines of code I have something like:
public void shouldHaveFirstTransitivePropertyOfInequality() {
assertTrue(valueUnderTest.compareTo(valueExpectedToBeBiggerThanExpected) < 0);
assertTrue(valueExpectedToBeBiggerThanExpected.compareTo(anotherValueExpectedToBeEvenBiggerThanExpected) < 0);
assertTrue(valueUnderTest.compareTo(anotherValueExpectedToBeEvenBiggerThanExpected) < 0);
}
Full sentences in the method names. Yeah, it specifies the expected behaviour of the unit under test, but the question is about readability now.
I tried to remove the camel case to see if the readability improves, and also because I’m not a Lazzy Programmer
public void should_have_first_transitive_property_of_inequality() {
assertTrue(value_under_test.compareTo(value_expected_to_be_bigger) < 0);
assertTrue(value_expected_to_be_bigger.compareTo(value_expected_to_be_even_bigger) < 0);
assertTrue(value_under_test.compareTo(value_expected_to_be_even_bigger) < 0);
}
I’m feeling good with the readability improvement, so I will drop Camel Case in my BDD exercises.
One concern I had, when started this BDD exercise, was about the length of the name for objects, fields and methods. Yes, it may look a little odd at first (ohh, the guilty of breaking conventions!!), but like everything else in life, also this code may turn to be better than what I have today. My goal is to improve readability and not follow a convention.
The video is from Dave Astels (http://techblog.daveastels.com/) and is here: http://www.youtube.com/watch?v=XOkHh8zF33o
Inheritance in JPA Entities
“..but equals should usually compare state, not identity. This is particularly true for “data-centric” classes which map to database records. [...] If you extend a concrete class, and add a new field which contributes to equals, then it is not possible to write a perfectly correct equals method for the new class. Instead, you should use composition instead of inheritance. (See Effective Java by Joshua Bloch for more information.) ”
From http://www.javapractices.com/topic/TopicAction.do?Id=17
This can be interpreted as “It’s not a good idea to use inheritance in, for example, JPA Entities. It’s better to use composition”. I tend to agree. Deep hierarchies of JPA entities, can be a daunting task to understand, maintain and extends. Having small hierarchies, I think it’s ok. If a JPA model, most of the time models real world concepts, and if real world concepts are better described in terms of composition, instead of inheritance, why complicate things? Take the typical Car exercise, would you model most of your car using inheritance or composition?
But if you’re modelling your JPA entities with object oriented principles , not caring about the mapping stuff, for now, everything that you will need to store in a DB are value types, like Integer, Long, String, byte[], or some composition of these and other value types, so there’s no point to inherit just to add values to an object, it’s better to create a new value type that represents the concept.
Mutation Testing with PITest and JUnit
What? More testing? This time are the tests for your tests. Mutation Testing analyses your code, and based on some heuristics change it to try to “kill” your tests. If if can kill all your tests, then your tests are probably fine, otherwise maybe your coverage it’s not as good as you may think. PIT is a framework worth looking, since it integrates with maven and seems to be maintained. http://pitest.org/
Just use the maven plugin to try with your maven projects and see the results.
There are other tools for mutation Testing with Java and JUnit, but did not try:
http://jester.sourceforge.net/
http://jmute.sourceforge.net/
http://jumble.sourceforge.net/
Programmer testing exercise
Some time ago, I wrote here to leave you with a presentation about programmer testing. This post is a kind of follow up, leaving you now with the exercise.
You can see the exercise here
I also have the presentation in PDF stored in google drive. Find it here.
If you have any feedback/comments or whatever, comment this post.
An introduction to Maven 2
This is an hands-on workshop about Maven. It will help you to get up and running with Maven if you don’t know Maven.
I have included the exercise that you can use to get your hands on Maven. This information is relevant also for Maven 3, though it was developed for Maven 2.
The presentation is here:
If you prefer the PDF, you can view it here: http://bit.ly/Ip7UYl
The exercise can be downloaded/viewed here http://bit.ly/KXB6v3
If you any feedback/comment/whatever comment it.
Quick introduction to REST and JAX-RS
Here are some slides introducing to REST world. Examples are using JAX-RS (JSR 311).
If we’re moving to the cloud-era, the undestanding of this architecture style is essential. In the cloud we are presented with services (Storage, Search, Graph, Geolocation, …) that we can and should use to build applications. Almost all of these services, available in the cloud, provide some kind of interface and happens that, this interfaces is, generally, a RESTful Web Service. If I want collaborate with these services I must talk the same language!! Moreover, exploring this architectural style in new applications opens the door for realy distributed and scalable systems, while the simplicity is kept high!
Here the slides:
PDF can be downloaded from here.
java, programming, Software, Software Architectures, WEB 2.0
Software Architecture disruption?
:Adrian Colyer is a smart guy and he put together, in a talk, what software architectures will look like for the next years. True is, most of the services you’re using online today follow these architecture principles. Nothing new, thought.
Nothing in this architecture is can go wrong, it’s so simple! This type of architecture is the perfect fit for this ubiquitous platform that is Internet.
Btw, SpringSource makes it really easy to develop applications in this way, just look to Spring Integration project, for example. They have a plenty of projects, built on top of Spring, that makes development of this type of architectures more, and more fun and easy.
(Ignore the sound problems at the beginning
)
Contrast this with traditional “enterprise” architectures. Which side of the fence you want to be?
How to violate the Interface Segregation Principle
In my last post, I gave away some slides where OO Design Principles are introduced. I have an though about the big-fail that was the J2EE (before JEE5), in terms of violating the Interface Segregation Principle.
If you you are fortunate enough to have experienced the pain of writing applications with J2EE, then you recall that, for example, when you define an Stateless EJB, you have to implement the SessionBean interface.
Well, this is a clear violation of the Interface Segregation Principle, your EJB component have to implement the EJB lifecycle callback methods, even if you don’t need them. Right?
For instance:
public class MyComponent extends SessionBean {
public void someCoolBusinessMethod() {
// Business knowledge is coded here
}
public void ejbCreate() {} //Don't have anything to do in this EJB lifecycle callback, but the interface forces me to implement the method
public void ejbRemove() {} //Don't have anything to do in this EJB lifecycle callback, but the interface forces me to implement the method
public void ejbPassivate() { } //Don't have anything to do in this EJB lifecycle callback, but the interface forces me to implement the method
...
}
Latest versions of JEE (5 and 6), allows you to bind methods to component lifecycle events declaratively, with annotations of XML. For example:
public void MyOtheComponent {
public String realBusinessMethod() {
return "I do really cool stuff";
}
@PreDestroy
private void letMeGo() {
//Any business that should run before the object is left to the GC
}
}
They fixed it, but very behind time…
OO Design Principles, part 2
I’ve put a PDF online for the first part of OO Design principles, or guidelines… . Dowload it from here.
This second part is also the last one of this short introduction to OO design principles. I see these principles a the basic conceptual framework to build Object Oriented programs. It is the base model for a lots of cool frameworks out there, some of them you’re using today to build really cool stuff!
I have also the PDF online. If you want to download it for future reference, you can do it from here.
