# HG changeset patch # User Jaroslav Tulach # Date 1213429982 -7200 # Node ID bea28c7c66530b9fffd7cc62e0a7cb77b8110f1b # Parent 02e05defc6a03ace97445b91149c278a17762664 Converting the Writer delegation problem into real example diff -r 02e05defc6a0 -r bea28c7c6653 samples/delegatingwriter/build.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/samples/delegatingwriter/build.xml Sat Jun 14 09:53:02 2008 +0200 @@ -0,0 +1,69 @@ + + + + + + Builds, tests, and runs the project delegatingwriter. + + + diff -r 02e05defc6a0 -r bea28c7c6653 samples/delegatingwriter/nbproject/build-impl.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/samples/delegatingwriter/nbproject/build-impl.xml Sat Jun 14 09:53:02 2008 +0200 @@ -0,0 +1,627 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Must set src.dir + Must set test.src.dir + Must set build.dir + Must set dist.dir + Must set build.classes.dir + Must set dist.javadoc.dir + Must set build.test.classes.dir + Must set build.test.results.dir + Must set build.classes.excludes + Must set dist.jar + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Must set javac.includes + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Must select some files in the IDE or set javac.includes + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + To run this application from the command line without Ant, try: + + + + + + + java -cp "${run.classpath.with.dist.jar}" ${main.class} + + + + + + + + + + + + + + + + + + + + + + + To run this application from the command line without Ant, try: + + java -jar "${dist.jar.resolved}" + + + + + + + + + + + + + + + + + + + Must select one file in the IDE or set run.class + + + + + + + + + + + + + + + + + + + + Must select one file in the IDE or set debug.class + + + + + Must set fix.includes + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Must select some files in the IDE or set javac.includes + + + + + + + + + + + + + + + + + + + + Some tests failed; see details above. + + + + + + + + + Must select some files in the IDE or set test.includes + + + + Some tests failed; see details above. + + + + + Must select one file in the IDE or set test.class + + + + + + + + + + + + + + + + + + + + + + + + + + + Must select one file in the IDE or set applet.url + + + + + + + + + Must select one file in the IDE or set applet.url + + + + + + + + + + + + + + + + + + + diff -r 02e05defc6a0 -r bea28c7c6653 samples/delegatingwriter/nbproject/genfiles.properties --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/samples/delegatingwriter/nbproject/genfiles.properties Sat Jun 14 09:53:02 2008 +0200 @@ -0,0 +1,8 @@ +build.xml.data.CRC32=1fa45f30 +build.xml.script.CRC32=d80e7700 +build.xml.stylesheet.CRC32=be360661 +# This file is used by a NetBeans-based IDE to track changes in generated files such as build-impl.xml. +# Do not edit this file. You may delete it but then the IDE will never regenerate such files for you. +nbproject/build-impl.xml.data.CRC32=1fa45f30 +nbproject/build-impl.xml.script.CRC32=1dc6566a +nbproject/build-impl.xml.stylesheet.CRC32=f1d9da08 diff -r 02e05defc6a0 -r bea28c7c6653 samples/delegatingwriter/nbproject/project.properties --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/samples/delegatingwriter/nbproject/project.properties Sat Jun 14 09:53:02 2008 +0200 @@ -0,0 +1,57 @@ +build.classes.dir=${build.dir}/classes +build.classes.excludes=**/*.java,**/*.form +# This directory is removed when the project is cleaned: +build.dir=build +build.generated.dir=${build.dir}/generated +# Only compile against the classpath explicitly listed here: +build.sysclasspath=ignore +build.test.classes.dir=${build.dir}/test/classes +build.test.results.dir=${build.dir}/test/results +debug.classpath=\ + ${run.classpath} +debug.test.classpath=\ + ${run.test.classpath} +# This directory is removed when the project is cleaned: +dist.dir=dist +dist.jar=${dist.dir}/delegatingwriter.jar +dist.javadoc.dir=${dist.dir}/javadoc +excludes= +includes=** +jar.compress=false +javac.classpath= +# Space-separated list of extra javac options +javac.compilerargs= +javac.deprecation=false +javac.source=1.5 +javac.target=1.5 +javac.test.classpath=\ + ${javac.classpath}:\ + ${build.classes.dir}:\ + ${libs.junit.classpath}:\ + ${libs.junit_4.classpath} +javadoc.additionalparam= +javadoc.author=false +javadoc.encoding=${source.encoding} +javadoc.noindex=false +javadoc.nonavbar=false +javadoc.notree=false +javadoc.private=false +javadoc.splitindex=true +javadoc.use=true +javadoc.version=false +javadoc.windowtitle= +meta.inf.dir=${src.dir}/META-INF +platform.active=default_platform +run.classpath=\ + ${javac.classpath}:\ + ${build.classes.dir} +# Space-separated list of JVM arguments used when running the project +# (you may also define separate properties like run-sys-prop.name=value instead of -Dname=value +# or test-sys-prop.name=value to set system properties for unit tests): +run.jvmargs= +run.test.classpath=\ + ${javac.test.classpath}:\ + ${build.test.classes.dir} +source.encoding=UTF-8 +src.dir=src +test.src.dir=test diff -r 02e05defc6a0 -r bea28c7c6653 samples/delegatingwriter/nbproject/project.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/samples/delegatingwriter/nbproject/project.xml Sat Jun 14 09:53:02 2008 +0200 @@ -0,0 +1,16 @@ + + + org.netbeans.modules.java.j2seproject + + + delegatingwriter + 1.6.5 + + + + + + + + + diff -r 02e05defc6a0 -r bea28c7c6653 samples/delegatingwriter/src/org/apidesign/delegatingwriter/ExBufferedWriter.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/samples/delegatingwriter/src/org/apidesign/delegatingwriter/ExBufferedWriter.java Sat Jun 14 09:53:02 2008 +0200 @@ -0,0 +1,51 @@ +/* + * To change this template, choose Tools | Templates + * and open the template in the editor. + */ + +package org.apidesign.delegatingwriter; + +import java.io.BufferedWriter; +import java.io.IOException; +import java.io.Writer; + +/** + * This is a regular {@link BufferedWriter}, just it optimizes for + * huge {@link CharSequence} objects set to its {@link #append} method. + * Instead of converting them to string, which might required too much + * temporary memory, it delegates it directly. + *

+ * This class is simulating would would happen if JDK's BufferedWriter + * in revision 1.5 + * was designed to delegate its newly added append methods + * instead of calling its already existing write ones. + * + * @author Jaroslav Tulach + */ +public class ExBufferedWriter extends BufferedWriter { + private final Writer out; + + public ExBufferedWriter(Writer out, int sz, boolean optimized) { + super(out, sz); + this.out = optimized ? out : null; + } + + @Override + public Writer append(CharSequence csq) throws IOException { + if (out != null) { + // efficient, yet dangerous delegation skipping methods known to + // subclasses that used version 1.4 + out.append(csq); + return this; + } else { + // non-efficient variant of delegating via converting to String first + // and using one of methods that existed in 1.4 + if (csq == null) { + write("null"); + } else { + write(csq.toString()); + } + return this; + } + } +}