Skip to content

Commit

Permalink
"interface" is really in the *most* abstract sense
Browse files Browse the repository at this point in the history
  • Loading branch information
Oberon00 authored Jul 22, 2020
1 parent 179fcc1 commit 0b9709d
Showing 1 changed file with 7 additions and 1 deletion.
8 changes: 7 additions & 1 deletion specification/trace/sdk.md
Original file line number Diff line number Diff line change
Expand Up @@ -177,7 +177,13 @@ Thus, the SDK specification defines two new terms:

Note: First, these requirements use "interface" in the most abstract sense --
it does not need to be an actual Java `interface` for example but could also be
a `final` POJO. Second, these are abstract requirements for interfaces. Not all
a `final` POJO, or, especially in the case of read/write span, even two (or more)
separate objects that are passed together to give full read/write capabilities
(when chosing this implemenation technique,
changes through one object should be reflected in the other
objects immediately if they are observable through them at all
to avoid introducing suble gotchas).
Second, these are abstract requirements for interfaces. Not all
places in the spec that talk about a readable span need to be implemented by the
same concrete interface. For example, this allows using a different interface
for the readable span passed to an exporter than for the readable span passed
Expand Down

0 comments on commit 0b9709d

Please sign in to comment.