Skip to content

Commit 9ad57df

Browse files
committed
Add Chapter 8 Notes
1 parent b64bbf1 commit 9ad57df

File tree

1 file changed

+49
-0
lines changed

1 file changed

+49
-0
lines changed

README.md

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@
88
* [Chapter 5 - Formatting](#chapter5)
99
* [Chapter 6 - Objects and Data Structures](#chapter6)
1010
* [Chapter 7 - Error Handling](#chapter7)
11+
* [Chapter 8 - Boundaries](#chapter8)
1112

1213

1314
<a name="chapter1">
@@ -962,3 +963,51 @@ If you are tempted to return null from a method, consider throwing an exception
962963
963964
### Don't Pass Null
964965
Returning null from methods is bad, but passing null into methods is worse. Unless you are working with an API which expects you to pass null, you should avoid passing null in your code whenever possible.
966+
967+
<a name="chapter8">
968+
## Chapter 8 - Boundaries
969+
</a>
970+
971+
We seldom control all the software in our systems. Sometimes we buy third-party pack- ages or use open source. Other times we depend on teams in our own company to produce components or subsystems for us. Somehow we must cleanly integrate this foreign code with our own.
972+
973+
### Using Third-Party Code
974+
There is a natural tension between the provider of an interface and the user of an interface. Providers of third-party packages and frameworks strive for broad applicability so they can work in many environments and appeal to a wide audience. Users, on the other hand, want an interface that is focused on their particular needs. This tension can cause problems at the boundaries of our systems. Example:
975+
976+
```java
977+
Map sensors = new HashMap();
978+
Sensor s = (Sensor)sensors.get(sensorId);
979+
```
980+
981+
VS
982+
983+
```java
984+
public class Sensors {
985+
private Map sensors = new HashMap();
986+
987+
public Sensor getById(String id) {
988+
return (Sensor) sensors.get(id);
989+
}
990+
//snip
991+
}
992+
```
993+
994+
The first code exposes the casting in the Map, while the second is able to evolve with very little impact on the rest of the application. The casting and type management is handled inside the Sensors class.
995+
996+
The interface is also tailored and constrained to meet the needs of the application. It results in code that is easier to understand and harder to misuse. The Sensors class can enforce design and business rules.
997+
998+
### Exploring and Learning Boundaries
999+
Third-party code helps us get more functionality delivered in less time. Where do we start when we want to utilize some third-party package? It’s not our job to test the third-party code, but it may be in our best interest to write tests for the third-party code we use.
1000+
1001+
It's a good idea write some test for learn and understand how to use a third-party code. Newkirk calls such tests learning tests.
1002+
1003+
### Learning Tests Are Better Than Free
1004+
1005+
The learning tests end up costing nothing. We had to learn the API anyway, and writing those tests was an easy and isolated way to get that knowledge. The learning tests were precise experiments that helped increase our understanding.
1006+
1007+
Not only are learning tests free, they have a positive return on investment. When there are new releases of the third-party package, we run the learning tests to see whether there are behavioral differences.
1008+
1009+
### Using Code That Does Not Yet Exist
1010+
Some times it's necessary work in a module that will be connected to another module under develop, and we have no idea about how to send the information, because the API had not been designed yet. In this cases it's recommendable create an interface for encapsulate the communication with the pending module. In this way we maintain the control over our module and we can test although the second module isn't available yet.
1011+
1012+
### Clean Boundaries
1013+
Interesting things happen at boundaries. Change is one of those things. Good software designs accommodate change without huge investments and rework. When we use code that is out of our control, special care must be taken to protect our investment and make sure future change is not too costly.

0 commit comments

Comments
 (0)