RFR 15: 8243010: Test support: Customizable Hex Printer

[Lance Andersen]

Hi Roger,

I think tackling this via the new Developer’s guide project makes sense as it would help folks re-inventing the wheel and making it easier to find what already exists.  

Best
Lance

> On Apr 17, 2020, at 12:55 PM, Roger Riggs <Roger.Riggs at oracle.com> wrote:
> 
> Hi Lance,
> 
> The test library is a bit of a black box usually approached from the angle of existing tests.
> And unfortunately, there is a lower bar for documentation and API development.
> Perhaps an item to be looked at as part of the new developer guide project.
> 
> Thanks, Roger
> 
> 
> 
> On 4/17/20 11:34 AM, Lance Andersen wrote:
>> Hi Roger,
>> 
>> Thank you for creating this as it looks good.
>> 
>> A couple of quick questions
>> 
>> - Will the javadoc be hosted somewhere
>> - Maybe I have not stumbled onto it yet, but is there a document/wiki somewhere that describes all of the useful test libraries vs discovering as you go?
>> 
>> 
>> Best
>> Lance
>> 
>> 
>>> On Apr 16, 2020, at 3:17 PM, Roger Riggs <Roger.Riggs at oracle.com <mailto:Roger.Riggs at oracle.com>> wrote:
>>> 
>>> Please review[2] and comment on a new Hex printing utility to support OpenJDK tests.
>>> The usefulness of a hex printing has been discussed from time to time with
>>> many suggestions as to the API shape and features.
>>> 
>>> To get an idea of the API and features, take a look at the javadoc[1].
>>> It covers the basic formatting of offset, and values, and extends the
>>> descriptive part beyond simple ASCII or printable so that a custom formatter
>>> can interpret the byte stream in parallel to the bytes.
>>> 
>>> The webrev includes changes to existing tests that currently
>>> use HexDumpEncoder to use HexPrinter.
>>> 
>>> Comments appreciated, Roger
>>> 
>>> [1]Javadoc:
>>> http://cr.openjdk.java.net/~rriggs/webrev-hexprinter-8243010/javadoc <http://cr.openjdk.java.net/~rriggs/webrev-hexprinter-8243010/javadoc>
>>> 
>>> [2] Webrev:
>>>   http://cr.openjdk.java.net/~rriggs/webrev-hexprinter-8243010/ <http://cr.openjdk.java.net/~rriggs/webrev-hexprinter-8243010/>
>>> 
>>> [3] Issue:
>>>   https://bugs.openjdk.java.net/browse/JDK-8243010 <https://bugs.openjdk.java.net/browse/JDK-8243010>
>> 
>> <oracle_sig_logo.gif> <http://oracle.com/us/design/oracle-email-sig-198324.gif>
>>  <http://oracle.com/us/design/oracle-email-sig-198324.gif> <http://oracle.com/us/design/oracle-email-sig-198324.gif>
>>  <http://oracle.com/us/design/oracle-email-sig-198324.gif>Lance Andersen| Principal Member of Technical Staff | +1.781.442.2037
>> Oracle Java Engineering 
>> 1 Network Drive 
>> Burlington, MA 01803
>> Lance.Andersen at oracle.com <mailto:Lance.Andersen at oracle.com>
>> 
>> 
>> 
> 

 <http://oracle.com/us/design/oracle-email-sig-198324.gif>
 <http://oracle.com/us/design/oracle-email-sig-198324.gif> <http://oracle.com/us/design/oracle-email-sig-198324.gif>
 <http://oracle.com/us/design/oracle-email-sig-198324.gif>Lance Andersen| Principal Member of Technical Staff | +1.781.442.2037
Oracle Java Engineering 
1 Network Drive 
Burlington, MA 01803
Lance.Andersen at oracle.com <mailto:Lance.Andersen at oracle.com>