Writers Benchmark

Writers Parent POM

License	MIT
GroupId	com.github.marschall
ArtifactId	writers-benchmark
Last Version	0.2.0
Release Date	Sep 17, 2020
Type	jar
Description	Writers Benchmark Writers Parent POM

Download writers-benchmark

Filename	Size
writers-benchmark-0.2.0.pom
writers-benchmark-0.2.0.jar	78 KB
writers-benchmark-0.2.0-sources.jar	41 KB
writers-benchmark-0.2.0-javadoc.jar	514 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.marschall/writers-benchmark/ -->
<dependency>
    <groupId>com.github.marschall</groupId>
    <artifactId>writers-benchmark</artifactId>
    <version>0.2.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.marschall/writers-benchmark/
implementation 'com.github.marschall:writers-benchmark:0.2.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.marschall/writers-benchmark/
implementation ("com.github.marschall:writers-benchmark:0.2.0")

Apache Buildr

'com.github.marschall:writers-benchmark:jar:0.2.0'

Apache Ivy

<dependency org="com.github.marschall" name="writers-benchmark" rev="0.2.0">
  <artifact name="writers-benchmark" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.marschall', module='writers-benchmark', version='0.2.0')
)

Scala SBT

libraryDependencies += "com.github.marschall" % "writers-benchmark" % "0.2.0"

Leiningen

[com.github.marschall/writers-benchmark "0.2.0"]

Dependencies

compile (2)

Group / Artifact	Type	Version
com.github.marschall : writers	jar	0.2.0
org.openjdk.jmh : jmh-core	jar	1.25.2

Project Modules

There are no modules declared in this project.

Writers

Implementations of java.io.Writer with different trade-offs.

java.io.OutputStreamWriter is very flexible and supports any encoding. However its use of sun.nio.cs.StreamEncoder can result in a noticeable overhead for small writes. It allocates a few temporary objects which for small writes can be noticeable. By addressing only special cases we can make optimizations based on different trade-offs.

Currently we only offer the following two classes:

• com.github.marschall.writers.AsciiOutputStreamWriter, only supports US-ASCII.
  • does not allocate any objects
  • thread-safe
• com.github.marschall.writers.BufferedAsciiOutputStreamWriter, only supports US-ASCII but also buffers like a java.io.BufferedOutputStream. This can result in more efficient writes than using com.github.marschall.writers.AsciiOutputStreamWriter with java.io.BufferedOutputStream.
  • does not allocate any objects beyond the initial byte[], the #write and #append methods do not allocate memory
  • uses bulk array copy methods on Java 9+
  • not thread-safe

This project requires Java 11.

Versions

Version
0.2.0 Sep 17, 2020
0.1.1 Oct 12, 2019
0.1.0 Oct 5, 2019