Writers

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

License	MIT
GroupId	com.github.marschall
ArtifactId	writers
Last Version	0.2.0
Release Date	Sep 17, 2020
Type	jar
Description	Writers Implementations of `java.io.Writer` with different trade-offs.

Download writers

Filename	Size
writers-0.2.0.pom
writers-0.2.0.jar	7 KB
writers-0.2.0-sources.jar	5 KB
writers-0.2.0-javadoc.jar	400 KB

How to add to project

Apache Maven

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

Gradle Groovy

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

Gradle Kotlin

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

Apache Buildr

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

Apache Ivy

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

Groovy Grape

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

Scala SBT

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

Leiningen

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

Dependencies

test (2)

Group / Artifact	Type	Version
org.junit.jupiter : junit-jupiter-api	jar
org.junit.jupiter : junit-jupiter-engine	jar

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