Shallow size of an object is the amount of memory allocated to store the object itself, not taking into account the referenced objects. Shallow size of a regular (non-array) object depends on the number and types of its fields. Shallow size of an array depends on the array length and the type of its elements (objects, primitive types). Shallow size of a set of objects represents the sum of shallow sizes of all objects in the set.

Retained size of an object is its shallow size plus the shallow sizes of the objects that are accessible, directly or indirectly, only from this object. In other words, the retained size represents the amount of memory that will be freed by the garbage collector when this object is collected.

To better understand the notion of the retained size, let us look at the following examples:

retained size에 대한 보다 더 자세한 이해를 위해서 다음의 예제를 살펴보자.

In order to measure the retained sizes, all objects in memory are treated as nodes of a graph where its edges represent references from objects to objects. There are also special nodes - GC root objects, which will not be collected by Garbage Collector at the time of measuring (read more about GC roots).

The pictures below show the same set of objects, but with varying internal references.

아래 그림을 보면 돌일한 set을 가지는 객체들이며, 내부적인 참조는 다른 상황이다.

Figure 1:

Figure 2:

Let us consider obj1.As you can see, in both pictures we have highlighted all of the objects that are directly or indirectly accessed only by obj1. If you look at Figure 1, you will see that obj3 is not highlighted, because it is also referenced by a GC root object. On Figure 2, however, it is already included into the retained set, unlike obj5, which is still referenced byGC root.

Thus, the retained size of obj1 will represent the following respective values:

For Figure 1: the sum of shallow sizes of obj1, obj2 and obj4

For Figure 2: the sum of shallow sizes of obj1, obj2, obj3 and obj4

따라서 obj1의 retained size는 다음의 값들을 나타낸다.

그림 1 : obj1,2,4의 shallow size의 합

그림 2 : obj1,2,3,4의 shallow size의 합

Looking at obj2, however, we see that its retained size in the above cases will be:

For Figure 1: the sum of shallow sizes of obj2 and obj4

For Figure 2: the sum of shallow sizes of obj2, obj3 and obj4

obj2를 보자. 이 객체의 retained 크기는

그림 1 : obj2, 4의 shallow size의 합

그림 2 : obj2,3,4의 shallow size의 합

In general, retained size is an integral measure, which helps to understand the structure (clusterization) of memory and the dependences between object subgraphs, as well as find potential roots of those subgraphs.