HiddenBuilder
From APIDesign
(Difference between revisions)
(New page: HiddenBuilder is a trick that hides the builder from Javadoc of your API. It may be very handy when the builder comes with a complex (generic type) signature like in case o...) |
|||
| Line 1: | Line 1: | ||
[[HiddenBuilder]] is a trick that hides the [[builder]] from [[Javadoc]] of your [[API]]. It may be very handy when the builder comes with a complex (generic type) signature like in case of [[ResistingBuilder]]. | [[HiddenBuilder]] is a trick that hides the [[builder]] from [[Javadoc]] of your [[API]]. It may be very handy when the builder comes with a complex (generic type) signature like in case of [[ResistingBuilder]]. | ||
| - | An example of [[HiddenBuilder]] can be found at [[Truffle]] [[API]]. There is {{truffle|com/oracle/truffle/api/vm|PolyglotEngine.Builder}} which constructs instances of {{truffle|com/oracle/truffle/api/vm|PolyglotEngine}}, but if you look at overall [[Truffle]] [[javadoc]], the [[builder]] isn't visible in the {{truffle|com/oracle/truffle/api/vm|package- | + | An example of [[HiddenBuilder]] can be found at [[Truffle]] [[API]]. There is {{truffle|com/oracle/truffle/api/vm|PolyglotEngine.Builder}} which constructs instances of {{truffle|com/oracle/truffle/api/vm|PolyglotEngine}}, but if you look at overall [[Truffle]] [[javadoc]], the [[builder]] isn't visible in the {{truffle|com/oracle/truffle/api/vm|package-summary}} overview. |
[[TBD]]: Explain why. | [[TBD]]: Explain why. | ||
Revision as of 06:41, 20 June 2016
HiddenBuilder is a trick that hides the builder from Javadoc of your API. It may be very handy when the builder comes with a complex (generic type) signature like in case of ResistingBuilder.
An example of HiddenBuilder can be found at Truffle API. There is PolyglotEngine.Builder which constructs instances of PolyglotEngine, but if you look at overall Truffle javadoc, the builder isn't visible in the package-summary overview.
TBD: Explain why.
Follow
